harmony 鸿蒙NativeWindow

2022-08-09 浏览 (1611)

NativeWindow

概述

提供NativeWindow功能，作为数据生产者，可用来和egl对接

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本:

8

汇总

文件

名称描述
external_window.h定义获取和使用NativeWindow的相关函数
引用文件：<native_window/external_window.h>
库：libnative_window.so

结构体

名称描述
Region表示本地窗口OHNativeWindow需要更新内容的矩形区域（脏区）
OHHDRMetaDataHDR元数据结构体定义
OHExtDataHandle扩展数据句柄结构体定义

类型定义

名称描述
OHNativeWindow提供对OHNativeWindow的访问功能
OHNativeWindowBuffer提供对OHNativeWindowBuffer的访问功能
Region表示本地窗口OHNativeWindow需要更新内容的矩形区域（脏区）

枚举

名称描述
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)创建OHNativeWindow实例，每次调用都会产生一个新的OHNativeWindow实例
OH_NativeWindow_DestroyNativeWindow (OHNativeWindow *window)将OHNativeWindow对象的引用计数减1，当引用计数为0的时候，该OHNativeWindow对象会被析构掉
OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer (void *pSurfaceBuffer)创建OHNativeWindowBuffer实例，每次调用都会产生一个新的OHNativeWindowBuffer实例
OH_NativeWindow_DestroyNativeWindowBuffer (OHNativeWindowBuffer *buffer)将OHNativeWindowBuffer对象的引用计数减1，当引用计数为0的时候，该OHNativeWindowBuffer对象会被析构掉
OH_NativeWindow_NativeWindowRequestBuffer (OHNativeWindow *window, OHNativeWindowBuffer **buffer, int *fenceFd)通过OHNativeWindow对象申请一块OHNativeWindowBuffer，用以内容生产
OH_NativeWindow_NativeWindowFlushBuffer (OHNativeWindow *window, OHNativeWindowBuffer *buffer, int fenceFd, Region region)通过OHNativeWindow将生产好内容的OHNativeWindowBuffer放回到Buffer队列中，用以内容消费
OH_NativeWindow_NativeWindowAbortBuffer (OHNativeWindow *window, OHNativeWindowBuffer *buffer)通过OHNativeWindow将之前申请出来的OHNativeWindowBuffer返还到Buffer队列中，供下次再申请
OH_NativeWindow_NativeWindowHandleOpt (OHNativeWindow *window, int code,...)设置/获取OHNativeWindow的属性，包括设置/获取宽高、内容格式等
OH_NativeWindow_GetBufferHandleFromNative (OHNativeWindowBuffer *buffer)通过OHNativeWindowBuffer获取该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)设置OHNativeWindow的ScalingMode
OH_NativeWindow_NativeWindowSetMetaData (OHNativeWindow *window, uint32_t sequence, int32_t size, const OHHDRMetaData *metaData)设置OHNativeWindow的元数据
OH_NativeWindow_NativeWindowSetMetaDataSet (OHNativeWindow*window, uint32_t sequence, OHHDRMetadataKey key, int32_t size, const uint8_t *metaData)设置OHNativeWindow的元数据集。
OH_NativeWindow_NativeWindowSetTunnelHandle (OHNativeWindow *window, const OHExtDataHandle *handle)设置OHNativeWindow的TunnelHandle。

类型定义说明

OHNativeWindow

typedef struct NativeWindow OHNativeWindow

描述:

提供对OHNativeWindow的访问功能

OHNativeWindowBuffer

typedef struct NativeWindowBuffer OHNativeWindowBuffer

描述:

提供对OHNativeWindowBuffer的访问功能

Region

typedef struct Region Region

描述:

表示本地窗口OHNativeWindow需要更新内容的矩形区域（脏区）

枚举类型说明

NativeWindowOperation

enum NativeWindowOperation

描述:

OH_NativeWindow_NativeWindowHandleOpt函数中的操作码

