harmony 鸿蒙OH_NativeImage

  • 2022-10-28
  • 浏览 (838)

OH_NativeImage

概述

提供NativeImage功能，作为数据消费者，主要用来将数据和OpenGL纹理对接，需在OpenGL环境下使用

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

起始版本:

9

汇总

文件

名称 描述
native_image.h 定义获取和使用NativeImage的相关函数
引用文件：<native_image/native_image.h>
库：libnative_image.so

类型定义

名称 描述
OH_NativeImage 提供OH_NativeImage结构体声明
OHNativeWindow 提供对NativeWindow的访问功能

函数

名称 描述
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

typedef struct OH_NativeImage OH_NativeImage

描述:

提供OH_NativeImage结构体声明

OHNativeWindow

typedef struct NativeWindow OHNativeWindow

描述:

提供对NativeWindow的访问功能

函数说明

OH_NativeImage_AcquireNativeWindow()

OHNativeWindow* OH_NativeImage_AcquireNativeWindow (OH_NativeImage * image)

描述:

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

OH_NativeWindow_DestroyNativeWindow释放

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

名称 描述
image 指向OH_NativeImage实例的指针。

返回:

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

OH_NativeImage_AttachContext()

int32_t OH_NativeImage_AttachContext (OH_NativeImage * image, uint32_t textureId )

描述:

将OH_NativeImage实例附加到当前OpenGL ES上下文, 且该OpenGL ES纹理会绑定到

GL_TEXTURE_EXTERNAL_OES, 并通过OH_NativeImage进行更新

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

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

返回:

返回值为0表示执行成功

OH_NativeImage_Create()

OH_NativeImage* OH_NativeImage_Create (uint32_t textureId, uint32_t textureTarget )

描述:

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

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

名称 描述
textureId OpenGL ES的纹理ID，OH_NativeImage实例会与之相关联
textureTarget OpenGL ES的纹理目标

返回:

返回一个指向OH_NativeImage实例的指针 returns NULL otherwise

OH_NativeImage_Destroy()

void OH_NativeImage_Destroy (OH_NativeImage ** image)

描述:

销毁通过OH_NativeImage_Create创建的OH_NativeImage实例, 销毁后该

OH_NativeImage指针会被赋值为空

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

名称 描述
image 指向OH_NativeImage实例的指针。

OH_NativeImage_DetachContext()

int32_t OH_NativeImage_DetachContext (OH_NativeImage * image)

描述:

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

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

名称 描述
image 指向OH_NativeImage实例的指针。

返回:

返回值为0表示执行成功

OH_NativeImage_GetTimestamp()

int64_t OH_NativeImage_GetTimestamp (OH_NativeImage * image)

描述:

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

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

名称 描述
image 指向OH_NativeImage实例的指针。

返回:

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

OH_NativeImage_GetTransformMatrix()

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

描述:

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

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

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

返回:

返回值为0表示执行成功

OH_NativeImage_UpdateSurfaceImage()

int32_t OH_NativeImage_UpdateSurfaceImage (OH_NativeImage * image)

描述:

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

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeImage

参数:

名称 描述
image 指向OH_NativeImage实例的指针。

返回:

返回值为0表示执行成功

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Native API

harmony 鸿蒙AVCapability

harmony 鸿蒙AVDemuxer

harmony 鸿蒙AVMuxer

harmony 鸿蒙AVScreenCapture

harmony 鸿蒙AVSource

harmony 鸿蒙AudioDecoder

harmony 鸿蒙AudioEncoder

harmony 鸿蒙CodecBase

harmony 鸿蒙Core

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/738d1a187a914eb687957b23df3bb851
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录