• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 图片绘制（C/C++）
2
3
4位图是一种用于在内存中存储和表示图像的数据结构，它是一个未经过压缩的像素集合，而JPEG或PNG等格式的图片是压缩格式的，两者并不相同。如果需要将JPEG或PNG绘制到屏幕上，需要先解码成位图格式，具体可参考[图片处理服务（Image Kit）](../media/image/image-overview.md)图片解码相关章节。
5
6
7目前Drawing（C/C++）中位图绘制需要依赖PixelMap，它可以用于读取或写入图像数据以及获取图像信息。详细的API介绍请参考[drawing_pixel_map.h](../reference/apis-arkgraphics2d/drawing__pixel__map_8h.md)。
8
9
10有多个API接口可以创建PixelMap，下文以使用OH_Drawing_PixelMapGetFromOhPixelMapNative()为例。
11
12
131. 添加链接库。
14
15   在Native工程的src/main/cpp/CMakeLists.txt，添加如下链接库：
16
17   ```c++
18   target_link_libraries(entry PUBLIC libhilog_ndk.z.so libpixelmap.so)
19   ```
20
212. 创建OH_PixelmapNative像素图对象。
22
23   PixelMap需要从图像框架定义的像素图对象（OH_PixelmapNative）中获取，所以需要先通过OH_PixelmapNative_CreatePixelmap()创建OH_PixelmapNative。该函数接受4个参数，第一个参数为图像像素数据的缓冲区，用于初始化PixelMap的像素。第二个参数是缓冲区长度。第三个参数是位图格式（包括长、宽、颜色类型、透明度类型等）。第四个参数即OH_PixelmapNative对象，作为出参使用。
24
25   ```c++
26   // 图片宽高
27   uint32_t width = 600;
28   uint32_t height = 400;
29   // 字节长度，RGBA_8888每个像素占4字节
30   size_t bufferSize = width * height * 4;
31   uint8_t *pixels = new uint8_t[bufferSize];
32   for (uint32_t i = 0; i < width*height; ++i) {
33       // 遍历并编辑每个像素，从而形成红绿蓝相间的条纹
34       uint32_t n = i / 20 % 3;
35       pixels[i*4] = 0x00;
36       pixels[i*4+1] = 0x00;
37       pixels[i*4+2] = 0x00;
38       pixels[i*4+3] = 0xFF;
39       if (n == 0) {
40           pixels[i*4] = 0xFF;
41       } else if (n == 1) {
42           pixels[i*4+1] = 0xFF;
43       } else {
44           pixels[i*4+2] = 0xFF;
45       }
46   }
47   // 设置位图格式（长、宽、颜色类型、透明度类型）
48   OH_Pixelmap_InitializationOptions *createOps = nullptr;
49   OH_PixelmapInitializationOptions_Create(&createOps);
50   OH_PixelmapInitializationOptions_SetWidth(createOps, width);
51   OH_PixelmapInitializationOptions_SetHeight(createOps, height);
52   OH_PixelmapInitializationOptions_SetPixelFormat(createOps, PIXEL_FORMAT_RGBA_8888);
53   OH_PixelmapInitializationOptions_SetAlphaType(createOps, PIXELMAP_ALPHA_TYPE_UNKNOWN);
54   // 创建OH_PixelmapNative对象
55   OH_PixelmapNative *pixelMapNative = nullptr;
56   OH_PixelmapNative_CreatePixelmap(pixels, bufferSize, createOps, &pixelMapNative);
57   ```
58
593. 创建PixelMap。
60
61   通过OH_Drawing_PixelMapGetFromOhPixelMapNative()函数从OH_PixelmapNative中获取PixelMap。
62
63   ```c++
64   OH_Drawing_PixelMap *pixelMap = OH_Drawing_PixelMapGetFromOhPixelMapNative(pixelMapNative);
65   ```
66
674. 绘制PixelMap。
68
69   需要通过OH_Drawing_CanvasDrawPixelMapRect()绘制位图PixelMap。函数接受5个参数，分别为画布Canvas、PixelMap对象、PixelMap中像素的截取区域、画布中显示的区域以及采样选项对象。
70
71   其中采样选项对象（OH_Drawing_SamplingOptions）表示了从原始像素数据（即Bitmap）中采样以生成新的像素值的具体方式，具体可见[drawing_sampling_options.h](../reference/apis-arkgraphics2d/drawing__sampling__options_8h.md)。
72
73   ```c++
74   // PixelMap中像素的截取区域
75   OH_Drawing_Rect *src = OH_Drawing_RectCreate(0, 0, 600, 400);
76   // 画布中显示的区域
77   OH_Drawing_Rect *dst = OH_Drawing_RectCreate(200, 200, 800, 600);
78   // 采样选项对象
79   OH_Drawing_SamplingOptions* samplingOptions = OH_Drawing_SamplingOptionsCreate(
80       OH_Drawing_FilterMode::FILTER_MODE_LINEAR, OH_Drawing_MipmapMode::MIPMAP_MODE_LINEAR);
81   // 绘制PixelMap
82   OH_Drawing_CanvasDrawPixelMapRect(canvas, pixelMap, src, dst, samplingOptions);
83   ```
84
855. 绘制完成后释放相关对象。
86
87   ```c++
88   OH_PixelmapNative_Release(pixelMapNative);
89   delete[] pixels;
90   ```
91
92   绘制效果如下：
93
94   ![Screenshot_20241225200426678](figures/Screenshot_20241225200426678.jpg)
95
96<!--RP1-->
97## 相关实例
98
99针对Drawing(C/C++)的开发，有以下相关实例可供参考：
100
101- [NDKGraphicsDraw (API14)](https://gitee.com/openharmony/applications_app_samples/tree/master/code/DocsSample/Drawing/NDKGraphicsDraw)
102<!--RP1End-->