HarmonyOS API:头文件
版本:v3.1 Beta
drawing_types.h
更新时间: 2023-02-17 09:19
概述
文件中定义了用于绘制2d图形的数据类型,包括画布、画笔、画刷、位图和路径。
起始版本:
8
相关模块:
汇总
类型定义
类型定义名称 | 描述 |
OH_Drawing_Canvas定义为一块矩形的画布,可以结合画笔和画刷在上面绘制各种形状、图片和文字 | |
OH_Drawing_Pen定义为画笔,画笔用于描述绘制图形轮廓的样式和颜色 | |
OH_Drawing_Brush定义为画刷,画刷用于描述填充图形的样式和颜色 | |
OH_Drawing_Path定义为路径,路径用于自定义各种形状 | |
OH_Drawing_Bitmap定义为位图,位图是一块内存,内存中包含了描述一张图片的像素数据 |
枚举
枚举名称 | 描述 |
OH_Drawing_ColorFormat { COLOR_FORMAT_UNKNOWN, COLOR_FORMAT_ALPHA_8, COLOR_FORMAT_RGB_565, COLOR_FORMAT_ARGB_4444, COLOR_FORMAT_RGBA_8888, COLOR_FORMAT_BGRA_8888 } | OH_Drawing_ColorFormat用于描述位图像素的存储格式 |
OH_Drawing_AlphaFormat { ALPHA_FORMAT_UNKNOWN, ALPHA_FORMAT_OPAQUE, ALPHA_FORMAT_PREMUL, ALPHA_FORMAT_UNPREMUL } | OH_Drawing_AlphaFormat用于描述位图像素的透明度分量 |
external_window.h
更新时间: 2023-02-17 09:19
概述
定义获取和使用NativeWindow的相关函数。
起始版本:
8
相关模块:
汇总
结构体
结构体名称 | 描述 |
Region | 表示本地窗口NativeWindow需要更新内容的矩形区域(脏区)。 |
矩形区域。 | |
HDR元数据结构体定义 。 | |
扩展数据句柄结构体定义 。 |
类型定义
类型定义名称 | 描述 |
OHNativeWindow | 提供对NativeWindow的访问功能 |
OHNativeWindowBuffer | 提供对NativeWindowBuffer的访问功能 |
Region | 表示本地窗口NativeWindow需要更新内容的矩形区域(脏区) |
枚举
枚举名称 | 描述 |
NativeWindowOperation { SET_BUFFER_GEOMETRY, GET_BUFFER_GEOMETRY, GET_FORMAT, SET_FORMAT, GET_USAGE, SET_USAGE, SET_STRIDE, GET_STRIDE, SET_SWAP_INTERVAL, GET_SWAP_INTERVAL, SET_TIMEOUT, GET_TIMEOUT, SET_COLOR_GAMUT, GET_COLOR_GAMUT, SET_TRANSFORM, GET_TRANSFORM, SET_UI_TIMESTAMP } | OH_NativeWindow_NativeWindowHandleOpt函数中的操作码 |
OHScalingMode { OH_SCALING_MODE_FREEZE = 0, OH_SCALING_MODE_SCALE_TO_WINDOW, OH_SCALING_MODE_SCALE_CROP, OH_SCALING_MODE_NO_SCALE_CROP } | 缩放模式 Scaling Mode |
OHHDRMetadataKey { OH_METAKEY_RED_PRIMARY_X = 0, OH_METAKEY_RED_PRIMARY_Y = 1, OH_METAKEY_GREEN_PRIMARY_X = 2, OH_METAKEY_GREEN_PRIMARY_Y = 3, OH_METAKEY_BLUE_PRIMARY_X = 4, OH_METAKEY_BLUE_PRIMARY_Y = 5, OH_METAKEY_WHITE_PRIMARY_X = 6, OH_METAKEY_WHITE_PRIMARY_Y = 7, OH_METAKEY_MAX_LUMINANCE = 8, OH_METAKEY_MIN_LUMINANCE = 9, OH_METAKEY_MAX_CONTENT_LIGHT_LEVEL = 10, OH_METAKEY_MAX_FRAME_AVERAGE_LIGHT_LEVEL = 11, OH_METAKEY_HDR10_PLUS = 12, OH_METAKEY_HDR_VIVID = 13 } | 枚举HDR元数据关键字 |
函数
函数名称 | 描述 |
OH_NativeWindow_CreateNativeWindow (void *pSurface) | 创建NativeWindow实例,每次调用都会产生一个新的NativeWindow实例 |
OH_NativeWindow_DestroyNativeWindow (OHNativeWindow *window) | 将NativeWindow对象的引用计数减1,当引用计数为0的时候,该NativeWindow对象会被析构掉 |
OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer (void *pSurfaceBuffer) | 创建NativeWindowBuffer实例,每次调用都会产生一个新的NativeWindowBuffer实例 |
OH_NativeWindow_DestroyNativeWindowBuffer (OHNativeWindowBuffer *buffer) | 将NativeWindowBuffer对象的引用计数减1,当引用计数为0的时候,该NativeWindowBuffer对象会被析构掉 |
OH_NativeWindow_NativeWindowRequestBuffer (OHNativeWindow *window, OHNativeWindowBuffer **buffer, int *fenceFd) | 通过NativeWindow对象申请一块NativeWindowBuffer,用以内容生产 |
OH_NativeWindow_NativeWindowFlushBuffer (OHNativeWindow *window, OHNativeWindowBuffer *buffer, int fenceFd, Region region) | 通过NativeWindow将生产好内容的NativeWindowBuffer放回到Buffer队列中,用以内容消费 |
OH_NativeWindow_NativeWindowAbortBuffer (OHNativeWindow *window, OHNativeWindowBuffer *buffer) | 通过NativeWindow将之前申请出来的NativeWindowBuffer返还到Buffer队列中,供下次再申请 |
OH_NativeWindow_NativeWindowHandleOpt (OHNativeWindow *window, int code,...) | 设置/获取NativeWindow的属性,包括设置/获取宽高、内容格式等 |
OH_NativeWindow_GetBufferHandleFromNative (OHNativeWindowBuffer *buffer) | 通过NativeWindowBuffer获取该buffer的BufferHandle指针 |
OH_NativeWindow_NativeObjectReference (void *obj) | 增加一个NativeObject的引用计数 |
OH_NativeWindow_NativeObjectUnreference (void *obj) | 减少一个NativeObject的引用计数,当引用计数减少为0时,该NativeObject将被析构掉 |
OH_NativeWindow_GetNativeObjectMagic (void *obj) | 获取NativeObject的MagicId |
OH_NativeWindow_NativeWindowSetScalingMode (OHNativeWindow *window, uint32_t sequence, OHScalingMode scalingMode) | 设置NativeWindow的ScalingMode |
OH_NativeWindow_NativeWindowSetMetaData (OHNativeWindow *window, uint32_t sequence, int32_t size, const OHHDRMetaData *metaData) | 设置NativeWindow的元数据 |
OH_NativeWindow_NativeWindowSetMetaDataSet (OHNativeWindow *window, uint32_t sequence, OHHDRMetadataKey key, int32_t size, const uint8_t *metaData) | 设置NativeWindow的元数据集。 |
OH_NativeWindow_NativeWindowSetTunnelHandle (OHNativeWindow *window, const OHExtDataHandle *handle) | 设置NativeWindow的TunnelHandle。 |
image_pixel_map_napi.h
更新时间: 2023-02-17 09:19
概述
声明可以锁定并访问pixelmap数据的方法,声明解锁的方法。
起始版本:
8
相关模块:
Image
汇总
结构体
结构体名称 | 描述 |
用于定义 pixel map 的相关信息。 |
枚举
枚举名称 | 描述 |
{ OHOS_IMAGE_RESULT_SUCCESS = 0, OHOS_IMAGE_RESULT_BAD_PARAMETER = -1 } | 函数方法返回值的错误码的枚举。 |
{ OHOS_PIXEL_MAP_FORMAT_NONE = 0, OHOS_PIXEL_MAP_FORMAT_RGBA_8888 = 3, OHOS_PIXEL_MAP_FORMAT_RGB_565 = 2 } | pixel 格式的枚举。 |
函数
函数名称 | 描述 |
OH_GetImageInfo (napi_env env, napi_value value, OhosPixelMapInfo *info) | 获取 PixelMap 的信息,并记录信息到OhosPixelMapInfo结构中。 |
OH_AccessPixels (napi_env env, napi_value value, void **addrPtr) | 获取PixelMap对象数据的内存地址,并锁定该内存。 |
OH_UnAccessPixels (napi_env env, napi_value value) | 释放PixelMap对象数据的内存锁, 用于匹配方法OH_AccessPixels。 |