搜索分类、插件与代码仓

pro_image_editor 封面
插件详情v14.22.0

pro_image_editor

一个Flutter图像编辑器:通过用户友好的编辑功能,无缝提升您的图片质量。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
8万
喜欢数
597
Pub 分数
160

安装插件

flutter pub add pro_image_editor

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

Pro Image Editor 是一个 Flutter 包,为在 Flutter 应用中编辑图像提供无缝且用户友好的界面。它支持裁剪、旋转、调整亮度、对比度和饱和度等基本编辑功能,非常适合需要随时随地进行图像增强的应用程序。该包兼容 Android、iOS、Web、macOS、Windows 和 Linux 多个平台,确保广泛的覆盖范围。通过直观的控制和高效的性能,它使开发者能够无需大量自定义开发即可集成强大的图像编辑功能。

适合场景

  • 移动应用照片编辑
  • 基于网络的图像自定义
  • 跨平台图像增强工具
  • 社交媒体内容创作
  • 电子商务产品图像编辑

主要特点

  • 裁剪和旋转工具
  • 亮度、对比度和饱和度调整
  • 多平台支持
  • 与 Flutter 的简单集成
  • 编辑的实时预览
  • 轻量且高效

适合对象

  • 开发图像密集型应用的开发者
  • 注重设计的移动或网页应用
  • 需要快速图像修改的应用程序
  • 教育或创意工具
  • 内容管理系统

使用建议

  • 仅限基本编辑功能
  • 无高级过滤器或AI增强
  • 需要仔细处理大图像文件
  • 可能需要针对高分辨率图像进行额外优化
  • 依赖外部依赖项以实现完整功能

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Logo

pub package Sponsor License GitHub issues Web Demo

The ProImageEditor is a Flutter widget designed for image editing within your application. It provides a flexible and convenient way to integrate image editing capabilities into your Flutter project.

Demo Website

Table of contents

Preview

Grounded-Design Frosted-Glass-Design WhatsApp-Design
Grounded-Design Frosted-Glass-Design WhatsApp-Design
Ai-Commands Ai-Remove-Background Ai-Replace-Background
Ai-Commands Ai-Remove-Background Ai-Replace-Background
Paint-Editor Text-Editor Crop-Rotate-Editor
Paint-Editor Text-Editor Crop-Rotate-Editor
Filter-Editor Emoji-Editor Sticker/ Widget Editor
Filter-Editor Emoji-Editor Sticker-Widget-Editor

Features

🧩 Editor Modules
  • 🎨 Paint Editor: Draw freehand with various brushes, shapes (like circles and arrows), and apply blur or pixelation for censoring.
  • 🅰️ Text Editor: Add and style text with full customization.
  • ✂️ Crop & Rotate Editor: Crop, flip, and rotate images with ease.
  • 🎛️ Tune Adjustments: Adjust brightness, contrast, saturation, and more.
  • 📸 Filter Editor: Apply custom or predefined image filters.
  • 💧 Blur Editor: Add blur to any part of the image.
  • 😀 Emoji Picker: Quickly insert emojis into your design.
  • 🖼️ Sticker Editor: Add and manage custom image stickers.
🚀 Performance & Architecture
  • 🧵 Multi-Threading
    • Use isolates for background tasks on native platforms.
    • Use web workers for background tasks in web environments.
    • Auto- or manually configure the number of active background processors based on device capabilities.
🛠️ Core Features
  • 🖼️ Flexible Image Input: Load images from memory, assets, files, or network.
  • 🌍 i18n Support: Translate every string in the UI.
  • 🎚️ Per-Editor Configuration: Each module offers extensive customization options.
  • 🧱 Fully Customizable: Swap icons, styles, and widgets for any subeditor.
  • 📐 Helper Lines: Snap and align objects more accurately.
  • ↩️ Undo/Redo support for non-destructive editing.
  • 🔁 Movable Background Image: Position the base image as needed.
  • 🔀 Reorder Layers: Change layer stacking order dynamically.
  • 🎯 Interactive Layers: Select and manipulate each element with precision.
  • 🖌️ Hit Detection: Paint layers support interactive selection.
  • 🔍 Zoom Support: Zoom in/out in both paint and main editor views.
  • 🖱️ Enhanced Desktop UX: Fine-tuned movement and scaling on desktop platforms.
  • 🧲 Multiselect Support: Select multiple elements at once.
