1# Display (V1_2) 2 3 4## 概述 5 6显示模块驱动接口定义。 7 8提供给上层图形服务使用的驱动接口，包括图层管理、设备控制、显示内存管理等相关接口。 9 10**起始版本：** 5.0 11 12 13## 汇总 14 15 16### 文件 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [DisplayComposerType.idl](files_composer_display_v12_display_composer_type_8idl.md) | 显示合成类型定义，定义显示图层合成操作相关接口所使用的数据类型。 | 21| [IDisplayComposer.idl](files_composer_display_v12_i_display_composer_8idl.md) | 显示合成接口声明。 | 22| [IVBlankIdleCallback.idl](files_composer_display_v12_i_v_blank_idle_callback_8idl.md) | 帧同步事件回调接口声明。 | 23 24 25### 结构体 26 27| 名称 | 描述 | 28| -------- | -------- | 29| struct [PresentParam](annotated_composer_display_v12_present_param.md) | 定义显示参数。 | 30| interface [IDisplayComposer](annotated_composer_display_v12_interface_i_display_composer.md) | 显示合成接口声明。主要提供注册热插拔事件回调、获取显示设备能力集等功能，在v1_1.IDisplayComposer基础上新增注册更改VBlankIdle事件回调、清除缓冲区、硬光标特性等功能，具体方法使用详见函数说明。 | 31| interface [IVBlankIdleCallback](annotated_composer_display_v12_interface_i_v_blank_idle_callback.md) | 定义帧同步事件回调接口。 | 32 33 34### 枚举 35 36| 名称 | 描述 | 37| -------- | -------- | 38| [DispPowerStatus](#disppowerstatus) : ohos.hdi.display.composer.v1_1.DispPowerStatus {<br/>POWER_STATUS_PRE_ON = 5,<br/>POWER_STATUS_PRE_OFF = 6,<br/>POWER_STATUS_DOZE = 7,<br/>POWER_STATUS_DOZE_SUSPEND = 8,<br/>POWER_STATUS_BUTT_V1_2<br/>} | 定义电源状态。 | 39| [BufferUsage](#bufferusage) : ohos.hdi.display.composer.v1_0.BufferUsage {<br/>HBM_USE_CPU_HW_BOTH = (1ULL << 17), HBM_USAGE_GPU_PERFORMANCE = (1ULL << 18), HBM_USE_RGB_TO_YUV_CONVERSION = (1ULL << 19), HBM_USE_AUXILLARY_BUFFER0 = (1ULL << 20),<br/>HBM_USE_AUXILLARY_BUFFER1 = (1ULL << 21), HBM_USE_AUXILLARY_BUFFER2 = (1ULL << 22), HBM_USE_AUXILLARY_BUFFER3 = (1ULL << 23), HBM_USE_VIDEO_DEC_MV = HBM_USE_VIDEO_DECODER \| HBM_USE_AUXILLARY_BUFFER2,<br/>HBM_USE_DRM_REDRAW = (1ULL << 24)<br/>} | 定义缓冲区使用情况。 | 40| [PixelFormat](#pixelformat) : ohos.hdi.display.composer.v1_1.PixelFormat { PIXEL_FMT_RGBA16_FLOAT = 39 } | 像素格式类型定义。 | 41| [DispCmd](#dispcmd) : ohos.hdi.display.composer.v1_0.DispCmd {<br/>REQUEST_CMD_COMMIT_AND_GET_RELEASE_FENCE = 82, REQUEST_CMD_SET_DISPLAY_CONSTRAINT = 83, REQUEST_CMD_SET_LAYER_PERFRAME_PARAM = 84, REQUEST_CMD_BUTT_V1_2,<br/>REPLY_CMD_COMMIT_AND_GET_RELEASE_FENCE = 515, REPLY_CMD_BUTT_V1_2<br/>} | 枚举Display命令。 | 42| [DisplayPropertyID](#displaypropertyid) { DISPLAY_PROPERTY_ID_SKIP_VALIDATE = 1, DISPLAY_CAPBILITY_HARDWARE_CURSOR = 2, DISPLAY_PROPERTY_ID_ADAPTIVE_SYNC = 3 } | 定义显示属性ID。 | 43 44 45## 枚举类型说明 46 47 48### BufferUsage 49 50``` 51enum BufferUsage : ohos.hdi.display.composer.v1_0.BufferUsage 52``` 53 54**描述** 55 56定义缓冲区使用情况。 57 58**起始版本：** 5.0 59 60| 枚举值 | 描述 | 61| -------- | -------- | 62| HBM_USE_CPU_HW_BOTH | 支持CPU和硬件 | 63| HBM_USAGE_GPU_PERFORMANCE | 首选性能而不是内存消耗 | 64| HBM_USE_RGB_TO_YUV_CONVERSION | 用于识别RGB到YUV的转换 | 65| HBM_USE_AUXILLARY_BUFFER0 | 保留缓冲区BUFFER0 | 66| HBM_USE_AUXILLARY_BUFFER1 | 保留缓冲区BUFFER1 | 67| HBM_USE_AUXILLARY_BUFFER2 | 保留缓冲区BUFFER2 | 68| HBM_USE_AUXILLARY_BUFFER3 | 保留缓冲区BUFFER3 | 69| HBM_USE_VIDEO_DEC_MV | 支持音视频解码 | 70| HBM_USE_DRM_REDRAW | 对DRM重绘帧缓冲区分配 | 71 72 73### DispCmd 74 75``` 76enum DispCmd : ohos.hdi.display.composer.v1_0.DispCmd 77``` 78 79**描述** 80 81枚举Display命令。 82 83**起始版本：** 5.0 84 85| 枚举值 | 描述 | 86| -------- | -------- | 87| REQUEST_CMD_COMMIT_AND_GET_RELEASE_FENCE | 请求cmd提交并释放Fence句柄 | 88| REQUEST_CMD_SET_DISPLAY_CONSTRAINT | 请求cmd设置显示约束 | 89| REQUEST_CMD_SET_LAYER_PERFRAME_PARAM | 设置图层cmd | 90| REQUEST_CMD_BUTT_V1_2 | 请求按键cmd | 91| REPLY_CMD_COMMIT_AND_GET_RELEASE_FENCE | 回复cmd提交并释放Fence句柄 | 92| REPLY_CMD_BUTT_V1_2 | 回复cmd提交并释放Fence句柄 | 93 94 95### DisplayPropertyID 96 97``` 98enum DisplayPropertyID 99``` 100 101**描述** 102 103定义显示属性ID。 104 105**起始版本：** 5.0 106 107| 枚举值 | 描述 | 108| -------- | -------- | 109| DISPLAY_PROPERTY_ID_SKIP_VALIDATE | 表示跳过验证特性 | 110| DISPLAY_CAPBILITY_HARDWARE_CURSOR | 表示硬光标特性 | 111| DISPLAY_PROPERTY_ID_ADAPTIVE_SYNC | 表示是否支持 Adaptive Sync（提前显示） | 112 113 114### DispPowerStatus 115 116``` 117enum DispPowerStatus : ohos.hdi.display.composer.v1_1.DispPowerStatus 118``` 119 120**描述** 121 122定义电源状态。 123 124**起始版本：** 5.0 125 126| 枚举值 | 描述 | 127| -------- | -------- | 128| POWER_STATUS_PRE_ON | 进入预点亮屏幕状态 | 129| POWER_STATUS_PRE_OFF | 退出预点亮屏幕状态 | 130| POWER_STATUS_DOZE | 电源状态为DOZE（省电） | 131| POWER_STATUS_DOZE_SUSPEND | 电源状态为DOZE_SUSPEND（超级省电） | 132| POWER_STATUS_BUTT_V1_2 | 无效状态 | 133 134 135### PixelFormat 136 137``` 138enum PixelFormat : ohos.hdi.display.composer.v1_1.PixelFormat 139``` 140 141**描述** 142 143像素格式类型定义。 144 145**起始版本：** 5.0 146 147| 枚举值 | 描述 | 148| -------- | -------- | 149| PIXEL_FMT_RGBA16_FLOAT | RGBA16 float格式 | 150