鸿蒙OpenHarmony Native API【NativeWindow】

  • 开发
  • 12

NativeWindow

Overview

Description:

提供NativeWindow功能，主要用来和egl对接

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Since:

8

Version:

1.0

Summary

Files

File Name Description
[external_window.h] 定义获取和使用NativeWindow的相关函数

Functions

Function Description
OH_NativeWindow_CreateNativeWindowFromSurface (void *pSurface) struct NativeWindow * 创建NativeWindow实例，每次调用都会产生一个新的NativeWindow实例
OH_NativeWindow_DestroyNativeWindow (struct NativeWindow *window) void 将NativeWindow对象的引用计数减1，当引用计数为0的时候，该NativeWindow对象会被析构掉
OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer (void *pSurfaceBuffer) struct NativeWindowBuffer * 创建NativeWindowBuffer实例，每次调用都会产生一个新的NativeWindowBuffer实例
OH_NativeWindow_DestroyNativeWindowBuffer (struct NativeWindowBuffer *buffer) void 将NativeWindowBuffer对象的引用计数减1，当引用计数为0的时候，该NativeWindowBuffer对象会被析构掉
OH_NativeWindow_NativeWindowRequestBuffer (struct NativeWindow *window, struct NativeWindowBuffer **buffer, int *fenceFd) int32_t 通过NativeWindow对象申请一块NativeWindowBuffer，用以内容生产
OH_NativeWindow_NativeWindowFlushBuffer (struct NativeWindow *window, struct NativeWindowBuffer *buffer, int fenceFd, Region region) int32_t 通过NativeWindow将生产好内容的NativeWindowBuffer放回到Buffer队列中，用以内容消费
OH_NativeWindow_NativeWindowCancelBuffer (struct NativeWindow *window, struct NativeWindowBuffer *buffer) int32_t 通过NativeWindow将之前申请出来的NativeWindowBuffer返还到Buffer队列中，供下次再申请
OH_NativeWindow_NativeWindowHandleOpt (struct NativeWindow *window, int code,…) int32_t 设置/获取NativeWindow的属性，包括设置/获取宽高、内容格式等
OH_NativeWindow_GetBufferHandleFromNative (struct NativeWindowBuffer *buffer) BufferHandle * 通过NativeWindowBuffer获取该buffer的BufferHandle指针
OH_NativeWindow_NativeObjectReference (void *obj) int32_t 增加一个NativeObject的引用计数
OH_NativeWindow_NativeObjectUnreference (void *obj) int32_t 减少一个NativeObject的引用计数，当引用计数减少为0时，该NativeObject将被析构掉
OH_NativeWindow_GetNativeObjectMagic (void *obj) int32_t 获取NativeObject的MagicId

Details

Function

OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer()

struct NativeWindowBuffer* OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer (void * pSurfaceBuffer)

Description:

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

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
pSurfaceBuffer 参数是一个指向生产者buffer的指针，类型为sptrOHOS::SurfaceBuffer

Returns:

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

OH_NativeWindow_CreateNativeWindowFromSurface()

struct NativeWindow* OH_NativeWindow_CreateNativeWindowFromSurface (void * pSurface)

Description:

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

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
pSurface 参数是一个指向生产者ProduceSurface的指针，类型为sptrOHOS::Surface

Returns:

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

OH_NativeWindow_DestroyNativeWindow()

void OH_NativeWindow_DestroyNativeWindow (struct NativeWindow * window)

Description:

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

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
window 参数是一个NativeWindow的结构体实例的指针

OH_NativeWindow_DestroyNativeWindowBuffer()

void OH_NativeWindow_DestroyNativeWindowBuffer (struct NativeWindowBuffer * buffer)

Description:

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

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
buffer 参数是一个NativeWindowBuffer的结构体实例的指针

OH_NativeWindow_GetBufferHandleFromNative()

BufferHandle* OH_NativeWindow_GetBufferHandleFromNative (struct NativeWindowBuffer * buffer)

Description:

通过NativeWindowBuffer获取该buffer的BufferHandle指针

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
buffer 参数是一个NativeWindowBuffer的结构体实例的指针

Returns:

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

OH_NativeWindow_GetNativeObjectMagic()

int32_t OH_NativeWindow_GetNativeObjectMagic (void * obj)

Description:

获取NativeObject的MagicId

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
obj 参数是一个NativeWindow or NativeWindowBuffer的结构体实例的指针

Returns:

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

OH_NativeWindow_NativeObjectReference()

int32_t OH_NativeWindow_NativeObjectReference (void * obj)

Description:

增加一个NativeObject的引用计数

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
obj 参数是一个NativeWindow or NativeWindowBuffer的结构体实例的指针

Returns:

GSError 返回值为错误码

OH_NativeWindow_NativeObjectUnreference()

int32_t OH_NativeWindow_NativeObjectUnreference (void * obj)

Description:

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

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
obj 参数是一个NativeWindow or NativeWindowBuffer的结构体实例的指针

