Display

概述

显示模块驱动接口定义。

提供给图形系统使用的驱动接口，包括图层管理、设备控制、图形硬件加速、显示内存管理和回调接口等。

Since:

1.0

Version:

2.0

汇总

文件

名称	描述
display_device.h	显示设备控制接口声明。
display_gfx.h	显示硬件加速驱动接口声明。
display_gralloc.h	显示内存驱动接口声明。
display_layer.h	显示图层驱动接口声明。
display_type.h	显示类型定义，定义显示驱动接口所使用的数据类型。
display_vgu.h	该文件定义2D矢量硬件加速模块相关驱动函数。

类

名称	描述
DeviceFuncs	struct 显示设备控制接口结构体，定义显示设备控制接口函数指针。
ExtDataHandle	struct 扩展数据句柄结构体定义。
GfxFuncs	struct 显示硬件加速驱动接口结构体，定义硬件加速驱动接口函数指针。
GrallocFuncs	struct 显示内存驱动接口结构体，定义显示内存驱动接口函数指针。
LayerFuncs	struct 显示图层驱动接口结构体，定义显示图层驱动接口函数指针。
DisplayInfo	struct 定义显示信息结构体
LayerInfo	struct 定义图层信息结构体
LayerAlpha	struct 定义图层Alpha信息的结构体
BufferData	struct 定义一层的缓冲区数据，包括虚拟和物理内存地址。
LayerBuffer	struct 图层Buffer，用于存放图层数据。
IRect	struct 定义矩形信息
ISurface	struct 用于存放窗口相关信息的结构体定义，提供给硬件加速使用，例如图像合成，位图搬移等操作。
ILine	struct 线条描述结构体定义，用于硬件加速绘制直线。
ICircle	struct 圆形描述结构体定义，用于硬件加速绘制圆形。
Rectangle	struct 矩形描述结构体定义，用于硬件加速绘制矩形。
GfxOpt	struct 图像硬件加速相关的操作选项结构体定义，用于图像硬件加速时的操作选项。
PropertyObject	struct 定义包含名称、属性ID和值的属性对象。
DisplayCapability	struct 定义输出性能。
DisplayModeInfo	struct 定义输出模式信息。
AllocInfo	struct 定义关于要分配的内存的信息。
HDRCapability	struct HDR属性结构体定义
HDRMetaData	struct HDR元数据结构体定义
VerifyAllocInfo	struct 用于验证内存分配信息的结构体定义
PresentTimestamp	struct 上屏时间戳结构体定义
VGUPoint	struct 坐标点对象。
VGURect	struct 矩形对象。
VGUPath	struct 路径对象，存放路径命令和坐标数据。
VGUMatrix3	struct 变换矩阵。
VGUBuffer	struct 硬件加速渲染位图缓存。
VGUMaskLayer	struct 定义蒙版图层。
VGUSurface	struct 2D硬件加速绘制目标表面。
VGUColorStop	struct 渐变颜色分布位置。
VGULinear	struct 线性渐变。
VGURadial	struct 辐射渐变。
VGUConic	struct 圆锥渐变。
VGUImage	struct 图像对象。
VGUPattern	struct 图片模式对象。
VGUGradient	struct 渐变对象。
VGUSolid	struct 颜色对象
VGUPaintStyle	struct 填充或描边路径的渲染风格。
VGUFillAttr	struct 填充路径的属性。
VGUStrokeAttr	struct 描边路径的属性。
VGUFuncs	struct 定义2D硬件加速驱动函数。
YUVDescInfo	struct YUV描述信息结构体定义

宏定义

名称	描述
PROPERTY_NAME_LEN   50	属性名字长度。
HDI_VGU_SCALAR_IS_FLOAT   1	VGU标量是否为浮点型。

类型定义

名称	描述
(* HotPlugCallback) (uint32_t devId, bool connected, void *data)	typedef void 热插拔事件回调
(* VBlankCallback) (unsigned int sequence, uint64_t ns, void *data)	typedef void VBlank事件回调。
(* RefreshCallback) (uint32_t devId, void *data)	typedef void 刷新请求回调
VGUScalar	typedef float VGU标量。
VGUPixelFormat	typedef PixelFormat 像素格式。
VGUBlendType	typedef BlendType 混合操作类型。

枚举

名称	描述
DispErrCode { DISPLAY_SUCCESS = 0, DISPLAY_FAILURE = -1, DISPLAY_FD_ERR = -2, DISPLAY_PARAM_ERR = -3,   DISPLAY_NULL_PTR = -4, DISPLAY_NOT_SUPPORT = -5, DISPLAY_NOMEM = -6, DISPLAY_SYS_BUSY = -7,   DISPLAY_NOT_PERM = -8 }	返回值类型定义。
LayerType { LAYER_TYPE_GRAPHIC, LAYER_TYPE_OVERLAY, LAYER_TYPE_SDIEBAND, LAYER_TYPE_CURSOR, LAYER_TYPE_BUTT }	图层类型定义。
{ HBM_USE_CPU_READ = (1 << 0), HBM_USE_CPU_WRITE = (1 << 1), HBM_USE_MEM_MMZ = (1 << 2), HBM_USE_MEM_DMA = (1 << 3),   HBM_USE_MEM_SHARE = (1 << 4), HBM_USE_MEM_MMZ_CACHE = (1 << 5), HBM_USE_MEM_FB = (1 << 6), HBM_USE_ASSIGN_SIZE = (1 << 7) }	定义缓冲区使用。
PixelFormat { 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 }	像素格式类型定义。
TransformType { ROTATE_NONE = 0, ROTATE_90, ROTATE_180, ROTATE_270, ROTATE_BUTT }	图层变换类型定义。
BlendType { 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 }	支持的图像混合类型。
RopType { 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 }	硬件加速支持的ROP操作类型。
ColorKey { CKEY_NONE = 0, CKEY_SRC, CKEY_DST, CKEY_BUTT }	Color key操作类型定义，即硬件加速支持的Color key操作类型。
MirrorType { MIRROR_NONE = 0, MIRROR_LR, MIRROR_TB, MIRROR_BUTT }	硬件加速支持的镜像操作类型定义
Connection { CON_INVALID = 0, CONNECTED, DISCONNECTED }	热插拔连接类型定义
InterfaceType { 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 }	枚举接口类型。
DispPowerStatus { POWER_STATUS_ON, POWER_STATUS_STANDBY, POWER_STATUS_SUSPEND, POWER_STATUS_OFF,   POWER_STATUS_BUTT }	枚举显示状态
CompositionType { COMPOSITION_CLIENT, COMPOSITION_DEVICE, COMPOSITION_CURSOR, COMPOSITION_VIDEO,   COMPOSITION_DEVICE_CLEAR, COMPOSITION_CLIENT_CLEAR, COMPOSITION_TUNNEL, COMPOSITION_BUTT }	枚举特殊层的组合类型。
ColorGamut { 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 }	色域类型枚举值
GamutMap { GAMUT_MAP_CONSTANT = 0, GAMUT_MAP_EXPANSION = 1, GAMUT_MAP_HDR_CONSTANT = 2, GAMUT_MAP_HDR_EXPANSION = 3 }	枚举色域的映射类型
ColorDataSpace { 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 = GAMUT_BT601 | TRANSFORM_FUNC_SMPTE_170M | PRECISION_FULL, BT601_SMPTE170M_LIMITED = GAMUT_BT601 | TRANSFORM_FUNC_SMPTE_170M | PRESION_LIMITED, BT709_LINEAR_FULL = GAMUT_BT709 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, BT709_LINEAR_EXTENDED = GAMUT_BT709 | TRANSFORM_FUNC_LINEAR | PRESION_EXTENDED,   BT709_SRGB_FULL = GAMUT_BT709 | TRANSFORM_FUNC_SRGB | PRECISION_FULL, BT709_SRGB_EXTENDED = GAMUT_BT709 | TRANSFORM_FUNC_SRGB | PRESION_EXTENDED, BT709_SMPTE170M_LIMITED = GAMUT_BT709 | TRANSFORM_FUNC_SMPTE_170M | PRESION_LIMITED, DCI_P3_LINEAR_FULL = GAMUT_DCI_P3 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL,   DCI_P3_GAMMA26_FULL = GAMUT_DCI_P3 | TRANSFORM_FUNC_GM2_6 | PRECISION_FULL, DISPLAY_P3_LINEAR_FULL = GAMUT_DISPLAY_P3 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, DCI_P3_SRGB_FULL = GAMUT_DCI_P3 | TRANSFORM_FUNC_SRGB | PRECISION_FULL, ADOBE_RGB_GAMMA22_FULL = GAMUT_ADOBE_RGB | TRANSFORM_FUNC_GM2_2 | PRECISION_FULL,   BT2020_LINEAR_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, BT2020_SRGB_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_SRGB | PRECISION_FULL, BT2020_SMPTE170M_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_SMPTE_170M | PRECISION_FULL, BT2020_ST2084_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_ST2084 | PRECISION_FULL,   BT2020_HLG_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_HLG | PRECISION_FULL, BT2020_ST2084_LIMITED = GAMUT_BT2020 | TRANSFORM_FUNC_ST2084 | PRESION_LIMITED }	枚举颜色空间的类型
HDRFormat { NOT_SUPPORT_HDR = 0, DOLBY_VISION = 1, HDR10 = 2, HLG = 3,   HDR10_PLUS = 4, HDR_VIVID = 5 }	枚举HDR格式
HDRMetadataKey { 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 }	枚举HDR元数据关键字
PresentTimestampType { HARDWARE_DISPLAY_PTS_UNSUPPORTED = 0, HARDWARE_DISPLAY_PTS_DELAY = 1 << 0, HARDWARE_DISPLAY_PTS_TIMESTAMP = 1 << 1 }	上屏时间戳类型枚举值
VGUPathDataType { VGU_DATA_TYPE_S16 = 0, VGU_DATA_TYPE_S32, VGU_DATA_TYPE_F32 }	路径坐标数据类型。
VGUCapability { VGU_CAP_BLIT = (1 << 0), VGU_CAP_BLIT_NUM = (1 << 1), VGU_CAP_PATH = (1 << 2), VGU_CAP_FILTER_BLUR = (1 << 3) }	硬件加速能力。
VGUResult { VGU_SUCCESS = 0, VGU_NO_SUPPORT = -1, VGU_OPERATION_FAILED = -2, VGU_OUT_OF_MEMORY = -3,   VGU_TIMEOUT = -4, VGU_INVALID_PARAMETER = -5, VGU_BUSY = -6, VGU_NO_CONTEXT = -7 }	错误码定义。
VGULineCap { VGU_LINECAP_BUTT = 0, VGU_LINECAP_ROUND, VGU_LINECAP_SQUARE }	线帽。
VGUJointType { VGU_LINE_JOIN_MITER = 0, VGU_LINE_JOIN_ROUND, VGU_LINE_JOIN_BEVEL, VGU_LINE_JOIN_BUTT }	联接类型。
VGUFilter { VGU_FILTER_BILINEAR = 0, VGU_FILTER_NEAREST, VGU_FILTER_LINEAR, VGU_FILTER_BUTT }	图像滤波类型。
VGUFillRule { VGU_RULE_WINDING = 0, VGU_RULE_EVEN_ODD, VGU_RULE_BUTT }	填充规则定义。
VGUFillSpread { VGU_SPREAD_PAD = 0, VGU_SPREAD_REFLECT, VGU_SPREAD_REPEAT, VGU_SPREAD_BUTT }	渐变填充区域外的延展类型。
VGUWrapType { VGU_WRAP_REFLECT = 0, VGU_WRAP_REPEAT, VGU_WRAP_BUTT }	图像模式填充延展类型。
VGUPathCmd { VGU_PATH_CMD_CLOSE = 0, VGU_PATH_CMD_MOVE, VGU_PATH_CMD_LINE, VGU_PATH_CMD_HLINE,   VGU_PATH_CMD_VLINE, VGU_PATH_CMD_QUAD, VGU_PATH_CMD_CUBIC, VGU_PATH_CMD_SQUAD,   VGU_PATH_CMD_SCUBIC, VGU_PATH_CMD_BUTT }	路径绘制指令类型。
VGUTransformType { VGU_TRANSFORM_TRANSLATE = (1 << 0), VGU_TRANSFORM_SCALE = (1 << 1), VGU_TRANSFORM_ROTATE_90 = (1 << 2), VGU_TRANSFORM_ROTATE_180 = (1 << 3),   VGU_TRANSFORM_ROTATE_270 = (1 << 4), VGU_TRANSFORM_OTHER = (1 << 16) }	变换类型。
VGUClipType { VGU_CLIP_RECT = 0, VGU_CLIP_PATH, VGU_CLIP_BUTT }	绘制表面剪切类型。
VGUGradientType { VGU_GRADIENT_LINEAR = 0, VGU_GRADIENT_RADIAL, VGU_GRADIENT_CONIC, VGU_GRADIENT_BUTT }	渐变类型。
VGUPaintType { VGU_PAINT_SOLID = 0, VGU_PAINT_GRADIENT, VGU_PAINT_PATTERN, VGU_PAINT_BUTT }	渲染对象

