Display


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

宏定义

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

类型定义

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

枚举

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

变量

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

宏定义说明

PROPERTY_NAME_LEN

#define PROPERTY_NAME_LEN   50
1

描述:

属性名称长度

HDI_VGU_SCALAR_IS_FLOAT

#define HDI_VGU_SCALAR_IS_FLOAT   1
1

描述:

VGU标量是否为浮点型

类型定义说明

VGUPixelFormat

typedef PixelFormat VGUPixelFormat; 
1

描述:

像素格式

VGUBlendType

typedef BlendType VGUBlendType; 
1

描述:

混合操作类型

VGUScalar

#ifdef HDI_VGU_SCALAR_IS_FLOAT
typedef float VGUScalar;
#else
typedef int32_t VGUScalar;
#endif
1
2
3
4
5

描述:

VGU标量

HotPlugCallback

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

描述:

热插拔事件回调。

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

参数:

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

RefreshCallback

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

描述:

刷新请求回调。

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

参数:

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

VBlankCallback

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

描述:

VBlank 事件回调。

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

参数:

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

枚举类型说明

anonymous enum

anonymous enum
1

描述:

定义缓冲区使用。

枚举值 描述
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
1

描述:

支持的图像混合类型。

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

枚举值 描述
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
1

描述:

枚举颜色空间的类型

枚举值 描述
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
1

描述:

色域类型枚举值

枚举值 描述
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
1

描述:

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

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

CompositionType

enum CompositionType
1

描述:

枚举特殊层的组合类型。

枚举值 描述
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
1

描述:

热插拔连接类型定义

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

DispErrCode

enum DispErrCode
1

描述:

返回值类型定义。

枚举值 描述
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
1

描述:

枚举显示状态

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

GamutMap

enum GamutMap
1

描述:

枚举色域的映射类型

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

HDRFormat

enum HDRFormat
1

描述:

枚举HDR格式

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

HDRMetadataKey

enum HDRMetadataKey
1

描述:

枚举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
1

描述:

枚举接口类型。

枚举值 描述
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
1

描述:

图层类型定义。

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

MirrorType

enum MirrorType
1

描述:

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

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

PixelFormat

enum PixelFormat
1

描述:

像素格式类型定义。

枚举值 描述
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
1

描述:

上屏时间戳类型枚举值

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

RopType

enum RopType
1

描述:

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

硬件加速支持的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
1

描述:

图层变换类型定义。

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

VGUCapability

enum VGUCapability
1

描述:

硬件加速能力。

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

VGUClipType

enum VGUClipType
1

描述:

绘制表面剪切类型。

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

VGUFillRule

enum VGUFillRule
1

描述:

填充规则定义。

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

VGUFillSpread

enum VGUFillSpread
1

描述:

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

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

VGUFilter

enum VGUFilter
1

描述:

图像滤波类型。

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

VGUGradientType

enum VGUGradientType
1

描述:

渐变类型。

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

VGUJointType

enum VGUJointType
1

描述:

联接类型。

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

VGULineCap

enum VGULineCap
1

描述:

线帽。

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

VGUPaintType

enum VGUPaintType
1

描述:

渲染对象

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

VGUPathCmd

enum VGUPathCmd
1

描述:

路径绘制指令类型。

枚举值 描述
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
1

描述:

路径坐标数据类型。

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

VGUResult

enum VGUResult
1

描述:

错误码定义。

枚举值 描述
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
1

描述:

变换类型。

枚举值 描述
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
1

描述:

图像模式填充延展类型。

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

函数说明

DeviceInitialize()

int32_t DeviceInitialize (DeviceFuncs ** funcs)
1

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

DeviceUninitialize()

int32_t DeviceUninitialize (DeviceFuncs * funcs)
1

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GfxInitialize()

int32_t GfxInitialize (GfxFuncs ** funcs)
1

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GfxUninitialize()

int32_t GfxUninitialize (GfxFuncs * funcs)
1

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GrallocInitialize()

int32_t GrallocInitialize (GrallocFuncs ** funcs)
1

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GrallocUninitialize()

int32_t GrallocUninitialize (GrallocFuncs * funcs)
1

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

LayerInitialize()

int32_t LayerInitialize (LayerFuncs ** funcs)
1

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

