harmony 鸿蒙Display

  • 2022-08-09
  • 浏览 (2030)

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 [12]

uint8_t LayerAlpha::alpha0

描述:

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

alpha0 [22]

uint8_t ISurface::alpha0

描述:

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

alpha1 [12]

uint8_t LayerAlpha::alpha1

描述:

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

alpha1 [22]

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 [13]

VGUBuffer* VGUMaskLayer::buffer

描述:

蒙版缓存

buffer [23]

VGUBuffer* VGUSurface::buffer

描述:

位图缓存

buffer [33]

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 [15]

uint32_t ILine::color

描述:

线条颜色

color [25]

uint32_t ICircle::color

描述:

圆的颜色

color [35]

uint32_t Rectangle::color

描述:

矩形颜色

color [45]

uint32_t VGUColorStop::color

描述:

偏移位置对应颜色

color [55]

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 [12]

BufferData LayerBuffer::data

描述:

图层buffer数据

data [22]

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 [12]

bool LayerAlpha::enGlobalAlpha

描述:

全局alpha使能标志

enGlobalAlpha [22]

bool GfxOpt::enGlobalAlpha

描述:

全局alpha使能位

enPixelAlpha [12]

bool LayerAlpha::enPixelAlpha

描述:

像素alpha使能标志

enPixelAlpha [22]

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 [12]

PixelFormat AllocInfo::format

描述:

申请内存格式

format [22]

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 [12]

int32_t IRect::h

描述:

矩形框高度

h [22]

VGUScalar VGURect::h

描述:

矩形高度

hdl

BufferHandle* LayerBuffer::hdl

描述:

图层buffer句柄

height [18]

uint32_t DisplayInfo::height

描述:

显示屏高度

height [28]

int32_t LayerInfo::height

描述:

图层高度

height [38]

int32_t LayerBuffer::height

描述:

buffer高度

height [48]

int32_t ISurface::height

描述:

图像高度

height [58]

int32_t DisplayModeInfo::height

描述:

像素高度

height [68]

uint32_t AllocInfo::height

描述:

申请内存高度

height [78]

uint32_t VerifyAllocInfo::height

描述:

分配内存的高度

height [88]

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 [12]

VGUMatrix3* VGUImage::matrix

描述:

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

matrix [22]

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 [12]

char PropertyObject::name[PROPERTY_NAME_LEN]

描述:

属性名称

name [22]

char DisplayCapability::name[PROPERTY_NAME_LEN]

描述:

显示设备名称

numSegments

int32_t VGUPath::numSegments

描述:

路径命令总数

opacity [13]

uint8_t VGUImage::opacity

描述:

透明度,范围0~255

opacity [23]

uint8_t VGUGradient::opacity

描述:

透明度,范围0~255

opacity [33]

uint8_t VGUSolid::opacity

描述:

透明度,值范围 0 ~ 255

pattern

VGUPattern* VGUPaintStyle::pattern

描述:

图片模式对象

phyAddr [13]

uint64_t BufferData::phyAddr

描述:

物理内存地址

phyAddr [23]

uint64_t ISurface::phyAddr

描述:

图像首地址

phyAddr [33]

uint64_t VGUBuffer::phyAddr

描述:

位图缓存的物理地址

phyHeight

uint32_t DisplayCapability::phyHeight

描述:

物理高度

phyWidth

uint32_t DisplayCapability::phyWidth

描述:

物理宽度

pitch

int32_t LayerBuffer::pitch

描述:

一行数据所占字节数

pixelFormat

VGUPixelFormat VGUBuffer::pixelFormat

描述:

像素格式

pixFormat [12]

PixelFormat LayerInfo::pixFormat

描述:

图层像素格式

pixFormat [22]

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 [13]

IRect Rectangle::rect

描述:

矩形区域

rect [23]

VGURect* VGUMaskLayer::rect

描述:

蒙版矩形

rect [33]

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 [12]

int32_t ISurface::stride

描述:

图像跨度

stride [22]

uint32_t VGUBuffer::stride

描述:

位图stride

supportLayers

uint32_t DisplayCapability::supportLayers

描述:

支持的图层数

supportWriteBack

bool DisplayCapability::supportWriteBack

