# OpenGTX_FrameRenderInfo

> phone 5.0.0(12)+ | tablet 5.0.0(12)+ | tv 6.1.0(23)+

## 概述

此结构体描述帧渲染信息，游戏应用获取到帧属性后传递此参数。该参数中的相机矩阵通常用于优化渲染层降负载方案的画质效果。

**起始版本：** 5.0.0(12)

**相关模块：** [GraphicsAccelerate](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_graphics_accelerate)

**所在头文件：** [opengtx_base.h](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/opengtx__base_8h)

## 汇总

### 成员变量

|名称|描述|
|:---------------------------------------------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|[OpenGTX_Vector3](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_open_g_t_x___vector3) [mainCameraPosition](#maincameraposition)|主摄像头的位置。x、y、z的取值范围均为[-360, 360]，超出取值范围则该值不生效，并且返回[401](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal#section401-参数检查失败)错误码。单位：deg。|
|[OpenGTX_Vector3](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_open_g_t_x___vector3) [mainCameraRotate](#maincamerarotate)|主摄像头的转动，包括偏航、俯仰、侧滚。x、y、z的取值范围均为[-360, 360]，超出取值范围则该值不生效，并且返回[401](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal#section401-参数检查失败)错误码。单位：deg。|

## 结构体成员变量说明

### mainCameraPosition

```c
OpenGTX_Vector3 OpenGTX_FrameRenderInfo::mainCameraPosition
```

**描述**

主摄像头的位置。x、y、z的取值范围均为[-360, 360]，超出取值范围则该值不生效，并且返回[401](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal#section401-参数检查失败)错误码。单位：deg。

### mainCameraRotate

```c
OpenGTX_Vector3 OpenGTX_FrameRenderInfo::mainCameraRotate
```

**描述**

主摄像头的转动，包括偏航、俯仰、侧滚。x、y、z的取值范围均为[-360, 360]，超出取值范围则该值不生效，并且返回[401](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal#section401-参数检查失败)错误码。单位：deg。