1# 图形SURFACE组件<a name="ZH-CN_TOPIC_0000001078362030"></a> 2 3- [简介](#section11660541593) 4- [目录](#section161941989596) 5- [编译构建](#section137768191623) 6- [说明](#section1312121216216) 7 - [流程说明](#section1551164914237) 8 - [使用说明](#section129654513264) 9 10- [相关仓](#section1371113476307) 11 12## 简介<a name="section11660541593"></a> 13 14Surface组件用于管理和传递图形和媒体的共享内存。具体场景包括了图形的送显、合成，媒体的播放、录制等。 15 16Surface的跨进程传输使用IPC传输句柄等控制结构（有拷贝），使用共享内存传递图形/媒体数据（零拷贝）。 17 18**图 1** surface(即图中的Screen Buffer)在系统架构中的位置<a name="fig584223343312"></a> 19 20 21## 目录<a name="section161941989596"></a> 22 23``` 24/foundation/graphic/surface 25├── frameworks # 框架代码 26├── interfaces # 接口 27│ ├── innerkits # 模块间接口 28│ └── kits # 对外接口 29└── test # 测试代码 30 ├── fuzztest # fuzz测试 31 └── unittest # 单元测试 32``` 33 34## 编译构建<a name="section137768191623"></a> 35 36``` 37# 通过gn编译,在out目录下对应产品的文件夹中生成libsurface.so 38hb build lite_surface 39``` 40 41## 说明<a name="section1312121216216"></a> 42 43### 流程说明<a name="section1551164914237"></a> 44 45以WMS组件和UI组件交互为例，UI为生产者，WMS为消费者。 46 47生产者：从Free队列中获取Buffer，将UI内容绘制到Buffer中，然后将Buffer放到Dirty队列； 48 49消费者：从Dirty队列中获取Buffer并进行合成，然后将Buffer重新放到Free队列中。 50 51**图 2** Surface轮转流程<a name="fig126141128261"></a> 52 53 54> **须知：** 55>1. 由于使用了共享内存，而共享内存的管理任务在首次创建Surface的进程中，因此需要对该进程格外关注，如果发生进程异常且没有回收处理会发生严重的内存泄漏； 56>2. Surface一般用作图形/媒体中大块内存的跨进程传输（如显示数据），尤其在使用了连续物理内存的情况下，可以大幅提高传输速率。不建议用在小内存传输的场景，容易造成内存碎片化影响典型场景的性能。 57 58### 使用说明<a name="section129654513264"></a> 59 60可参考轻量图形[WMS组件](https://gitee.com/openharmony/graphic_wms/blob/master/README_zh.md)。 61 62## 相关仓<a name="section1371113476307"></a> 63 64[图形子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/%E5%9B%BE%E5%BD%A2%E5%AD%90%E7%B3%BB%E7%BB%9F.md) 65 66[graphic_wms](https://gitee.com/openharmony/graphic_wms/blob/master/README_zh.md) 67 68**graphic_surface** 69 70[graphic_ui](https://gitee.com/openharmony/graphic_ui/blob/master/README_zh.md) 71 72[graphic_utils](https://gitee.com/openharmony/graphic_utils/blob/master/README_zh.md)
