diff --git a/zh-cn/application-dev/reference/native-apis/_native_vsync.md b/zh-cn/application-dev/reference/native-apis/_native_vsync.md index 0487dbc7c286827dd833fb9798d592dc5ee84718..83a9586f575fcbde8f1cf7f50c1af6a368488fc7 100644 --- a/zh-cn/application-dev/reference/native-apis/_native_vsync.md +++ b/zh-cn/application-dev/reference/native-apis/_native_vsync.md @@ -19,7 +19,7 @@ | 名称 | 描述 | | -------- | -------- | -| [native_vsync.h](native__vsync_8h.md) | 定义获取和使用NativeVsync的相关函数
引用文件：<native_vsync/native_vsync.h> | +| [native_vsync.h](native__vsync_8h.md) | 定义获取和使用NativeVsync的相关函数
**引用文件：** <native_vsync/native_vsync.h>
**库：** libnative_vsync.so | ### 类型定义 @@ -37,7 +37,7 @@ | [OH_NativeVSync_Create](#oh_nativevsync_create) (const char \*name, unsigned int length) | 创建一个OH_NativeVSync实例，每次调用都会产生一个新的实例 | | [OH_NativeVSync_Destroy](#oh_nativevsync_destroy) ([OH_NativeVSync](#oh_nativevsync) \*nativeVsync) | 销毁OH_NativeVSync实例 | | [OH_NativeVSync_RequestFrame](#oh_nativevsync_requestframe) ([OH_NativeVSync](#oh_nativevsync) \*nativeVsync, [OH_NativeVSync_FrameCallback](#oh_nativevsync_framecallback) callback, void \*data) | 请求下一次vsync信号，当信号到来时，调用回调函数callback | - +| [OH_NativeVSync_GetPeriod](#oh_nativevsync_getperiod) ([OH_NativeVSync](#oh_nativevsync) \*nativeVsync, long long \*period) |获取vsync周期。| ## 类型定义说明 @@ -77,6 +77,34 @@ VSync回调函数类型 ## 函数说明 +### OH_NativeVSync_GetPeriod() + + +``` +int OH_NativeVSync_GetPeriod (OH_NativeVSync * nativeVsync, long long * period ) +``` + +**描述:** + +获取vsync周期。 + +\@syscap SystemCapability.Graphic.Graphic2D.NativeVsync + +**参数:** + +| 名称 | 描述 | +| -------- | -------- | +| nativeVsync | 一个指向OH_NativeVSync实例的指针。| +| period | 用于获取vsync周期的变量。 | + +**返回:** + +返回值为0表示执行成功。 + +**起始版本：** + +10 + ### OH_NativeVSync_Create() diff --git a/zh-cn/application-dev/reference/native-apis/_o_h___native_buffer.md b/zh-cn/application-dev/reference/native-apis/_o_h___native_buffer.md index 18e79e28c1f3733d0074f5b1ff0f408db1da5bc7..ba9381e58e64bc32083898c438e2559c1570bab9 100644 --- a/zh-cn/application-dev/reference/native-apis/_o_h___native_buffer.md +++ b/zh-cn/application-dev/reference/native-apis/_o_h___native_buffer.md @@ -19,7 +19,7 @@ | 名称 | 描述 | | -------- | -------- | -| [native_buffer.h](native__buffer_8h.md) | 定义获取和使用NativeBuffer的相关函数。
引用文件：<native_buffer/native_buffer.h> | +| [native_buffer.h](native__buffer_8h.md) | 定义获取和使用NativeBuffer的相关函数。
**引用文件：** <native_buffer/native_buffer.h>
**库：** libnative_buffer.so| ### 结构体 @@ -35,6 +35,12 @@ | -------- | -------- | | [OH_NativeBuffer](#oh_nativebuffer) | 提供OH_NativeBuffer结构体声明。 | +### 枚举 + +| 名称 | 描述 | +| -------- | -------- | +| [OH_NativeBuffer_Usage](#oh_nativebuffer_usage) { NATIVEBUFFER_USAGE_CPU_READ = (1ULL << 0), NATIVEBUFFER_USAGE_CPU_WRITE = (1ULL << 1), NATIVEBUFFER_USAGE_MEM_DMA = (1ULL << 3) } | OH_NativeBuffer的用途。 | +| [OH_NativeBuffer_Format](#oh_nativebuffer_format) {
NATIVEBUFFER_PIXEL_FMT_RGB_565 = 3, NATIVEBUFFER_PIXEL_FMT_RGBA_5658, NATIVEBUFFER_PIXEL_FMT_RGBX_4444, NATIVEBUFFER_PIXEL_FMT_RGBA_4444,
NATIVEBUFFER_PIXEL_FMT_RGB_444, NATIVEBUFFER_PIXEL_FMT_RGBX_5551, NATIVEBUFFER_PIXEL_FMT_RGBA_5551, NATIVEBUFFER_PIXEL_FMT_RGB_555,
NATIVEBUFFER_PIXEL_FMT_RGBX_8888, NATIVEBUFFER_PIXEL_FMT_RGBA_8888, NATIVEBUFFER_PIXEL_FMT_RGB_888, NATIVEBUFFER_PIXEL_FMT_BGR_565,
NATIVEBUFFER_PIXEL_FMT_BGRX_4444, NATIVEBUFFER_PIXEL_FMT_BGRA_4444, NATIVEBUFFER_PIXEL_FMT_BGRX_5551, NATIVEBUFFER_PIXEL_FMT_BGRA_5551,
NATIVEBUFFER_PIXEL_FMT_BGRX_8888, NATIVEBUFFER_PIXEL_FMT_BGRA_8888, NATIVEBUFFER_PIXEL_FMT_BUTT = 0X7FFFFFFF
} | OH_NativeBuffer的格式。 | ### 函数 @@ -63,6 +69,70 @@ typedef struct OH_NativeBuffer OH_NativeBuffer 提供OH_NativeBuffer结构体声明。 +## 枚举类型说明 + + +### OH_NativeBuffer_Format + +``` +enum OH_NativeBuffer_Format +``` + +**描述:** + +OH_NativeBuffer的格式。 + +\@SysCap SystemCapability.Graphic.Graphic2D.NativeBuffer + +| 枚举值 | 描述 | +| -------- | -------- | +| NATIVEBUFFER_PIXEL_FMT_RGB_565 | RGB565格式 | +| NATIVEBUFFER_PIXEL_FMT_RGBA_5658 | RGBA5658格式 | +| NATIVEBUFFER_PIXEL_FMT_RGBX_4444 | RGBX4444格式 | +| NATIVEBUFFER_PIXEL_FMT_RGBA_4444 | RGBA4444格式 | +| NATIVEBUFFER_PIXEL_FMT_RGB_444 | RGB444格式 | +| NATIVEBUFFER_PIXEL_FMT_RGBX_5551 | RGBX5551格式 | +| NATIVEBUFFER_PIXEL_FMT_RGBA_5551 | RGBA5551格式 | +| NATIVEBUFFER_PIXEL_FMT_RGB_555 | RGB555格式 | +| NATIVEBUFFER_PIXEL_FMT_RGBX_8888 | RGBX8888格式 | +| NATIVEBUFFER_PIXEL_FMT_RGBA_8888 | RGBA8888格式 | +| NATIVEBUFFER_PIXEL_FMT_RGB_888 | RGB888格式 | +| NATIVEBUFFER_PIXEL_FMT_BGR_565 | BGR565格式 | +| NATIVEBUFFER_PIXEL_FMT_BGRX_4444 | BGRX4444格式 | +| NATIVEBUFFER_PIXEL_FMT_BGRA_4444 | BGRA4444格式 | +| NATIVEBUFFER_PIXEL_FMT_BGRX_5551 | BGRX5551格式 | +| NATIVEBUFFER_PIXEL_FMT_BGRA_5551 | BGRA5551格式 | +| NATIVEBUFFER_PIXEL_FMT_BGRX_8888 | BGRX8888格式 | +| NATIVEBUFFER_PIXEL_FMT_BGRA_8888 | BGRA8888格式 | +| NATIVEBUFFER_PIXEL_FMT_BUTT | 无效格式 | + +**起始版本：** + +10 + + +### OH_NativeBuffer_Usage + +``` +enum OH_NativeBuffer_Usage +``` + +**描述:** + +OH_NativeBuffer的用途。 + +\@SysCap SystemCapability.Graphic.Graphic2D.NativeBuffer + +| 枚举值 | 描述 | +| -------- | -------- | +| NATIVEBUFFER_USAGE_CPU_READ | CPU可读 | +| NATIVEBUFFER_USAGE_CPU_WRITE | CPU可写 | +| NATIVEBUFFER_USAGE_MEM_DMA | 直接内存访问缓冲区 | + +**起始版本：** + +10 + ## 函数说明 diff --git a/zh-cn/application-dev/reference/native-apis/_o_h___native_buffer___config.md b/zh-cn/application-dev/reference/native-apis/_o_h___native_buffer___config.md index 73dcff7c6944290528f4ff7ba6bf4be3197dbedf..45783932327ccd5f11842c6d31354ce30cb0997a 100644 --- a/zh-cn/application-dev/reference/native-apis/_o_h___native_buffer___config.md +++ b/zh-cn/application-dev/reference/native-apis/_o_h___native_buffer___config.md @@ -21,9 +21,72 @@ OH_NativeBuffer的属性配置，用于申请新的OH_NativeBuffer实例或查 ### 成员变量 -| 成员变量名称 | 描述 | +| 名称 | 描述 | | -------- | -------- | -| width | 宽度（像素）。 | -| height | 高度（像素）。 | -| format | 像素格式。 | -| usage | buffer的用途说明。 | +| [width](#width) | 宽度（像素）。 | +| [height](#height) | 高度（像素）。 | +| [format](#format) | 像素格式。 | +| [usage](#usage) | buffer的用途说明。 | +| [stride](#stride) | 本地窗口缓冲区步幅。 | + + +## 结构体成员变量说明 + + +### format + +``` +int32_t OH_NativeBuffer_Config::format +``` + +**描述:** + +像素格式 + + +### height + +``` +int32_t OH_NativeBuffer_Config::height +``` + +**描述:** + +高度（像素）。 + + +### stride + +``` +int32_t OH_NativeBuffer_Config::stride +``` + +**描述:** + +本地窗口缓冲区步幅。 + +**起始版本：** + +10 + + +### usage + +``` +int32_t OH_NativeBuffer_Config::usage +``` + +**描述:** + +buffer的用途说明。 + + +### width + +``` +int32_t OH_NativeBuffer_Config::width +``` + +**描述:** + +宽度（像素）。 diff --git a/zh-cn/application-dev/reference/native-apis/native__buffer_8h.md b/zh-cn/application-dev/reference/native-apis/native__buffer_8h.md index 07e37cf965ea928fa016826e10e6600621fe67e0..68f6ec4751d8e3c5bb517059fb47f927d40ec9a1 100644 --- a/zh-cn/application-dev/reference/native-apis/native__buffer_8h.md +++ b/zh-cn/application-dev/reference/native-apis/native__buffer_8h.md @@ -30,6 +30,12 @@ | -------- | -------- | | [OH_NativeBuffer](_o_h___native_buffer.md#oh_nativebuffer) | 提供OH_NativeBuffer结构体声明 | +### 枚举 + +| 名称 | 描述 | +| -------- | -------- | +| [OH_NativeBuffer_Usage](_o_h___native_buffer.md#oh_nativebuffer_usage) { NATIVEBUFFER_USAGE_CPU_READ = (1ULL << 0), NATIVEBUFFER_USAGE_CPU_WRITE = (1ULL << 1), NATIVEBUFFER_USAGE_MEM_DMA = (1ULL << 3) } | OH_NativeBuffer的用途。 | +| [OH_NativeBuffer_Format](_o_h___native_buffer.md#oh_nativebuffer_format) {
NATIVEBUFFER_PIXEL_FMT_RGB_565 = 3, NATIVEBUFFER_PIXEL_FMT_RGBA_5658, NATIVEBUFFER_PIXEL_FMT_RGBX_4444, NATIVEBUFFER_PIXEL_FMT_RGBA_4444,
NATIVEBUFFER_PIXEL_FMT_RGB_444, NATIVEBUFFER_PIXEL_FMT_RGBX_5551, NATIVEBUFFER_PIXEL_FMT_RGBA_5551, NATIVEBUFFER_PIXEL_FMT_RGB_555,
NATIVEBUFFER_PIXEL_FMT_RGBX_8888, NATIVEBUFFER_PIXEL_FMT_RGBA_8888, NATIVEBUFFER_PIXEL_FMT_RGB_888, NATIVEBUFFER_PIXEL_FMT_BGR_565,
NATIVEBUFFER_PIXEL_FMT_BGRX_4444, NATIVEBUFFER_PIXEL_FMT_BGRA_4444, NATIVEBUFFER_PIXEL_FMT_BGRX_5551, NATIVEBUFFER_PIXEL_FMT_BGRA_5551,
NATIVEBUFFER_PIXEL_FMT_BGRX_8888, NATIVEBUFFER_PIXEL_FMT_BGRA_8888, NATIVEBUFFER_PIXEL_FMT_BUTT = 0X7FFFFFFF
} | OH_NativeBuffer的格式。 | ### 函数 diff --git a/zh-cn/application-dev/reference/native-apis/native__vsync_8h.md b/zh-cn/application-dev/reference/native-apis/native__vsync_8h.md index f127e04ce8e7028d9ce1a9d27547577d59df05c2..c1001d8bffd2d7639ca32e49b9128e6e35c6882e 100644 --- a/zh-cn/application-dev/reference/native-apis/native__vsync_8h.md +++ b/zh-cn/application-dev/reference/native-apis/native__vsync_8h.md @@ -32,3 +32,4 @@ | [OH_NativeVSync_Create](_native_vsync.md#oh_nativevsync_create) (const char \*name, unsigned int length) | 创建一个OH_NativeVSync实例，每次调用都会产生一个新的实例 | | [OH_NativeVSync_Destroy](_native_vsync.md#oh_nativevsync_destroy) (OH_NativeVSync \*nativeVsync) | 销毁OH_NativeVSync实例 | | [OH_NativeVSync_RequestFrame](_native_vsync.md#oh_nativevsync_requestframe) (OH_NativeVSync \*nativeVsync, OH_NativeVSync_FrameCallback callback, void \*data) | 请求下一次vsync信号，当信号到来时，调用回调函数callback | +| [OH_NativeVSync_GetPeriod](_native_vsync.md#oh_nativevsync_getperiod) (OH_NativeVSync \*nativeVsync, long long \*period) |获取vsync周期。| \ No newline at end of file