1# 图片编辑 2 3### 介绍 4 5本示例使用 [TextArea](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textarea.md) 6实现多文本输入，使用 [@ohos.app.ability.common](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-common.md) 7依赖系统的图库引用，实现在相册中获取图片，使用 [@ohos.multimedia.image](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-image-kit/js-apis-image.md) 8生成pixelMap，使用pixelMap的scale()，crop()，rotate()接口实现对图片的缩放，裁剪，旋转功能。 9使用[@ohos.effectKit](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-arkgraphics2d/js-apis-effectKit.md) 10生成effectKit,使用effectKit.getHighestSaturationColor() 11接口实现对图片的高亮调节。添加文字/贴纸，利用组件的组合编辑素材大小和位置，再使用OffscreenCanvasRenderingContext2D进行离屏绘制保存。 12接口实现对图片编解码功能。可以通过uri\fd\data\rawFile将图片资源解码为ImageSource或pixelMap。可通过ImageSource/pixelMap编码为file/data。 13 14### 效果预览 15 16| 编辑删除 | 图片调整 | 图片标记 | 17|-------------------------------------------------|-----------------------------------------------------|-------------------------------------------------| 18|  |  |  | 19 20| 图片裁剪 | 图片缩放 | 图片旋转 | 21|-------------------------------------------------|---------------------------------------------------|-----------------------------------------------------| 22|  |  |  | 23 24| 图片亮度调节 | 图片添加贴纸 | 图片添加文字 | 图片色域调节 | 修改hdr设置 | 25|-----------------------------------------------------|-------------------------------------------------------|-------------------------------------------------|-------------------------------------------------------------|-------------------------------------------------------| 26|  |  |  |  |  | 27 28 29使用说明： 30 311. 发表评价页面点击添加图片/照片，页面跳转到图片选择页面； 322. 进入图片选择页面后，选择需要显示的图片； 333. 选中图片后，页面会跳转到发表评价页面，点击图片跳转到图片编辑删除页面，点击编辑进入到编辑功能页； 344. 调整菜单有裁剪、缩放、旋转、调色、修改hdr设置功能(因为有些机型设备不支持，所以HDR解码后显示效果看不出来)； 355. 标记菜单有添加文字、添加贴纸功能； 366. 编辑完成后，点击撤回按钮图片会还原到上一个编辑状态； 377. 图片编辑完成后，点击保存，页面会跳转到发表评价页面，显示相关照片； 388. 点击返回按钮，退出应用。 39 40### 工程目录 41 42``` 43entry/src/main/ets/ 44|---pages 45| |---EditImages.ets // 图片编辑 46| |---GetPictrues.ets // 图片选择 47| |---Index.ets // 首页 48| |---UpadatePages.ets // 编辑删除界面 49photomodify/src/main/ets/components 50|---featrue 51| |---ComputeFeature.ets // 计算功能 52| |---PixelMapQueue.ets // PixelMap队列 53|---model 54| |---AdjustData.ets // 功能数据 55| |---AdjustModels.ets // 功能模型 56| |---MaterialData.ets // 素材数据 57| |---MaterialModels.ets // 素材模型 58|---pages 59| |---EditImage.ets // 图片编辑 60| |---InputTextDialog.ets // 输入框弹窗 61| |---MaterialEdit.ets // 素材编辑组件 62| |---ScalePhotoPage.ets // 图片缩放 63| |---ColorSpacePage.ets // 色域修改 64| |---UpdatePage.ets // 编辑删除界面 65|---util 66| |---CoordinatesUtil.ets // 转换坐标系 67| |---CopyObj.ets // 对象克隆 68| |---ImageUtil.ets // 图片宽高处理 69| |---Logger.ets // 日志工具 70| |---MediaUtil.ts // 媒体帮助类 71| |---SvgUtil.ts // svg操作帮助类 72| |---FileUtil.ets // 图片编解码操作帮助类 73``` 74 75### 具体实现 76 77+ 图片选择功能在GetPictures中实现，源码参考[GetPictures.ets](entry%2Fsrc%2Fmain%2Fets%2Fpages%2FGetPictures.ets): 78 + 图片选择：首先使用startAbilityForResult()启动系统图库应用，然后将选择的图片用select数组保存路径，展示到页面便于选择，选择完跳转到首页，点击一张图片，进入到编辑删除界面。 79+ 图片编辑功能在EditImage中实现，源码参考[EditImage.ets](photomodify%2Fsrc%2Fmain%2Fets%2Fcomponents%2Fpages%2FEditImage.ets): 80 + 图片编辑：图片编辑权限需要使用[requestPermissionsFromUser](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-ability-kit/js-apis-abilityAccessCtrl.md#requestpermissionsfromuser9) 81 申请，源码参考[MainAbility.ts](entry/src/main/ets/MainAbility/MainAbility.ts) 82 ，首先根据选择图片获取到的uri打开图片文件，fileAsset.open选择‘rw'读写模式，然后使用image.createImageSource创建图片源实例，接下来使用createPixelMap创建PixelMap对象，便于处理图片，最后使用crop对图像进行裁剪处理，使用scale对图像进行缩放处理，rotate进行旋转处理。亮度调节使用effectKit.getHighestSaturationColor() 83 接口实现对图片的高亮调节。图片解码通过createPixelMap(DecodingOptions)，并根据DecodingOptions构造参数里面的设定值(0: auto;1: SDR;2 HDR)，对应创建不同的PixelMap对象。其中设置值为AUTO时，会根据图片本身结构来判断是否解码为HDR内容。添加文字/贴纸，编辑模式下，使用组件组合（Image、Shape、Text）进行交互完成素材大小和位置选择；编辑确认后，再使用OffscreenCanvasRenderingContext2D进行离屏绘制，保存为新的pixelMap。 84+ 图片编解码功能在Image中实现，源码参考[Image.cpp](photomodify/src/main/cpp/Image.cpp): 85 + 图片解码：调用OH_ImageSourceNative_CreateFromUri，OH_ImageSourceNative_CreateFromFd， 86 OH_ImageSourceNative_CreateFromData，OH_ImageSourceNative_CreateFromRawFile等接口，根据接收不同的参数调用不同的接口来创建ImageSource对象。 87 再通过OH_ImageSourceNative_CreatePixelmap接口将ImageSource转换为新的pixelMap。 88 + 图片编码：通过调用OH_ImagePackerNative_PackToFileFromPixelmap，OH_ImagePackerNative_PackToFileFromImageSource， 89 OH_ImagePackerNative_PackToDataFromPixelmap，OH_ImagePackerNative_PackToDataFromImageSource等接口，可以将ImageSource或pixelMap编码为file/data。 90 91### 相关权限 92 93[ohos.permission.READ_MEDIA](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionread_media) 94 95[ohos.permission.WRITE_MEDIA](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionwrite_media) 96 97[ohos.permission.MEDIA_LOCATION](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionmedia_location) 98 99### 依赖 100 101不涉及。 102 103### 约束与限制 104 1051. 本示例仅支持标准系统上运行，支持设备：RK3568; 1062. 本示例为Stage模型，已适配API version 12版本SDK，SDK版本号(API Version 12 5.0.0.26),镜像版本号(5.0.0.26); 1073. 本示例需要使用DevEco Studio 版本号(4.1.3.500)及以上版本才可编译运行。 108 109### 下载 110 111如需单独下载本工程，执行如下命令： 112 113``` 114git init 115git config core.sparsecheckout true 116echo code/BasicFeature/Media/Image/ > .git/info/sparse-checkout 117git remote add origin https://gitee.com/openharmony/applications_app_samples.git 118git pull origin master 119``` 120
