• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# PixelMap数据处理(Native)
2
3开发者可以通过本指导了解如何使用Native Image的接口。
4
5## 开发步骤
6
7**添加依赖**
8
9在进行应用开发之前，开发者需要打开native工程的src/main/cpp/CMakeLists.txt，在target_link_libraries依赖中添加image的libpixelmap_ndk.z.so以及日志依赖libhilog_ndk.z.so。
10
11```txt
12target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so libpixelmap_ndk.z.so)
13```
14
15**添加接口映射**
16
17打开src/main/cpp/hello.cpp文件，在Init函数中添加接口映射如下：
18
19```c++
20EXTERN_C_START
21static napi_value Init(napi_env env, napi_value exports)
22{
23    napi_property_descriptor desc[] = {
24        { "createPixelMapTest", nullptr, CreatePixelMapTest, nullptr, nullptr, nullptr, napi_default, nullptr },
25        { "createAlphaPixelMap", nullptr, CreateAlphaPixelMap, nullptr, nullptr, nullptr, napi_default, nullptr },
26        { "transform", nullptr, Transform, nullptr, nullptr, nullptr, napi_default, nullptr },
27    };
28
29    napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
30    return exports;
31}
32EXTERN_C_END
33```
34
35
36**Native接口调用**
37
38具体接口说明请参考[API文档](../reference/native-apis/image.md)
39
40在hello.cpp文件中获取JS的资源对象，并转为Native的资源对象，即可调用Native接口，调用方式示例代码如下：
41
42**添加引用文件**
43
44    #include <multimedia/image_framework/image_mdk_common.h>
45    #include <multimedia/image_framework/image_pixel_map_mdk.h>
46    #include <stdlib.h>
47
481. 创建一个 **PixelMap** 对象。
49    ```c++
50    napi_value CreatePixelMapTest(napi_env env, napi_callback_info info) {
51        napi_value udfVar = nullptr;
52        napi_value pixelMap = nullptr;
53
54        struct OhosPixelMapCreateOps createOps;
55        createOps.width = 4;
56        createOps.height = 6;
57        createOps.pixelFormat = 4;
58        createOps.alphaType = 0;
59        size_t bufferSize = createOps.width * createOps.height * 4;
60        void *buff = malloc(bufferSize);
61
62        char *cc = (char *)buff;
63        for (int i = 0; i < 96; i++) {
64            *(cc++) = (char)i;
65        }
66        int32_t res = OH_PixelMap_CreatePixelMap(env, createOps, (uint8_t *)buff, bufferSize, &pixelMap);
67        if (res != IMAGE_RESULT_SUCCESS || pixelMap == nullptr) {
68            return udfVar;
69        }
70        return pixelMap;
71    }
72    ```
732. 根据Alpha通道的信息，来生成一个仅包含Alpha通道信息的 **PixelMap** 对象。
74    ```c++
75    napi_value CreateAlphaPixelMap(napi_env env, napi_callback_info info) {
76        napi_value udfVar = nullptr;
77        napi_value thisVar = nullptr;
78        napi_value argValue[1] = {0};
79        size_t argCount = 1;
80
81        napi_value alphaPixelMap = nullptr;
82
83        napi_get_undefined(env, &udfVar);
84
85        if (napi_get_cb_info(env, info, &argCount, argValue, &thisVar, nullptr) != napi_ok || argCount < 1 ||
86            argValue[0] == nullptr) {
87            return udfVar;
88        }
89        int32_t res = OH_PixelMap_CreateAlphaPixelMap(env, argValue[0], &alphaPixelMap);
90        if (res != IMAGE_RESULT_SUCCESS || alphaPixelMap == nullptr) {
91            return udfVar;
92        }
93        return alphaPixelMap;
94    }
95    ```
963. 对 **PixelMap** 数据进行处理。
97    ```c++
98    napi_value Transform(napi_env env, napi_callback_info info) {
99        napi_value thisVar = nullptr;
100        napi_value argValue[1] = {0};
101        size_t argCount = 1;
102
103        if (napi_get_cb_info(env, info, &argCount, argValue, &thisVar, nullptr) != napi_ok || argCount < 1 ||
104            argValue[0] == nullptr) {
105            return nullptr;
106        }
107        napi_value result = nullptr;
108        napi_get_undefined(env, &result);
109
110        // 初始化PixelMap对象数据。
111        NativePixelMap *native = OH_PixelMap_InitNativePixelMap(env, argValue[0]);
112        if (native == nullptr) {
113            return result;
114        }
115
116        // 获取图片信息。
117        struct OhosPixelMapInfos pixelMapInfo;
118        OH_PixelMap_GetImageInfo(native, &pixelMapInfo);
119
120        // 获取PixelMap对象每行字节数。
121        int32_t rowBytes;
122        OH_PixelMap_GetBytesNumberPerRow(native, &rowBytes);
123
124        // 获取PixelMap对象是否可编辑的状态。
125        int32_t editable = 0;
126        OH_PixelMap_GetIsEditable(native, &editable);
127
128        // 获取PixelMap对象是否支持Alpha通道。
129        int32_t supportAlpha = 0;
130        OH_PixelMap_IsSupportAlpha(native, &supportAlpha);
131
132        // 设置PixelMap对象的Alpha通道。
133        int32_t alphaAble = 0;
134        OH_PixelMap_SetAlphaAble(native, alphaAble);
135
136        // 获取PixelMap对象像素密度。
137        int32_t densityG;
138        OH_PixelMap_GetDensity(native, &densityG);
139
140        // 设置PixelMap对象像素密度。
141        int32_t densityS = 100;
142        OH_PixelMap_SetDensity(native, densityS);
143
144        // 设置PixelMap对象的透明度。
145        float opacity = 0.5;
146        OH_PixelMap_SetOpacity(native, opacity);
147
148        // 设置缩放比例。
149        // scaleX: 宽为原来的0.5。
150        // scaleY: 高为原来的0.5。
151        float scaleX = 0.5;
152        float scaleY = 0.5;
153        OH_PixelMap_Scale(native, scaleX, scaleY);
154
155        // 设置偏移。
156        // translateX: 向下偏移50。
157        // translateY: 向右偏移50。
158        float translateX = 50;
159        float translateY = 50;
160        OH_PixelMap_Translate(native, translateX, translateY);
161
162        // 设置顺时针旋转90度。
163        float angle = 90;
164        OH_PixelMap_Rotate(native, angle);
165
166        // 设置翻转
167        // flipX: 水平翻转，0为不翻转，1为翻转。
168        // flipY: 垂直翻转，0为不翻转，1为翻转。
169        int32_t flipX = 0;
170        int32_t flipY = 1;
171        OH_PixelMap_Flip(native, flipX, flipY);
172
173        // 设置裁剪区域。
174        // cropX: 裁剪起始点横坐标。
175        // cropY: 裁剪起始点纵坐标。
176        // cropH: 裁剪高度10，方向为从上往下（裁剪后的图片高度为10）。
177        // cropW: 裁剪宽度10，方向为从左到右（裁剪后的图片宽度为10）。
178        int32_t cropX = 1;
179        int32_t cropY = 1;
180        int32_t cropW = 10;
181        int32_t cropH = 10;
182        OH_PixelMap_Crop(native, cropX, cropY, cropW, cropH);
183
184        // 获取PixelMap对象数据的内存地址，并锁定该内存。
185        void *pixelAddr = nullptr;
186        OH_PixelMap_AccessPixels(native, &pixelAddr);
187
188        // 释放PixelMap对象数据的内存锁。
189        OH_PixelMap_UnAccessPixels(native);
190
191        return result;
192    }
193    ```
194
195
196**JS侧调用**
197
1981. 打开src\main\cpp\types\libentry\index.d.ts（其中libentry根据工程名生成），导入如下引用文件:
199
200    ```js
201    import image from '@ohos.multimedia.image'
202
203    export const createPixelMapTest: () => image.PixelMap;
204    export const transform: (a: image.PixelMap) => image.PixelMap;
205    ```
206
2072. 打开src\main\ets\pages\index.ets, 导入"libentry.so"(根据工程名生成)；调用Native接口，传入JS的资源对象。示例如下:
208
209    ```js
210    import testNapi from 'libentry.so'
211    import image from '@ohos.multimedia.image'
212
213    @Entry
214    @Component
215    struct Index {
216    @State _pixelMap: image.PixelMap = undefined;
217
218    build() {
219        Row() {
220            Column() {
221                Button("PixelMap")
222                .width(100)
223                .height(100)
224                .onClick(() => {
225                    console.log("com.example.native_ndk_api10 button click in");
226                    this._pixelMap = testNapi.createPixelMapTest();
227                    testNapi.transform(this._pixelMap);
228                })
229                Image(this._pixelMap)
230                .width(500)
231                .height(500)
232                .objectFit(ImageFit.Cover)
233                .border({width: 1, color: Color.Blue})
234                }
235                .width('100%')
236            }
237            .height('100%')
238        }
239    }
240    ```
241