参见:

LayerUninitialize

LayerUninitialize()

int32_t LayerUninitialize (LayerFuncs * funcs)
1

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

参见:

LayerInitialize

VGUGradientClearStop()

VGUResult VGUGradientClearStop (VGUGradient * gradient)
1

描述:

清除ColorStop。

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUGradientColorStop()

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

描述:

对渐变添加ColorStop。

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUGradientConic()

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

描述:

创建圆锥渐变对象。

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUGradientLinear()

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

描述:

创建线性渐变对象。

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUGradientMatrix()

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

描述:

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

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUGradientRadial()

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

描述:

创建辐射渐变对象

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUInitialize()

VGUResult VGUInitialize (VGUFuncs ** funcs)
1

描述:

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

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUMatrixIdentity()

VGUResult VGUMatrixIdentity (VGUMatrix3 * matrix)
1

描述:

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

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUMatrixRotate()

VGUResult VGUMatrixRotate (VGUMatrix3 * matrix, float degree )
1

描述:

矩阵变换旋转。

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUMatrixScale()

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

描述:

矩阵变换缩放。

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUMatrixTranslate()

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

描述:

矩阵变换平移。

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUPathAppend()

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

描述:

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

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUPathClear()

VGUResult VGUPathClear (VGUPath * path)
1

描述:

清除路径对象内存。

参数:

名称 描述
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 )
1

描述:

初始化路径对象。

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

VGUUninitialize()

VGUResult VGUUninitialize (VGUFuncs * funcs)
1

描述:

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

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

变量说明

alpha0 [1/2]

uint8_t LayerAlpha::alpha0
1

描述:

alpha0值,取值范围:[0, 255]

alpha0 [2/2]

uint8_t ISurface::alpha0
1

描述:

Alpha0值,取值范围:[0,255]

alpha1 [1/2]

uint8_t LayerAlpha::alpha1
1

描述:

alpha1值,取值范围:[0, 255]

alpha1 [2/2]

uint8_t ISurface::alpha1
1

描述:

Alpha1值,取值范围:[0,255]

alphaRopType

RopType GfxOpt::alphaRopType
1

描述:

Alpha的Rop类型

bAlphaExt1555

bool ISurface::bAlphaExt1555
1

描述:

是否使能1555的Alpha扩展

bAlphaMax255

bool ISurface::bAlphaMax255
1

描述:

图像alpha最大值为255还是128

baseAddr

void* YUVDescInfo::baseAddr
1

描述:

内存的初始地址

blend

VGUBlendType VGUSurface::blend
1

描述:

混合叠加模式

blendType

BlendType GfxOpt::blendType
1

描述:

混合方式

boundBox

VGURect VGUPath::boundBox
1

描述:

路径最大边界

bpp

int32_t LayerInfo::bpp
1

描述:

每像素所占bit数

buffer [1/3]

VGUBuffer* VGUMaskLayer::buffer
1

描述:

蒙版缓存

buffer [2/3]

VGUBuffer* VGUSurface::buffer
1

描述:

位图缓存

VGUSurface::clipRect

buffer [3/3]

VGUBuffer* VGUImage::buffer
1

描述:

图像存储缓存

bYCbCrClut

bool ISurface::bYCbCrClut
1

描述:

CLUT表是否位于 YCbCr 空间

cap

VGULineCap VGUStrokeAttr::cap
1

描述:

线帽类型

cbcrPhyAddr

uint64_t ISurface::cbcrPhyAddr
1

描述:

CbCr分量地址

cbcrStride

int32_t ISurface::cbcrStride
1

描述:

CbCr分量跨度

clipPath

VGUPath* VGUSurface::clipPath
1

描述:

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

clipRect

VGURect* VGUSurface::clipRect
1

描述:

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

clipType

VGUClipType VGUSurface::clipType
1

描述:

表面剪切类型

clutPhyAddr

uint64_t ISurface::clutPhyAddr
1

描述:

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

color [1/5]

uint32_t ILine::color
1

描述:

线条颜色

color [2/5]

uint32_t ICircle::color
1

描述:

圆的颜色

color [3/5]

uint32_t Rectangle::color
1

描述:

矩形颜色

color [4/5]

uint32_t VGUColorStop::color
1

描述:

