位图操作
====

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4c/v3/JpfGyct8TeWevb3O_faqHA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073521Z&HW-CC-Expire=86400&HW-CC-Sign=A9EB73A62B0CAC09C3557A8288F01AF1552FE058B6F83D7C9C392E8782607482)

当前开发指导使用的接口为[Image](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-image)模块下的C API，可完成图片编解码，图片接收器，处理图像数据等功能。这部分API在API version 11之前发布，在后续的版本不再增加新功能，**不再推荐使用**。

开发者可使用[Image\_NativeModule](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-image-nativemodule)模块下的C API，不仅提供上述图片框架基础功能，还可以完成多图编解码等新特性，相关开发指导请参考[图片开发指导(C/C++)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/image-source-c)节点下的内容。这部分API从API version 12开始支持，并将持续演进，**推荐开发者使用**。

两套C API不建议同时使用，在部分场景下存在不兼容的问题。

开发者可以通过本指导了解如何使用Native Image的接口完成位图操作。

#### 开发步骤

**添加依赖**

在进行应用开发之前，开发者需要打开native工程的src/main/cpp/CMakeLists.txt，在target\_link\_libraries依赖中添加image的libace\_napi.z.so、libpixelmap\_ndk.z.so以及日志依赖libhilog\_ndk.z.so。

target\_link\_libraries(entry PUBLIC libace\_napi.z.so libhilog\_ndk.z.so libpixelmap\_ndk.z.so)

**添加接口映射**

打开src/main/cpp/hello.cpp文件，在Init函数中添加接口映射如下：

EXTERN\_C\_START
static napi\_value Init(napi\_env env, napi\_value exports)
{
    napi\_property\_descriptor desc\[\] = {
        { "createPixelMapTest", nullptr, CreatePixelMapTest, nullptr, nullptr, nullptr, napi\_default, nullptr },
        { "createAlphaPixelMap", nullptr, CreateAlphaPixelMap, nullptr, nullptr, nullptr, napi\_default, nullptr },
        { "transform", nullptr, Transform, nullptr, nullptr, nullptr, napi\_default, nullptr },
    };

    napi\_define\_properties(env, exports, sizeof(desc) / sizeof(desc\[0\]), desc);
    return exports;
}
EXTERN\_C\_END

**Native接口调用**

具体接口说明请参考[Image](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-image)。

在hello.cpp文件中获取JS的资源对象，并转为Native的资源对象，即可调用Native接口，调用方式示例代码如下：

**添加引用文件**

#include <multimedia/image\_framework/image\_mdk\_common.h>
#include <multimedia/image\_framework/image\_pixel\_map\_mdk.h>
#include <stdlib.h>

1.  创建一个 **PixelMap** 对象。
    
    napi\_value CreatePixelMapTest(napi\_env env, napi\_callback\_info info) {
        napi\_value udfVar = nullptr;
        napi\_value pixelMap = nullptr;
    
        struct OhosPixelMapCreateOps createOps;
        createOps.width = 4;
        createOps.height = 6;
        createOps.pixelFormat = 4;
        createOps.alphaType = 0;
        size\_t bufferSize = createOps.width \* createOps.height \* 4;
        void \*buff = malloc(bufferSize);
        if (buff == nullptr) {
            return udfVar;
        }
    
        char \*cc = (char \*)buff;
        for (int i = 0; i < 96; i++) {
            \*(cc++) = (char)i;
        }
        int32\_t res = OH\_PixelMap\_CreatePixelMap(env, createOps, (uint8\_t \*)buff, bufferSize, &pixelMap);
        free(buff);
        if (res != IMAGE\_RESULT\_SUCCESS || pixelMap == nullptr) {
            return udfVar;
        }
        return pixelMap;
    }
    
2.  根据Alpha通道的信息，来生成一个仅包含Alpha通道信息的 **PixelMap** 对象。
    
    napi\_value CreateAlphaPixelMap(napi\_env env, napi\_callback\_info info) {
        napi\_value udfVar = nullptr;
        napi\_value thisVar = nullptr;
        napi\_value argValue\[1\] = {0};
        size\_t argCount = 1;
    
        napi\_value alphaPixelMap = nullptr;
    
        napi\_get\_undefined(env, &udfVar);
    
        if (napi\_get\_cb\_info(env, info, &argCount, argValue, &thisVar, nullptr) != napi\_ok || argCount < 1 ||
            argValue\[0\] == nullptr) {
            return udfVar;
        }
        int32\_t res = OH\_PixelMap\_CreateAlphaPixelMap(env, argValue\[0\], &alphaPixelMap);
        if (res != IMAGE\_RESULT\_SUCCESS || alphaPixelMap == nullptr) {
            return udfVar;
        }
        return alphaPixelMap;
    }
    