Returns:

GSError

OH_NativeWindow_NativeWindowCancelBuffer()

int32_t OH_NativeWindow_NativeWindowCancelBuffer (struct NativeWindow * window, struct NativeWindowBuffer * buffer )

Description:

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

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
window 参数是一个NativeWindow的结构体实例的指针
buffer 参数是一个NativeWindowBuffer的结构体实例的指针

Returns:

GSError 返回值为错误码

OH_NativeWindow_NativeWindowFlushBuffer()

int32_t OH_NativeWindow_NativeWindowFlushBuffer (struct NativeWindow * window, struct NativeWindowBuffer * buffer, int fenceFd, Region region )

Description:

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

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
window 参数是一个NativeWindow的结构体实例的指针
buffer 参数是一个NativeWindowBuffer的结构体实例的指针
fenceFd 参数是一个文件描述符句柄，用以同步时序
region 参数表示一块脏区域，该区域有内容更新

Returns:

GSError 返回值为错误码

OH_NativeWindow_NativeWindowHandleOpt()

int32_t OH_NativeWindow_NativeWindowHandleOpt (struct NativeWindow * window, int code,  ... )

Description:

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

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
window 参数是一个NativeWindow的结构体实例的指针
code 操作码

Returns:

GSError 返回值为错误码

OH_NativeWindow_NativeWindowRequestBuffer()

int32_t OH_NativeWindow_NativeWindowRequestBuffer (struct NativeWindow * window, struct NativeWindowBuffer ** buffer, int * fenceFd )

Description:

通过NativeWindow对象申请一块NativeWindowBuffer，用以内容生产

@syscap SystemCapability.Graphic.Graphic2D.NativeWindow

Parameters:

Name Description
window 参数是一个NativeWindow的结构体实例的指针
buffer 参数是一个NativeWindowBuffer的结构体实例的二级指针
fenceFd 参数是一个文件描述符句柄

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

Returns:

GSError 返回值为错误码

阅读全部

相关推荐

  1. 鸿蒙：PrefereneceUtil

    2024-07-22 11:54:02       42 阅读

  5. 「前端+鸿蒙」鸿蒙应用开发简介

    2024-07-22 11:54:02       25 阅读

  6. 「前端+鸿蒙」鸿蒙应用开发-TS函数

    2024-07-22 11:54:02       23 阅读

  7. 「前端+鸿蒙」鸿蒙应用开发-布局

    2024-07-22 11:54:02       28 阅读

  10. 鸿蒙学习资料

    2024-07-22 11:54:02       56 阅读

最近更新

  3. docker php8.1+nginx base 镜像 dockerfile 配置

    2024-07-22 11:54:02       52 阅读

  4. Could not load dynamic library ‘cudart64_100.dll‘

    2024-07-22 11:54:02       54 阅读

  9. 在Django里面运行非项目文件

    2024-07-22 11:54:02       45 阅读

  19. Python语言-面向对象

    2024-07-22 11:54:02       55 阅读

  20. 如何分清楚常见的 Git 分支管理策略Git Flow、GitHub Flow 和 GitLab Flow

    2024-07-22 11:54:02       50 阅读

热门阅读

  7. Linux 驱动学习笔记

    2024-07-22 11:54:02       14 阅读

  8. 【OpenHarmony4.1 之 U-Boot 2024.07源码深度解析】014 - UBOOT 内存分布梳理

    2024-07-22 11:54:02       15 阅读

  13. 【嵌入式软考】试题整理（持续更新,第二次更新）

    2024-07-22 11:54:02       15 阅读

  14. 掌握Git：面试中常见的问题与解答

    2024-07-22 11:54:02       16 阅读

  17. DOS常用命令大全

    2024-07-22 11:54:02       12 阅读

  19. 设计模式在FileBrowser中的几个应用

    2024-07-22 11:54:02       13 阅读

  20. wxs 和小程序的Page能不能在执行过程中传值?wxs能不能往page里面传值?

    2024-07-22 11:54:02       16 阅读

  22. 代码随想录 day 17 二叉树

    2024-07-22 11:54:02       16 阅读

  23. Golang_交替打印ABC\奇偶数\1-10\字母（并发编程）

    2024-07-22 11:54:02       15 阅读

  25. 每天一个数据分析题（四百三十六）- 正态分布

    2024-07-22 11:54:02       16 阅读

  26. 使用Event Sourcing模式管理应用状态

    2024-07-22 11:54:02       18 阅读

  27. 从0到1搭建数据中台（4）：TiDB的安装和使用

    2024-07-22 11:54:02       16 阅读

  28. Modbus协议了解与简单使用

    2024-07-22 11:54:02       20 阅读

  29. springboot引入kafka

    2024-07-22 11:54:02       14 阅读

  30. C语言实战3：要求输入年月日，输出这是这一年的第几天以及菱形空心输出，还有用 go to 写求质数

    2024-07-22 11:54:02       18 阅读