枚举值描述
SET_BUFFER_GEOMETRY设置本地窗口缓冲区几何图形， 函数中的可变参数是 [输入] int32_t height，[输入] int32_t width。
GET_BUFFER_GEOMETRY获取本地窗口缓冲区几何图形， 函数中的可变参数是 [输出] int32_t *height， [输出] int32_t *width。
GET_FORMAT获取本地窗口缓冲区格式， 函数中的可变参数是 [输出] int32_t *format。
SET_FORMAT设置本地窗口缓冲区格式， 函数中的可变参数是 [输入] int32_t format。
GET_USAGE获取本地窗口读写方式， 函数中的可变参数是 [输出] int32_t *usage。
SET_USAGE设置本地窗口缓冲区读写方式， 函数中的可变参数是 [输入] int32_t usage。
SET_STRIDE设置本地窗口缓冲区步幅， 函数中的可变参数是 [输入] int32_t stride。
GET_STRIDE获取本地窗口缓冲区步幅， 函数中的可变参数是 [输出] int32_t *stride。
SET_SWAP_INTERVAL设置本地窗口缓冲区交换间隔， 函数中的可变参数是 [输入] int32_t interval。
GET_SWAP_INTERVAL获取本地窗口缓冲区交换间隔， 函数中的可变参数是 [输出] int32_t *interval。
SET_TIMEOUT设置请求本地窗口缓冲区的超时等待时间， 函数中的可变参数是 [输入] int32_t timeout。
GET_TIMEOUT获取请求本地窗口缓冲区的超时等待时间， 函数中的可变参数是 [输出] int32_t *timeout。
SET_COLOR_GAMUT设置本地窗口缓冲区色彩空间， 函数中的可变参数是 [输入] int32_t colorGamut。
GET_COLOR_GAMUT获取本地窗口缓冲区色彩空间， 函数中的可变参数是 [out int32_t *colorGamut]。
SET_TRANSFORM设置本地窗口缓冲区变换， 函数中的可变参数是 [输入] int32_t transform。
GET_TRANSFORM获取本地窗口缓冲区变换， 函数中的可变参数是 [输出] int32_t *transform。
SET_UI_TIMESTAMP设置本地窗口缓冲区UI时间戳， 函数中的可变参数是 [输入] uint64_t uiTimestamp。

OHHDRMetadataKey

enum OHHDRMetadataKey

描述:

枚举HDR元数据关键字

起始版本:

9

弃用:

从API version 10开始废弃，不再提供替代接口

枚举值描述
OH_METAKEY_RED_PRIMARY_X红基色X坐标
OH_METAKEY_RED_PRIMARY_Y红基色Y坐标
OH_METAKEY_GREEN_PRIMARY_X绿基色X坐标
OH_METAKEY_GREEN_PRIMARY_Y绿基色Y坐标
OH_METAKEY_BLUE_PRIMARY_X蓝基色X坐标
OH_METAKEY_BLUE_PRIMARY_Y蓝基色Y坐标
OH_METAKEY_WHITE_PRIMARY_X白点X坐标
OH_METAKEY_WHITE_PRIMARY_Y白点Y坐标
OH_METAKEY_MAX_LUMINANCE最大的光亮度
OH_METAKEY_MIN_LUMINANCE最小的光亮度
OH_METAKEY_MAX_CONTENT_LIGHT_LEVEL最大的内容亮度水平
OH_METAKEY_MAX_FRAME_AVERAGE_LIGHT_LEVEL最大的帧平均亮度水平
OH_METAKEY_HDR10_PLUSHDR10 Plus
OH_METAKEY_HDR_VIVIDVivid

OHScalingMode

enum OHScalingMode

描述:

缩放模式 Scaling Mode

起始版本:

9

弃用:

从API version 10开始废弃，不再提供替代接口

枚举值描述
OH_SCALING_MODE_FREEZE在接收到窗口大小的缓冲区之前，不可以更新窗口内容
OH_SCALING_MODE_SCALE_TO_WINDOW缓冲区在二维中缩放以匹配窗口大小
OH_SCALING_MODE_SCALE_CROP缓冲区被统一缩放，使得缓冲区的较小尺寸与窗口大小匹配
OH_SCALING_MODE_NO_SCALE_CROP窗口被裁剪为缓冲区裁剪矩形的大小，裁剪矩形之外的像素被视为完全透明