3.  对 **PixelMap** 数据进行处理。
    
    napi\_value Transform(napi\_env env, napi\_callback\_info info) {
        napi\_value thisVar = nullptr;
        napi\_value argValue\[1\] = {0};
        size\_t argCount = 1;
    
        if (napi\_get\_cb\_info(env, info, &argCount, argValue, &thisVar, nullptr) != napi\_ok || argCount < 1 ||
            argValue\[0\] == nullptr) {
            return nullptr;
        }
        napi\_value result = nullptr;
        napi\_get\_undefined(env, &result);
        
        // 初始化NativePixelMap对象。
        NativePixelMap \*native = OH\_PixelMap\_InitNativePixelMap(env, argValue\[0\]);
        if (native == nullptr) {
            return result;
        }
    
        // 获取图片信息。
        struct OhosPixelMapInfos pixelMapInfo;
        OH\_PixelMap\_GetImageInfo(native, &pixelMapInfo);
    
        // 获取PixelMap对象每行字节数。
        int32\_t rowBytes;
        OH\_PixelMap\_GetBytesNumberPerRow(native, &rowBytes);
    
        // 获取PixelMap对象是否可编辑的状态。
        int32\_t editable = 0;
        OH\_PixelMap\_GetIsEditable(native, &editable);
    
        // 获取PixelMap对象是否支持Alpha通道。
        int32\_t supportAlpha = 0;
        OH\_PixelMap\_IsSupportAlpha(native, &supportAlpha);
    
        // 设置PixelMap对象的Alpha通道。
        int32\_t alphaAble = 0;
        OH\_PixelMap\_SetAlphaAble(native, alphaAble);
    
        // 获取PixelMap对象像素密度。
        int32\_t densityG;
        OH\_PixelMap\_GetDensity(native, &densityG);
    
        // 设置PixelMap对象像素密度。
        int32\_t densityS = 100;
        OH\_PixelMap\_SetDensity(native, densityS);
    
        // 设置PixelMap对象的透明度。
        float opacity = 0.5;
        OH\_PixelMap\_SetOpacity(native, opacity);
    
        // 设置缩放比例。
        // scaleX: 宽为原来的0.5。
        // scaleY: 高为原来的0.5。
        float scaleX = 0.5;
        float scaleY = 0.5;
        OH\_PixelMap\_Scale(native, scaleX, scaleY);
    
        // 设置偏移。
        // translateX: 向下偏移50。
        // translateY: 向右偏移50。
        float translateX = 50;
        float translateY = 50;
        OH\_PixelMap\_Translate(native, translateX, translateY);
    
        // 设置顺时针旋转90度。
        float angle = 90;
        OH\_PixelMap\_Rotate(native, angle);
    
        // 设置翻转
        // flipX: 水平翻转，0为不翻转，1为翻转。
        // flipY: 垂直翻转，0为不翻转，1为翻转。
        int32\_t flipX = 0;
        int32\_t flipY = 1;
        OH\_PixelMap\_Flip(native, flipX, flipY);
    
        // 设置裁剪区域。
        // cropX: 裁剪起始点横坐标。
        // cropY: 裁剪起始点纵坐标。
        // cropH: 裁剪高度10，方向为从上往下（裁剪后的图片高度为10）。
        // cropW: 裁剪宽度10，方向为从左到右（裁剪后的图片宽度为10）。
        int32\_t cropX = 1;
        int32\_t cropY = 1;
        int32\_t cropW = 10;
        int32\_t cropH = 10;
        OH\_PixelMap\_Crop(native, cropX, cropY, cropW, cropH);
    
        // 获取PixelMap对象数据的内存地址，并锁定该内存。
        void \*pixelAddr = nullptr;
        OH\_PixelMap\_AccessPixels(native, &pixelAddr);
    
        // 释放PixelMap对象数据的内存锁。
        OH\_PixelMap\_UnAccessPixels(native);
    
        return result;
    }
    

**JS侧调用**

1.  打开src\\main\\cpp\\types\\libentry\\index.d.ts（其中libentry根据工程名生成），导入如下引用文件：
    
    import { image } from '@kit.ImageKit';
    
    export const createPixelMapTest: () => image.PixelMap;
    export const transform: (a: image.PixelMap) => void;
    
2.  打开src\\main\\ets\\pages\\index.ets, 导入"libentry.so"(根据工程名生成)，调用Native接口，传入JS的资源对象。示例如下：
    
    import testNapi from 'libentry.so';
    import { image } from '@kit.ImageKit';
    
    @Entry
    @Component
    struct Index {
    @State \_pixelMap : image.PixelMap | undefined = undefined;
    
    build() {
        Row() {
            Column() {
                Button("PixelMap")
                .width(100)
                .height(100)
                .onClick(() => {
                    console.info("com.example.native\_ndk\_api10 button click in");
                    this.\_pixelMap = testNapi.createPixelMapTest();
                    testNapi.transform(this.\_pixelMap);
                })
                Image(this.\_pixelMap)
                .width(500)
                .height(500)
                .objectFit(ImageFit.Cover)
                .border({width: 1, color: Color.Blue})
                }
                .width('100%')
            }
            .height('100%')
        }
    }