# PixelMapImageEditTest

**Repository Path**: LYGiteeSpace/pixel-map-image-edit-test

## Basic Information

- **Project Name**: PixelMapImageEditTest
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-09
- **Last Updated**: 2025-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于图片编解码实现图片编辑功能

基于图片编解码，实现原图信息查看与图片编辑，包含裁剪、旋转、色域调节（本章介绍亮度、镜像、透明度、饱和度）等功能。



| <img src="./screenshots/zh1_converted.png" width="320"/> | <img src="./screenshots/zh2_converted.png" width="320"/> | <img src="./screenshots/zh3_converted.png" width="320"/> |
|----------------------------------------------------------|----------------------------------------------------------|----------------------------------------------------------|
| <img src="./screenshots/zh4_converted.png" width="320"/> | <img src="./screenshots/zh5_converted.png" width="320"/> | <img src="./screenshots/zh6_converted.png" width="320"/> |

### 相关概念

- 图片解码：图片解码指将所支持格式的存档图片解码成统一的PixelMap，以便在应用或系统中进行图片显示或图片处理。
- PixelMap：图像像素类，用于读取或写入图像数据以及获取图像信息。
- 图片编码：图片编码指将PixelMap编码成不同格式的存档图片（当前仅支持打包为JPEG、WebP和png格式），用于后续处理，如保存、传输等。

### 功能特性

- **原图信息**：查看解码原图数据
- **基础编辑**：裁剪、旋转、镜像
- **图像调节**：亮度、透明度、饱和度调节
- **图像变换**：平移、缩放
- **滤镜效果**：灰度、模糊、高亮等多种滤镜
- **实时预览**：所有编辑操作支持实时预览
- **保存功能**：支持保存编辑后的图片

### 工程目录

```
├──ets
│  ├──common
│  │  └──constant
│  │     └──constant
│  │        └──CommonConstants.ts   // 常量
│  ├──entryability
│  │  └──EntryAbility.ets
│  ├──pages
│  │  └──PictureEdit.ets            // 编辑
│  ├──utils
│  │  ├──AdjustUtil.ets             // 调节utils
│  │  ├──CropUtil.ets               // 裁剪utils
│  │  ├──DecodeUtil.ets             // 解码utils
│  │  ├──EncodeUtil.ets             // 编码utils
│  │  ├──LoggerUtil.ets             // 
│  │  └──OpacityUtil.ets            // 透明utils
│  ├──view
│  │  ├──AdjustContentView.ets      //  调节组件
│  │  └──ApplyFilterView.ets        //  滤镜组件
│  ├──viewModel           
│  │  ├──IconListViewModel.ets      // icon Model
│  │  ├──MessageItem.ets            // 
│  │  ├──OptionViewModel.ets        // 操作枚举
│  │  └──RegionItem.ets             //
│  └──viewModel
│     ├──AdjustBrightnessWork.ets   // 工作线程
│     └──AdjustSaturationWork.ets   // 工作线程         
└──resources
```

### 相关权限

- 允许读取用户公共目录的图片或视频文件：ohos.permission.WRITE_IMAGEVIDEO
- 允许应用读写用户外部存储中的媒体文件信息：ohos.permission.WRITE_MEDIA

### 使用说明

1. 点击顶部信息按钮，查看原图信息。
2. 使用底部标签页切换不同的编辑功能：
    - **裁剪**：支持多种比例裁剪
    - **调节**：调整图片亮度、透明度、饱和度
    - **滤镜**：应用各种滤镜效果
    - **平移**：水平和垂直移动图片
    - **缩放**：放大或缩小图片
3. 实时预览编辑效果。
4. 点击保存按钮保存编辑后的图片。

### 约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机。
2. HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。
3. DevEco Studio版本：DevEco Studio 5.0.5 Release及以上。
4. HarmonyOS SDK版本：HarmonyOS 5.0.5 Release SDK及以上。