函数

名称	描述
DeviceInitialize (DeviceFuncs **funcs)	int32_t 实现显示设备控制接口的初始化，申请操作显示设备控制接口的资源，并获取对应的操作接口。
DeviceUninitialize (DeviceFuncs *funcs)	int32_t 取消显示设备控制接口的初始化，释放控制接口使用到的资源。
GfxInitialize (GfxFuncs **funcs)	int32_t 获取硬件加速相关的操作接口指针。
GfxUninitialize (GfxFuncs *funcs)	int32_t 释放硬件加速相关的操作接口指针。
GrallocInitialize (GrallocFuncs **funcs)	int32_t 初始化内存模块，并获取内存提供的操作接口。
GrallocUninitialize (GrallocFuncs *funcs)	int32_t 取消初始化内存模块，并释放内存操作接口指针。
LayerInitialize (LayerFuncs **funcs)	int32_t 实现图层初始化功能，申请图层使用的资源，并获取图层提供的操作接口。
LayerUninitialize (LayerFuncs *funcs)	int32_t 取消图层初始化功能，释放图层使用到的资源，并释放图层操作接口指针。
VGUPathInit (VGUPath *path, VGUPathDataType type, const uint8_t *segments, int numSegments, const uint8_t *data, bool enAlias, VGURect boundBox)	VGUResult 初始化路径对象。
VGUPathAppend (VGUPath *path, const VGUPath *subpath)	VGUResult 添加子路径到当前路径中。
VGUPathClear (VGUPath *path)	VGUResult 清除路径对象内存。
VGUMatrixIdentity (VGUMatrix3 *matrix)	VGUResult 初始化矩阵对象为单位矩阵。
VGUMatrixScale (VGUMatrix3 *matrix, float xScale, float yScale)	VGUResult 矩阵变换缩放。
VGUMatrixRotate (VGUMatrix3 *matrix, float degree)	VGUResult 矩阵变换旋转。
VGUMatrixTranslate (VGUMatrix3 *matrix, float x, float y)	VGUResult 矩阵变换平移。
VGUGradientColorStop (VGUGradient *gradient, const VGUColorStop *colorStop, uint32_t count)	VGUResult 对渐变添加ColorStop。
VGUGradientClearStop (VGUGradient *gradient)	VGUResult 清除ColorStop。
VGUGradientMatrix (VGUGradient *gradient, const VGUMatrix3 *matrix)	VGUResult 设置渐变对象的变换矩阵。
VGUGradientLinear (VGUGradient *gradient, const VGUPoint *p1, const VGUPoint *p2)	VGUResult 创建线性渐变对象。
VGUGradientRadial (VGUGradient *gradient, const VGUPoint *p1, VGUScalar r1, const VGUPoint *p2, VGUScalar r2)	VGUResult 创建辐射渐变对象
VGUGradientConic (VGUGradient *gradient, VGUScalar cx, VGUScalar cy)	VGUResult 创建圆锥渐变对象。
VGUInitialize (VGUFuncs **funcs)	VGUResult 获取硬件加速相关的操作接口指针。
VGUUninitialize (VGUFuncs *funcs)	VGUResult 去初始化硬件加速模块，同时释放硬件加速模块操作函数指针。

变量