函数说明

OH_NativeWindow_CreateNativeWindow()

OHNativeWindow* OH_NativeWindow_CreateNativeWindow (void * pSurface)

描述:

创建OHNativeWindow实例，每次调用都会产生一个新的OHNativeWindow实例

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
pSurface一个指向生产者ProduceSurface的指针，类型为sptr<OHOS::Surface>

返回:

返回一个指针，指向OHNativeWindow的结构体实例

OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer()

OHNativeWindowBuffer* OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer (void * pSurfaceBuffer)

描述:

创建OHNativeWindowBuffer实例，每次调用都会产生一个新的OHNativeWindowBuffer实例

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
pSurfaceBuffer一个指向生产者buffer的指针，类型为sptr<OHOS::SurfaceBuffer>

返回:

返回一个指针，指向OHNativeWindowBuffer的结构体实例

OH_NativeWindow_DestroyNativeWindow()

void OH_NativeWindow_DestroyNativeWindow (OHNativeWindow *  window)

描述:

将OHNativeWindow对象的引用计数减1，当引用计数为0的时候，该OHNativeWindow对象会被析构掉

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
window一个OHNativeWindow的结构体实例的指针

OH_NativeWindow_DestroyNativeWindowBuffer()

void OH_NativeWindow_DestroyNativeWindowBuffer (OHNativeWindowBuffer *  buffer)

描述:

将OHNativeWindowBuffer对象的引用计数减1，当引用计数为0的时候，该OHNativeWindowBuffer对象会被析构掉

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
buffer一个OHNativeWindowBuffer的结构体实例的指针

OH_NativeWindow_GetBufferHandleFromNative()

BufferHandle* OH_NativeWindow_GetBufferHandleFromNative (OHNativeWindowBuffer *  buffer)

描述:

通过OHNativeWindowBuffer获取该buffer的BufferHandle指针

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
buffer一个OHNativeWindowBuffer的结构体实例的指针

返回:

BufferHandle 返回一个指针，指向BufferHandle的结构体实例

OH_NativeWindow_GetNativeObjectMagic()

int32_t OH_NativeWindow_GetNativeObjectMagic (void * obj)

描述:

获取NativeObject的MagicId

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
obj一个OHNativeWindow或者OHNativeWindowBuffer的结构体实例的指针

返回:

MagicId 返回值为魔鬼数字，每个NativeObject唯一

OH_NativeWindow_NativeObjectReference()

int32_t OH_NativeWindow_NativeObjectReference (void * obj)

描述:

增加一个NativeObject的引用计数

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
obj一个OHNativeWindow或者OHNativeWindowBuffer的结构体实例的指针

返回:

返回值为0表示执行成功

OH_NativeWindow_NativeObjectUnreference()

int32_t OH_NativeWindow_NativeObjectUnreference (void * obj)

描述:

减少一个NativeObject的引用计数，当引用计数减少为0时，该NativeObject将被析构掉

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
obj一个OHNativeWindow或者OHNativeWindowBuffer的结构体实例的指针

返回:

返回值为0表示执行成功

OH_NativeWindow_NativeWindowAbortBuffer()

int32_t OH_NativeWindow_NativeWindowAbortBuffer (OHNativeWindow *  window, OHNativeWindowBuffer *  buffer )

描述:

通过OHNativeWindow将之前申请出来的OHNativeWindowBuffer返还到Buffer队列中，供下次再申请

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
window一个OHNativeWindow的结构体实例的指针
buffer一个OHNativeWindowBuffer的结构体实例的指针

返回:

返回值为0表示执行成功

OH_NativeWindow_NativeWindowFlushBuffer()

int32_t OH_NativeWindow_NativeWindowFlushBuffer (OHNativeWindow *  window, OHNativeWindowBuffer *  buffer, int fenceFd, Region region )

描述:

通过OHNativeWindow将生产好内容的OHNativeWindowBuffer放回到Buffer队列中，用以内容消费

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
window一个OHNativeWindow的结构体实例的指针
buffer一个OHNativeWindowBuffer的结构体实例的指针
fenceFd一个文件描述符句柄，用以同步时序
region表示一块脏区域，该区域有内容更新

