# 图形子系统
- [1.1 轻量系统](#section1346303311377)
- [简介](#section1165992615384)
- [目录](#section141331948134020)
- [约束](#section15729113104112)
- [说明](#section812962919413)
- [相关仓](#section12651205434115)
- [1.2 标准系统](#section1249610812538)
- [简介](#section1374615251510)
- [目录](#section16751364713)
- [约束](#section126494189715)
- [编译构建](#section883114292070)
- [说明](#section1351214227564)
- [相关仓](#section11578621131119)
图形子系统主要包括UI组件、布局、动画、字体、输入事件、窗口管理、渲染绘制等模块,构建基于轻量OS应用框架满足硬件资源较小的物联网设备或者构建基于标准OS的应用框架满足富设备的OpenHarmony系统应用开发。
## 1.1 轻量系统
### 简介
图形子系统主要包括UI组件、布局、动画、字体、输入事件、窗口管理、渲染绘制等模块,构建基于轻量OS的应用框架,满足硬件资源较小的物联网设备的OpenHarmony系统应用开发。
**图 1** 图形子系统架构图
![](figures/图形子系统架构图.png "图形子系统架构图")
各模块介绍:
- View:应用组件,包括UIView、UIViewGroup、UIButton、UILabel、UILabelButton、UIList、UISlider等。
- Animator:动画模块,开发者可以自定义动画。
- Layout:布局控件,包括Flexlayout、GridLayout、ListLayout等。
- Transform:图形变换模块,包括旋转、平移、缩放等。
- Event:事件模块,包括click、press、drag、long press等基础事件。
- Rendering engine:渲染绘制模块。
- 2D graphics library:2D绘制模块,包括直线、矩形、圆、弧、图片、文字等绘制。包括软件绘制和硬件加速能力对接。
- Multi-language:多语言模块,用于处理不用不同语言文字的换行、整形等。
- Image library:图片处理模块,用于解析和操作不同类型和格式的图片,例如png、jpeg、ARGB8888、ARGB565等
- WindowManager:窗口管理模块,包括窗口创建、显示隐藏、合成等处理。
- InputManager:输入事件管理模块。
### 目录
```
/foundation/graphic
├── surface # 共享内存
├── ui # UI模块,包括UI控件、动画、字体等功能
├── utils # 图形基础库和硬件适配层
└── wms # 窗口管理和输入事件管理
```
### 约束
- 图形组件不支持多线程并发操作,建议相关操作都在ui线程中执行;
- utils/interfaces/innerkits/graphic\_config.h文件列举了图形部分可配置功能的宏开关,需要在编译前配置,配置时需要注意部分宏开关是分平台配置的。
### 说明
参考各仓README以及test目录
### 相关仓
**图形子系统**
[graphic\_surface](https://gitee.com/openharmony/graphic_surface)
[graphic\_ui](https://gitee.com/openharmony/graphic_ui)
[graphic\_wms](https://gitee.com/openharmony/graphic_wms)
[graphic\_utils](https://gitee.com/openharmony/graphic_utils)
## 1.2 标准系统
### 简介
**图形子系统** 提供了图形接口能力。
其主要的结构如下图所示:
![图形子系统架构图](figures/graphic_rosen_architecture.jpg)
OpenHarmony 图形栈的分层说明如下:
• 接口层:提供图形的 NDK(native development kit,原生开发包)能力,包括:WebGL、Native Drawing的绘制能力、OpenGL 指令级的绘制能力支撑等。
• 框架层:分为 Render Service、Drawing、Animation、Effect、显示与内存管理五个模块。
| 模块 | 能力描述 |
|------------------------|--------------------------------------------------------------------------------------------|
| Render Servicel (渲染服务) | 提供UI框架的绘制能力,其核心职责是将ArkUI的控件描述转换成绘制树信息,根据对应的渲染策略,进行最佳路径渲染。同时,负责多窗口流畅和空间态下UI共享的核心底层机制。 |
| Drawing (绘制) | 提供图形子系统内部的标准化接口,主要完成2D渲染、3D渲染和渲染引擎的管理等基本功能。 |
| Animation (动画) | 提供动画引擎的相关能力。 |
| Effect (效果) | 主要完成图片效果、渲染特效等效果处理的能力,包括:多效果的串联、并联处理,在布局时加入渲染特效、控件交互特效等相关能力。 |
| 显示与内存管理 | 此模块是图形栈与硬件解耦的主要模块,主要定义了OpenHarmony显示与内存管理的能力,其定义的HDI接口需要让不同的OEM厂商完成对OpenHarmony图形栈的适配. |
• 引擎层:包括2D图形库和3D图形引擎两个模块。2D图形库提供2D图形绘制底层API,支持图形绘制与文本绘制底层能力。3D图形引擎能力尚在构建中。
### 目录
```
foundation/graphic/standard/
├── figures # Markdown引用的图片目录
├── frameworks # 框架代码目录
│ ├── animation_server # AnimationServer代码
│ ├── bootanimation # 开机动画目录
│ ├── dumper # graphic dumper代码
│ ├── fence # fence代码
│ ├── surface # Surface代码
│ ├── vsync # Vsync代码
├── rosen # 框架代码目录
│ ├── build # 构建说明
│ ├── doc # doc
│ ├── include # 对外头文件代码
│ ├── lib # lib
│ ├── modules # graphic 子系统各模块代码
│ ├── samples # 实例代码
│ ├── test # 开发测试代码
│ ├── tools # 工具代码
├── interfaces # 图形接口存放目录
│ ├── innerkits # 内部native接口存放目录
│ └── kits # js/napi外部接口存放目录
└── utils # 小部件存放目录
```
### 约束
语言版本:C++11及以上
### 编译构建
### 说明
参考各仓README以及test目录
### 相关仓
**图形子系统**
- [ace_ace_engine](https://gitee.com/openharmony/ace_ace_engine)
- [aafwk_standard](https://gitee.com/openharmony/aafwk_standard)
- [multimedia_media_standard](https://gitee.com/openharmony/multimedia_media_standard)
- [multimedia_camera_standard](https://gitee.com/openharmony/multimedia_camera_standard)
- Window Manager