偏移位置对应颜色

color [5/5]

uint32_t VGUSolid::color
1

描述:

颜色值

colorKeyFrom

ColorKey GfxOpt::colorKeyFrom
1

描述:

色键模式

colorRopType

RopType GfxOpt::colorRopType
1

描述:

颜色的Rop类型

colorStops

VGUColorStop* VGUGradient::colorStops
1

描述:

渐变停止颜色数组指针

Commit

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

描述:

提交合成送显请求。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

conic

VGUConic VGUGradient::conic
1

描述:

圆锥渐变对象

CreateVirtualDisplay

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

描述:

创建虚拟显示设备。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

cx

VGUScalar VGUConic::cx
1

描述:

圆弧中心x坐标

cy

VGUScalar VGUConic::cy
1

描述:

圆弧中心y坐标

data [1/2]

BufferData LayerBuffer::data
1

描述:

图层buffer数据

data [2/2]

uint8_t* VGUPath::data
1

描述:

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

DeinitVgu

VGUResult(* VGUFuncs::DeinitVgu) (void)
1

描述:

去初始化硬件加速。

返回:

VGU_SUCCESS 表示执行成功。

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

参见:

InitVgu

DestroyVirtualDisplay

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

描述:

销毁虚拟显示设备。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

enableRop

bool GfxOpt::enableRop
1

描述:

Rop功能使能位

enableScale

bool GfxOpt::enableScale
1

描述:

缩放功能使能位

enAlias

bool VGUPath::enAlias
1

描述:

抗锯齿开关

enColorFmt

PixelFormat ISurface::enColorFmt
1

描述:

图像格式

enGlobalAlpha [1/2]

bool LayerAlpha::enGlobalAlpha
1

描述:

全局alpha使能标志

enGlobalAlpha [2/2]

bool GfxOpt::enGlobalAlpha
1

描述:

全局alpha使能位

enPixelAlpha [1/2]

bool LayerAlpha::enPixelAlpha
1

描述:

像素alpha使能标志

enPixelAlpha [2/2]

bool GfxOpt::enPixelAlpha
1

描述:

像素alpha使能位

expectedSize

uint32_t AllocInfo::expectedSize
1

描述:

申请内存大小

fd

int32_t ExtDataHandle::fd
1

描述:

句柄 fd, -1代表不支持

fenceId

int32_t LayerBuffer::fenceId
1

描述:

buffer 的fence号r

filter

VGUFilter VGUSurface::filter
1

描述:

图像滤波类型

format [1/2]

PixelFormat AllocInfo::format
1

描述:

申请内存格式

format [2/2]

PixelFormat VerifyAllocInfo::format
1

描述:

分配内存的像素格式

formatCount

uint32_t HDRCapability::formatCount
1

描述:

支持的HDR格式的数量

formats

HDRFormat* HDRCapability::formats
1

描述:

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

freshRate

uint32_t DisplayModeInfo::freshRate
1

描述:

刷新速率

gAlpha

uint8_t LayerAlpha::gAlpha
1

描述:

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

GetDisplayBacklight

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetDisplayCapability

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

描述:

获取显示设备能力集。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetDisplayColorGamut

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

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetDisplayCompChange

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetDisplayGamutMap

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

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetDisplayMode

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetDisplayPowerStatus

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetDisplayProperty

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

描述:

获取显示设备属性值。

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

参数:

名称 描述
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)
1

描述:

获取显示图层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)
1

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetDisplaySupportedModes

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetHDRCapabilityInfos

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

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetSupportedMetadataKey

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

描述:

获取显示设备支持的 HDRMetadataKey。

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

GetWriteBackFrame

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

描述:

获取显示设备的回写帧。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

globalAlpha

uint32_t GfxOpt::globalAlpha
1

描述:

全局alpha的值

gradient

VGUGradient* VGUPaintStyle::gradient
1

描述:

渐变对象

h [1/2]

int32_t IRect::h
1

描述:

矩形框高度

h [2/2]

VGUScalar VGURect::h
1

描述:

矩形高度

hdl

BufferHandle* LayerBuffer::hdl
1

描述:

图层buffer句柄

height [1/8]

uint32_t DisplayInfo::height
1

描述:

显示屏高度

height [2/8]