名称	描述
(* DeviceFuncs::RegHotPlugCallback )(HotPlugCallback callback, void *data)	int32_t 注册热插拔事件回调。
(* DeviceFuncs::RegDisplayVBlankCallback )(uint32_t devId, VBlankCallback callback, void *data)	int32_t 注册VBlank事件回调。
(* DeviceFuncs::RegDisplayRefreshCallback )(uint32_t devId, RefreshCallback callback, void *data)	int32_t 刷新请求回调。
(* DeviceFuncs::GetDisplayCapability )(uint32_t devId, DisplayCapability *info)	int32_t 获取显示设备能力集。
(* DeviceFuncs::GetDisplaySupportedModes )(uint32_t devId, uint32_t *num, DisplayModeInfo *modes)	int32_t 获取显示设备支持的显示模式信息。
(* DeviceFuncs::GetDisplayMode )(uint32_t devId, uint32_t *modeId)	int32_t 获取显示设备当前的显示模式。
(* DeviceFuncs::SetDisplayMode )(uint32_t devId, uint32_t modeId)	int32_t 设置显示设备的显示模式。
(* DeviceFuncs::GetDisplayPowerStatus )(uint32_t devId, DispPowerStatus *status)	int32_t 获取显示设备当前的电源状态。
(* DeviceFuncs::SetDisplayPowerStatus )(uint32_t devId, DispPowerStatus status)	int32_t 设置显示设备当前的电源状态。
(* DeviceFuncs::GetDisplayBacklight )(uint32_t devId, uint32_t *level)	int32_t 获取显示设备当前的背光值。
(* DeviceFuncs::SetDisplayBacklight )(uint32_t devId, uint32_t level)	int32_t 设置显示设备当前的背光值。
(* DeviceFuncs::GetDisplayProperty )(uint32_t devId, uint32_t id, uint64_t *value)	int32_t 获取显示设备属性值。
(* DeviceFuncs::SetDisplayProperty )(uint32_t devId, uint32_t id, uint64_t value)	int32_t 设置显示设备属性值。
(* DeviceFuncs::PrepareDisplayLayers )(uint32_t devId, bool *needFlushFb)	int32_t 显示设备合成前准备。
(* DeviceFuncs::GetDisplayCompChange )(uint32_t devId, uint32_t *num, uint32_t *Layers, int32_t *type)	int32_t 获取显示设备合成类型有变化的layer。
(* DeviceFuncs::SetDisplayClientCrop )(uint32_t devId, IRect *rect)	int32_t 设置显示设备的裁剪区域。
(* DeviceFuncs::SetDisplayClientDestRect )(uint32_t devId, IRect *rect)	int32_t 设置显示设备的显示区域。
(* DeviceFuncs::SetDisplayClientBuffer )(uint32_t devId, const BufferHandle *buffer, int32_t fence)	int32_t 设置显示设备的显示缓存。
(* DeviceFuncs::SetDisplayClientDamage )(uint32_t devId, uint32_t num, IRect *rect)	int32_t 设置显示设备的显示脏区。
(* DeviceFuncs::SetDisplayVsyncEnabled )(uint32_t devId, bool enabled)	int32_t 使能垂直同步信号。
(* DeviceFuncs::GetDisplayReleaseFence )(uint32_t devId, uint32_t *num, uint32_t *layers, int32_t *fences)	int32_t 获取显示图层fence。
(* DeviceFuncs::GetDisplaySupportedColorGamuts )(uint32_t devId, uint32_t *num, ColorGamut *gamuts)	int32_t 获取显示设备支持的色域信息。
(* DeviceFuncs::GetDisplayColorGamut )(uint32_t devId, ColorGamut *gamut)	int32_t 获取显示设备当前的色域模式。
(* DeviceFuncs::SetDisplayColorGamut )(uint32_t devId, ColorGamut gamut)	int32_t 设置显示设备当前的色域模式。
(* DeviceFuncs::GetDisplayGamutMap )(uint32_t devId, GamutMap *gamutMap)	int32_t 获取显示设备当前的色域映射模式。
(* DeviceFuncs::SetDisplayGamutMap )(uint32_t devId, GamutMap gamutMap)	int32_t 设置显示设备当前的色域映射模式。
(* DeviceFuncs::SetDisplayColorTransform )(uint32_t devId, const float *matrix)	int32_t 设置显示设备当前的4x4的颜色转换矩阵。
(* DeviceFuncs::GetHDRCapabilityInfos )(uint32_t devId, HDRCapability *info)	int32_t 获取显示设备支持的HDR属性信息。
(* DeviceFuncs::GetSupportedMetadataKey )(uint32_t devId, uint32_t *num, HDRMetadataKey *keys)	int32_t 获取显示设备支持的HDRMetadataKey。
(* DeviceFuncs::Commit )(uint32_t devId, int32_t *fence)	int32_t 提交合成送显请求。
(* DeviceFuncs::InvokeDisplayCmd )(uint32_t devId,…)	int32_t 调用显示设备命令。
(* DeviceFuncs::CreateVirtualDisplay )(uint32_t width, uint32_t height, int32_t *format, uint32_t *devId)	int32_t 创建虚拟显示设备。
(* DeviceFuncs::DestroyVirtualDisplay )(uint32_t devId)	int32_t 销毁虚拟显示设备。
(* DeviceFuncs::SetVirtualDisplayBuffer )(uint32_t devId, BufferHandle *buffer, int32_t fence)	int32_t 设置虚拟屏的输出缓存。
(* DeviceFuncs::GetWriteBackFrame )(uint32_t devId, BufferHandle *buffer, int32_t *fence)	int32_t 获取显示设备的回写帧。
DisplayInfo::width	uint32_t 显示屏宽度
DisplayInfo::height	uint32_t 显示屏高度
DisplayInfo::rotAngle	int32_t 显示屏旋转角度
LayerInfo::width	int32_t 图层宽度
LayerInfo::height	int32_t 图层高度
LayerInfo::type	LayerType 图层类型，包括图形层、视频层和媒体播放模式
LayerInfo::bpp	int32_t 每像素所占bit数
LayerInfo::pixFormat	PixelFormat 图层像素格式
LayerAlpha::enGlobalAlpha	bool 全局alpha使能标志
LayerAlpha::enPixelAlpha	bool 像素alpha使能标志
LayerAlpha::alpha0	uint8_t alpha0值，取值范围：[0, 255]
LayerAlpha::alpha1	uint8_t alpha1值，取值范围：[0, 255]
LayerAlpha::gAlpha	uint8_t 全局alpha值，取值范围：[0, 255]
BufferData::phyAddr	uint64_t 物理内存地址
BufferData::virAddr	void * 虚拟内存地址
LayerBuffer::fenceId	int32_t buffer的fence号
LayerBuffer::width	int32_t buffer宽度
LayerBuffer::height	int32_t buffer高度
LayerBuffer::pitch	int32_t 一行数据所占字节数
LayerBuffer::pixFormat	PixelFormat buffer像素格式r
LayerBuffer::data	BufferData 图层buffer数据
LayerBuffer::hdl	BufferHandle * 图层buffer句柄
IRect::x	int32_t 矩形框起始x坐标
IRect::y	int32_t 矩形框起始y坐标
IRect::w	int32_t 矩形框宽度
IRect::h	int32_t 矩形框高度
ISurface::phyAddr	uint64_t 图像首地址
ISurface::height	int32_t 图像高度
ISurface::width	int32_t 图像宽度
ISurface::stride	int32_t 图像跨度
ISurface::enColorFmt	PixelFormat 图像格式
ISurface::bYCbCrClut	bool CLUT表是否位于 YCbCr 空间
ISurface::bAlphaMax255	bool 图像alpha最大值为255还是128
ISurface::bAlphaExt1555	bool 是否使能1555的Alpha扩展
ISurface::alpha0	uint8_t Alpha0值，取值范围：[0,255]
ISurface::alpha1	uint8_t Alpha1值，取值范围：[0,255]
ISurface::cbcrPhyAddr	uint64_t CbCr分量地址
ISurface::cbcrStride	int32_t CbCr分量跨度
ISurface::clutPhyAddr	uint64_t Clut表首地址，用作颜色扩展或颜色校正
ILine::x0	int32_t 线条起点的x坐标
ILine::y0	int32_t 线条起点的y坐标
ILine::x1	int32_t 线条终点的x坐标
ILine::y1	int32_t 线条终点的y坐标
ILine::color	uint32_t 线条颜色
ICircle::x	int32_t 圆心x坐标
ICircle::y	int32_t 圆心y坐标r
ICircle::r	int32_t 圆的半径
ICircle::color	uint32_t 圆的颜色
Rectangle::rect	IRect 矩形区域
Rectangle::color	uint32_t 矩形颜色
GfxOpt::enGlobalAlpha	bool 全局alpha使能位
GfxOpt::globalAlpha	uint32_t 全局alpha的值
GfxOpt::enPixelAlpha	bool 像素alpha使能位
GfxOpt::blendType	BlendType 混合方式
GfxOpt::colorKeyFrom	ColorKey 色键模式
GfxOpt::enableRop	bool Rop功能使能位
GfxOpt::colorRopType	RopType 颜色的Rop类型
GfxOpt::alphaRopType	RopType Alpha的Rop类型
GfxOpt::enableScale	bool 缩放功能使能位
GfxOpt::rotateType	TransformType 旋转类型
GfxOpt::mirrorType	MirrorType 镜像类型
PropertyObject::name [PROPERTY_NAME_LEN]	char 属性名称
PropertyObject::propId	uint32_t 属性ID
PropertyObject::value	uint64_t 属性值
DisplayCapability::name [PROPERTY_NAME_LEN]	char 显示设备名称
DisplayCapability::type	InterfaceType 显示屏接口类型
DisplayCapability::phyWidth	uint32_t 物理宽度
DisplayCapability::phyHeight	uint32_t 物理高度
DisplayCapability::supportLayers	uint32_t 支持的图层数
DisplayCapability::virtualDispCount	uint32_t 支持的虚拟屏数
DisplayCapability::supportWriteBack	bool 是否支持回写
DisplayCapability::propertyCount	uint32_t 属性数组大小
DisplayCapability::props	PropertyObject * 属性数组
DisplayModeInfo::width	int32_t 像素宽度
DisplayModeInfo::height	int32_t 像素高度
DisplayModeInfo::freshRate	uint32_t 刷新速率
DisplayModeInfo::id	int32_t 模式ID
AllocInfo::width	uint32_t 申请内存宽度
AllocInfo::height	uint32_t 申请内存高度
AllocInfo::usage	uint64_t 申请内存的使用场景
AllocInfo::format	PixelFormat 申请内存格式
AllocInfo::expectedSize	uint32_t 申请内存大小
HDRCapability::formatCount	uint32_t 支持的HDR格式的数量
HDRCapability::formats	HDRFormat * 支持的HDR格式的数组首地址
HDRCapability::maxLum	float 最大的光亮度luminance值
HDRCapability::maxAverageLum	float 最大的平均光亮度luminance值
HDRCapability::minLum	float 最小的光亮度luminance值
HDRMetaData::key	HDRMetadataKey HDR元数据关键字
HDRMetaData::value	float 关键字对应的值
VerifyAllocInfo::width	uint32_t 分配内存的宽度
VerifyAllocInfo::height	uint32_t 分配内存的高度
VerifyAllocInfo::usage	uint64_t 内存的用处
VerifyAllocInfo::format	PixelFormat 分配内存的像素格式
PresentTimestamp::type	PresentTimestampType 上屏时间戳类型
PresentTimestamp::time	int64_t 类型对应的值
ExtDataHandle::fd	int32_t 句柄 fd, -1代表不支持
ExtDataHandle::reserveInts	uint32_t reserve数组的个数
ExtDataHandle::reserve[0]	int32_t reserve数组
YUVDescInfo::baseAddr	void * 内存的初始地址
YUVDescInfo::yOffset	size_t Y的偏移量
YUVDescInfo::uOffset	size_t U的偏移量
YUVDescInfo::vOffset	size_t V的偏移量
YUVDescInfo::yStride	size_t Y的stride信息
YUVDescInfo::uvStride	size_t UV的stride信息
YUVDescInfo::uvStep	size_t UV的step信息
VGUPoint::x	VGUScalar 点水平坐标
VGUPoint::y	VGUScalar 点垂直坐标
VGURect::x	VGUScalar 矩形水平起始坐标
VGURect::y	VGUScalar 矩形垂直起始坐标
VGURect::w	VGUScalar 矩形宽度
VGURect::h	VGUScalar 矩形高度
VGUPath::segment	uint8_t * 存放路径命令数据
VGUPath::numSegments	int32_t 路径命令总数
VGUPath::data	uint8_t * 存放路径命令对应坐标数据
VGUPath::type	VGUPathDataType 路径数据存储类型
VGUPath::enAlias	bool 抗锯齿开关
VGUPath::boundBox	VGURect 路径最大边界
VGUMatrix3::m [3][3]	float 3x3变换矩阵
VGUMatrix3::type	uint32_t 矩阵变换类型，简单变换为缩放，平移，90度倍数旋转
VGUBuffer::pixelFormat	VGUPixelFormat 像素格式
VGUBuffer::width	uint32_t 位图宽度
VGUBuffer::height	uint32_t 位图高度
VGUBuffer::stride	uint32_t 位图stride
VGUBuffer::virAddr	void * 位图缓存的虚拟地址
VGUBuffer::phyAddr	uint64_t 位图缓存的物理地址
VGUMaskLayer::buffer	VGUBuffer * 蒙版缓存
VGUMaskLayer::rect	VGURect * 蒙版矩形
VGUSurface::buffer	VGUBuffer * 位图缓存
VGUSurface::clipRect	VGURect * 矩形剪切域，如果为空，整个表面直接渲染。
VGUSurface::clipPath	VGUPath * 路径剪切域，如果为空，整个表面直接渲染。
VGUSurface::clipType	VGUClipType 表面剪切类型
VGUSurface::mask	VGUMaskLayer * 蒙版图层, 可以为空
VGUSurface::blend	VGUBlendType 混合叠加模式
VGUSurface::filter	VGUFilter 图像滤波类型
VGUColorStop::stop	float 颜色偏移位置，值范围是 0.0 ~ 1.0
VGUColorStop::color	uint32_t 偏移位置对应颜色
VGULinear::x1	VGUScalar 线性渐变起点水平坐标
VGULinear::y1	VGUScalar 线性渐变起点垂直坐标
VGULinear::x2	VGUScalar 线性渐变终点水平坐标
VGULinear::y2	VGUScalar 线性渐变终点垂直坐标
VGURadial::x0	VGUScalar 内圈圆心水平坐标
VGURadial::y0	VGUScalar 内圈圆心垂直坐标
VGURadial::r0	VGUScalar 内圈圆半径
VGURadial::x1	VGUScalar 外圈圆心水平坐标
VGURadial::y1	VGUScalar 外圈圆心垂直坐标
VGURadial::r1	VGUScalar 外圈圆半径
VGUConic::cx	VGUScalar 圆弧中心x坐标
VGUConic::cy	VGUScalar 圆弧中心y坐标
VGUImage::buffer	VGUBuffer * 图像存储缓存
VGUImage::matrix	VGUMatrix3 * 图像矩阵变换，该参数为空，则内部使用单位变换矩阵
VGUImage::rect	VGURect * 图像截取矩形，该参数为空，则截取整个图像
VGUImage::opacity	uint8_t 透明度，范围0~255
VGUPattern::image	VGUImage * 图像对象
VGUPattern::wrapx	VGUWrapType 图像水平方向平铺类型
VGUPattern::wrapy	VGUWrapType 图像垂直方向平铺类型
VGUGradient::matrix	VGUMatrix3 * 针对渐变对象的变换矩阵
VGUGradient::colorStops	VGUColorStop * 渐变停止颜色数组指针
VGUGradient::stopCount	uint16_t 渐变停止颜色个数
VGUGradient::linear	VGULinear 线性渐变对象
VGUGradient::radial	VGURadial 辐射渐变对象
VGUGradient::conic	VGUConic 圆锥渐变对象
VGUGradient::type	VGUGradientType 渐变类型
VGUGradient::spread	VGUFillSpread 渐变延伸模式
VGUGradient::opacity	uint8_t 透明度，范围0~255
VGUSolid::color	uint32_t 颜色值
VGUSolid::opacity	uint8_t 透明度. 值范围 0 ~ 255
VGUPaintStyle::gradient	VGUGradient * 渐变对象
VGUPaintStyle::pattern	VGUPattern * 图片模式对象
VGUPaintStyle::solid	VGUSolid * 颜色对象
VGUPaintStyle::type	VGUPaintType 渲染类型
VGUFillAttr::rule	VGUFillRule 填充规格
VGUStrokeAttr::cap	VGULineCap 线帽类型
VGUStrokeAttr::join	VGUJointType 联结类型
VGUStrokeAttr::miterLimit	float 最大斜切长度
VGUStrokeAttr::width	float 线宽
(* VGUFuncs::InitVgu )(void)	VGUResult 初始化硬件加速。
(* VGUFuncs::DeinitVgu )(void)	VGUResult 去初始化硬件加速。
(* VGUFuncs::QueryCapability )(uint32_t cap)	int32_t 查询硬件能力集。
(* VGUFuncs::RenderFill )(VGUSurface *target, const VGUPath *path, const VGUMatrix3 *matrix, const VGUFillAttr *attr, const VGUPaintStyle *style)	VGUResult 使用指定的渲染对象来填充路径。
(* VGUFuncs::RenderStroke )(VGUSurface *target, const VGUPath *path, const VGUMatrix3 *matrix, const VGUStrokeAttr *attr, const VGUPaintStyle *style)	VGUResult 使用指定的渲染对象来描边路径。
(* VGUFuncs::RenderBlur )(VGUSurface *target, uint16_t blur)	VGUResult 对目标表面进行模糊处理。
(* VGUFuncs::RenderBlit )(VGUSurface *target, const VGUImage *src, uint32_t color)	VGUResult 对图像进行搬移操作。
(* VGUFuncs::RenderBlitN )(VGUSurface *target, const VGUImage *src, uint16_t count, uint32_t color)	VGUResult 对多个源图像进行叠加操作。
(* VGUFuncs::RenderClearRect )(VGUSurface *target, const VGURect *rect, uint32_t color, uint8_t opacity)	VGUResult 对指定矩形进行颜色清除操作。
(* VGUFuncs::RenderCancel )()	VGUResult 取消硬件加速渲染。
(* VGUFuncs::RenderSync )(int32_t timeOut)	VGUResult 同步硬件加速模块绘制或搬移操作。

宏定义说明

HDI_VGU_SCALAR_IS_FLOAT

#define HDI_VGU_SCALAR_IS_FLOAT   1

PROPERTY_NAME_LEN

#define PROPERTY_NAME_LEN   50

描述:

属性名称长度

类型定义说明

HotPlugCallback

typedef void(* HotPlugCallback) (uint32_t devId, bool connected, void *data)

描述:

热插拔事件回调

当有热插拔事件发生时，会回调该接口，需要通过RegHotPlugCallback注册该回调接口。

参数:

名称	描述
devId	输入参数，显示设备ID，此ID由HDI实现层生成，并通过当前回调接口传递给图形服务使用，用以标记当前连接的显示设备。
connected	输入参数，指明设备的连接状态，ture代表连接，false代表断开。
data	输出参数，图形服务携带的私有数据，该参数携带的是RegHotPlugCallback接口注册时传递的私有数据地址， 详情参考RegHotPlugCallback接口注册时传递的地址。

RefreshCallback

typedef void(* RefreshCallback) (uint32_t devId, void *data)

描述:

刷新请求回调

当接口实现层需要图形服务刷新数据帧时会回调该接口，需要通过RegDisplayRefreshCallback注册该回调接口。

参数:

名称	描述
devId	输入参数，显示设备ID。
data	输出参数，图形服务携带的私有数据，该参数携带的是RegDisplayRefreshCallback接口注册时传递的地址。

VBlankCallback

typedef void(* VBlankCallback) (unsigned int sequence, uint64_t ns, void *data)

描述:

VBlank 事件回调。

垂直同步事件回调接口，需要通过RegDisplayVBlankCallback注册该回调接口。

参数:

名称	描述
sequence	输入参数，指明VBlank序列，是一个累加值。
ns	输入参数，该次VBlank事件的时间戳，以纳秒为单位。
data	输出参数，图形服务携带的私有数据，该参数携带的是RegDisplayVBlankCallback接口注册时传递的地址。

VGUBlendType

typedef BlendTypeVGUBlendType

VGUPixelFormat

typedef PixelFormatVGUPixelFormat

VGUScalar

typedef float VGUScalar

枚举类型说明

anonymous enum

anonymous enum

描述:

定义缓冲区使用。