🎨 Themes
  • 🪵 Grounded Theme
  • 🧊 Frosted Glass Theme
  • 💬 WhatsApp Theme
🔗 Integration
  • 🤖 AI Assistant: Integrate ChatGPT, Gemini, or other AI models to assist with image editing via smart suggestions or direct commands.
  • 🎥 Video Editor: Seamlessly combine image and video editing workflows.

Setup

Web
Show web setup

If you're displaying emoji on the web and want them to be colored by default (especially if you're not using a custom font like Noto Emoji), you can achieve this by adding the useColorEmoji: true parameter to your flutter_bootstrap.js file, as shown in the code snippet below:

{{flutter_js}}
{{flutter_build_config}}

_flutter.loader.load({
    serviceWorkerSettings: {
        serviceWorkerVersion: {{flutter_service_worker_version}},
    },
    onEntrypointLoaded: function (engineInitializer) {
      engineInitializer.initializeEngine({
        useColorEmoji: true, // add this parameter
        renderer: 'canvaskit'
      }).then(function (appRunner) {
        appRunner.runApp();
      });
    }
});

You can view the full web example here.

Android, iOS, macOS, Linux, Windows

No additional setup required.

Apps that still use package:flutter/material.dart

Since v14 the editor is built on material_ui and cupertino_ui, which Flutter is decoupling from the SDK. If your app has not migrated its own MaterialApp yet, hand it the localizations of those packages, otherwise the editor's app bars, dialogs and bottom sheets throw No MaterialLocalizations found:

import 'package:material_ui/material_ui.dart' as material_ui;

MaterialApp(
  localizationsDelegates: [
    ...material_ui.GlobalMaterialLocalizations.delegates,
    // Your existing delegates, e.g. the ones from flutter_localizations.
  ],
  // ...
);

Usage

import 'package:pro_image_editor/pro_image_editor.dart';

@override
Widget build(BuildContext context) {
  return ProImageEditor.network(
    'https://picsum.photos/id/237/2000',
    callbacks: ProImageEditorCallbacks(
      onImageEditingComplete: (Uint8List bytes) async {
        /*
          Your code to process the edited image, such as uploading it to your server.

          You can choose to use await to keep the loading dialog visible until 
          your code completes, or run it without async to close the loading dialog immediately.

          By default, the image bytes are in JPG format.
        */
        Navigator.pop(context);
      },
        /* 
        Optional: If you want haptic feedback when a line is hit, similar to WhatsApp, 
        you can use the code below along with the vibration package.

          mainEditorCallbacks: MainEditorCallbacks(
            helperLines: HelperLinesCallbacks(
              onLineHit: () {
                Vibration.vibrate(duration: 3);
              }
            ),
          ),
        */
    ),
  );
}
Designs

The editor offers three prebuilt designs:

Extended-Configurations

The editor provides extensive customization options, allowing you to modify text, icons, colors, and widgets to fit your needs. It also includes numerous callbacks for full control over its functionality.

Check out the web demo to explore all possibilities. You can find the example code for all demos here.

Video-Editor

The editor supports full video generation on Android, iOS, and macOS. Support for Windows and Linux is coming soon.

To keep the image editor lightweight, you’ll need to manually add the video player package of your choice. For rendering the video, you can use my package pro_video_editor, which is also used in the example.

An example of how to implement the video editor with a specific video player can be found here, and a simpler example using just the default video_player is available here.

Sponsors

Included Packages

A big thanks to the authors of these amazing packages.

Contributors

Made with contrib.rocks.

所属分类

依赖

依赖清单 7 项

源码仓库

使用此插件的项目