int32_t LayerInfo::height
1

描述:

图层高度

height [3/8]

int32_t LayerBuffer::height
1

描述:

buffer高度

height [4/8]

int32_t ISurface::height
1

描述:

图像高度

height [5/8]

int32_t DisplayModeInfo::height
1

描述:

像素高度

height [6/8]

uint32_t AllocInfo::height
1

描述:

申请内存高度

height [7/8]

uint32_t VerifyAllocInfo::height
1

描述:

分配内存的高度

height [8/8]

uint32_t VGUBuffer::height
1

描述:

位图高度

id

int32_t DisplayModeInfo::id
1

描述:

模式ID

image

VGUImage* VGUPattern::image
1

描述:

图像对象

InitVgu

VGUResult(* VGUFuncs::InitVgu) (void)
1

描述:

初始化硬件加速。

返回:

VGU_SUCCESS 表示执行成功。

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

参见:

DeinitVgu

InvokeDisplayCmd

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

描述:

调用显示设备命令。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

join

VGUJointType VGUStrokeAttr::join
1

描述:

联结类型

key

HDRMetadataKey HDRMetaData::key
1

描述:

HDR元数据关键字

linear

VGULinear VGUGradient::linear
1

描述:

线性渐变对象

m

float VGUMatrix3::m[3][3]
1

描述:

3x3变换矩阵

mask

VGUMaskLayer* VGUSurface::mask
1

描述:

蒙版图层,可以为空

matrix [1/2]

VGUMatrix3* VGUImage::matrix
1

描述:

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

matrix [2/2]

VGUMatrix3* VGUGradient::matrix
1

描述:

针对渐变对象的变换矩阵

maxAverageLum

float HDRCapability::maxAverageLum
1

描述:

最大的平均光亮度luminance值

maxLum

float HDRCapability::maxLum
1

描述:

最大的光亮度luminance值

minLum

float HDRCapability::minLum
1

描述:

最小的光亮度luminance值

mirrorType

MirrorType GfxOpt::mirrorType
1

描述:

镜像类型

miterLimit

float VGUStrokeAttr::miterLimit
1

描述:

最大斜切长度

name [1/2]

char PropertyObject::name[PROPERTY_NAME_LEN]
1

描述:

属性名称

name [2/2]

char DisplayCapability::name[PROPERTY_NAME_LEN]
1

描述:

显示设备名称

numSegments

int32_t VGUPath::numSegments
1

描述:

路径命令总数

opacity [1/3]

uint8_t VGUImage::opacity
1

描述:

透明度,范围0~255

opacity [2/3]

uint8_t VGUGradient::opacity
1

描述:

透明度,范围0~255

opacity [3/3]

uint8_t VGUSolid::opacity
1

描述:

透明度,取值范围 0 ~ 255。

pattern

VGUPattern* VGUPaintStyle::pattern
1

描述:

图片模式对象

phyAddr [1/3]

uint64_t BufferData::phyAddr
1

描述:

物理内存地址

phyAddr [2/3]

uint64_t ISurface::phyAddr
1

描述:

图像首地址

phyAddr [3/3]

uint64_t VGUBuffer::phyAddr
1

描述:

位图缓存的物理地址

phyHeight

uint32_t DisplayCapability::phyHeight
1

描述:

物理高度

phyWidth

uint32_t DisplayCapability::phyWidth
1

描述:

物理宽度

pitch

int32_t LayerBuffer::pitch
1

描述:

一行数据所占字节数

pixelFormat

VGUPixelFormat VGUBuffer::pixelFormat
1

描述:

像素格式

pixFormat [1/2]

PixelFormat LayerInfo::pixFormat
1

描述:

图层像素格式

pixFormat [2/2]

PixelFormat LayerBuffer::pixFormat
1

描述:

buffer像素格式r

PrepareDisplayLayers

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

描述:

显示设备合成前准备。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

propertyCount

uint32_t DisplayCapability::propertyCount
1

描述:

属性数组大小

propId

uint32_t PropertyObject::propId
1

描述:

属性ID

props

PropertyObject* DisplayCapability::props
1

描述:

属性数组

QueryCapability

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

描述:

查询硬件能力集。

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

r

int32_t ICircle::r
1

描述:

圆的半径

r0