枚举值	描述
HBM_USE_CPU_READ	CPU 读缓冲
HBM_USE_CPU_WRITE	CPU 写内存
HBM_USE_MEM_MMZ	MMZ
HBM_USE_MEM_DMA	DMA缓冲区
HBM_USE_MEM_SHARE	共享内存缓冲区
HBM_USE_MEM_MMZ_CACHE	MMZ缓存
HBM_USE_MEM_FB	帧缓存
HBM_USE_ASSIGN_SIZE	内存分配

BlendType

enum BlendType

描述:

支持的图像混合类型。

系统在硬件加速期间基于指定的混合类型合成图像。

枚举值	描述
BLEND_NONE	No 混合操作
BLEND_CLEAR	CLEAR 混合操作
BLEND_SRC	SRC 混合操作
BLEND_SRCOVER	SRC_OVER 混合操作
BLEND_DSTOVER	DST_OVER 混合操作
BLEND_SRCIN	SRC_IN 混合操作
BLEND_DSTIN	DST_IN 混合操作
BLEND_SRCOUT	SRC_OUT 混合操作
BLEND_DSTOUT	DST_OUT 混合操作
BLEND_SRCATOP	SRC_ATOP 混合操作
BLEND_DSTATOP	DST_ATOP 混合操作
BLEND_ADD	ADD 混合操作
BLEND_XOR	XOR 混合操作
BLEND_DST	DST 混合操作
BLEND_AKS	AKS 混合操作
BLEND_AKD	AKD 混合操作
BLEND_BUTT	空操作

ColorDataSpace

enum ColorDataSpace

描述:

枚举颜色空间的类型

枚举值	描述
COLOR_DATA_SPACE_UNKNOWN	未知的
GAMUT_BT601	BT601色域
GAMUT_BT709	BT709色域
GAMUT_DCI_P3	DCI_P3色域
GAMUT_SRGB	SRGB色域
GAMUT_ADOBE_RGB	ADOBE_RGB色域
GAMUT_DISPLAY_P3	DISPLAY_P3色域
GAMUT_BT2020	BT2020色域
GAMUT_BT2100_PQ	BT2100_PQ色域
GAMUT_BT2100_HLG	BT2100_HLG色域
GAMUT_DISPLAY_BT2020	DISPLAY_BT2020色域
TRANSFORM_FUNC_UNSPECIFIED	UNSPECIFIED转换函数
TRANSFORM_FUNC_LINEAR	LINEAR转换函数
TRANSFORM_FUNC_SRGB	SRGB转换函数
TRANSFORM_FUNC_SMPTE_170M	SMPTE_170M转换函数
TRANSFORM_FUNC_GM2_2	GM2_2转换函数
TRANSFORM_FUNC_GM2_6	GM2_6转换函数
TRANSFORM_FUNC_GM2_8	GM2_8转换函数
TRANSFORM_FUNC_ST2084	ST2084转换函数
TRANSFORM_FUNC_HLG	HLG转换函数
PRECISION_UNSPECIFIED	UNSPECIFIED精度
PRECISION_FULL	FULL精度
PRESION_LIMITED	LIMITED精度
PRESION_EXTENDED	EXTENDED精度
BT601_SMPTE170M_FULL	BT601色域 | SMPTE_170M转换函数 | FULL精度
BT601_SMPTE170M_LIMITED	BT601色域 | SMPTE_170M转换函数 | LIMITED精度
BT709_LINEAR_FULL	BT709色域 | LINEAR转换函数 | FULL精度
BT709_LINEAR_EXTENDED	BT709色域 | LINEAR转换函数 | EXTENDED精度
BT709_SRGB_FULL	BT709色域 | SRGB转换函数 | FULL精度
BT709_SRGB_EXTENDED	BT709色域 | SRGB转换函数 | EXTENDED精度
BT709_SMPTE170M_LIMITED	BT709色域 | SMPTE_170M转换函数 | LIMITED精度
DCI_P3_LINEAR_FULL	DCI_P3色域 | LINEAR转换函数 | FULL精度
DCI_P3_GAMMA26_FULL	DCI_P3色域 | GM2_6转换函数 | FULL精度
DISPLAY_P3_LINEAR_FULL	DISPLAY_P3色域 | LINEAR转换函数 | FULL精度
DCI_P3_SRGB_FULL	DCI_P3色域 | SRGB转换函数 | FULL精度
ADOBE_RGB_GAMMA22_FULL	ADOBE_RGB色域 | GM2_2转换函数 | FULL精度
BT2020_LINEAR_FULL	BT2020色域 | LINEAR转换函数 | FULL精度
BT2020_SRGB_FULL	BT2020色域 | SRGB转换函数 | FULL精度
BT2020_SMPTE170M_FULL	BT2020色域 | SMPTE_170M转换函数 | FULL精度
BT2020_ST2084_FULL	BT2020色域 | ST2084转换函数 | FULL精度
BT2020_HLG_FULL	BT2020色域 | HLG转换函数 | FULL精度
BT2020_ST2084_LIMITED	BT2020色域 | ST2084转换函数 | LIMITED精度

ColorGamut

enum ColorGamut

描述:

色域类型枚举值

枚举值	描述
COLOR_GAMUT_INVALID	无效值
COLOR_GAMUT_NATIVE	默认值
COLOR_GAMUT_STANDARD_BT601	Standard BT601类型
COLOR_GAMUT_STANDARD_BT709	Standard BT709类型
COLOR_GAMUT_DCI_P3	DCI P3类型
COLOR_GAMUT_SRGB	SRGB类型
COLOR_GAMUT_ADOBE_RGB	Adobe RGB类型
COLOR_GAMUT_DISPLAY_P3	display P3类型
COLOR_GAMUT_BT2020	BT2020类型
COLOR_GAMUT_BT2100_PQ	BT2100 PQ类型
COLOR_GAMUT_BT2100_HLG	BT2100 HLG类型
COLOR_GAMUT_DISPLAY_BT2020	Display BT2020类型

ColorKey

enum ColorKey

描述:

Color key操作类型定义，即硬件加速支持的Color key操作类型。

枚举值	描述
CKEY_NONE	不使用colorkey
CKEY_SRC	使用源colorkey
CKEY_DST	使用目标colorkey
CKEY_BUTT	空操作

CompositionType

enum CompositionType

描述:

枚举特殊层的组合类型。

枚举值	描述
COMPOSITION_CLIENT	Client 合成类型,使用CPU或者GPU合成
COMPOSITION_DEVICE	Device合成类型，使用Device合成
COMPOSITION_CURSOR	Cursor合成类型，用于光标合成
COMPOSITION_VIDEO	Video合成类型，用于视频层合成
COMPOSITION_DEVICE_CLEAR	Device clear 合成类型, device会清除目标区域
COMPOSITION_CLIENT_CLEAR	Client clear 合成类型, service会清除目标区域
COMPOSITION_TUNNEL	Tunnel 合成类型, 用于tunnel.
COMPOSITION_BUTT	合成类型, 一个不可用类型, 用于默认初始化

Connection

enum Connection

描述:

热插拔连接类型定义

枚举值	描述
CON_INVALID	无效类型
CONNECTED	已连接
DISCONNECTED	断开连接

DispErrCode

enum DispErrCode

描述:

返回值类型定义。

枚举值	描述
DISPLAY_SUCCESS	成功
DISPLAY_FAILURE	失败
DISPLAY_FD_ERR	fd错误
DISPLAY_PARAM_ERR	参数错误
DISPLAY_NULL_PTR	空指针
DISPLAY_NOT_SUPPORT	不支持的特性
DISPLAY_NOMEM	内存不足
DISPLAY_SYS_BUSY	系统繁忙
DISPLAY_NOT_PERM	操作不允许

DispPowerStatus

enum DispPowerStatus

描述:

枚举显示状态

枚举值	描述
POWER_STATUS_ON	上电模式
POWER_STATUS_STANDBY	待机模式
POWER_STATUS_SUSPEND	休眠模式
POWER_STATUS_OFF	下电模式
POWER_STATUS_BUTT	默认模式

GamutMap

enum GamutMap

描述:

枚举色域的映射类型

枚举值	描述
GAMUT_MAP_CONSTANT	不变
GAMUT_MAP_EXPANSION	映射增强
GAMUT_MAP_HDR_CONSTANT	不变，用于HDR
GAMUT_MAP_HDR_EXPANSION	映射增强, 用于HDR

HDRFormat

enum HDRFormat

描述:

枚举HDR格式

枚举值	描述
NOT_SUPPORT_HDR	不支持HDR
DOLBY_VISION	Dolby Vision格式
HDR10	HDR10格式
HLG	HLG格式
HDR10_PLUS	HDR10 Plus格式
HDR_VIVID	Vivid格式

HDRMetadataKey

enum HDRMetadataKey

描述:

枚举HDR元数据关键字

枚举值	描述
MATAKEY_RED_PRIMARY_X	红基色X坐标
MATAKEY_RED_PRIMARY_Y	红基色Y坐标
MATAKEY_GREEN_PRIMARY_X	绿基色X坐标
MATAKEY_GREEN_PRIMARY_Y	绿基色Y坐标
MATAKEY_BLUE_PRIMARY_X	蓝基色X坐标
MATAKEY_BLUE_PRIMARY_Y	蓝基色Y坐标
MATAKEY_WHITE_PRIMARY_X	白点X坐标
MATAKEY_WHITE_PRIMARY_Y	白点Y坐标
MATAKEY_MAX_LUMINANCE	最大的光亮度
MATAKEY_MIN_LUMINANCE	最小的光亮度
MATAKEY_MAX_CONTENT_LIGHT_LEVEL	最大的内容亮度水平
MATAKEY_MAX_FRAME_AVERAGE_LIGHT_LEVEL	最大的帧平均亮度水平
MATAKEY_HDR10_PLUS	HDR10 Plus
MATAKEY_HDR_VIVID	Vivid

InterfaceType

enum InterfaceType

描述:

枚举接口类型。

枚举值	描述
DISP_INTF_HDMI	HDMI 接口
DISP_INTF_LCD	LCD 接口
DISP_INTF_BT1120	BT1120 接口
DISP_INTF_BT656	BT656 接口
DISP_INTF_YPBPR	YPBPR 接口
DISP_INTF_RGB	RGB 接口
DISP_INTF_CVBS	CVBS 接口
DISP_INTF_SVIDEO	SVIDEO 接口
DISP_INTF_VGA	VGA 接口
DISP_INTF_MIPI	MIPI 接口
DISP_INTF_PANEL	PANEL 接口
DISP_INTF_BUTT	BUTT 接口, 一个不可用类型, 用于默认初始化

LayerType

enum LayerType

描述:

图层类型定义。

枚举值	描述
LAYER_TYPE_GRAPHIC	图形层
LAYER_TYPE_OVERLAY	视频层
LAYER_TYPE_SIDEBAND	媒体播放
LAYER_TYPE_CURSOR	光标层
LAYER_TYPE_BUTT	空图层

MirrorType

enum MirrorType

描述:

硬件加速支持的镜像操作类型定义

枚举值	描述
MIRROR_NONE	不使用镜像
MIRROR_LR	左右镜像
MIRROR_TB	上下镜像
MIRROR_BUTT	空操作

PixelFormat

enum PixelFormat

描述:

像素格式类型定义。

枚举值	描述
PIXEL_FMT_CLUT8	CLUT8 格式
PIXEL_FMT_CLUT1	CLUT1 格式
PIXEL_FMT_CLUT4	CLUT4 格式
PIXEL_FMT_RGB_565	RGB565 格式
PIXEL_FMT_RGBA_5658	RGBA5658 格式
PIXEL_FMT_RGBX_4444	RGBX4444 格式
PIXEL_FMT_RGBA_4444	RGBA4444 格式
PIXEL_FMT_RGB_444	RGB444 格式
PIXEL_FMT_RGBX_5551	RGBX5551 格式
PIXEL_FMT_RGBA_5551	RGBA5551 格式
PIXEL_FMT_RGB_555	RGB555 格式
PIXEL_FMT_RGBX_8888	RGBX8888 格式
PIXEL_FMT_RGBA_8888	RGBA8888 格式
PIXEL_FMT_RGB_888	RGB888 格式
PIXEL_FMT_BGR_565	BGR565 格式
PIXEL_FMT_BGRX_4444	BGRX4444 格式
PIXEL_FMT_BGRA_4444	BGRA4444 格式
PIXEL_FMT_BGRX_5551	BGRX5551 格式
PIXEL_FMT_BGRA_5551	BGRA5551 格式
PIXEL_FMT_BGRX_8888	BGRX8888 格式
PIXEL_FMT_BGRA_8888	BGRA8888 格式
PIXEL_FMT_YUV_422_I	YUV422 交错格式
PIXEL_FMT_YCBCR_422_SP	YCBCR422 半平面格式
PIXEL_FMT_YCRCB_422_SP	YCRCB422 半平面格式
PIXEL_FMT_YCBCR_420_SP	YCBCR420 半平面格式
PIXEL_FMT_YCRCB_420_SP	YCRCB420 半平面格式
PIXEL_FMT_YCBCR_422_P	YCBCR422 平面格式
PIXEL_FMT_YCRCB_422_P	YCRCB422 平面格式
PIXEL_FMT_YCBCR_420_P	YCBCR420 平面格式
PIXEL_FMT_YCRCB_420_P	YCRCB420 平面格式
PIXEL_FMT_YUYV_422_PKG	YUYV422 打包格式
PIXEL_FMT_UYVY_422_PKG	UYVY422 打包格式t
PIXEL_FMT_YVYU_422_PKG	YVYU422 打包格式
PIXEL_FMT_VYUY_422_PKG	VYUY422 打包格式
PIXEL_FMT_VENDER_MASK	vendor mask 格式
PIXEL_FMT_BUTT	Invalid 像素格式

