图形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