返回:

返回值为0表示执行成功

OH_NativeWindow_NativeWindowHandleOpt()

int32_t OH_NativeWindow_NativeWindowHandleOpt (OHNativeWindow *  window, int code,  ... )

描述:

设置/获取OHNativeWindow的属性，包括设置/获取宽高、内容格式等

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
window一个OHNativeWindow的结构体实例的指针
code表示操作码，详见NativeWindowOperation
...可变参数，必须与操作码一一对应

返回:

返回值为0表示执行成功

OH_NativeWindow_NativeWindowRequestBuffer()

int32_t OH_NativeWindow_NativeWindowRequestBuffer (OHNativeWindow *  window, OHNativeWindowBuffer **  buffer, int * fenceFd )

描述:

通过OHNativeWindow对象申请一块OHNativeWindowBuffer，用以内容生产

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
window一个OHNativeWindow的结构体实例的指针
buffer一个OHNativeWindowBuffer的结构体实例的二级指针
fenceFd一个文件描述符句柄

返回:

返回值为0表示执行成功

OH_NativeWindow_NativeWindowSetMetaData()

int32_t OH_NativeWindow_NativeWindowSetMetaData (OHNativeWindow *  window, uint32_t sequence, int32_t size, const OHHDRMetaData *  metaData )

描述:

设置OHNativeWindow的元数据

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
window一个OHNativeWindow的结构体实例的指针
sequence生产缓冲区的序列
sizeOHHDRMetaData数组的大小
metaDate指向OHHDRMetaData数组的指针

返回:

返回值为0表示执行成功

起始版本:

9

弃用:

从API version 10开始废弃，不再提供替代接口

OH_NativeWindow_NativeWindowSetMetaDataSet()

int32_t OH_NativeWindow_NativeWindowSetMetaDataSet (OHNativeWindow *  window, uint32_t sequence, OHHDRMetadataKey key, int32_t size, const uint8_t * metaData )

描述:

设置OHNativeWindow的元数据集。

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
window一个OHNativeWindow的结构体实例的指针。
sequence生产缓冲区的序列。
key枚举值OHHDRMetadataKey
sizeuint8_t向量的大小
metaDate指向uint8_t向量的指针

返回:

返回值为0表示执行成功

起始版本:

9

弃用:

从API version 10开始废弃，不再提供替代接口

OH_NativeWindow_NativeWindowSetScalingMode()

int32_t OH_NativeWindow_NativeWindowSetScalingMode (OHNativeWindow *  window, uint32_t sequence, OHScalingMode scalingMode )

描述:

设置OHNativeWindow的ScalingMode

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
window一个OHNativeWindow的结构体实例的指针
sequence生产缓冲区的序列
scalingMode枚举值OHScalingMode

返回:

返回值为0表示执行成功

起始版本:

9

弃用:

从API version 10开始废弃，不再提供替代接口

OH_NativeWindow_NativeWindowSetTunnelHandle()

int32_t OH_NativeWindow_NativeWindowSetTunnelHandle (OHNativeWindow *  window, const OHExtDataHandle *  handle )

描述:

设置OHNativeWindow的TunnelHandle。

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

参数:

名称描述
window一个OHNativeWindow的结构体实例的指针
handle指向OHExtDataHandle的指针

返回:

返回值为0表示执行成功

起始版本:

9

弃用:

从API version 10开始废弃，不再提供替代接口

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Native API

harmony 鸿蒙AVCapability

harmony 鸿蒙AVDemuxer

harmony 鸿蒙AVMuxer

harmony 鸿蒙AVScreenCapture

harmony 鸿蒙AVSource

harmony 鸿蒙AudioDecoder

harmony 鸿蒙AudioEncoder

harmony 鸿蒙CodecBase

harmony 鸿蒙Core

  • 所属分类： 后端技术
  • 本文标签： 鸿蒙 软件
  • 版权声明： 本文链接 https://seaxiang.com/blog/ec16e788866547bf92ac66c8ffa71956