VGUScalar VGURadial::r0
1

描述:

内圈圆半径

r1

VGUScalar VGURadial::r1
1

描述:

外圈圆半径

radial

VGURadial VGUGradient::radial
1

描述:

辐射渐变对象

rect [1/3]

IRect Rectangle::rect
1

描述:

矩形区域

rect [2/3]

VGURect* VGUMaskLayer::rect
1

描述:

蒙版矩形

rect [3/3]

VGURect* VGUImage::rect
1

描述:

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

RegDisplayRefreshCallback

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

描述:

刷新请求回调。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

RegDisplayVBlankCallback

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

描述:

注册VBlank事件回调。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

RegHotPlugCallback

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

描述:

注册热插拔事件回调。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

RenderBlit

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

描述:

对图像进行搬移操作。

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

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

RenderBlitN

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

描述:

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

搬移过程中同时进行颜色空间转换,矩阵变换操作。该接口支持多个源图形同时叠加到目标表面, 对于硬件支持源图像数目可以通过QueryCapability接口查询**。**

参数

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

返回

VGU_SUCCESS 表示执行成功。

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

RenderBlur

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

描述:

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

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

RenderCancel

VGUResult(* VGUFuncs::RenderCancel) ()
1

描述:

取消硬件加速渲染。

返回:

VGU_SUCCESS 表示执行成功。

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

RenderClearRect

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

描述:

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

参数:

名称 描述
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)
1

描述:

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

参数:

名称 描述
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)
1

描述:

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

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

RenderSync

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

描述:

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

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

参数:

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

返回:

VGU_SUCCESS 表示执行成功。

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

reserve

int32_t ExtDataHandle::reserve[0]
1

描述:

reserve数组

reserveInts

uint32_t ExtDataHandle::reserveInts
1

描述:

reserve数组的个数

rotAngle

int32_t DisplayInfo::rotAngle
1

描述:

显示屏旋转角度

rotateType

TransformType GfxOpt::rotateType
1

描述:

旋转类型

rule

VGUFillRule VGUFillAttr::rule
1

描述:

填充规格

segment

uint8_t* VGUPath::segment
1

描述:

存放路径命令数据

SetDisplayBacklight

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayClientBuffer

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayClientCrop

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayClientDamage

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayClientDestRect

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayColorGamut

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

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayColorTransform

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

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayGamutMap

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

描述:

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayMode

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayPowerStatus

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

描述:

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

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayProperty

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

描述:

设置显示设备属性值。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetDisplayVsyncEnabled

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

描述:

使能垂直同步信号。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

SetVirtualDisplayBuffer

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

描述:

设置虚拟屏的输出缓存。

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

参数:

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

返回:

DISPLAY_SUCCESS 表示执行成功。

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

solid

VGUSolid* VGUPaintStyle::solid
1

描述:

颜色对象

spread

VGUFillSpread VGUGradient::spread
1

描述:

渐变延伸模式

stop

float VGUColorStop::stop
1

描述:

颜色偏移位置,取值范围是 0.0 ~ 1.0。

stopCount

uint16_t VGUGradient::stopCount
1

描述:

渐变停止颜色个数

stride [1/2]

int32_t ISurface::stride
1

描述:

图像跨度

stride [2/2]

uint32_t VGUBuffer::stride
1

描述:

位图stride

supportLayers

uint32_t DisplayCapability::supportLayers
1

描述:

支持的图层数

supportWriteBack

bool DisplayCapability::supportWriteBack
1

描述:

是否支持回写

time

int64_t PresentTimestamp::time
1

描述:

类型对应的值

type [1/7]

LayerType LayerInfo::type
1

描述:

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

type [2/7]

InterfaceType DisplayCapability::type
1

描述:

显示屏接口类型

type [3/7]

PresentTimestampType PresentTimestamp::type
1

描述:

上屏时间戳类型

type [4/7]

VGUPathDataType VGUPath::type
1

描述:

路径数据存储类型

type [5/7]

uint32_t VGUMatrix3::type
1

描述:

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

type [6/7]

VGUGradientType VGUGradient::type
1

描述:

渐变类型

type [7/7]

VGUPaintType VGUPaintStyle::type
1

描述:

渲染类型

uOffset