描述:

是否支持回写

time

int64_t PresentTimestamp::time

描述:

类型对应的值

type [17]

LayerType LayerInfo::type

描述:

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

type [27]

InterfaceType DisplayCapability::type

描述:

显示屏接口类型

type [37]

PresentTimestampType PresentTimestamp::type

描述:

上屏时间戳类型

type [47]

VGUPathDataType VGUPath::type

描述:

路径数据存储类型

type [57]

uint32_t VGUMatrix3::type

描述:

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

type [67]

VGUGradientType VGUGradient::type

描述:

渐变类型

type [77]

VGUPaintType VGUPaintStyle::type

描述:

渲染类型

uOffset

size_t YUVDescInfo::uOffset

描述:

U的偏移量

usage [12]

uint64_t AllocInfo::usage

描述:

申请内存的使用场景

usage [22]

uint64_t VerifyAllocInfo::usage

描述:

内存的用处

uvStep

size_t YUVDescInfo::uvStep

描述:

UV的step信息

uvStride

size_t YUVDescInfo::uvStride

描述:

UV的stride信息

value [12]

uint64_t PropertyObject::value

描述:

属性值

value [22]

float HDRMetaData::value

描述:

关键字对应的值

virAddr [12]

void* BufferData::virAddr

描述:

虚拟内存地址

virAddr [22]

void* VGUBuffer::virAddr

描述:

位图缓存的虚拟地址

virtualDispCount

uint32_t DisplayCapability::virtualDispCount

描述:

支持的虚拟屏数

vOffset

size_t YUVDescInfo::vOffset

描述:

V的偏移量

w [12]

int32_t IRect::w

描述:

矩形框宽度

w [22]

VGUScalar VGURect::w

描述:

矩形宽度

width [19]

uint32_t DisplayInfo::width

描述:

显示屏宽度

width [29]

int32_t LayerInfo::width

描述:

图层宽度

width [39]

int32_t LayerBuffer::width

描述:

buffer宽度

width [49]

int32_t ISurface::width

描述:

图像宽度

width [59]

int32_t DisplayModeInfo::width

描述:

像素宽度

width [69]

uint32_t AllocInfo::width

描述:

申请内存宽度

width [79]

uint32_t VerifyAllocInfo::width

描述:

分配内存的宽度

width [89]

uint32_t VGUBuffer::width

描述:

位图宽度

width [99]

float VGUStrokeAttr::width

描述:

线宽

wrapx

VGUWrapType VGUPattern::wrapx

描述:

图像水平方向平铺类型

wrapy

VGUWrapType VGUPattern::wrapy

描述:

图像垂直方向平铺类型

x [14]

int32_t IRect::x

描述:

矩形框起始x坐标

x [24]

int32_t ICircle::x

描述:

圆心x坐标

x [34]

VGUScalar VGUPoint::x

描述:

点水平坐标

x [44]

VGUScalar VGURect::x

描述:

矩形水平起始坐标

x0 [12]

int32_t ILine::x0

描述:

线条起点的x坐标

x0 [22]

VGUScalar VGURadial::x0

描述:

内圈圆心水平坐标

x1 [13]

int32_t ILine::x1

描述:

线条终点的x坐标

x1 [23]

VGUScalar VGULinear::x1

描述:

线性渐变起点水平坐标

x1 [33]

VGUScalar VGURadial::x1

描述:

外圈圆心水平坐标

x2

VGUScalar VGULinear::x2

描述:

线性渐变终点水平坐标

y [14]

int32_t IRect::y

描述:

矩形框起始y坐标

y [24]

int32_t ICircle::y

描述:

圆心y坐标r

y [34]

VGUScalar VGUPoint::y

描述:

点垂直坐标

y [44]

VGUScalar VGURect::y

描述:

矩形垂直起始坐标

y0 [12]

int32_t ILine::y0

描述:

线条起点的y坐标

y0 [22]

VGUScalar VGURadial::y0

描述:

内圈圆心垂直坐标

y1 [13]

int32_t ILine::y1

描述:

线条终点的y坐标

y1 [23]

VGUScalar VGULinear::y1

描述:

线性渐变起点垂直坐标

y1 [33]

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

0  赞