1# image_pixel_map_napi.h
2
3
4## Overview
5
6The **image_pixel_map_napi.h** file declares the APIs used to lock, access, and unlock a PixelMap.
7
8**Library**: libpixelmap_ndk.z.so
9
10**File to include**: <multimedia/image_framework/image_pixel_map_napi.h>
11
12**Since**: 8
13
14**Deprecated from**: 10
15
16**Substitute**: [image_pixel_map_mdk.h](image__pixel__map__mdk_8h.md)
17
18**Related module**: [Image](image.md)
19
20
21## Summary
22
23
24### Structs
25
26| Name| Description|
27| -------- | -------- |
28| struct  [OhosPixelMapInfo](_o_h_o_s_1_1_media_1_1_ohos_pixel_map_info.md) | Describes the information about a PixelMap. |
29
30
31### Enums
32
33| Name| Description|
34| -------- | -------- |
35| { [OHOS_IMAGE_RESULT_SUCCESS](image.md#error-codes-returned-by-functions) = 0,<br>[OHOS_IMAGE_RESULT_BAD_PARAMETER](image.md#error-codes-returned-by-functions) = -1 } | Enumerates the error codes returned by the functions.|
36| { [OHOS_PIXEL_MAP_FORMAT_NONE](image.md#pixel-formats) = 0,<br>[OHOS_PIXEL_MAP_FORMAT_RGBA_8888](image.md#pixel-formats) = 3,<br>[OHOS_PIXEL_MAP_FORMAT_RGB_565](image.md#pixel-formats) = 2 } | Enumerates the PixelMap formats.|
37| { [OHOS_PIXEL_MAP_SCALE_MODE_FIT_TARGET_SIZE](image.md#anonymous-enum) = 0,<br>[OHOS_PIXEL_MAP_SCALE_MODE_CENTER_CROP](image.md#anonymous-enum) = 1 } | Enumerates the PixelMap scale modes.|
38
39
40### Functions
41
42| Name| Description|
43| -------- | -------- |
44| int32_t [OH_GetImageInfo](image.md#oh_getimageinfo) (napi_env env, napi_value value, [OhosPixelMapInfo](_o_h_o_s_1_1_media_1_1_ohos_pixel_map_info.md) \*info) | Obtains the information about a **PixelMap** object and stores the information to the [OhosPixelMapInfo](_o_h_o_s_1_1_media_1_1_ohos_pixel_map_info.md) struct. |
45| int32_t [OH_AccessPixels](image.md#oh_accesspixels) (napi_env env, napi_value value, void \*\*addrPtr) | Obtains the memory address of a **PixelMap** object and locks the memory. |
46| int32_t [OH_UnAccessPixels](image.md#oh_unaccesspixels) (napi_env env, napi_value value) | Unlocks the memory of a **PixelMap** object. This function is used with **OH_AccessPixels** in pairs. |
47