OH_NativeImage


OH_NativeImage

提供NativeImage功能。

@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

自从:

9

汇总

文件

文件名称 描述
native_image.h 定义获取和使用NativeImage的相关函数。

函数

函数名称 描述
OH_NativeImage_Create (uint32_t textureId, uint32_t textureTarget) 创建一个OH_NativeImage实例,该实例与OPENGL ES的纹理ID和纹理目标相关联。
OH_NativeImage_AcquireNativeWindow (OH_NativeImage *image) 获取与OH_NativeImage相关联的OHNativeWindow指针. 该OHNativeWindow后续不再需要时需要调用 OH_NativeWindow_DestroyNativeWindow释放。
OH_NativeImage_AttachContext (OH_NativeImage *image, uint32_t textureId) 将OH_NativeImage实例附加到当前OPENGL ES上下文, 且该OPENGL ES纹理会绑定到 GL_TEXTURE_EXTERNAL_OES, 并通过OH_NativeImage进行更新。
OH_NativeImage_DetachContext (OH_NativeImage *image) 将OH_NativeImage实例从当前OPENGL ES上下文分离。
OH_NativeImage_UpdateSurfaceImage (OH_NativeImage *image) 通过OH_NativeImage获取最新帧更新相关联的OPENGL ES纹理。
OH_NativeImage_GetTimestamp (OH_NativeImage *image) 获取最近调用OH_NativeImage_UpdateSurfaceImage的纹理图像的相关时间戳。
OH_NativeImage_GetTransformMatrix (OH_NativeImage *image, float matrix[16]) 获取最近调用OH_NativeImage_UpdateSurfaceImage的纹理图像的变化矩阵。
OH_NativeImage_Destroy (OH_NativeImage **image) 销毁通过OH_NativeImage_Create创建的OH_NativeImage实例, 销毁后该 OH_NativeImage指针会被赋值为空。

详细描述

函数说明

OH_NativeImage_AcquireNativeWindow()

OHNativeWindow* OH_NativeImage_AcquireNativeWindow (OH_NativeImage * image)
1

描述:

获取与OH_NativeImage相关联的OHNativeWindow指针。该OHNativeWindow后续不再需要时需要调用 OH_NativeWindow_DestroyNativeWindow释放。

@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

Name 描述
image 指向<b>OH_NativeImage</b>实例的指针。

返回:

成功则返回一个指向OHNativeWindow实例的指针,否则返回NULL

自从:

9

OH_NativeImage_AttachContext()

int32_t OH_NativeImage_AttachContext (OH_NativeImage * image, uint32_t textureId )
1

描述:

将OH_NativeImage实例附加到当前OPENGL ES上下文,且该OPENGL ES纹理会绑定到 GL_TEXTURE_EXTERNAL_OES,并通过OH_NativeImage进行更新。

@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

Name 描述
image 指向OH_NativeImage实例的指针。
textureId OH_NativeImage要附加到的OPENGL ES纹理的id。

返回:

返回一个由SurfaceError定义的int32_t类型的错误码。

自从:

9

OH_NativeImage_Create()

OH_NativeImage* OH_NativeImage_Create (uint32_t textureId, uint32_t textureTarget )
1

描述:

创建一个OH_NativeImage实例,该实例与OPENGL ES的纹理ID和纹理目标相关联。

@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

Name 描述
textureId OPENGL ES的纹理ID,OH_NativeImage实例会与之相关联。
textureTarget OPENGL ES的纹理目标。

返回:

返回一个指向OH_NativeImage实例的指针,否则返回NULL

自从:

9

OH_NativeImage_Destroy()

void OH_NativeImage_Destroy (OH_NativeImage ** image)
1

描述:

销毁通过OH_NativeImage_Create创建的OH_NativeImage实例, 销毁后该 OH_NativeImage指针会被赋值为空.

@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

Name 描述
image 指向OH_NativeImage实例的指针。

OH_NativeImage_DetachContext()

int32_t OH_NativeImage_DetachContext (OH_NativeImage * image)
1

描述:

将OH_NativeImage实例从当前OPENGL ES上下文分离。

@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

Name 描述
image 指向OH_NativeImage实例的指针。

返回:

返回一个由SurfaceError定义的int32_t类型的错误码。

自从:

9

OH_NativeImage_GetTimestamp()

int64_t OH_NativeImage_GetTimestamp (OH_NativeImage * image)
1

描述:

获取最近调用OH_NativeImage_UpdateSurfaceImage的纹理图像的相关时间戳。

@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

Name 描述
image 指向OH_NativeImage实例的指针。

返回:

返回纹理图像的相关时间戳。

自从:

9

OH_NativeImage_GetTransformMatrix()

int32_t OH_NativeImage_GetTransformMatrix (OH_NativeImage * image, float matrix[16] )
1

描述:

获取最近调用OH_NativeImage_UpdateSurfaceImage的纹理图像的变化矩阵。

@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

Name 描述
image 指向OH_NativeImage实例的指针。
matrix 用来存储要获取的4*4的变化矩阵。

返回:

返回一个由SurfaceError定义的int32_t类型的错误码。

自从:

9

OH_NativeImage_UpdateSurfaceImage()

int32_t OH_NativeImage_UpdateSurfaceImage (OH_NativeImage * image)
1

描述:

通过OH_NativeImage获取最新帧更新相关联的OPENGL ES纹理。

@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

Name 描述
image 指向OH_NativeImage实例的指针。

返回:

返回一个由SurfaceError定义的int32_t类型的错误码。

自从:

9