flutter_image_clip 0.6.0
flutter_image_clip: ^0.6.0 copied to clipboard
A reusable Android and iOS Flutter image clipping library with a ready-to-use crop editor UI and image processing APIs.
0.6.0 #
- 将发布包平台声明收敛为仅支持 Android 和 iOS。
- 更新 README 和 pubspec 描述,移除面向桌面/Web 的平台暗示。
- 拆分编辑器 UI 层,将控制器、编辑器主体、预览面板、工具栏、结果页、主题、文案和裁剪遮罩 painter 拆到独立文件。
- 新增
ImageClipTask、ImageClipTaskOptions和ImageClipTaskProgress,支持任务取消、进度监听和超时取消。 ImageClipEditorController新增cancelTask(),可取消当前编辑器后台处理任务。- 新增
benchmark/image_processor_benchmark.dart,覆盖解码、旋转裁剪导出 JPEG 和大图 downscale 的耗时基准。 - 补充任务进度和取消测试。
0.5.0 #
- 新增
ImageClipPipeline和ImageClipPipelineStep,支持把解码、旋转、裁剪、翻转、缩放、调色和导出合并为一次后台任务。 - 新增
ImageProcessor.processPipeline和ImageProcessor.processBytes,减少多步处理时的重复 decode/encode 和 isolate 往返。 - 重构图像处理层文件结构,将异常、模型、pipeline 描述、isolate job、像素操作和示例图生成拆分到独立模块。
- 保留
cropRegion、rotate、adjustColor、exportJpeg等既有单步 API,旧调用方式无需迁移。 - 补充 pipeline 多步处理测试,覆盖从原始字节和已有
EditedImage两种入口运行。
0.4.0 #
- 新增
ImageClipEditorController,支持父组件主动加载图片、清空图片、重置裁剪视图、旋转图片、读取当前裁剪区域并触发裁剪。 - 优化编辑器异步任务生命周期:新的图片加载请求会使旧任务结果失效,避免快速切换图片时旧结果覆盖新状态。
- 裁剪保存任务也加入过期结果保护,避免图片被替换后继续回写旧裁剪结果。
- 补充控制器驱动流程和乱序异步加载的 Widget 测试。
- 更新 README 的控制器集成示例。
0.3.0 #
- Added
ImageClipEditorThemefor configurable editor and result page colors, borders, crop overlays, and framed surface radius. - Added EXIF orientation baking during image decoding so rotated camera photos crop with the expected dimensions.
- Added
ImageClipProcessingSettingsfor input pixel limits, output pixel limits, and automatic downscaling. - Added typed exceptions for decode failures, processing failures, invalid crop regions, and oversized images.
- Improved configurable crop ratio presets so custom ratio frames inherit editor theme tokens.
- Added GitHub Actions CI for formatting, analysis, tests, API docs, and pub dry-run validation.
0.2.0 #
- Added
ImageClipEditorLabelsfor configurable editor, status, and result page copy. - Added
ImageClipAspectRatioso the editor can show custom named crop ratio presets such as square or widescreen crops. - Added
ImageClipOutputSettingsandImageClipOutputFormatfor configurable PNG or JPEG crop output. - Added
ImageProcessor.exportImageandImageProcessor.exportJpeg. - Changed built-in editor and processor messages to English defaults.
0.1.1 #
- Updated the changelog to use English content for pub.dev language checks.
- Added dartdoc comments for the public libraries, image processing APIs, and crop editor APIs.
0.1.0 #
- Initial release of
flutter_image_clip. - Added
showImageClipEditor, a ready-to-use crop editor route API. - Added
ImageClipEditor, an embeddable Flutter crop editor widget. - Added
ImageProcessorimage processing APIs for decoding, cropping, rotating, flipping, resizing, color adjustment, and PNG export. - Added
ImageClipResultwith source image data, cropped image data, crop region metadata, and rotation metadata.