Skip to content

KodeGood/graphic_surface-openharmony

 
 

Repository files navigation

图形SURFACE组件

简介

Surface组件用于管理和传递图形和媒体的共享内存。具体场景包括了图形的送显、合成,媒体的播放、录制等。

Surface的跨进程传输使用IPC传输句柄等控制结构(有拷贝),使用共享内存传递图形/媒体数据(零拷贝)。

图 1 surface(即图中的Screen Buffer)在系统架构中的位置

目录

/foundation/graphic/graphic_surface
├── surface             # 框架代码
│   ├── include         # surface头文件
│   ├── src             # surface源码
│   └── test            # 测试代码
│       ├── fuzztest    # fuzz测试
│       └── unittest    # 单元测试
├── interfaces          # 接口
│   ├── inner_api       # 模块间接口
│   └── kits            # 对外接口
├── buffer_handle       # 依赖的部件
└── scoped_bytrace      # 依赖的部件

编译构建

# 通过gn编译,在out目录下对应产品的文件夹中生成surface.so
hb build graphic_surface

说明

流程说明

以WMS组件和UI组件交互为例,UI为生产者,WMS为消费者。

生产者:从Free队列中获取Buffer,将UI内容绘制到Buffer中,然后将Buffer放到Dirty队列;

消费者:从Dirty队列中获取Buffer并进行合成,然后将Buffer重新放到Free队列中。

图 2 Surface轮转流程

须知:

  1. 由于使用了共享内存,而共享内存的管理任务在首次创建Surface的进程中,因此需要对该进程格外关注,如果发生进程异常且没有回收处理会发生严重的内存泄漏;
  2. Surface一般用作图形/媒体中大块内存的跨进程传输(如显示数据),尤其在使用了连续物理内存的情况下,可以大幅提高传输速率。不建议用在小内存传输的场景,容易造成内存碎片化影响典型场景的性能。

使用说明

可参考轻量图形WMS组件

相关仓

图形子系统

window_window_manager

About

提供Surface管理、Buffer管理和Fence管理能力

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 96.4%
  • C 3.6%