PresentTimestampType

enum PresentTimestampType

描述:

上屏时间戳类型枚举值

枚举值	描述
HARDWARE_DISPLAY_PTS_UNSUPPORTED	不支持
HARDWARE_DISPLAY_PTS_DELAY	Delay 时延类型
HARDWARE_DISPLAY_PTS_TIMESTAMP	时间戳类型

RopType

enum RopType

描述:

硬件加速支持的ROP操作类型。

在将前景位图的RGB颜色分量和Alpha分量值与背景位图的RGB颜色分量值和Alpha分量值进行按位的布尔运算（包括按位与，按位或等），将结果输出。

枚举值	描述
ROP_BLACK	黑色
ROP_NOTMERGEPEN	~(S2+S1)
ROP_MASKNOTPEN	~S2&S1
ROP_NOTCOPYPEN	~S2
ROP_MASKPENNOT	S2&~S1
ROP_NOT	~S1
ROP_XORPEN	S2^S1
ROP_NOTMASKPEN	~(S2&S1)
ROP_MASKPEN	S2&S1
ROP_NOTXORPEN	~(S2^S1)
ROP_NOP	S1
ROP_MERGENOTPEN	~S2+S1
ROP_COPYPE	S2
ROP_MERGEPENNOT	S2+~S1
ROP_MERGEPEN	S2+S1
ROP_WHITE	白色
ROP_BUTT	无效值

TransformType

enum TransformType

描述:

图层变换类型定义。

枚举值	描述
ROTATE_NONE	不旋转
ROTATE_90	旋转90度
ROTATE_180	旋转180度
ROTATE_270	旋转270度
ROTATE_BUTT	无效操作

VGUCapability

enum VGUCapability

描述:

硬件加速能力。

枚举值	描述
VGU_CAP_BLIT	支持Blit能力
VGU_CAP_BLIT_NUM	搬移支持图片叠加最大数目
VGU_CAP_PATH	支持路径的fill和stroke能力
VGU_CAP_FILTER_BLUR	支持模糊能力

VGUClipType

enum VGUClipType

描述:

绘制表面剪切类型。

枚举值	描述
VGU_CLIP_RECT	矩形剪切(默认)
VGU_CLIP_PATH	路径剪切
VGU_CLIP_BUTT	无效定义

VGUFillRule

enum VGUFillRule

描述:

填充规则定义。

枚举值	描述
VGU_RULE_WINDING	非0填充(默认)
VGU_RULE_EVEN_ODD	奇偶填充
VGU_RULE_BUTT	无效定义

VGUFillSpread

enum VGUFillSpread

描述:

渐变填充区域外的延展类型。

枚举值	描述
VGU_SPREAD_PAD	Pad类型(默认)
VGU_SPREAD_REFLECT	Reflect类型
VGU_SPREAD_REPEAT	Repeat类型
VGU_SPREAD_BUTT	无效定义

VGUFilter

enum VGUFilter

描述:

图像滤波类型。

枚举值	描述
VGU_FILTER_BILINEAR	双线性插值(默认)
VGU_FILTER_NEAREST	无插值
VGU_FILTER_LINEAR	线性插值
VGU_FILTER_BUTT	无效定义

VGUGradientType

enum VGUGradientType

描述:

渐变类型。

枚举值	描述
VGU_GRADIENT_LINEAR	线性渐变
VGU_GRADIENT_RADIAL	辐射渐变
VGU_GRADIENT_CONIC	圆锥渐变
VGU_GRADIENT_BUTT	无效定义

VGUJointType

enum VGUJointType

描述:

联接类型。

枚举值	描述
VGU_LINE_JOIN_MITER	尖角(默认)
VGU_LINE_JOIN_ROUND	圆角
VGU_LINE_JOIN_BEVEL	斜角
VGU_LINE_JOIN_BUTT	无效定义

VGULineCap

enum VGULineCap

描述:

线帽。

枚举值	描述
VGU_LINECAP_BUTT	线条末端为平直线帽(默认)
VGU_LINECAP_ROUND	线条末端为圆形线帽
VGU_LINECAP_SQUARE	线条末端为正方向形线帽

VGUPaintType

enum VGUPaintType

描述:

渲染对象

枚举值	描述
VGU_PAINT_SOLID	填充颜色
VGU_PAINT_GRADIENT	渲染渐变对象
VGU_PAINT_PATTERN	渲染图片模式
VGU_PAINT_BUTT	无效操作

VGUPathCmd

enum VGUPathCmd

描述:

路径绘制指令类型。

枚举值	描述
VGU_PATH_CMD_CLOSE	线段关闭，坐标数据: none
VGU_PATH_CMD_MOVE	移动到指定位置，坐标数据: x0, y0
VGU_PATH_CMD_LINE	线条，坐标数据: x0, y0
VGU_PATH_CMD_HLINE	水平线，坐标数据: x0
VGU_PATH_CMD_VLINE	垂直线，坐标数据: y0
VGU_PATH_CMD_QUAD	二次贝塞尔曲线，坐标数据: x0, y0, x1, y1
VGU_PATH_CMD_CUBIC	三次贝塞尔曲线，坐标数据: x0, y0, x1, y1, x2, y2
VGU_PATH_CMD_SQUAD	平滑二次贝塞尔曲线，坐标数据: x1, y1
VGU_PATH_CMD_SCUBIC	平滑三次贝塞尔曲线，坐标数据: x1, y1, x2, y2
VGU_PATH_CMD_BUTT	无效定义

VGUPathDataType

enum VGUPathDataType

描述:

路径坐标数据类型。

枚举值	描述
VGU_DATA_TYPE_S16	整型(2 bytes)
VGU_DATA_TYPE_S32	整型(4 bytes)
VGU_DATA_TYPE_F32	浮点(4 bytes)

VGUResult

enum VGUResult

描述:

错误码定义。

枚举值	描述
VGU_SUCCESS	成功
VGU_NO_SUPPORT	不支持
VGU_OPERATION_FAILED	操作失败
VGU_OUT_OF_MEMORY	内存溢出
VGU_TIMEOUT	超时
VGU_INVALID_PARAMETER	无效参数，
VGU_BUSY	设备忙
VGU_NO_CONTEXT	无上下文

VGUTransformType

enum VGUTransformType

描述:

变换类型。

枚举值	描述
VGU_TRANSFORM_TRANSLATE	平移变换
VGU_TRANSFORM_SCALE	缩放变换
VGU_TRANSFORM_ROTATE_90	旋转90度
VGU_TRANSFORM_ROTATE_180	旋转180度
VGU_TRANSFORM_ROTATE_270	旋转270度
VGU_TRANSFORM_OTHER	其他变换

VGUWrapType

enum VGUWrapType

描述:

图像模式填充延展类型。

枚举值	描述
VGU_WRAP_REFLECT	反射类型
VGU_WRAP_REPEAT	重复类型
VGU_WRAP_BUTT	无效定义

函数说明

DeviceInitialize()

int32_t DeviceInitialize (DeviceFuncs ** funcs)

描述:

实现显示设备控制接口的初始化，申请操作显示设备控制接口的资源，并获取对应的操作接口。

参数:

名称	描述
funcs	输出参数，显示设备控制接口指针，初始化时分配内存，调用者不需要分配内存，调用者获取该指针用于操作显示设备。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

DeviceUninitialize()

int32_t DeviceUninitialize (DeviceFuncs * funcs)

描述:

取消显示设备控制接口的初始化，释放控制接口使用到的资源。

参数:

名称	描述
funcs	输出参数，显示设备控制接口指针，用于释放初始化函数中分配的操作指针内存。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GfxInitialize()

int32_t GfxInitialize (GfxFuncs ** funcs)

描述:

获取硬件加速相关的操作接口指针。

参数:

名称	描述
funcs	输出参数，硬件加速模块操作接口指针，调用者不需要分配内存，调用者获取该指针操作硬件加速。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GfxUninitialize()

int32_t GfxUninitialize (GfxFuncs * funcs)

描述:

释放硬件加速相关的操作接口指针。

参数:

名称	描述
funcs	输出参数，硬件加速操作接口指针。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GrallocInitialize()

int32_t GrallocInitialize (GrallocFuncs ** funcs)

描述:

初始化内存模块，并获取内存提供的操作接口。

参数:

名称	描述
funcs	输出参数，内存模块操作接口指针，初始化内存模块时分配内存，调用者不需要分配内存，调用者获取该指针操作内存。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GrallocUninitialize()

int32_t GrallocUninitialize (GrallocFuncs * funcs)

描述:

取消初始化内存模块，并释放内存操作接口指针。

参数:

名称	描述
funcs	输出参数，内存操作接口指针，用于释放内存初始化函数中分配的操作指针内存。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

LayerInitialize()

int32_t LayerInitialize (LayerFuncs ** funcs)

描述:

实现图层初始化功能，申请图层使用的资源，并获取图层提供的操作接口。

参数:

名称	描述
funcs	输出参数，图层操作接口指针，初始化图层时分配内存，调用者不需要分配内存，调用者获取该指针操作图层。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

参见:

LayerUninitialize

LayerUninitialize()

int32_t LayerUninitialize (LayerFuncs * funcs)

描述:

取消图层初始化功能，释放图层使用到的资源，并释放图层操作接口指针。

参数:

名称	描述
funcs	输出参数，图层操作接口指针，用于释放图层初始化函数中分配的操作指针内存。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

参见:

LayerInitialize

VGUGradientClearStop()

VGUResult VGUGradientClearStop (VGUGradient * gradient)

描述:

清除ColorStop。

参数:

名称	描述
gradient	输入参数，渐变对象。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUGradientColorStop()

VGUResult VGUGradientColorStop (VGUGradient * gradient, const VGUColorStop * colorStop, uint32_t count )

描述:

对渐变添加ColorStop。

参数:

名称	描述
gradient	输入参数，渐变对象。
colorStop	输入参数，ColorStop数组指针。
count	输入参数，colorStops总数。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUGradientConic()

VGUResult VGUGradientConic (VGUGradient * gradient, VGUScalar cx, VGUScalar cy )

描述:

创建圆锥渐变对象。

参数:

名称	描述
gradient	输入参数，渐变对象。
cx	输入参数，渐变中心水平坐标。
cy	输入参数，渐变中心垂直坐标。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUGradientLinear()

VGUResult VGUGradientLinear (VGUGradient * gradient, const VGUPoint * p1, const VGUPoint * p2 )

描述:

创建线性渐变对象。

参数:

名称	描述
gradient	输入参数，渐变对象。
p1	输入参数，起点坐标。
p2	输入参数，终点坐标。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUGradientMatrix()

VGUResult VGUGradientMatrix (VGUGradient * gradient, const VGUMatrix3 * matrix )

描述:

设置渐变对象的变换矩阵。

参数:

名称	描述
gradient	输入参数，渐变对象。
matrix	输入参数，渐变对象变换矩阵。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUGradientRadial()

VGUResult VGUGradientRadial (VGUGradient * gradient, const VGUPoint * p1, VGUScalar r1, const VGUPoint * p2, VGUScalar r2 )

描述:

创建辐射渐变对象

参数:

名称	描述
gradient	输入参数，渐变对象。
p1	输入参数，内圆圆心坐标。
r1	输入参数，内圆半径。
p2	输入参数，外圆圆心坐标。
r2	输入参数，外圆半径。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUInitialize()

VGUResult VGUInitialize (VGUFuncs ** funcs)