size_t YUVDescInfo::uOffset
1

描述:

U的偏移量

usage [1/2]

uint64_t AllocInfo::usage
1

描述:

申请内存的使用场景

usage [2/2]

uint64_t VerifyAllocInfo::usage
1

描述:

内存的用处

uvStep

size_t YUVDescInfo::uvStep
1

描述:

UV的step信息

uvStride

size_t __attribute__::uvStride
1

描述:

UV的stride信息

value [1/2]

uint64_t PropertyObject::value
1

描述:

属性值

value [2/2]

float HDRMetaData::value
1

描述:

关键字对应的值

virAddr [1/2]

void* BufferData::virAddr
1

描述:

虚拟内存地址

virAddr [2/2]

void* VGUBuffer::virAddr
1

描述:

位图缓存的虚拟地址

virtualDispCount

uint32_t DisplayCapability::virtualDispCount
1

描述:

支持的虚拟屏数

vOffset

size_t YUVDescInfo::vOffset
1

描述:

V的偏移量

w [1/2]

int32_t IRect::w
1

描述:

矩形框宽度

w [2/2]

VGUScalar VGURect::w
1

描述:

矩形宽度

width [1/9]

uint32_t DisplayInfo::width
1

描述:

显示屏宽度

width [2/9]

int32_t LayerInfo::width
1

描述:

图层宽度

width [3/9]

int32_t LayerBuffer::width
1

描述:

buffer宽度

width [4/9]

int32_t ISurface::width
1

描述:

图像宽度

width [5/9]

int32_t DisplayModeInfo::width
1

描述:

像素宽度

width [6/9]

uint32_t AllocInfo::width
1

描述:

申请内存宽度

width [7/9]

uint32_t VerifyAllocInfo::width
1

描述:

分配内存的宽度

width [8/9]

uint32_t VGUBuffer::width
1

描述:

位图宽度

width [9/9]

float VGUStrokeAttr::width
1

描述:

线宽

wrapx

VGUWrapType VGUPattern::wrapx
1

描述:

图像水平方向平铺类型

wrapy

VGUWrapType VGUPattern::wrapy
1

描述:

图像垂直方向平铺类型

x [1/4]

int32_t IRect::x
1

描述:

矩形框起始x坐标

x [2/4]

int32_t ICircle::x
1

描述:

圆心x坐标

x [3/4]

VGUScalar VGUPoint::x
1

描述:

点水平坐标

x [4/4]

VGUScalar VGURect::x
1

描述:

矩形水平起始坐标

x0 [1/2]

int32_t ILine::x0
1

描述:

线条起点的x坐标

x0 [2/2]

VGUScalar VGURadial::x0
1

描述:

内圈圆心水平坐标

x1 [1/3]

int32_t ILine::x1
1

描述:

线条终点的x坐标

x1 [2/3]

VGUScalar VGULinear::x1
1

描述:

线性渐变起点水平坐标

x1 [3/3]

VGUScalar VGURadial::x1
1

描述:

外圈圆心水平坐标

x2

VGUScalar VGULinear::x2
1

描述:

线性渐变终点水平坐标

y [1/4]

int32_t IRect::y
1

描述:

矩形框起始y坐标

y [2/4]

int32_t ICircle::y
1

描述:

圆心y坐标r

y [3/4]

VGUScalar VGUPoint::y
1

描述:

点垂直坐标

y [4/4]

VGUScalar VGURect::y
1

描述:

矩形垂直起始坐标

y0 [1/2]

int32_t ILine::y0
1

描述:

线条起点的y坐标

y0 [2/2]

VGUScalar VGURadial::y0
1

描述:

内圈圆心垂直坐标

y1 [1/3]

int32_t ILine::y1
1

描述:

线条终点的y坐标

y1 [2/3]

VGUScalar VGULinear::y1
1

描述:

线性渐变起点垂直坐标

y1 [3/3]

VGUScalar VGURadial::y1
1

描述:

外圈圆心垂直坐标

y2

VGUScalar VGULinear::y2
1

描述:

线性渐变终点垂直坐标

yOffset

size_t YUVDescInfo::yOffset
1

描述:

Y的偏移量

yStride

size_t YUVDescInfo::yStride
1

描述:

Y的stride信息