jeasonlzy/ImagePicker
ImagePicker
ImagePicker is a mobile image picker library that provides a user interface for selecting, rotating, and cropping images from a device gallery or camera. It includes a multi-image selection interface that allows users to pick one or multiple photos up to a specified limit.
The library features a customizable image loader interface, allowing the replacement of default system image retrieval with third-party loading libraries. It also includes an image cropping tool for trimming photos into custom rectangular or circular shapes with precise dimensions and aspect ratios.
The project covers media management capabilities such as gallery image selection, camera photo capture, and image rotation. These utilities enable the launching of the device camera to capture new photos directly within the selection interface.
Features
- Mobile Image Pickers - Provides a comprehensive mobile UI for selecting existing photos from the gallery or capturing new ones.
- Image Cropping Tools - Provides a utility for trimming photos into custom shapes with specific aspect ratios and dimensions.
- Geometric Shape Cropping - Allows trimming photos into custom rectangular or circular shapes with precise dimensions.
- Android Gallery Selection - Implements the logic to trigger and manage the selection of image files from the device gallery.
- Camera Integrations - Provides a bridge to launch the native device camera for capturing new photos within the selection interface.
- Camera Image Capture - Enables capturing images from the device camera for immediate use within the image selection workflow.
- Custom Loading and Caching Logic - Offers extensible interfaces to replace default image retrieval with custom third-party loading logic.
- Matrix-Based Rotations - Applies degree-based matrix transformations to rotate image orientation before finalizing the selection.
- Coordinate Calculation - Implements coordinate-based logic to calculate rectangular and circular boundary offsets for precise image extraction.
- Custom Loader Interfaces - Provides an interface to integrate third-party image loading and caching libraries into the picker.
- Loading Abstractions - Utilizes a standardized loading contract to allow swapping between system-default and third-party image retrieval implementations.
- Multiple Selections - Features a gallery viewer that supports picking multiple photos up to a specified limit.
- Selection Logic - Manages the selection state of images, including the enforcement of maximum selection limits.
- Image Loader Configurations - Supports configuring image loaders to integrate third-party libraries for optimized image retrieval.
- Image Display and Processing - WeChat-style image picker UI.
