# drawing_gpu_context.h

#### 概述

声明与绘图模块中的图形处理器上下文对象相关的函数。

**引用文件：** <native\_drawing/drawing\_gpu\_context.h>

**库：** libnative\_drawing.so

**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing

**起始版本：** 12

**相关模块：** Drawing

#### 汇总

#### 结构体

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| OH_Drawing_GpuContextOptions | OH_Drawing_GpuContextOptions | 定义有关图形处理器上下文的选项。 |

#### 函数

| 名称 | 描述 |
| --- | --- |
| OH_Drawing_GpuContext* OH_Drawing_GpuContextCreateFromGL(OH_Drawing_GpuContextOptions gpuContextOptions) | 用于创建一个使用OpenGL作为后端接口的图形处理器上下文对象。 |
| OH_Drawing_GpuContext* OH_Drawing_GpuContextCreate(void) | 用于创建一个图形处理器上下文对象, 使用的后端类型取决于运行设备。 |
| void OH_Drawing_GpuContextDestroy(OH_Drawing_GpuContext* gpuContext) | 用于销毁图形处理器上下文对象并回收该对象占用的内存。 |

#### 函数说明

#### OH\_Drawing\_GpuContextCreateFromGL()

```
OH_Drawing_GpuContext* OH_Drawing_GpuContextCreateFromGL(OH_Drawing_GpuContextOptions gpuContextOptions)
```

**描述**

用于创建一个使用OpenGL作为后端接口的图形处理器上下文对象。

**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing

**起始版本：** 12

**废弃版本：** 18

**替代接口：** OH\_Drawing\_GpuContextCreate

**参数：**

| 参数项 | 描述 |
| --- | --- |
| OH_Drawing_GpuContextOptions gpuContextOptions | 图形处理器上下文选项OH_Drawing_GpuContextOptions。 |

**返回：**

| 类型 | 说明 |
| --- | --- |
| OH_Drawing_GpuContext* | 返回一个指针，指针指向创建的图形处理器上下文对象OH_Drawing_GpuContext。 |

#### OH\_Drawing\_GpuContextCreate()

```
OH_Drawing_GpuContext* OH_Drawing_GpuContextCreate(void)
```

**描述**

用于创建一个图形处理器上下文对象, 使用的后端类型取决于运行设备。

**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing

**起始版本：** 16

**返回：**

| 类型 | 说明 |
| --- | --- |
| OH_Drawing_GpuContext* | 返回一个指针，指针指向创建的图形处理器上下文对象OH_Drawing_GpuContext。 |

#### OH\_Drawing\_GpuContextDestroy()

```
void OH_Drawing_GpuContextDestroy(OH_Drawing_GpuContext* gpuContext)
```

**描述**

用于销毁图形处理器上下文对象并回收该对象占用的内存。

**系统能力：** SystemCapability.Graphic.Graphic2D.NativeDrawing

**起始版本：** 12

**参数：**

| 参数项 | 描述 |
| --- | --- |
| OH_Drawing_GpuContext* gpuContext | 指向图形处理器上下文对象的指针OH_Drawing_GpuContext。 |