syncfusion-maui-image-editor

实现 .NET MAUI 图像编辑器

一份关于实现和自定义 Syncfusion .NET MAUI ImageEditor（SfImageEditor）控件的综合指南。ImageEditor 提供强大的图像编辑功能，包括裁剪、变换、批注、滤镜和效果，并内置可自定义工具栏。

何时使用此指南

在以下情况下使用此指南：

• 在 .NET MAUI 应用程序中编辑和处理图像
• 使用各种纵横比或自定义选区裁剪图像
• 旋转或翻转图像（变换）
• 添加批注：形状、文本或手绘
• 应用滤镜和效果（亮度、对比度、模糊、饱和度等）
• 自定义内置工具栏或创建自定义工具栏
• 缩放和平移图像，以便进行精细编辑
• 将编辑后的图像保存到文件或流
• 序列化和反序列化编辑器状态（批注、变换）
• 实现撤销/重做功能
• 处理图像编辑事件
• 自定义图像编辑器外观

组件概览

SfImageEditor 是一款适用于 .NET MAUI 的综合图像编辑控件，提供以下功能：

核心功能：

• 从文件、流或资源加载图像
• 使用预设（正方形、圆形、16:9、4:3、3:2 等）或手绘方式裁剪图像
• 变换：旋转（90°、180°、270°、自定义角度）、翻转（水平/垂直）
• 批注：形状（圆形、矩形、箭头、直线、路径）、文本、手绘
• 图像滤镜：亮度、对比度、模糊、锐化、曝光、饱和度、色调、不透明度
• 内置工具栏，支持全面自定义
• 使用捏合手势缩放和平移
• 批注的 Z 顺序控制（置于顶层、置于底层）
• 撤销/重做操作
• 保存到文件或流（JPEG、JPG、PNG、BMP）
• 序列化/反序列化编辑器状态
• 全面的事件处理

NuGet 包： Syncfusion.Maui.ImageEditor

文档和导航指南

入门与设置

📄 阅读： references/getting-started.md

• 安装和 NuGet 包设置
• 在 MauiProgram.cs 中注册处理程序
• ImageEditor 基本实现（XAML 和 C#）
• 从不同来源加载图像
• Source 属性和图像加载

裁剪与变换

📄 阅读： references/crop-transform.md

• 使用 Crop 方法裁剪图像
• ImageCropType 选项（自由、正方形、圆形、纵横比）
• 交互式裁剪与编程式裁剪
• 旋转操作（Rotate 方法）
• 翻转操作（水平/垂直）
• 自定义角度旋转
• 变换事件

批注

📄 阅读： references/annotations.md

• 添加形状批注（圆形、矩形、箭头、直线、路径）
• AddShape 方法和 AnnotationShape 枚举
• 文本批注（AddText 方法）
• 手绘功能
• 自定义视图叠加层
• 批注设置（边界、透明度、旋转、颜色）
• 批注选择和操作
• AllowDrag、AllowResize、IsEditable 属性

滤镜与效果

📄 阅读： references/filters-effects.md

• 以编程方式应用图像滤镜
• 调整亮度和对比度
• 控制曝光、饱和度和色调
• 模糊和锐化效果
• 调整不透明度
• 组合多个效果
• 效果预览和重置

工具栏自定义

📄 阅读： references/toolbar.md

• 使用 ShowToolbar 属性控制可见性
• 内置工具栏项
• 添加自定义工具栏项
• 移除或重新排列工具栏项
• 工具栏位置和方向
• 自定义工具栏项外观
• ToolbarItemSelected 事件
• 创建完全自定义的工具栏

缩放与导航

📄 阅读： references/zooming-navigation.md

• 缩放功能（捏合缩放、程序化缩放）
• 缩放级别管理
• 平移与导航控件
• FitToScreen 功能
• 注释的 Z 顺序管理
• BringToFront 和 SendToBack 方法
• 复杂组合的图层管理

保存与序列化

📄 阅读： references/save-serialization.md

• 保存已编辑的图像（Save 方法）
• 保存到文件路径或流
• 图像格式选项（JPEG、JPG、PNG、BMP）
• 质量和压缩设置
• 序列化为 JSON（注释和状态）
• 反序列化（加载已保存的编辑器状态）
• 重置功能
• 导出场景和最佳实践

撤销与重做操作

📄 阅读： references/undo-redo.md

• Undo 和 Redo 方法
• CanUndo 和 CanRedo 属性
• 历史记录堆栈管理
• 用于撤销/重做的自定义 UI
• 历史记录限制和配置
• Undo/Redo 事件

事件与事件处理

📄 阅读： references/events.md

• ImageLoaded 事件
• ImageSaving 和 ImageSaved 事件
• ItemsSelected 事件（注释选择）
• ToolbarItemSelected 事件
• 裁剪事件
• 事件参数和访问事件数据
• 构建事件驱动型工作流

样式与自定义

📄 阅读： references/styling-customization.md

• 视觉自定义选项
• 主题支持与样式
• 液态玻璃效果
• 控件外观自定义
• 注释样式自定义
• 边框和背景属性

无障碍与本地化

📄 阅读： references/accessibility-localization.md

• 无障碍功能与支持
• 屏幕阅读器兼容性
• 键盘导航（桌面平台）
• 语义属性
• 本地化和多语言支持
• 区域格式设置
• 从右到左（RTL）布局支持