1# Display(V1_0) 2 3 4## 概述 5 6显示模块驱动接口定义。 7 8提供给上层图形服务使用的驱动接口,包括图层管理、设备控制、显示内存管理等相关接口。 9 10**起始版本:** 3.2 11 12 13## 汇总 14 15 16### 文件 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [DisplayBufferType.idl](_display_buffer_type_8idl_v10.md) | 显示内存类型定义,定义显示内存操作相关接口所使用的数据类型。 | 21| [IAllocator.idl](_i_allocator_8idl_v10.md) | 显示内存分配接口声明。 | 22| [IMapper.idl](_i_mapper_8idl_v10.md) | 显示内存映射接口声明。 | 23| [DisplayComposerType.idl](_display_composer_type_8idl_v10.md) | 显示合成类型定义,定义显示图层合成操作相关接口所使用的数据类型。 | 24| [IDisplayComposer.idl](_i_display_composer_8idl_v10.md) | 显示合成接口声明。 | 25| [IHotPlugCallback.idl](_i_hot_plug_callback_8idl_v10.md) | 热插拔事件回调接口声明。 | 26| [IRefreshCallback.idl](_i_refresh_callback_8idl_v10.md) | 显示刷新事件回调接口声明。 | 27| [IVBlankCallback.idl](_i_v_blank_callback_8idl_v10.md) | 帧同步事件回调接口声明。 | 28 29 30### 类 31 32| 名称 | 描述 | 33| -------- | -------- | 34| struct [AllocInfo](_alloc_info_v10.md) | 定义待分配内存的信息。 | 35| struct [VerifyAllocInfo](_verify_alloc_info_v10.md) | 用于验证内存分配信息的结构体定义。 | 36| interface [IAllocator](interface_i_allocator_v10.md) | 定义显示内存分配接口。 | 37| interface [IMapper](interface_i_mapper_v10.md) | 定义释放显示内存接口。 | 38| struct [PropertyObject](_property_object_v10.md) | 定义包含名称、属性ID和值的属性对象。 | 39| struct [DisplayCapability](_display_capability_v10.md) | 定义输出性能。 | 40| struct [DisplayModeInfo](_display_mode_info_v10.md) | 定义输出模式信息。 | 41| struct [LayerInfo](_layer_info_v10.md) | Defines 定义图层信息结构体。 | 42| struct [LayerAlpha](_layer_alpha_v10.md) | 定义图层Alpha信息的结构体。 | 43| struct [IRect](_i_rect_v10.md) | 定义矩形框信息。 | 44| struct [ISurface](_i_surface_v10.md) | 用于存放窗口相关信息的结构体定义,提供给硬件加速使用,例如图像合成,位图搬移等操作。 | 45| struct [ILine](_i_line_v10.md) | 线条描述结构体定义,用于硬件加速绘制直线。 | 46| struct [ICircle](_i_circle_v10.md) | 圆形描述结构体定义,用于硬件加速绘制圆形。 | 47| struct [Rectangle](_rectangle_v10.md) | 矩形描述结构体定义,用于硬件加速绘制矩形, | 48| struct [GfxOpt](_gfx_opt_v10.md) | 图像硬件加速相关的操作选项结构体定义,用于图像硬件加速时的操作选项。 | 49| struct [HDRCapability](_h_d_r_capability_v10.md) | HDR属性结构体定义。 | 50| struct [HDRMetaData](_h_d_r_meta_data_v10.md) | HDR元数据结构体定义。 | 51| struct [PresentTimestamp](_present_timestamp_v10.md) | 上屏时间戳结构体定义。 | 52| struct [ExtDataHandle](_ext_data_handle_v10.md) | 扩展数据句柄结构体定义。 | 53| struct [YUVDescInfo](_y_u_v_desc_info_v10.md) | YUV描述信息结构体定义。 | 54| struct [HdifdInfo](_hdifd_info_v10.md) | 定义 hdi fd 信息结构体。 | 55| struct [LayerColor](_layer_color_v10.md) | 定义图层颜色设置的结构结构体。 | 56| interface [IDisplayComposer](interface_i_display_composer_v10.md) | 显示合成接口声明。 | 57| interface [IHotPlugCallback](interface_i_hot_plug_callback_v10.md) | 定义热插拔事件回调接口。 | 58| interface [IRefreshCallback](interface_i_refresh_callback_v10.md) | 定义显示刷新事件回调接口。 | 59| interface [IVBlankCallback](interface_i_v_blank_callback_v10.md) | 定义帧同步事件回调接口。 | 60 61 62### 枚举 63 64| 名称 | 描述 | 65| -------- | -------- | 66| [DispCmd](#dispcmd) {<br/>REQUEST_CMD_PREPARE_DISPLAY_LAYERS = 64 , REQUEST_CMD_SET_DISPLAY_CLIENT_BUFFER = 65 , REQUEST_CMD_SET_DISPLAY_CLIENT_DAMAGE = 66 , REQUEST_CMD_COMMIT = 67 ,<br/>REQUEST_CMD_SET_LAYER_ALPHA = 68 , REQUEST_CMD_SET_LAYER_REGION = 69 , REQUEST_CMD_SET_LAYER_CROP = 70 , REQUEST_CMD_SET_LAYER_ZORDER = 71 ,<br/>REQUEST_CMD_SET_LAYER_PREMULTI = 72 , REQUEST_CMD_SET_LAYER_TRANSFORM_MODE = 73 , REQUEST_CMD_SET_LAYER_DIRTY_REGION = 74 , REQUEST_CMD_SET_LAYER_VISIBLE_REGION = 75 ,<br/>REQUEST_CMD_SET_LAYER_BUFFER = 76 , REQUEST_CMD_SET_LAYER_COMPOSITION_TYPE = 77 , REQUEST_CMD_SET_LAYER_BLEND_TYPE = 78 , REQUEST_CMD_SET_LAYER_VISIBLE = 79 ,<br/>REQUEST_CMD_SET_LAYER_MASK_INFO = 80 , REQUEST_CMD_SET_LAYER_COLOR = 81 , REQUEST_CMD_BUTT , REPLY_CMD_SET_ERROR = 512 ,<br/>REPLY_CMD_PREPARE_DISPLAY_LAYERS = 513 , REPLY_CMD_COMMIT = 514 , REPLY_CMD_BUTT , CONTROL_CMD_REQUEST_BEGIN = 1024 ,<br/>CONTROL_CMD_REPLY_BEGIN = 1025 , CONTROL_CMD_REQUEST_END = 1026 , CONTROL_CMD_REPLY_END = 1027 , CONTROL_CMD_BUTT<br/>} | 枚举Display命令。 | 67| [DispErrCode](#disperrcode) {<br/>DISPLAY_SUCCESS = 0 , DISPLAY_FAILURE = -1 , DISPLAY_FD_ERR = -2 , DISPLAY_PARAM_ERR = -3 ,<br/>DISPLAY_NULL_PTR = -4 , DISPLAY_NOT_SUPPORT = -5 , DISPLAY_NOMEM = -6 , DISPLAY_SYS_BUSY = -7 , DISPLAY_NOT_PERM = -8<br/>} | 返回值类型定义。 | 68| [PixelFormat](#pixelformat) {<br/>PIXEL_FMT_CLUT8 = 0, PIXEL_FMT_CLUT1, PIXEL_FMT_CLUT4, PIXEL_FMT_RGB_565, PIXEL_FMT_RGBA_5658, PIXEL_FMT_RGBX_4444, PIXEL_FMT_RGBA_4444, PIXEL_FMT_RGB_444, PIXEL_FMT_RGBX_5551, PIXEL_FMT_RGBA_5551, PIXEL_FMT_RGB_555, PIXEL_FMT_RGBX_8888, PIXEL_FMT_RGBA_8888, PIXEL_FMT_RGB_888, PIXEL_FMT_BGR_565, PIXEL_FMT_BGRX_4444, PIXEL_FMT_BGRA_4444, PIXEL_FMT_BGRX_5551, PIXEL_FMT_BGRA_5551, PIXEL_FMT_BGRX_8888, PIXEL_FMT_BGRA_8888, PIXEL_FMT_YUV_422_I, PIXEL_FMT_YCBCR_422_SP, PIXEL_FMT_YCRCB_422_SP, PIXEL_FMT_YCBCR_420_SP, PIXEL_FMT_YCRCB_420_SP, PIXEL_FMT_YCBCR_422_P, PIXEL_FMT_YCRCB_422_P, PIXEL_FMT_YCBCR_420_P, PIXEL_FMT_YCRCB_420_P, PIXEL_FMT_YUYV_422_PKG, PIXEL_FMT_UYVY_422_PKG, PIXEL_FMT_YVYU_422_PKG, PIXEL_FMT_VYUY_422_PKG, PIXEL_FMT_VENDER_MASK = 0X7FFF0000, PIXEL_FMT_BUTT = 0X7FFFFFFF<br/>} | 像素格式类型定义。 | 69| [BufferUsage](#bufferusage) : unsigned long {<br/>HBM_USE_CPU_READ = (1ULL << 0) , HBM_USE_CPU_WRITE = (1ULL << 1) , HBM_USE_MEM_MMZ = (1ULL << 2) , HBM_USE_MEM_DMA = (1ULL << 3) ,<br/>HBM_USE_MEM_SHARE = (1ULL << 4) , HBM_USE_MEM_MMZ_CACHE = (1ULL << 5) , HBM_USE_MEM_FB = (1ULL << 6) , HBM_USE_ASSIGN_SIZE = (1ULL << 7) ,<br/>HBM_USE_HW_RENDER = (1ULL << 8) , HBM_USE_HW_TEXTURE = (1ULL << 9) , HBM_USE_HW_COMPOSER = (1ULL << 10) , HBM_USE_PROTECTED = (1ULL << 11) ,<br/>HBM_USE_CAMERA_READ = (1ULL << 12) , HBM_USE_CAMERA_WRITE = (1ULL << 13) , HBM_USE_VIDEO_ENCODER = (1ULL << 14) , HBM_USE_VIDEO_DECODER = (1ULL << 15) ,<br/>HBM_USE_CPU_READ_OFTEN = (1ULL << 16) , HBM_USE_VENDOR_PRI0 = (1ULL << 44) , HBM_USE_VENDOR_PRI1 = (1ULL << 45) , HBM_USE_VENDOR_PRI2 = (1ULL << 46) ,<br/>HBM_USE_VENDOR_PRI3 = (1ULL << 47) , HBM_USE_VENDOR_PRI4 = (1ULL << 48) , HBM_USE_VENDOR_PRI5 = (1ULL << 49) , HBM_USE_VENDOR_PRI6 = (1ULL << 50) ,<br/>HBM_USE_VENDOR_PRI7 = (1ULL << 51) , HBM_USE_VENDOR_PRI8 = (1ULL << 52) , HBM_USE_VENDOR_PRI9 = (1ULL << 53) , HBM_USE_VENDOR_PRI10 = (1ULL << 54) ,<br/>HBM_USE_VENDOR_PRI11 = (1ULL << 55) , HBM_USE_VENDOR_PRI12 = (1ULL << 56) , HBM_USE_VENDOR_PRI13 = (1ULL << 57) , HBM_USE_VENDOR_PRI14 = (1ULL << 58) ,<br/>HBM_USE_VENDOR_PRI15 = (1ULL << 59) , HBM_USE_VENDOR_PRI16 = (1ULL << 60) , HBM_USE_VENDOR_PRI17 = (1ULL << 61) , HBM_USE_VENDOR_PRI18 = (1ULL << 62) ,<br/>HBM_USE_VENDOR_PRI19 = (1ULL << 63)<br/>} | 定义缓冲区使用情况。 | 70| [TransformType](#transformtype) {<br/>ROTATE_NONE = 0, ROTATE_90, ROTATE_180, ROTATE_270 ,<br/>MIRROR_H , MIRROR_V , MIRROR_H_ROTATE_90 , MIRROR_V_ROTATE_90 ,<br/>ROTATE_BUTT<br/>} | 枚举图像的转换类型。 | 71| [DispPowerStatus](#disppowerstatus) {<br/>POWER_STATUS_ON = 0 , POWER_STATUS_STANDBY = 1 , POWER_STATUS_SUSPEND = 2 , POWER_STATUS_OFF = 3 ,<br/>POWER_STATUS_BUTT<br/>} | 枚举显示状态。 | 72| [CompositionType](#compositiontype) {<br/>COMPOSITION_CLIENT, COMPOSITION_DEVICE, COMPOSITION_CURSOR, COMPOSITION_VIDEO, COMPOSITION_DEVICE_CLEAR, COMPOSITION_CLIENT_CLEAR, COMPOSITION_TUNNEL, COMPOSITION_BUTT<br/>} | 枚举特殊层的组合类型。 | 73| [LayerType](#layertype) {<br/>LAYER_TYPE_GRAPHIC, LAYER_TYPE_OVERLAY, LAYER_TYPE_SDIEBAND, LAYER_TYPE_CURSOR, LAYER_TYPE_BUTT<br/>} | 图层类型定义。 | 74| [BlendType](#blendtype) {<br/>BLEND_NONE = 0, BLEND_CLEAR, BLEND_SRC, BLEND_SRCOVER, BLEND_DSTOVER, BLEND_SRCIN, BLEND_DSTIN, BLEND_SRCOUT, BLEND_DSTOUT, BLEND_SRCATOP, BLEND_DSTATOP, BLEND_ADD, BLEND_XOR, BLEND_DST, BLEND_AKS, BLEND_AKD, BLEND_BUTT<br/>} | 支持的图像混合类型。 | 75| [RopType](#roptype) {<br/>ROP_BLACK = 0, ROP_NOTMERGEPEN, ROP_MASKNOTPEN, ROP_NOTCOPYPEN, ROP_MASKPENNOT, ROP_NOT, ROP_XORPEN, ROP_NOTMASKPEN, ROP_MASKPEN, ROP_NOTXORPEN, ROP_NOP, ROP_MERGENOTPEN, ROP_COPYPE, ROP_MERGEPENNOT, ROP_MERGEPEN, ROP_WHITE, ROP_BUTT<br/>} | 硬件加速支持的ROP操作类型。 | 76| [ColorKey](#colorkey) { CKEY_NONE = 0 , CKEY_SRC , CKEY_DST , CKEY_BUTT } | Colorkey操作类型定义,即硬件加速支持的Colorkey操作类型。 | 77| [MirrorType](#mirrortype) { MIRROR_NONE = 0 , MIRROR_LR , MIRROR_TB , MIRROR_BUTT } | 硬件加速支持的镜像操作类型定义。 | 78| [Connection](#connection) { CON_INVALID = 0 , CONNECTED , DISCONNECTED } | 热插拔连接类型定义。 | 79| [InterfaceType](#interfacetype) {<br/>DISP_INTF_HDMI = 0, DISP_INTF_LCD, DISP_INTF_BT1120, DISP_INTF_BT656, DISP_INTF_YPBPR, DISP_INTF_RGB, DISP_INTF_CVBS, DISP_INTF_SVIDEO, DISP_INTF_VGA, DISP_INTF_MIPI, DISP_INTF_PANEL, DISP_INTF_BUTT<br/>} | 显示接口类型。 | 80| [ColorGamut](#colorgamut) {<br/>COLOR_GAMUT_INVALID = -1, COLOR_GAMUT_NATIVE = 0, COLOR_GAMUT_SATNDARD_BT601 = 1, COLOR_GAMUT_STANDARD_BT709 = 2, COLOR_GAMUT_DCI_P3 = 3, COLOR_GAMUT_SRGB = 4, COLOR_GAMUT_ADOBE_RGB = 5, COLOR_GAMUT_DISPLAY_P3 = 6, COLOR_GAMUT_BT2020 = 7, COLOR_GAMUT_BT2100_PQ = 8, COLOR_GAMUT_BT2100_HLG = 9, COLOR_GAMUT_DISPLAY_BT2020 = 10<br/>} | 色域类型枚举值。 | 81| [GamutMap](#gamutmap) { GAMUT_MAP_CONSTANT = 0, GAMUT_MAP_EXPANSION = 1, GAMUT_MAP_HDR_CONSTANT = 2, GAMUT_MAP_HDR_EXPANSION = 3 } | 枚举色域的映射类型。 | 82| [ColorDataSpace](#colordataspace) {<br/>COLOR_DATA_SPACE_UNKNOWN = 0, GAMUT_BT601 = 0x00000001, GAMUT_BT709 = 0x00000002, GAMUT_DCI_P3 = 0x00000003, GAMUT_SRGB = 0x00000004, GAMUT_ADOBE_RGB = 0x00000005, GAMUT_DISPLAY_P3 = 0x00000006, GAMUT_BT2020 = 0x00000007, GAMUT_BT2100_PQ = 0x00000008, GAMUT_BT2100_HLG = 0x00000009, GAMUT_DISPLAY_BT2020 = 0x0000000a, TRANSFORM_FUNC_UNSPECIFIED = 0x00000100, TRANSFORM_FUNC_LINEAR = 0x00000200, TRANSFORM_FUNC_SRGB = 0x00000300, TRANSFORM_FUNC_SMPTE_170M = 0x00000400, TRANSFORM_FUNC_GM2_2 = 0x00000500, TRANSFORM_FUNC_GM2_6 = 0x00000600, TRANSFORM_FUNC_GM2_8 = 0x00000700, TRANSFORM_FUNC_ST2084 = 0x00000800, TRANSFORM_FUNC_HLG = 0x00000900, PRECISION_UNSPECIFIED = 0x00010000, PRECISION_FULL = 0x00020000, PRESION_LIMITED = 0x00030000, PRESION_EXTENDED = 0x00040000, BT601_SMPTE170M_FULL = 1 \| 1024 \| 131072 , BT601_SMPTE170M_LIMITED = 1 \| 1024 \| 196608 , BT709_LINEAR_FULL = 2 \| 512 \| 131072 , BT709_LINEAR_EXTENDED = 2 \| 512 \| 262144 , BT709_SRGB_FULL = 2 \| 768 \| 131072 , BT709_SRGB_EXTENDED = 2 \| 768 \| 262144 , BT709_SMPTE170M_LIMITED = 2 \| 1024 \| 196608 , DCI_P3_LINEAR_FULL = 3 \| 512 \| 131072 , DCI_P3_GAMMA26_FULL = 3 \| 1536 \| 131072 , DISPLAY_P3_LINEAR_FULL = 6 \| 512 \| 131072 , DCI_P3_SRGB_FULL = 3 \| 768 \| 131072 , ADOBE_RGB_GAMMA22_FULL = 5 \| 1280 \| 131072 , BT2020_LINEAR_FULL = 7 \| 512 \| 131072 , BT2020_SRGB_FULL = 7 \| 768 \| 131072 , BT2020_SMPTE170M_FULL = 7 \| 1024 \| 131072 , BT2020_ST2084_FULL = 7 \| 2048 \| 131072 , BT2020_HLG_FULL = 7 \| 2304 \| 131072 , BT2020_ST2084_LIMITED = 7 \| 2048 \| 196608<br/>} | 枚举颜色空间的类型。 | 83| [HDRFormat](#hdrformat) {<br/>NOT_SUPPORT_HDR = 0, DOLBY_VISION = 1, HDR10 = 2, HLG = 3, HDR10_PLUS = 4, HDR_VIVID = 5<br/>} | 枚举HDR格式。 | 84| [HDRMetadataKey](#hdrmetadatakey) {<br/>MATAKEY_RED_PRIMARY_X = 0, MATAKEY_RED_PRIMARY_Y = 1, MATAKEY_GREEN_PRIMARY_X = 2, MATAKEY_GREEN_PRIMARY_Y = 3, MATAKEY_BLUE_PRIMARY_X = 4, MATAKEY_BLUE_PRIMARY_Y = 5, MATAKEY_WHITE_PRIMARY_X = 6, MATAKEY_WHITE_PRIMARY_Y = 7, MATAKEY_MAX_LUMINANCE = 8, MATAKEY_MIN_LUMINANCE = 9, MATAKEY_MAX_CONTENT_LIGHT_LEVEL = 10, MATAKEY_MAX_FRAME_AVERAGE_LIGHT_LEVEL = 11, MATAKEY_HDR10_PLUS = 12, MATAKEY_HDR_VIVID = 13<br/>} | 枚举HDR元数据关键字。 | 85| [PresentTimestampType](#presenttimestamptype) { HARDWARE_DISPLAY_PTS_UNSUPPORTED = 0, HARDWARE_DISPLAY_PTS_DELAY = 1 << 0, HARDWARE_DISPLAY_PTS_TIMESTAMP = 1 << 1 } | 上屏时间戳类型枚举值。 | 86| [MaskInfo](#maskinfo) { LAYER_NORAML = 0 , LAYER_HBM_SYNC = 1 } | 图层蒙版枚举值。 | 87 88 89## 枚举类型说明 90 91 92### BlendType 93 94``` 95enum BlendType 96``` 97 98**描述** 99 100支持的图像混合类型。 101 102系统在硬件加速期间基于指定的混合类型合成图像。 103 104**起始版本:** 3.2 105 106| 枚举值 | 描述 | 107| -------- | -------- | 108| BLEND_NONE | No 混合操作 | 109| BLEND_CLEAR | CLEAR 混合操作 | 110| BLEND_SRC | SRC 混合操作 | 111| BLEND_SRCOVER | SRC_OVER 混合操作 | 112| BLEND_DSTOVER | DST_OVER 混合操作 | 113| BLEND_SRCIN | SRC_IN 混合操作 | 114| BLEND_DSTIN | DST_IN 混合操作 | 115| BLEND_SRCOUT | SRC_OUT 混合操作 | 116| BLEND_DSTOUT | DST_OUT 混合操作 | 117| BLEND_SRCATOP | SRC_ATOP 混合操作 | 118| BLEND_DSTATOP | DST_ATOP 混合操作 | 119| BLEND_ADD | ADD 混合操作 | 120| BLEND_XOR | XOR 混合操作 | 121| BLEND_DST | DST 混合操作 | 122| BLEND_AKS | AKS 混合操作 | 123| BLEND_AKD | AKD 混合操作 | 124| BLEND_BUTT | 空操作 | 125 126 127### BufferUsage 128 129``` 130enum BufferUsage : unsigned long 131``` 132 133**描述** 134 135定义缓冲区使用情况。 136 137**起始版本:** 3.2 138 139| 枚举值 | 描述 | 140| -------- | -------- | 141| HBM_USE_CPU_READ | CPU 读取内存 | 142| HBM_USE_CPU_WRITE | CPU 写入内存 | 143| HBM_USE_MEM_MMZ | 媒体内存区 (MMZ) | 144| HBM_USE_MEM_DMA | 直接内存访问 (DMA) 内存区 | 145| HBM_USE_MEM_SHARE | 共享内存内存区 | 146| HBM_USE_MEM_MMZ_CACHE | 存在缓存的 MMZ | 147| HBM_USE_MEM_FB | 帧内存 | 148| HBM_USE_ASSIGN_SIZE | 分配内存 | 149| HBM_USE_HW_RENDER | 写入GPU内存情况 | 150| HBM_USE_HW_TEXTURE | 读取GPU内存情况 | 151| HBM_USE_HW_COMPOSER | 硬件编写情况 | 152| HBM_USE_PROTECTED | 安全缓冲区情况,例如 DRM | 153| HBM_USE_CAMERA_READ | 读取相机情况 | 154| HBM_USE_CAMERA_WRITE | 写入相机情况 | 155| HBM_USE_VIDEO_ENCODER | 编码情况 | 156| HBM_USE_VIDEO_DECODER | 解码情况 | 157| HBM_USE_CPU_READ_OFTEN | HBM 经常使用 CPU 读取情况 | 158| HBM_USE_VENDOR_PRI0 | 为供应商提供 | 159| HBM_USE_VENDOR_PRI1 | 为供应商提供 | 160| HBM_USE_VENDOR_PRI2 | 为供应商提供 | 161| HBM_USE_VENDOR_PRI3 | 为供应商提供 | 162| HBM_USE_VENDOR_PRI4 | 为供应商提供 | 163| HBM_USE_VENDOR_PRI5 | 为供应商提供 | 164| HBM_USE_VENDOR_PRI6 | 为供应商提供 | 165| HBM_USE_VENDOR_PRI7 | 为供应商提供 | 166| HBM_USE_VENDOR_PRI8 | 为供应商提供 | 167| HBM_USE_VENDOR_PRI9 | 为供应商提供 | 168| HBM_USE_VENDOR_PRI10 | 为供应商提供 | 169| HBM_USE_VENDOR_PRI11 | 为供应商提供 | 170| HBM_USE_VENDOR_PRI12 | 为供应商提供 | 171| HBM_USE_VENDOR_PRI13 | 为供应商提供 | 172| HBM_USE_VENDOR_PRI14 | 为供应商提供 | 173| HBM_USE_VENDOR_PRI15 | 为供应商提供 | 174| HBM_USE_VENDOR_PRI16 | 为供应商提供 | 175| HBM_USE_VENDOR_PRI17 | 为供应商提供 | 176| HBM_USE_VENDOR_PRI18 | 为供应商提供 | 177| HBM_USE_VENDOR_PRI19 | 为供应商提供 | 178 179 180### ColorDataSpace 181 182``` 183enum ColorDataSpace 184``` 185 186**描述** 187 188枚举颜色空间的类型。 189 190**起始版本:** 3.2 191 192| 枚举值 | 描述 | 193| -------- | -------- | 194| COLOR_DATA_SPACE_UNKNOWN | 未知的 | 195| GAMUT_BT601 | BT601色域 | 196| GAMUT_BT709 | BT709色域 | 197| GAMUT_DCI_P3 | DCI_P3色域 | 198| GAMUT_SRGB | SRGB色域 | 199| GAMUT_ADOBE_RGB | ADOBE_RGB色域 | 200| GAMUT_DISPLAY_P3 | DISPLAY_P3色域 | 201| GAMUT_BT2020 | BT2020色域 | 202| GAMUT_BT2100_PQ | BT2100_PQ色域 | 203| GAMUT_BT2100_HLG | BT2100_HLG色域 | 204| GAMUT_DISPLAY_BT2020 | DISPLAY_BT2020色域 | 205| TRANSFORM_FUNC_UNSPECIFIED | UNSPECIFIED转换函数 | 206| TRANSFORM_FUNC_LINEAR | LINEAR转换函数 | 207| TRANSFORM_FUNC_SRGB | SRGB转换函数 | 208| TRANSFORM_FUNC_SMPTE_170M | SMPTE_170M转换函数 | 209| TRANSFORM_FUNC_GM2_2 | GM2_2转换函数 | 210| TRANSFORM_FUNC_GM2_6 | GM2_6转换函数 | 211| TRANSFORM_FUNC_GM2_8 | GM2_8转换函数 | 212| TRANSFORM_FUNC_ST2084 | ST2084转换函数 | 213| TRANSFORM_FUNC_HLG | HLG转换函数 | 214| PRECISION_UNSPECIFIED | UNSPECIFIED精度 | 215| PRECISION_FULL | FULL精度 | 216| PRESION_LIMITED | LIMITED精度 | 217| PRESION_EXTENDED | EXTENDED精度 | 218| BT601_SMPTE170M_FULL | BT601色域 \| SMPTE_170M转换函数 \| FULL精度 | 219| BT601_SMPTE170M_LIMITED | BT601色域 \| SMPTE_170M转换函数 \| LIMITED精度 | 220| BT709_LINEAR_FULL | BT709色域 \| LINEAR转换函数 \| FULL精度 | 221| BT709_LINEAR_EXTENDED | BT709色域 \| LINEAR转换函数 \| EXTENDED精度 | 222| BT709_SRGB_FULL | BT709色域 \| SRGB转换函数 \| FULL精度 | 223| BT709_SRGB_EXTENDED | BT709色域 \| SRGB转换函数 \| EXTENDED精度 | 224| BT709_SMPTE170M_LIMITED | BT709色域 \| SMPTE_170M转换函数 \| LIMITED精度 | 225| DCI_P3_LINEAR_FULL | DCI_P3色域 \| LINEAR转换函数 \| FULL精度 | 226| DCI_P3_GAMMA26_FULL | DCI_P3色域 \| GM2_6转换函数 \| FULL精度 | 227| DISPLAY_P3_LINEAR_FULL | DISPLAY_P3色域 \| LINEAR转换函数 \| FULL精度 | 228| DCI_P3_SRGB_FULL | DCI_P3色域 \| SRGB转换函数 \| FULL精度 | 229| ADOBE_RGB_GAMMA22_FULL | ADOBE_RGB色域 \| GM2_2转换函数 \| FULL精度 | 230| BT2020_LINEAR_FULL | BT2020色域 \| LINEAR转换函数 \| FULL精度 | 231| BT2020_SRGB_FULL | BT2020色域 \| SRGB转换函数 \| FULL精度 | 232| BT2020_SMPTE170M_FULL | BT2020色域 \| SMPTE_170M转换函数 \| FULL精度 | 233| BT2020_ST2084_FULL | BT2020色域 \| ST2084转换函数 \| FULL精度 | 234| BT2020_HLG_FULL | BT2020色域 \| HLG转换函数 \| FULL精度 | 235| BT2020_ST2084_LIMITED | BT2020色域 \| ST2084转换函数 \| LIMITED精度 | 236 237 238### ColorGamut 239 240``` 241enum ColorGamut 242``` 243 244**描述** 245 246色域类型枚举值。 247 248**起始版本:** 3.2 249 250| 枚举值 | 描述 | 251| -------- | -------- | 252| COLOR_GAMUT_INVALID | 无效值 | 253| COLOR_GAMUT_NATIVE | 默认值 | 254| COLOR_GAMUT_STANDARD_BT601 | Standard BT601类型 | 255| COLOR_GAMUT_STANDARD_BT709 | Standard BT709类型 | 256| COLOR_GAMUT_DCI_P3 | DCI P3类型 | 257| COLOR_GAMUT_SRGB | SRGB类型 | 258| COLOR_GAMUT_ADOBE_RGB | Adobe RGB类型 | 259| COLOR_GAMUT_DISPLAY_P3 | display P3类型 | 260| COLOR_GAMUT_BT2020 | BT2020类型 | 261| COLOR_GAMUT_BT2100_PQ | BT2100 PQ类型 | 262| COLOR_GAMUT_BT2100_HLG | BT2100 HLG类型 | 263| COLOR_GAMUT_DISPLAY_BT2020 | Display BT2020类型 | 264 265 266### ColorKey 267 268``` 269enum ColorKey 270``` 271 272**描述** 273 274Colorkey操作类型定义,即硬件加速支持的Colorkey操作类型。 275 276**起始版本:** 3.2 277 278| 枚举值 | 描述 | 279| -------- | -------- | 280| CKEY_NONE | 不使用Colorkey | 281| CKEY_SRC | 使用源Colorkey | 282| CKEY_DST | 使用目标Colorkey | 283| CKEY_BUTT | 空操作 | 284 285 286### CompositionType 287 288``` 289enum CompositionType 290``` 291 292**描述** 293 294枚举特殊层的组合类型。 295 296**起始版本:** 3.2 297 298| 枚举值 | 描述 | 299| -------- | -------- | 300| COMPOSITION_CLIENT | Client 合成类型,使用CPU或者GPU合成。 | 301| COMPOSITION_DEVICE | Device 合成类型,使用Device合成。 | 302| COMPOSITION_CURSOR | Cursor合成类型,用于光标合成。 | 303| COMPOSITION_VIDEO | Video合成类型,用于视频层合成。 | 304| COMPOSITION_DEVICE_CLEAR | Device清除合成类型, 用于清楚Device | 305| COMPOSITION_CLIENT_CLEAR | Client清除合成类型, 用于清除Client | 306| COMPOSITION_TUNNEL | Tunnel合成类型, 用于tunnel合成. | 307| COMPOSITION_BUTT | 合成类型, 一个不可用类型,用于默认初始化。 | 308 309 310### Connection 311 312``` 313enum Connection 314``` 315 316**描述** 317 318热插拔连接类型定义。 319 320**起始版本:** 3.2 321 322| 枚举值 | 描述 | 323| -------- | -------- | 324| CON_INVALID | 无效类型 | 325| CONNECTED | 已连接 | 326| DISCONNECTED | 断开连接 | 327 328 329### DispCmd 330 331``` 332enum DispCmd 333``` 334 335**描述** 336 337枚举Display命令。 338 339**起始版本:** 3.2 340 341| 枚举值 | 描述 | 342| -------- | -------- | 343| REQUEST_CMD_PREPARE_DISPLAY_LAYERS | 请求 CMD 准备显示图层 | 344| REQUEST_CMD_SET_DISPLAY_CLIENT_BUFFER | 请求 CMD 设置显示客户端缓冲区 | 345| REQUEST_CMD_SET_DISPLAY_CLIENT_DAMAGE | 请求 CMD 设置显示客户端损坏 | 346| REQUEST_CMD_COMMIT | 请求 CMD 提交 | 347| REQUEST_CMD_SET_LAYER_ALPHA | 请求 CMD 设置图层 ALPHA | 348| REQUEST_CMD_SET_LAYER_REGION | 请求 CMD 设置图层区域 | 349| REQUEST_CMD_SET_LAYER_CROP | 请求 CMD 设置图层裁剪 | 350| REQUEST_CMD_SET_LAYER_ZORDER | 请求 CMD 设置图层ZORDER | 351| REQUEST_CMD_SET_LAYER_PREMULTI | 请求 CMD 设置图层PREMULTI | 352| REQUEST_CMD_SET_LAYER_TRANSFORM_MODE | 请求 CMD 设置图层变换模式 | 353| REQUEST_CMD_SET_LAYER_DIRTY_REGION | 请求 CMD 设置图层脏区 | 354| REQUEST_CMD_SET_LAYER_VISIBLE_REGION | 请求 CMD 设置图层可见区域 | 355| REQUEST_CMD_SET_LAYER_BUFFER | 请求 CMD 设置图层缓冲区 | 356| REQUEST_CMD_SET_LAYER_COMPOSITION_TYPE | 请求 CMD 设置图层成分类型 | 357| REQUEST_CMD_SET_LAYER_BLEND_TYPE | 请求 CMD 设置图层混合类型 | 358| REQUEST_CMD_SET_LAYER_VISIBLE | 请求 CMD 设置图层可见 | 359| REQUEST_CMD_SET_LAYER_MASK_INFO | 请求 CMD 设置图层掩码信息 | 360| REQUEST_CMD_SET_LAYER_COLOR | 请求 CMD 设置图层颜色 | 361| REQUEST_CMD_BUTT | 请求 CMD 对接 | 362| REPLY_CMD_SET_ERROR | 回复 CMD 设置错误 | 363| REPLY_CMD_PREPARE_DISPLAY_LAYERS | 回复 CMD 准备显示图层 | 364| REPLY_CMD_COMMIT | 回复 CMD 提交 | 365| REPLY_CMD_BUTT | 回复 CMD 对接 | 366| CONTROL_CMD_REQUEST_BEGIN | 控制 CMD 请求开始 | 367| CONTROL_CMD_REPLY_BEGIN | 控制 CMD 回复开始 | 368| CONTROL_CMD_REQUEST_END | 控制 CMD 请求结束 | 369| CONTROL_CMD_REPLY_END | 控制 CMD 回复结束 | 370| CONTROL_CMD_BUTT | 控制 CMD 对接 | 371 372 373### DispErrCode 374 375``` 376enum DispErrCode 377``` 378 379**描述** 380 381返回值类型定义。 382 383**起始版本:** 3.2 384 385| 枚举值 | 描述 | 386| -------- | -------- | 387| DISPLAY_SUCCESS | 成功 | 388| DISPLAY_FAILURE | 失败 | 389| DISPLAY_FD_ERR | Fd错误 | 390| DISPLAY_PARAM_ERR | 参数错误 | 391| DISPLAY_NULL_PTR | 空指针 | 392| DISPLAY_NOT_SUPPORT | 不支持的特性 | 393| DISPLAY_NOMEM | 内存不足 | 394| DISPLAY_SYS_BUSY | 系统繁忙 | 395| DISPLAY_NOT_PERM | 操作不允许 | 396 397 398### DispPowerStatus 399 400``` 401enum DispPowerStatus 402``` 403 404**描述** 405 406枚举显示状态。 407 408**起始版本:** 3.2 409 410| 枚举值 | 描述 | 411| -------- | -------- | 412| POWER_STATUS_ON | 上电模式 | 413| POWER_STATUS_STANDBY | 待机模式 | 414| POWER_STATUS_SUSPEND | 休眠模式 | 415| POWER_STATUS_OFF | 下电模式 | 416| POWER_STATUS_BUTT | 默认模式 | 417 418 419### GamutMap 420 421``` 422enum GamutMap 423``` 424 425**描述** 426 427枚举色域的映射类型。 428 429**起始版本:** 3.2 430 431| 枚举值 | 描述 | 432| -------- | -------- | 433| GAMUT_MAP_CONSTANT | 不变 | 434| GAMUT_MAP_EXPANSION | 映射增强 | 435| GAMUT_MAP_HDR_CONSTANT | 不变,用于HDR。 | 436| GAMUT_MAP_HDR_EXPANSION | 映射增强,用于HDR。 | 437 438 439### HDRFormat 440 441``` 442enum HDRFormat 443``` 444 445**描述** 446 447枚举HDR格式。 448 449**起始版本:** 3.2 450 451| 枚举值 | 描述 | 452| -------- | -------- | 453| NOT_SUPPORT_HDR | 不支持HDR | 454| DOLBY_VISION | Dolby Vision格式 | 455| HDR10 | HDR10格式 | 456| HLG | HLG格式 | 457| HDR10_PLUS | HDR10 Plus格式 | 458| HDR_VIVID | Vivid格式 | 459 460 461### HDRMetadataKey 462 463``` 464enum HDRMetadataKey 465``` 466 467**描述** 468 469枚举HDR元数据关键字。 470 471**起始版本:** 3.2 472 473| 枚举值 | 描述 | 474| -------- | -------- | 475| MATAKEY_RED_PRIMARY_X | 红基色X坐标 | 476| MATAKEY_RED_PRIMARY_Y | 红基色Y坐标 | 477| MATAKEY_GREEN_PRIMARY_X | 绿基色X坐标 | 478| MATAKEY_GREEN_PRIMARY_Y | 绿基色Y坐标 | 479| MATAKEY_BLUE_PRIMARY_X | 蓝基色X坐标 | 480| MATAKEY_BLUE_PRIMARY_Y | 蓝基色Y坐标 | 481| MATAKEY_WHITE_PRIMARY_X | 白点X坐标 | 482| MATAKEY_WHITE_PRIMARY_Y | 白点Y坐标 | 483| MATAKEY_MAX_LUMINANCE | 最大的光亮度 | 484| MATAKEY_MIN_LUMINANCE | 最小的光亮度 | 485| MATAKEY_MAX_CONTENT_LIGHT_LEVEL | 最大的内容亮度水平 | 486| MATAKEY_MAX_FRAME_AVERAGE_LIGHT_LEVEL | 最大的帧平均亮度水平 | 487| MATAKEY_HDR10_PLUS | HDR10 Plus | 488| MATAKEY_HDR_VIVID | Vivid | 489 490 491### InterfaceType 492 493``` 494enum InterfaceType 495``` 496 497**描述** 498 499显示接口类型。 500 501**起始版本:** 3.2 502 503| 枚举值 | 描述 | 504| -------- | -------- | 505| DISP_INTF_HDMI | HDMI 接口 | 506| DISP_INTF_LCD | LCD 接口 | 507| DISP_INTF_BT1120 | BT1120 接口 | 508| DISP_INTF_BT656 | BT656 接口 | 509| DISP_INTF_YPBPR | YPBPR 接口 | 510| DISP_INTF_RGB | RGB 接口 | 511| DISP_INTF_CVBS | CVBS 接口 | 512| DISP_INTF_SVIDEO | SVIDEO 接口 | 513| DISP_INTF_VGA | VGA 接口 | 514| DISP_INTF_MIPI | MIPI 接口 | 515| DISP_INTF_PANEL | PANEL 接口 | 516| DISP_INTF_BUTT | BUTT 接口, 一个不可用类型, 用于默认初始化。 | 517 518 519### LayerType 520 521``` 522enum LayerType 523``` 524 525**描述** 526 527图层类型定义。 528 529**起始版本:** 3.2 530 531| 枚举值 | 描述 | 532| -------- | -------- | 533| LAYER_TYPE_GRAPHIC | 图形层 | 534| LAYER_TYPE_OVERLAY | 视频层 | 535| LAYER_TYPE_SDIEBAND | 媒体播放 | 536| LAYER_TYPE_CURSOR | 光标层 | 537| LAYER_TYPE_BUTT | 空图层 | 538 539 540### MaskInfo 541 542``` 543enum MaskInfo 544``` 545 546**描述** 547 548图层蒙版枚举值。 549 550**起始版本:** 3.2 551 552| 枚举值 | 描述 | 553| -------- | -------- | 554| LAYER_NORAML | | 555| LAYER_HBM_SYNC | | 556 557 558### MirrorType 559 560``` 561enum MirrorType 562``` 563 564**描述** 565 566硬件加速支持的镜像操作类型定义。 567 568**起始版本:** 3.2 569 570| 枚举值 | 描述 | 571| -------- | -------- | 572| MIRROR_NONE | 不使用镜像 | 573| MIRROR_LR | 左右镜像 | 574| MIRROR_TB | 上下镜像 | 575| MIRROR_BUTT | 空操作 | 576 577 578### PixelFormat 579 580``` 581enum PixelFormat 582``` 583 584**描述** 585 586像素格式类型定义。 587 588**起始版本:** 3.2 589 590| 枚举值 | 描述 | 591| -------- | -------- | 592| PIXEL_FMT_CLUT8 | CLUT8 格式 | 593| PIXEL_FMT_CLUT1 | CLUT1 格式 | 594| PIXEL_FMT_CLUT4 | CLUT4 格式 | 595| PIXEL_FMT_RGB_565 | RGB565 格式 | 596| PIXEL_FMT_RGBA_5658 | RGBA5658 格式 | 597| PIXEL_FMT_RGBX_4444 | RGBX4444 格式 | 598| PIXEL_FMT_RGBA_4444 | RGBA4444 格式 | 599| PIXEL_FMT_RGB_444 | RGB444 格式 | 600| PIXEL_FMT_RGBX_5551 | RGBX5551 格式 | 601| PIXEL_FMT_RGBA_5551 | RGBA5551 格式 | 602| PIXEL_FMT_RGB_555 | RGB555 格式 | 603| PIXEL_FMT_RGBX_8888 | RGBX8888 格式 | 604| PIXEL_FMT_RGBA_8888 | RGBA8888 格式 | 605| PIXEL_FMT_RGB_888 | RGB888 格式 | 606| PIXEL_FMT_BGR_565 | BGR565 格式 | 607| PIXEL_FMT_BGRX_4444 | BGRX4444 格式 | 608| PIXEL_FMT_BGRA_4444 | BGRA4444 格式 | 609| PIXEL_FMT_BGRX_5551 | BGRX5551 格式 | 610| PIXEL_FMT_BGRA_5551 | BGRA5551 格式 | 611| PIXEL_FMT_BGRX_8888 | BGRX8888 格式 | 612| PIXEL_FMT_BGRA_8888 | BGRA8888 格式 | 613| PIXEL_FMT_YUV_422_I | YUV422 交错格式 | 614| PIXEL_FMT_YCBCR_422_SP | YCBCR422 半平面格式 | 615| PIXEL_FMT_YCRCB_422_SP | YCRCB422 半平面格式 | 616| PIXEL_FMT_YCBCR_420_SP | YCBCR420 半平面格式 | 617| PIXEL_FMT_YCRCB_420_SP | YCRCB420 半平面格式 | 618| PIXEL_FMT_YCBCR_422_P | YCBCR422 平面格式 | 619| PIXEL_FMT_YCRCB_422_P | YCRCB422 平面格式 | 620| PIXEL_FMT_YCBCR_420_P | YCBCR420 平面格式 | 621| PIXEL_FMT_YCRCB_420_P | YCRCB420 平面格式 | 622| PIXEL_FMT_YUYV_422_PKG | YUYV422 平面格式 | 623| PIXEL_FMT_UYVY_422_PKG | UYVY422 平面格式 | 624| PIXEL_FMT_YVYU_422_PKG | YVYU422 平面格式 | 625| PIXEL_FMT_VYUY_422_PKG | VYUY422 平面格式 | 626| PIXEL_FMT_RGBA_1010102 | RGBA_1010102 供应商格式 | 627| PIXEL_FMT_VENDER_MASK | 供应商掩码 格式 | 628| PIXEL_FMT_BUTT | Invalid 像素格式 | 629 630 631### PresentTimestampType 632 633``` 634enum PresentTimestampType 635``` 636 637**描述** 638 639上屏时间戳类型枚举值。 640 641**起始版本:** 3.2 642 643| 枚举值 | 描述 | 644| -------- | -------- | 645| HARDWARE_DISPLAY_PTS_UNSUPPORTED | 不支持 | 646| HARDWARE_DISPLAY_PTS_DELAY | 时延类型 | 647| HARDWARE_DISPLAY_PTS_TIMESTAMP | 时间戳类型 | 648 649 650### RopType 651 652``` 653enum RopType 654``` 655 656**描述** 657 658硬件加速支持的ROP操作类型。 659 660硬件加速支持的ROP操作类型,在将前景位图的RGB颜色分量和Alpha分量值与背景位图的RGB颜色 分量值和Alpha分量值进行按位的布尔运算(包括按位与,按位或等),将结果输出。 661 662**起始版本:** 3.2 663 664| 枚举值 | 描述 | 665| -------- | -------- | 666| ROP_BLACK | 黑色 | 667| ROP_NOTMERGEPEN | ~(S2+S1) | 668| ROP_MASKNOTPEN | ~S2&S1 | 669| ROP_NOTCOPYPEN | ~S2 | 670| ROP_MASKPENNOT | S2&~S1 | 671| ROP_NOT | ~S1 | 672| ROP_XORPEN | S2^S1 | 673| ROP_NOTMASKPEN | ~(S2&S1) | 674| ROP_MASKPEN | S2&S1 | 675| ROP_NOTXORPEN | ~(S2^S1) | 676| ROP_NOP | S1 | 677| ROP_MERGENOTPEN | ~S2+S1 | 678| ROP_COPYPE | S2 | 679| ROP_MERGEPENNOT | S2+~S1 | 680| ROP_MERGEPEN | S2+S1 | 681| ROP_WHITE | 白色 | 682| ROP_BUTT | 无效值 | 683 684 685### TransformType 686 687``` 688enum TransformType 689``` 690 691**描述** 692 693枚举图像的转换类型。 694 695**起始版本:** 3.2 696 697| 枚举值 | 描述 | 698| -------- | -------- | 699| ROTATE_NONE | 不旋转 | 700| ROTATE_90 | 旋转90度 | 701| ROTATE_180 | 旋转180度 | 702| ROTATE_270 | 旋转270度 | 703| MIRROR_H | 水平方向镜像转换 | 704| MIRROR_V | 垂直方向镜像转换 | 705| MIRROR_H_ROTATE_90 | 水平方向镜像转换, 旋转90度 | 706| MIRROR_V_ROTATE_90 | 垂直方向镜像转换, 旋转90度 | 707| ROTATE_BUTT | 无效操作 | 708