描述:

获取硬件加速相关的操作接口指针。

参数:

名称	描述
funcs	输出参数，硬件加速模块操作接口指针，调用者不需要分配内存，调用者获取该指针操作硬件加速。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUMatrixIdentity()

VGUResult VGUMatrixIdentity (VGUMatrix3 * matrix)

描述:

初始化矩阵对象为单位矩阵。

参数:

名称	描述
matrix	输入参数，变换矩阵对象。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUMatrixRotate()

VGUResult VGUMatrixRotate (VGUMatrix3 * matrix, float degree )

描述:

矩阵变换旋转。

参数:

名称	描述
matrix	输入参数，变换矩阵对象。
degree	输入参数，旋转度数。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUMatrixScale()

VGUResult VGUMatrixScale (VGUMatrix3 * matrix, float xScale, float yScale )

描述:

矩阵变换缩放。

参数:

名称	描述
matrix	输入参数，变换矩阵对象。
xScale	输入参数，水平方向缩放倍数。
yScale	输入参数，垂直方向缩放倍数。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUMatrixTranslate()

VGUResult VGUMatrixTranslate (VGUMatrix3 * matrix, float x, float y )

描述:

矩阵变换平移。

参数:

名称	描述
matrix	输入参数，变换矩阵对象。
x	输入参数，水平方向位置。
y	输入参数，垂直方向位置。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUPathAppend()

VGUResult VGUPathAppend (VGUPath * path, const VGUPath * subpath )

描述:

添加子路径到当前路径中。

参数:

名称	描述
path	输入参数，路径对象。
subpath	输入参数，存放子路径对象。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUPathClear()

VGUResult VGUPathClear (VGUPath * path)

描述:

清除路径对象内存。

参数:

名称	描述
path	输入参数，路径对象。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUPathInit()

VGUResult VGUPathInit (VGUPath * path, VGUPathDataType type, const uint8_t * segments, int numSegments, const uint8_t * data, bool enAlias, VGURect boundBox )

描述:

初始化路径对象。

参数:

名称	描述
path	输入参数，路径对象。
type	输入参数，存储路径的数据类型。
segments	输入参数，路径的命令缓存。
numSegments	输入参数，路径命令总数。
data	输入参数，路径命令对应的坐标缓存。
enAlias	输入参数，使能抗锯齿。
boundBox	输入参数，路径的边界范围。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

VGUUninitialize()

VGUResult VGUUninitialize (VGUFuncs * funcs)

描述:

去初始化硬件加速模块，同时释放硬件加速模块操作函数指针。

参数:

名称	描述
funcs	输出参数，硬件加速操作接口指针。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

变量说明

alpha0 [¹⁄₂]

uint8_t LayerAlpha::alpha0

描述:

alpha0值，取值范围：[0, 255]

alpha0 [²⁄₂]

uint8_t ISurface::alpha0

描述:

Alpha0值，取值范围：[0,255]

alpha1 [¹⁄₂]

uint8_t LayerAlpha::alpha1

描述:

alpha1值，取值范围：[0, 255]

alpha1 [²⁄₂]

uint8_t ISurface::alpha1

描述:

Alpha1值，取值范围：[0,255]

alphaRopType

RopType GfxOpt::alphaRopType

描述:

Alpha的Rop类型

bAlphaExt1555

bool ISurface::bAlphaExt1555

描述:

是否使能1555的Alpha扩展

bAlphaMax255

bool ISurface::bAlphaMax255

描述:

图像alpha最大值为255还是128

baseAddr

void* YUVDescInfo::baseAddr

描述:

内存的初始地址

blend

VGUBlendType VGUSurface::blend

描述:

混合叠加模式

blendType

BlendType GfxOpt::blendType

描述:

混合方式

boundBox

VGURect VGUPath::boundBox

描述:

路径最大边界

bpp

int32_t LayerInfo::bpp

描述:

每像素所占bit数

buffer [¹⁄₃]

VGUBuffer* VGUMaskLayer::buffer

描述:

蒙版缓存

buffer [²⁄₃]

VGUBuffer* VGUSurface::buffer

描述:

位图缓存

buffer [³⁄₃]

VGUBuffer* VGUImage::buffer

描述:

图像存储缓存

bYCbCrClut

bool ISurface::bYCbCrClut

描述:

CLUT表是否位于 YCbCr 空间

cap

VGULineCap VGUStrokeAttr::cap

描述:

线帽类型

cbcrPhyAddr

uint64_t ISurface::cbcrPhyAddr

描述:

CbCr分量地址

cbcrStride

int32_t ISurface::cbcrStride

描述:

CbCr分量跨度

clipPath

VGUPath* VGUSurface::clipPath

描述:

路径剪切域，如果为空，整个表面直接渲染

clipRect

VGURect* VGUSurface::clipRect

描述:

矩形剪切域，如果为空，整个表面直接渲染

clipType

VGUClipType VGUSurface::clipType

描述:

表面剪切类型

clutPhyAddr

uint64_t ISurface::clutPhyAddr

描述:

Clut表首地址，用作颜色扩展或颜色校正

color [¹⁄₅]

uint32_t ILine::color

描述:

线条颜色

color [²⁄₅]

uint32_t ICircle::color

描述:

圆的颜色

color [³⁄₅]

uint32_t Rectangle::color

描述:

矩形颜色

color [⁴⁄₅]

uint32_t VGUColorStop::color

描述:

偏移位置对应颜色

color [⁵⁄₅]

uint32_t VGUSolid::color

描述:

颜色值

colorKeyFrom

ColorKey GfxOpt::colorKeyFrom

描述:

色键模式

colorRopType

RopType GfxOpt::colorRopType

描述:

颜色的Rop类型

colorStops

VGUColorStop* VGUGradient::colorStops

描述:

渐变停止颜色数组指针

Commit

int32_t(* DeviceFuncs::Commit) (uint32_t devId, int32_t *fence)

描述:

提交合成送显请求。

图形服务通过该接口向接口实现层提交合成送显请求，如果有硬件合成层，接口实现层需要在这时进行合成，并且把最终合成的数据送到硬件进行显示。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
fences	输出参数，fence首地址，指向fence数组的首地址。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

conic

VGUConic VGUGradient::conic

描述:

圆锥渐变对象

CreateVirtualDisplay

int32_t(* DeviceFuncs::CreateVirtualDisplay) (uint32_t width, uint32_t height, int32_t *format, uint32_t *devId)

描述:

创建虚拟显示设备。

该接口用于创建一个虚拟显示设备。

参数:

名称	描述
width	输入参数，指定显示设备的像素宽度。
height	输入参数，指定显示设备的像素高度。
format	输出参数，指定显示设备的像素格式。 详情参考PixelFormat，接口实现层可以根据硬件需求，修改format并返回给图形服务。
devId	输出参数，用于接口层返回创建的设备ID。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

cx

VGUScalar VGUConic::cx

描述:

圆弧中心x坐标

cy

VGUScalar VGUConic::cy

描述:

圆弧中心y坐标

data [¹⁄₂]

BufferData LayerBuffer::data

描述:

图层buffer数据

data [²⁄₂]

uint8_t* VGUPath::data

描述:

存放路径命令对应坐标数据

DeinitVgu

VGUResult(* VGUFuncs::DeinitVgu) (void)

描述:

去初始化硬件加速。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

参见:

InitVgu

DestroyVirtualDisplay

int32_t(* DeviceFuncs::DestroyVirtualDisplay) (uint32_t devId)

描述:

销毁虚拟显示设备。

该接口用于销毁指定的虚拟显示设备。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

enableRop

bool GfxOpt::enableRop

描述:

Rop功能使能位

enableScale

bool GfxOpt::enableScale

描述:

缩放功能使能位

enAlias

bool VGUPath::enAlias

描述:

抗锯齿开关

enColorFmt

PixelFormat ISurface::enColorFmt

描述:

图像格式

enGlobalAlpha [¹⁄₂]

bool LayerAlpha::enGlobalAlpha

描述:

全局alpha使能标志

enGlobalAlpha [²⁄₂]

bool GfxOpt::enGlobalAlpha

描述:

全局alpha使能位

enPixelAlpha [¹⁄₂]

bool LayerAlpha::enPixelAlpha

描述:

像素alpha使能标志

enPixelAlpha [²⁄₂]

bool GfxOpt::enPixelAlpha

描述:

像素alpha使能位

expectedSize

uint32_t AllocInfo::expectedSize

描述:

申请内存大小

fd

int32_t ExtDataHandle::fd

描述:

句柄 fd, -1代表不支持

fenceId

int32_t LayerBuffer::fenceId

描述:

buffer 的fence号。

filter

VGUFilter VGUSurface::filter

描述:

图像滤波类型

format [¹⁄₂]

PixelFormat AllocInfo::format

描述:

申请内存格式

format [²⁄₂]

PixelFormat VerifyAllocInfo::format

描述:

分配内存的像素格式

formatCount

uint32_t HDRCapability::formatCount

描述:

支持的HDR格式的数量

formats

HDRFormat* HDRCapability::formats

描述:

支持的HDR格式的数组首地址

freshRate

uint32_t DisplayModeInfo::freshRate

描述:

刷新速率

gAlpha

uint8_t LayerAlpha::gAlpha

描述:

全局alpha值，取值范围：[0, 255]

GetDisplayBacklight

int32_t(* DeviceFuncs::GetDisplayBacklight) (uint32_t devId, uint32_t *level)

描述:

获取显示设备当前的背光值。

图形服务可以通过该接口获取设置显示设备的背光值。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
level	输出参数，保存对应设备的背光值，由接口实现层进行写入。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplayCapability

int32_t(* DeviceFuncs::GetDisplayCapability) (uint32_t devId, DisplayCapability *info)

描述:

获取显示设备能力集。

图形服务可以通过该接口获取显示设备具备哪些显示能力。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
info	输出参数，设备支持的能力级信息，详情参考 DisplayCapability。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplayColorGamut

int32_t(* DeviceFuncs::GetDisplayColorGamut) (uint32_t devId, ColorGamut *gamut)

描述:

获取显示设备当前的色域模式。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
gamut	输出参数，保存对应设备的色域模式，由接口实现层进行写入。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplayCompChange

int32_t(* DeviceFuncs::GetDisplayCompChange) (uint32_t devId, uint32_t *num, uint32_t *Layers, int32_t *type)

描述:

获取显示设备合成类型有变化的layer。

在合成准备阶段，显示设备会根据设备的合成能力修改图层的合成类型，该接口会返回哪些图层合成类型发生了变化。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
num	输出参数，表示合成类型发生了变化的图层数量。
Layers	输出参数，指向图层数组首地址。
type	输出参数，指向合成类型数组首地址。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplayGamutMap

int32_t(* DeviceFuncs::GetDisplayGamutMap) (uint32_t devId, GamutMap *gamutMap)

描述:

获取显示设备当前的色域映射模式。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
gamutMap	输出参数，保存对应设备的色域映射模式，由接口实现层进行写入。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplayMode

int32_t(* DeviceFuncs::GetDisplayMode) (uint32_t devId, uint32_t *modeId)

描述:

获取显示设备当前的显示模式。

图形服务可以通过该接口获取显示设备当前的显示模式。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
modeId	输出参数，存放当前设备的显示模式ID， 由接口实现层进行数据的写入。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplayPowerStatus

int32_t(* DeviceFuncs::GetDisplayPowerStatus) (uint32_t devId, DispPowerStatus *status)

描述:

获取显示设备当前的电源状态。

图形服务可以通过该接口获设置显示设备的电源状态。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
status	输出参数，保存对应设备的电源状态，由接口实现层进行状态的写入。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplayProperty

int32_t(* DeviceFuncs::GetDisplayProperty) (uint32_t devId, uint32_t id, uint64_t *value)

描述:

获取显示设备属性值。

图形服务可以通过该接口获取显示设备具体的属性值。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
id	输入参数，由接口GetDisplayCapability返回属性ID。
level	输出参数，属性ID对应的属性值，由接口实现层写入。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplayReleaseFence

int32_t(* DeviceFuncs::GetDisplayReleaseFence) (uint32_t devId, uint32_t *num, uint32_t *layers, int32_t *fences)

描述:

获取显示图层fence。

图形服务在调用接口Commit后，需要通过该接口获取图层的fence信息。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
num	输出参数，图层个数。
layers	输出参数，图层首地址，指向图层数组的首地址。
fences	输出参数，fence首地址，指向fence数组的首地址。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplaySupportedColorGamuts

int32_t(* DeviceFuncs::GetDisplaySupportedColorGamuts) (uint32_t devId, uint32_t *num, ColorGamut *gamuts)

描述:

获取显示设备支持的色域信息。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
num	输出参数，设备支持的色域数组个数。
gamuts	输出参数，色域首地址，指向色域数组首地址。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetDisplaySupportedModes

int32_t(* DeviceFuncs::GetDisplaySupportedModes) (uint32_t devId, uint32_t *num, DisplayModeInfo *modes)

描述:

获取显示设备支持的显示模式信息。

图形服务可以通过该接口获取到显示设备支持哪些显示模式。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
num	输出参数，设备支持的模式数量。
modes	输出参数，设备支持的所有模式信息，包括所有能支持的分辨率和刷新率，每一个模式实现层都有一个Id与之对应，在获取当前模式 和设置当前模式时都会使用到，详情参考 DisplayModeInfo。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetHDRCapabilityInfos

int32_t(* DeviceFuncs::GetHDRCapabilityInfos) (uint32_t devId, HDRCapability *info)

描述:

获取显示设备支持的HDR属性信息。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
info	输出参数，保存对应设备的HDR属性信息，由接口实现层进行写入。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetSupportedMetadataKey

int32_t(* DeviceFuncs::GetSupportedMetadataKey) (uint32_t devId, uint32_t *num, HDRMetadataKey *keys)

描述:

获取显示设备支持的 HDRMetadataKey。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
num	输出参数，设备支持的HDRMetadataKey数组个数。
keys	输出参数，HDRMetadataKey首地址，指向HDRMetadataKey数组首地址。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

GetWriteBackFrame

int32_t(* DeviceFuncs::GetWriteBackFrame) (uint32_t devId, BufferHandle *buffer, int32_t *fence)

描述:

获取显示设备的回写帧。

该接口用来获取devId指定的回写点数据，接口实现层将显示设备回写点的数据写入到设置的缓存中。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
buffer	输出参数，回写点数据缓存。
fence	输出参数，同步栅栏，图形服务在调用该接口时，需要将Buffer的release fence 传入，标记该缓存是否可以被写入，接口实现层在接口返回前需要将buffer的acquirce fence 写入回传给图形服务，用来标记回写数据是否已经写入缓存。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

globalAlpha

uint32_t GfxOpt::globalAlpha

描述:

全局alpha的值

gradient

VGUGradient* VGUPaintStyle::gradient

描述:

渐变对象

h [¹⁄₂]

int32_t IRect::h

描述:

矩形框高度

h [²⁄₂]

VGUScalar VGURect::h

描述:

矩形高度

hdl

BufferHandle* LayerBuffer::hdl

描述:

图层buffer句柄

height [¹⁄₈]

uint32_t DisplayInfo::height

描述:

显示屏高度

height [²⁄₈]

int32_t LayerInfo::height

描述:

图层高度

height [³⁄₈]

int32_t LayerBuffer::height

描述:

buffer高度

height [⁴⁄₈]

int32_t ISurface::height

描述:

图像高度

height [⁵⁄₈]

int32_t DisplayModeInfo::height

描述:

像素高度

height [⁶⁄₈]

uint32_t AllocInfo::height

描述:

申请内存高度

height [⁷⁄₈]

uint32_t VerifyAllocInfo::height

描述:

分配内存的高度

height [⁸⁄₈]

uint32_t VGUBuffer::height

描述:

位图高度

id

int32_t DisplayModeInfo::id

描述:

模式ID

image

VGUImage* VGUPattern::image

描述:

图像对象

InitVgu

VGUResult(* VGUFuncs::InitVgu) (void)

描述:

初始化硬件加速。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

参见:

DeinitVgu

InvokeDisplayCmd

int32_t(* DeviceFuncs::InvokeDisplayCmd) (uint32_t devId,...)

描述:

调用显示设备命令。

该接口用于图形服务和接口实现层之间的的接口扩展，如果由临时接口新增可以通过该接口进行扩展，不用增加新的接口定义。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

join

VGUJointType VGUStrokeAttr::join

描述:

联结类型

key

HDRMetadataKey HDRMetaData::key

描述:

HDR元数据关键字

linear

VGULinear VGUGradient::linear

描述:

线性渐变对象

m

float VGUMatrix3::m[3][3]

描述:

3x3变换矩阵

mask

VGUMaskLayer* VGUSurface::mask

描述:

蒙版图层，可以为空

matrix [¹⁄₂]

VGUMatrix3* VGUImage::matrix

描述:

图像矩阵变换，该参数为空，则内部使用单位变换矩阵

matrix [²⁄₂]

VGUMatrix3* VGUGradient::matrix

描述:

针对渐变对象的变换矩阵

maxAverageLum

float HDRCapability::maxAverageLum

描述:

最大的平均光亮度luminance值

maxLum

float HDRCapability::maxLum

描述:

最大的光亮度luminance值

minLum

float HDRCapability::minLum

描述:

最小的光亮度luminance值

mirrorType

MirrorType GfxOpt::mirrorType

描述:

镜像类型

miterLimit

float VGUStrokeAttr::miterLimit

描述:

最大斜切长度

name [¹⁄₂]

char PropertyObject::name[PROPERTY_NAME_LEN]

描述:

属性名称

name [²⁄₂]

char DisplayCapability::name[PROPERTY_NAME_LEN]

描述:

显示设备名称

numSegments

int32_t VGUPath::numSegments

描述:

路径命令总数

opacity [¹⁄₃]

uint8_t VGUImage::opacity

描述:

透明度，范围0~255

opacity [²⁄₃]

uint8_t VGUGradient::opacity

描述:

透明度，范围0~255

opacity [³⁄₃]

uint8_t VGUSolid::opacity

描述:

透明度，值范围 0 ~ 255

pattern

VGUPattern* VGUPaintStyle::pattern

描述:

图片模式对象

phyAddr [¹⁄₃]

uint64_t BufferData::phyAddr

描述:

物理内存地址

phyAddr [²⁄₃]

uint64_t ISurface::phyAddr

描述:

图像首地址

phyAddr [³⁄₃]

uint64_t VGUBuffer::phyAddr

描述:

位图缓存的物理地址

phyHeight

uint32_t DisplayCapability::phyHeight

描述:

物理高度

phyWidth

uint32_t DisplayCapability::phyWidth

描述:

物理宽度

pitch

int32_t LayerBuffer::pitch

描述:

一行数据所占字节数

pixelFormat

VGUPixelFormat VGUBuffer::pixelFormat

描述:

像素格式

pixFormat [¹⁄₂]

PixelFormat LayerInfo::pixFormat

描述:

图层像素格式

pixFormat [²⁄₂]

PixelFormat LayerBuffer::pixFormat

描述:

buffer像素格式r

PrepareDisplayLayers

int32_t(* DeviceFuncs::PrepareDisplayLayers) (uint32_t devId, bool *needFlushFb)

描述:

显示设备合成前准备。

图形服务在合成前需要通过该接口通知显示设备进行合成前的准备工作。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
needFlushFb	输出参数，接口实现层通过该参数指示图形服务在commit前是否需要通过SetDisplayClientBuffer重新设置显示帧存。 true表示需要设置显示帧存，false表示不需要。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

propertyCount

uint32_t DisplayCapability::propertyCount

描述:

属性数组大小

propId

uint32_t PropertyObject::propId

描述:

属性ID

props

PropertyObject* DisplayCapability::props

描述:

属性数组

QueryCapability

int32_t(* VGUFuncs::QueryCapability) (uint32_t cap)

描述:

查询硬件能力集。

参数:

名称	描述
cap	输入参数，待查询能力。该参数类型定义参考VGUCapability。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

r

int32_t ICircle::r

描述:

圆的半径

r0

VGUScalar VGURadial::r0

描述:

内圈圆半径

r1

VGUScalar VGURadial::r1

描述:

外圈圆半径

radial

VGURadial VGUGradient::radial

描述:

辐射渐变对象

rect [¹⁄₃]

IRect Rectangle::rect

描述:

矩形区域

rect [²⁄₃]

VGURect* VGUMaskLayer::rect

描述:

蒙版矩形

rect [³⁄₃]

VGURect* VGUImage::rect

描述:

图像截取矩形，该参数为空，则截取整个图像

RegDisplayRefreshCallback

int32_t(* DeviceFuncs::RegDisplayRefreshCallback) (uint32_t devId, RefreshCallback callback, void *data)

描述:

刷新请求回调。

注册刷新请求事件回调，当实现层有刷新需求时，实现层通过回调注册的接口通知图形服务。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
callback	输入参数，刷新请求事件回调实例，当有接口实现层有刷新请求时，需要通过该实例通知图形服务。
data	输出参数，图形服务携带的私有数据，在事件回调接口中需要返回给图形服务。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

RegDisplayVBlankCallback

int32_t(* DeviceFuncs::RegDisplayVBlankCallback) (uint32_t devId, VBlankCallback callback, void *data)

描述:

注册VBlank事件回调。

注册VBlank事件回调，当有VBlank事件发生时接口实现层需要回调注册的接口。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
callback	输入参数，VBlank事件回调实例，当有VBlank事件发生时并且DisplayVsync处于Enable状态，接口实现层需要通过该实例通知图形服务。
data	输出参数，图形服务携带的私有数据，在事件回调接口中需要返回给图形服务。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

RegHotPlugCallback

int32_t(* DeviceFuncs::RegHotPlugCallback) (HotPlugCallback callback, void *data)

描述:

注册热插拔事件回调。

注册热插拔事件回调，当有热插拔事件发生时接口实现层需要回调注册的接口。

参数:

名称	描述
callback	输入参数，热插拔事件回调实例，当有热插拔事件发生时，接口实现层需要通过该实例通知图形服务。
data	输出参数，图形服务携带的私有数据，在事件回调接口中需要返回给图形服务。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

RenderBlit

VGUResult(* VGUFuncs::RenderBlit) (VGUSurface *target, const VGUImage *src, uint32_t color)

描述:

对图像进行搬移操作。

搬移过程中同时进行颜色空间转换，矩阵变换操作。

参数:

名称	描述
target	输入参数，渲染目标表面。
src	输入参数，待叠加源图像。
color	输入参数，参与混合的颜色值。如果颜色值为0，则不参与混合操作。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

RenderBlitN

VGUResult(* VGUFuncs::RenderBlitN) (VGUSurface *target, const VGUImage *src, uint16_t count, uint32_t color)

描述:

对多个源图像进行叠加操作。

搬移过程中同时进行颜色空间转换，矩阵变换操作。该接口支持多个源图形同时叠加到目标表面，

对于硬件支持源图像数目可以通过QueryCapability接口查询。

参数:

名称	描述
target	输入参数，渲染目标表面。
src	输入参数，待叠加源图像数组。
count	输入参数，待叠加源图像个数。
color	输入参数，参与混合的颜色值。如果颜色值为0，则不参与混合操作。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

RenderBlur

VGUResult(* VGUFuncs::RenderBlur) (VGUSurface *target, uint16_t blur)

描述:

对目标表面进行模糊处理。

参数:

名称	描述
target	输入参数，渲染目标表面。
blur	输入参数，模糊半径。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

RenderCancel

VGUResult(* VGUFuncs::RenderCancel) ()

描述:

取消硬件加速渲染。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

RenderClearRect

VGUResult(* VGUFuncs::RenderClearRect) (VGUSurface *target, const VGURect *rect, uint32_t color, uint8_t opacity)

描述:

对指定矩形进行颜色清除操作。

参数:

名称	描述
target	输入参数，渲染目标表面。
rect	输入参数，待填充矩形大小，如果该参数为空，则整个表面清除。
color	输入参数，填充颜色。
opacity	输入参数，填充透明度。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

RenderFill

VGUResult(* VGUFuncs::RenderFill) (VGUSurface *target, const VGUPath *path, const VGUMatrix3 *matrix, const VGUFillAttr *attr, const VGUPaintStyle *style)

描述:

使用指定的渲染对象来填充路径。

参数:

名称	描述
target	输入参数，渲染目标表面。
path	输入参数，路径对象。
matrix	输入参数，变换矩阵对象。 如果该参数为空，默认为单位矩阵。
attr	输入参数，填充属性。
style	输入参数，绘制对象。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

RenderStroke

VGUResult(* VGUFuncs::RenderStroke) (VGUSurface *target, const VGUPath *path, const VGUMatrix3 *matrix, const VGUStrokeAttr *attr, const VGUPaintStyle *style)

描述:

使用指定的渲染对象来描边路径。

参数:

名称	描述
target	输入参数，渲染目标表面。
path	输入参数，路径对象。
matrix	输入参数，变换矩阵对象。 如果该参数为空，默认为单位矩阵。
attr	输入参数，描边属性。
style	输入参数，绘制对象。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

RenderSync

VGUResult(* VGUFuncs::RenderSync) (int32_t timeOut)

描述:

同步硬件加速模块绘制或搬移操作。

该函数将阻塞等待硬件绘制完成后继续运行。

参数:

名称	描述
timeOut	输入参数，该参数表示硬件加速同步等待超时时间。 值为0表示没有等待时间。

返回:

VGU_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看VGUResult。

reserve[0]

int32_t ExtDataHandle::reserve[0]

描述:

reserve数组

reserveInts

uint32_t ExtDataHandle::reserveInts

描述:

reserve数组的个数

rotAngle

int32_t DisplayInfo::rotAngle

描述:

显示屏旋转角度

rotateType

TransformType GfxOpt::rotateType

描述:

旋转类型

rule

VGUFillRule VGUFillAttr::rule

描述:

填充规格

segment

uint8_t* VGUPath::segment

描述:

存放路径命令数据

SetDisplayBacklight

int32_t(* DeviceFuncs::SetDisplayBacklight) (uint32_t devId, uint32_t level)

描述:

设置显示设备当前的背光值。

图形服务可以通过该接口获设置显示设备的背光值。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
level	输入参数，表示需要设置的背光值。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayClientBuffer

int32_t(* DeviceFuncs::SetDisplayClientBuffer) (uint32_t devId, const BufferHandle *buffer, int32_t fence)

描述:

设置显示设备的显示缓存。

图形服务可以通过该接口将显示缓存设置给显示设备，显示设备硬件合成结果将会存放在该显示缓存中。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
buffer	输入参数，显示缓存。
fence	输入参数，同步栅栏，标识显示缓存是否可以访问，有图形服务创建和释放，接口实现层需要等待同步栅栏发送信号后才能使用显示缓存。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayClientCrop

int32_t(* DeviceFuncs::SetDisplayClientCrop) (uint32_t devId, IRect *rect)

描述:

设置显示设备的裁剪区域。

图形服务可以通过该接口设置显示设备的ClientBuffer的裁剪区域，裁剪区域不能超过ClientBuffer的大小。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
rect	输入参数，ClientBuffer的裁剪区域。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayClientDamage

int32_t(* DeviceFuncs::SetDisplayClientDamage) (uint32_t devId, uint32_t num, IRect *rect)

描述:

设置显示设备的显示脏区。

图形服务可以通过该接口设置显示设备脏区，接口实现层可以根据该区域进行区域刷新，脏区是由多个矩形区域组合起来的。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
num	输入参数，矩形个数。
rect	输入参数，区域矩形指针，指向矩形数组的首地址。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayClientDestRect

int32_t(* DeviceFuncs::SetDisplayClientDestRect) (uint32_t devId, IRect *rect)

描述:

设置显示设备的显示区域。

图形服务可以通过该接口设置显示设备的显示区域。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
rect	输入参数，显示区域。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayColorGamut

int32_t(* DeviceFuncs::SetDisplayColorGamut) (uint32_t devId, ColorGamut gamut)

描述:

设置显示设备当前的色域模式。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
gamut	输入参数，表示需要设置的色域模式。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayColorTransform

int32_t(* DeviceFuncs::SetDisplayColorTransform) (uint32_t devId, const float *matrix)

描述:

设置显示设备当前的4x4的颜色转换矩阵。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
matrix	输入参数，表示需要设置的颜色转换模式。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayGamutMap

int32_t(* DeviceFuncs::SetDisplayGamutMap) (uint32_t devId, GamutMap gamutMap)

描述:

设置显示设备当前的色域映射模式。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
gamutMap	输入参数，表示需要设置的色域映射模式。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayMode

int32_t(* DeviceFuncs::SetDisplayMode) (uint32_t devId, uint32_t modeId)

描述:

设置显示设备的显示模式。

图形服务可以通过该接口获设置显示设备的显示模式。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
modeId	输入参数，指明需要设置的模式ID，接口实现层将设备切换到该参数对应的显示模式。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayPowerStatus

int32_t(* DeviceFuncs::SetDisplayPowerStatus) (uint32_t devId, DispPowerStatus status)

描述:

设置显示设备当前的电源状态。

图形服务可以通过该接口获设置显示设备的电源状态。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
status	输入参数，表示需要设置的电源状态。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayProperty

int32_t(* DeviceFuncs::SetDisplayProperty) (uint32_t devId, uint32_t id, uint64_t value)

描述:

设置显示设备属性值。

图形服务可以通过该接口设置显示设备具体的属性值。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
id	输入参数，由接口GetDisplayCapability返回属性ID。
value	输入参数，需要设置的属性值。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetDisplayVsyncEnabled

int32_t(* DeviceFuncs::SetDisplayVsyncEnabled) (uint32_t devId, bool enabled)

描述:

使能垂直同步信号。

图形服务可以通过该接口使能或取消垂直同步信号，当有垂直同步信号产生时，接口实现层需要回调图形服务通过RegDisplayVBlankCallback注册的 VBlankCallback 回调。 图形服务在需要刷新显示时需要使能垂直同步信号，在收到VBlankCallback事件回调时再进行合成送显，不需要刷新显示时需要取消垂直同步信号。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
enabled	输入参数，使能状态，true表示能，false表示不能。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

SetVirtualDisplayBuffer

int32_t(* DeviceFuncs::SetVirtualDisplayBuffer) (uint32_t devId, BufferHandle *buffer, int32_t fence)

描述:

设置虚拟屏的输出缓存。

该接口用于设置虚拟屏输出缓存，接口实现层需要将虚拟屏的输出放入到该缓存中，接口实现层需要等待同步栅栏发送信号后才能使用缓存。

参数:

名称	描述
devId	输入参数，指示需要操作的设备ID。
buffer	输出参数，输出缓存。
fence	输出参数，同步栅栏。

返回:

DISPLAY_SUCCESS 表示执行成功。

其他值表示执行失败，具体错误码查看DispErrCode。

solid

VGUSolid* VGUPaintStyle::solid

描述:

颜色对象

spread

VGUFillSpread VGUGradient::spread

描述:

渐变延伸模式

stop

float VGUColorStop::stop

描述:

颜色偏移位置，值范围是 0.0 ~ 1.0

stopCount

uint16_t VGUGradient::stopCount

描述:

渐变停止颜色个数

stride [¹⁄₂]

int32_t ISurface::stride

描述:

图像跨度

stride [²⁄₂]

uint32_t VGUBuffer::stride

描述:

位图stride

supportLayers

uint32_t DisplayCapability::supportLayers

描述:

支持的图层数

supportWriteBack

bool DisplayCapability::supportWriteBack

描述:

是否支持回写

time

int64_t PresentTimestamp::time

描述:

类型对应的值

type [¹⁄₇]

LayerType LayerInfo::type

描述:

图层类型，包括图形层、视频层和媒体播放模式

type [²⁄₇]

InterfaceType DisplayCapability::type

描述:

显示屏接口类型

type [³⁄₇]

PresentTimestampType PresentTimestamp::type

描述:

上屏时间戳类型

type [⁴⁄₇]

VGUPathDataType VGUPath::type

描述:

路径数据存储类型

type [⁵⁄₇]

uint32_t VGUMatrix3::type

描述:

矩阵变换类型，简单变换为缩放，平移，90度倍数旋转

type [⁶⁄₇]

VGUGradientType VGUGradient::type

描述:

渐变类型

type [⁷⁄₇]

VGUPaintType VGUPaintStyle::type

描述:

渲染类型

uOffset

size_t YUVDescInfo::uOffset

描述:

U的偏移量

usage [¹⁄₂]

uint64_t AllocInfo::usage

描述:

申请内存的使用场景

usage [²⁄₂]

uint64_t VerifyAllocInfo::usage

描述:

内存的用处

uvStep

size_t YUVDescInfo::uvStep

描述:

UV的step信息

uvStride

size_t YUVDescInfo::uvStride

描述:

UV的stride信息

value [¹⁄₂]

uint64_t PropertyObject::value

描述:

属性值

value [²⁄₂]

float HDRMetaData::value

描述:

关键字对应的值

virAddr [¹⁄₂]

void* BufferData::virAddr

描述:

虚拟内存地址

virAddr [²⁄₂]

void* VGUBuffer::virAddr

描述:

位图缓存的虚拟地址

virtualDispCount

uint32_t DisplayCapability::virtualDispCount

描述:

支持的虚拟屏数

vOffset

size_t YUVDescInfo::vOffset

描述:

V的偏移量

w [¹⁄₂]

int32_t IRect::w

描述:

矩形框宽度

w [²⁄₂]

VGUScalar VGURect::w

描述:

矩形宽度

width [¹⁄₉]

uint32_t DisplayInfo::width

描述:

显示屏宽度

width [²⁄₉]

int32_t LayerInfo::width

描述:

图层宽度

width [³⁄₉]

int32_t LayerBuffer::width

描述:

buffer宽度

width [⁴⁄₉]

int32_t ISurface::width

描述:

图像宽度

width [⁵⁄₉]

int32_t DisplayModeInfo::width

描述:

像素宽度

width [⁶⁄₉]

uint32_t AllocInfo::width

描述:

申请内存宽度

width [⁷⁄₉]

uint32_t VerifyAllocInfo::width

描述:

分配内存的宽度

width [⁸⁄₉]

uint32_t VGUBuffer::width

描述:

位图宽度

width [⁹⁄₉]

float VGUStrokeAttr::width

描述:

线宽

wrapx

VGUWrapType VGUPattern::wrapx

描述:

图像水平方向平铺类型

wrapy

VGUWrapType VGUPattern::wrapy

描述:

图像垂直方向平铺类型

x [¹⁄₄]

int32_t IRect::x

描述:

矩形框起始x坐标

x [²⁄₄]

int32_t ICircle::x

描述:

圆心x坐标

x [³⁄₄]

VGUScalar VGUPoint::x

描述:

点水平坐标

x [⁴⁄₄]

VGUScalar VGURect::x

描述:

矩形水平起始坐标

x0 [¹⁄₂]

int32_t ILine::x0

描述:

线条起点的x坐标

x0 [²⁄₂]

VGUScalar VGURadial::x0

描述:

内圈圆心水平坐标

x1 [¹⁄₃]

int32_t ILine::x1

描述:

线条终点的x坐标

x1 [²⁄₃]

VGUScalar VGULinear::x1

描述:

线性渐变起点水平坐标

x1 [³⁄₃]

VGUScalar VGURadial::x1

描述:

外圈圆心水平坐标

x2

VGUScalar VGULinear::x2

描述:

线性渐变终点水平坐标

y [¹⁄₄]

int32_t IRect::y

描述:

矩形框起始y坐标

y [²⁄₄]

int32_t ICircle::y

描述:

圆心y坐标r

y [³⁄₄]

VGUScalar VGUPoint::y

描述:

点垂直坐标

y [⁴⁄₄]

VGUScalar VGURect::y

描述:

矩形垂直起始坐标

y0 [¹⁄₂]

int32_t ILine::y0

描述:

线条起点的y坐标

y0 [²⁄₂]

VGUScalar VGURadial::y0

描述:

内圈圆心垂直坐标

y1 [¹⁄₃]

int32_t ILine::y1

描述:

线条终点的y坐标

y1 [²⁄₃]

VGUScalar VGULinear::y1

描述:

线性渐变起点垂直坐标

y1 [³⁄₃]

VGUScalar VGURadial::y1

描述:

外圈圆心垂直坐标

y2

VGUScalar VGULinear::y2

描述:

线性渐变终点垂直坐标

yOffset

size_t YUVDescInfo::yOffset

描述:

Y的偏移量

yStride

size_t YUVDescInfo::yStride

描述:

Y的stride信息

你可能感兴趣的鸿蒙文章

harmony 鸿蒙HDI 参数参考

harmony 鸿蒙ActRecognitionEvent

harmony 鸿蒙Activation

harmony 鸿蒙ActivityRecognitionTypes.idl

harmony 鸿蒙AddFusion

harmony 鸿蒙Alignment

harmony 鸿蒙AllocInfo

harmony 鸿蒙ApduSimIORequestInfo

harmony 鸿蒙ArgMaxFusion

harmony 鸿蒙Audio