From 2e6bdc06bfead2da5f9382c81623222c8132bf65 Mon Sep 17 00:00:00 2001 From: muxiaoximuxiaoxi Date: Thu, 7 Jul 2022 02:11:07 -0700 Subject: [PATCH] =?UTF-8?q?fix=EF=BC=9ADisplay=20hdi=20interface=20annotat?= =?UTF-8?q?ion=20format=20modified?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: muxiaoximuxiaoxi --- zh-cn/device_api/hdi/display/display_device.h | 92 ++++++------ zh-cn/device_api/hdi/display/display_type.h | 133 ++++++++++++------ zh-cn/device_api/hdi/display/display_vgu.h | 8 +- 3 files changed, 138 insertions(+), 95 deletions(-) diff --git a/zh-cn/device_api/hdi/display/display_device.h b/zh-cn/device_api/hdi/display/display_device.h index 205bf8ed..0f246249 100644 --- a/zh-cn/device_api/hdi/display/display_device.h +++ b/zh-cn/device_api/hdi/display/display_device.h @@ -41,22 +41,22 @@ extern "C" { #endif -/* * +/** * @brief 热插拔事件回调 * * 当有热插拔事件发生时，会回调该接口，需要通过RegHotPlugCallback注册该回调接口。 * * @paramdevId 输入参数，显示设备ID，此ID由HDI实现层生成，并通过当前回调接口传递给图形服务使用，用以标记当前连接的显示设备。 * @param connected 输入参数，指明设备的连接状态，ture代表连接，false代表断开。 - * @param data 输出参数，图形服务携带的私有数据，该参数携带的是RegHotPlugCallback接口注册时传递的私有数据地址，详情参考 {@RegHotPlugCallback} - * 接口注册时传递的地址。 + * @param data 输出参数，图形服务携带的私有数据，该参数携带的是RegHotPlugCallback接口注册时传递的私有数据地址， + * 详情参考 {@link RegHotPlugCallback} 接口注册时传递的地址。 * * @since 1.0 * @version 1.0 */ typedef void (*HotPlugCallback)(uint32_t devId, bool connected, void *data); -/* * +/** * @brief VBlank 事件回调。 * * 垂直同步事件回调接口，需要通过RegDisplayVBlankCallback注册该回调接口。 @@ -70,7 +70,7 @@ typedef void (*HotPlugCallback)(uint32_t devId, bool connected, void *data); */ typedef void (*VBlankCallback)(unsigned int sequence, uint64_t ns, void *data); -/* * +/** * @brief 刷新请求回调 * * 刷新请求回调，当接口实现层需要图形服务刷新数据帧时会回调该接口，需要通过RegDisplayRefreshCallback注册该回调接口。 @@ -87,7 +87,7 @@ typedef void (*RefreshCallback)(uint32_t devId, void *data); * @brief 显示设备控制接口结构体，定义显示设备控制接口函数指针。 */ typedef struct { - /* * + /** * @brief 注册热插拔事件回调。 * * 注册热插拔事件回调，当有热插拔事件发生时接口实现层需要回调注册的接口。 @@ -103,7 +103,7 @@ typedef struct { */ int32_t (*RegHotPlugCallback)(HotPlugCallback callback, void *data); - /* * + /** * @brief 注册VBlank事件回调。 * * 注册VBlank事件回调，当有VBlank事件发生时接口实现层需要回调注册的接口。 @@ -120,7 +120,7 @@ typedef struct { */ int32_t (*RegDisplayVBlankCallback)(uint32_t devId, VBlankCallback callback, void *data); - /* * + /** * @brief 刷新请求回调。 * * 注册刷新请求事件回调，当实现层有刷新需求时，实现层通过回调注册的接口通知图形服务。 @@ -137,13 +137,13 @@ typedef struct { */ int32_t (*RegDisplayRefreshCallback)(uint32_t devId, RefreshCallback callback, void *data); - /* * + /** * @brief 获取显示设备能力集。 * * 图形服务可以通过该接口获取显示设备具备哪些显示能力。 * * @param devId 输入参数，指示需要操作的设备ID。 - * @param info 输出参数，设备支持的能力级信息，详情参考 {@DisplayCapability}。 + * @param info 输出参数，设备支持的能力级信息，详情参考 {@link DisplayCapability}。 * * @return DISPLAY_SUCCESS 表示执行成功。 * @return 其他值表示执行失败，具体错误码查看{@link DispErrCode}。 @@ -153,7 +153,7 @@ typedef struct { */ int32_t (*GetDisplayCapability)(uint32_t devId, DisplayCapability *info); - /* * + /** * @brief 获取显示设备支持的显示模式信息。 * * 图形服务可以通过该接口获取到显示设备支持哪些显示模式。 @@ -161,7 +161,7 @@ typedef struct { * @param devId 输入参数，指示需要操作的设备ID。 * @param num 输出参数，设备支持的模式数量。 * @param modes 输出参数，设备支持的所有模式信息，包括所有能支持的分辨率和刷新率，每一个模式实现层都有一个Id与之对应，在获取当前模式 - *和设置当前模式时都会使用到，详情参考 {@DisplayModeInfo}。 + * 和设置当前模式时都会使用到，详情参考 {@link DisplayModeInfo}。 * * @return DISPLAY_SUCCESS 表示执行成功。 * @return 其他值表示执行失败，具体错误码查看{@link DispErrCode}。 @@ -171,7 +171,7 @@ typedef struct { */ int32_t (*GetDisplaySupportedModes)(uint32_t devId, uint32_t *num, DisplayModeInfo *modes); - /* * + /** * @brief 获取显示设备当前的显示模式。 * * 图形服务可以通过该接口获取显示设备当前的显示模式。 @@ -187,7 +187,7 @@ typedef struct { */ int32_t (*GetDisplayMode)(uint32_t devId, uint32_t *modeId); - /* * + /** * @brief 设置显示设备的显示模式。 * * 图形服务可以通过该接口获设置显示设备的显示模式。 @@ -203,7 +203,7 @@ typedef struct { */ int32_t (*SetDisplayMode)(uint32_t devId, uint32_t modeId); - /* * + /** * @brief 获取显示设备当前的电源状态。 * * 图形服务可以通过该接口获设置显示设备的电源状态。 @@ -219,7 +219,7 @@ typedef struct { */ int32_t (*GetDisplayPowerStatus)(uint32_t devId, DispPowerStatus *status); - /* * + /** * @brief 设置显示设备当前的电源状态。 * * 图形服务可以通过该接口获设置显示设备的电源状态。 @@ -235,7 +235,7 @@ typedef struct { */ int32_t (*SetDisplayPowerStatus)(uint32_t devId, DispPowerStatus status); - /* * + /** * @brief 获取显示设备当前的背光值。 * * 图形服务可以通过该接口获取设置显示设备的背光值。 @@ -251,7 +251,7 @@ typedef struct { */ int32_t (*GetDisplayBacklight)(uint32_t devId, uint32_t *level); - /* * + /** * @brief 设置显示设备当前的背光值。 * * 图形服务可以通过该接口获设置显示设备的背光值。 @@ -267,8 +267,8 @@ typedef struct { */ int32_t (*SetDisplayBacklight)(uint32_t devId, uint32_t level); - /* * - * @brief 设置显示设备属性值。 + /** + * @brief 获取显示设备属性值。 * * 图形服务可以通过该接口获取显示设备具体的属性值。 * @@ -284,7 +284,7 @@ typedef struct { */ int32_t (*GetDisplayProperty)(uint32_t devId, uint32_t id, uint64_t *value); - /* * + /** * @brief 设置显示设备属性值。 * * 图形服务可以通过该接口设置显示设备具体的属性值。 @@ -301,7 +301,7 @@ typedef struct { */ int32_t (*SetDisplayProperty)(uint32_t devId, uint32_t id, uint64_t value); - /* * + /** * @brief 显示设备合成前准备。 * * 图形服务在合成前需要通过该接口通知显示设备进行合成前的准备工作。 @@ -318,7 +318,7 @@ typedef struct { */ int32_t (*PrepareDisplayLayers)(uint32_t devId, bool *needFlushFb); - /* * + /** * @brief 获取显示设备合成类型有变化的layer。 * * 在合成准备阶段，显示设备会根据设备的合成能力修改图层的合成类型，该接口会返回哪些图层合成类型发生了变化。 @@ -336,7 +336,7 @@ typedef struct { */ int32_t (*GetDisplayCompChange)(uint32_t devId, uint32_t *num, uint32_t *Layers, int32_t *type); - /* * + /** * @brief 设置显示设备的裁剪区域。 * * 图形服务可以通过该接口设置显示设备的ClientBuffer的裁剪区域，裁剪区域不能超过ClientBuffer的大小。 @@ -352,7 +352,7 @@ typedef struct { */ int32_t (*SetDisplayClientCrop)(uint32_t devId, IRect *rect); - /* * + /** * @brief 设置显示设备的显示区域。 * * 图形服务可以通过该接口设置显示设备的显示区域。 @@ -368,7 +368,7 @@ typedef struct { */ int32_t (*SetDisplayClientDestRect)(uint32_t devId, IRect *rect); - /* * + /** * @brief 设置显示设备的显示缓存。 * * 图形服务可以通过该接口将显示缓存设置给显示设备，显示设备硬件合成结果将会存放在该显示缓存中。 @@ -385,7 +385,7 @@ typedef struct { */ int32_t (*SetDisplayClientBuffer)(uint32_t devId, const BufferHandle *buffer, int32_t fence); - /* * + /** * @brief 设置显示设备的显示脏区。 * * 图形服务可以通过该接口设置显示设备脏区，接口实现层可以根据该区域进行区域刷新，脏区是由多个矩形区域组合起来的。 @@ -402,7 +402,7 @@ typedef struct { */ int32_t (*SetDisplayClientDamage)(uint32_t devId, uint32_t num, IRect *rect); - /* * + /** * @brief 使能垂直同步信号。 * * 图形服务可以通过该接口使能或取消垂直同步信号，当有垂直同步信号产生时，接口实现层需要回调图形服务通过RegDisplayVBlankCallback注册的 @@ -419,7 +419,7 @@ typedef struct { */ int32_t (*SetDisplayVsyncEnabled)(uint32_t devId, bool enabled); - /* * + /** * @brief 获取显示图层fence。 * * 图形服务在调用接口Commit后，需要通过该接口获取图层的fence信息。 @@ -437,7 +437,7 @@ typedef struct { */ int32_t (*GetDisplayReleaseFence)(uint32_t devId, uint32_t *num, uint32_t *layers, int32_t *fences); - /* * + /** * @brief 获取显示设备支持的色域信息。 * * @param devId 输入参数，指示需要操作的设备ID。 @@ -452,7 +452,7 @@ typedef struct { */ int32_t (*GetDisplaySupportedColorGamuts)(uint32_t devId, uint32_t *num, ColorGamut *gamuts); - /* * + /** * @brief 获取显示设备当前的色域模式。 * * @param devId 输入参数，指示需要操作的设备ID。 @@ -466,7 +466,7 @@ typedef struct { */ int32_t (*GetDisplayColorGamut)(uint32_t devId, ColorGamut *gamut); - /* * + /** * @brief 设置显示设备当前的色域模式。 * * @param devId 输入参数，指示需要操作的设备ID。 @@ -480,7 +480,7 @@ typedef struct { */ int32_t (*SetDisplayColorGamut)(uint32_t devId, ColorGamut gamut); - /* * + /** * @brief 获取显示设备当前的色域映射模式。 * * @param devId 输入参数，指示需要操作的设备ID。 @@ -494,7 +494,7 @@ typedef struct { */ int32_t (*GetDisplayGamutMap)(uint32_t devId, GamutMap *gamutMap); - /* * + /** * @brief 设置显示设备当前的色域映射模式。 * * @param devId 输入参数，指示需要操作的设备ID。 @@ -508,7 +508,7 @@ typedef struct { */ int32_t (*SetDisplayGamutMap)(uint32_t devId, GamutMap gamutMap); - /* * + /** * @brief 设置显示设备当前的4x4的颜色转换矩阵。 * * @param devId 输入参数，指示需要操作的设备ID。 @@ -522,7 +522,7 @@ typedef struct { */ int32_t (*SetDisplayColorTransform)(uint32_t devId, const float *matrix); - /* * + /** * @brief 获取显示设备支持的HDR属性信息。 * * @param devId 输入参数，指示需要操作的设备ID。 @@ -536,7 +536,7 @@ typedef struct { */ int32_t (*GetHDRCapabilityInfos)(uint32_t devId, HDRCapability *info); - /* * + /** * @brief 获取显示设备支持的 HDRMetadataKey。 * * @param devId 输入参数，指示需要操作的设备ID。 @@ -551,7 +551,7 @@ typedef struct { */ int32_t (*GetSupportedMetadataKey)(uint32_t devId, uint32_t *num, HDRMetadataKey *keys); - /* * + /** * @brief 提交合成送显请求。 * * 图形服务通过该接口向接口实现层提交合成送显请求，如果有硬件合成层，接口实现层需要在这时进行合成，并且把最终合成的数据送到硬件进行显示。 @@ -568,7 +568,7 @@ typedef struct { */ int32_t (*Commit)(uint32_t devId, int32_t *fence); - /* * + /** * @brief 调用显示设备命令。 * * 该接口用于图形服务和接口实现层之间的的接口扩展，如果由临时接口新增可以通过该接口进行扩展，不用增加新的接口定义。 @@ -583,7 +583,7 @@ typedef struct { */ int32_t (*InvokeDisplayCmd)(uint32_t devId, ...); - /* * + /** * @brief 创建虚拟显示设备。 * * 该接口用于创建一个虚拟显示设备。 @@ -591,7 +591,7 @@ typedef struct { * @param width 输入参数，指定显示设备的像素宽度。 * @param height 输入参数，指定显示设备的像素高度。 * @param format 输出参数，指定显示设备的像素格式。 - * 详情参考{@}PixelFormat，接口实现层可以根据硬件需求，修改format并返回给图形服务。 + * 详情参考{@link PixelFormat}，接口实现层可以根据硬件需求，修改format并返回给图形服务。 * @param devId 输出参数，用于接口层返回创建的设备ID。 * * @return DISPLAY_SUCCESS 表示执行成功。 @@ -602,7 +602,7 @@ typedef struct { */ int32_t (*CreateVirtualDisplay)(uint32_t width, uint32_t height, int32_t *format, uint32_t *devId); - /* * + /** * @brief 销毁虚拟显示设备。 * * 该接口用于销毁指定的虚拟显示设备。 @@ -617,7 +617,7 @@ typedef struct { */ int32_t (*DestroyVirtualDisplay)(uint32_t devId); - /* * + /** * @brief 设置虚拟屏的输出缓存。 * * 该接口用于设置虚拟屏输出缓存，接口实现层需要将虚拟屏的输出放入到该缓存中，接口实现层需要等待同步栅栏发送信号后才能使用缓存。 @@ -634,7 +634,7 @@ typedef struct { */ int32_t (*SetVirtualDisplayBuffer)(uint32_t devId, BufferHandle *buffer, int32_t fence); - /* * + /** * @brief 获取显示设备的回写帧。 * * 该接口用来获取devId指定的回写点数据，接口实现层将显示设备回写点的数据写入到设置的缓存中。 @@ -653,7 +653,7 @@ typedef struct { */ int32_t (*GetWriteBackFrame)(uint32_t devId, BufferHandle *buffer, int32_t *fence); - /* * + /** * @brief 对指定显示设备创建回写点。 * * 该接口用来对指定的设备创建一个回写点，如果回写点数量超过了限制，接口实现层将会返回失败。 @@ -671,7 +671,7 @@ typedef struct { */ int32_t (*CreateWriteBack)(uint32_t *devId, uint32_t width, uint32_t height, int32_t *format); - /* * + /** * @brief 销毁指定显示设备的回写点。 * * 该接口用來销毁指定的回写点。 diff --git a/zh-cn/device_api/hdi/display/display_type.h b/zh-cn/device_api/hdi/display/display_type.h index 3ca5e2f3..f2f5df2a 100644 --- a/zh-cn/device_api/hdi/display/display_type.h +++ b/zh-cn/device_api/hdi/display/display_type.h @@ -79,7 +79,7 @@ typedef enum { LAYER_TYPE_BUTT /**< 空图层 */ } LayerType; -/* * +/** * @brief 定义缓冲区使用。 * */ @@ -374,6 +374,7 @@ typedef struct { MirrorType mirrorType; /**< 镜像类型 */ } GfxOpt; +/** 属性名称长度 */ #define PROPERTY_NAME_LEN 50 /** @@ -402,7 +403,7 @@ typedef enum { DISP_INTF_VGA, /**< VGA 接口 */ DISP_INTF_MIPI, /**< MIPI 接口 */ DISP_INTF_PANEL, /**< PANEL 接口 */ - DISP_INTF_BUTT, + DISP_INTF_BUTT, /**< BUTT 接口, 一个不可用类型, 用于默认初始化 */ } InterfaceType; /** @@ -464,7 +465,7 @@ typedef enum { COMPOSITION_DEVICE_CLEAR, /**< Device clear 合成类型, device会清除目标区域 */ COMPOSITION_CLIENT_CLEAR, /**< Client clear 合成类型, service会清除目标区域 */ COMPOSITION_TUNNEL, /**< Tunnel 合成类型, 用于tunnel. */ - COMPOSITION_BUTT + COMPOSITION_BUTT, /**< 合成类型, 一个不可用类型, 用于默认初始化 */ } CompositionType; /** @@ -503,48 +504,90 @@ typedef enum { */ typedef enum { - COLOR_DATA_SPACE_UNKNOWN = 0, /**< 未知的 */ - GAMUT_BT601 = 0x00000001, /**< BT601色域 */ - GAMUT_BT709 = 0x00000002, /**< BT709色域 */ - GAMUT_DCI_P3 = 0x00000003, /**< DCI_P3色域 */ - GAMUT_SRGB = 0x00000004, /**< SRGB色域 */ - GAMUT_ADOBE_RGB = 0x00000005, /**< ADOBE_RGB色域 */ - GAMUT_DISPLAY_P3 = 0x00000006, /**< DISPLAY_P3色域 */ - GAMUT_BT2020 = 0x00000007, /**< BT2020色域 */ - GAMUT_BT2100_PQ = 0x00000008, /**< BT2100_PQ色域 */ - GAMUT_BT2100_HLG = 0x00000009, /**< BT2100_HLG色域 */ - GAMUT_DISPLAY_BT2020 = 0x0000000a, /**< DISPLAY_BT2020色域 */ - TRANSFORM_FUNC_UNSPECIFIED = 0x00000100, /**< UNSPECIFIED转换函数 */ - TRANSFORM_FUNC_LINEAR = 0x00000200, /**< LINEAR转换函数 */ - TRANSFORM_FUNC_SRGB = 0x00000300, /**< SRGB转换函数 */ - TRANSFORM_FUNC_SMPTE_170M = 0x00000400, /**< SMPTE_170M转换函数 */ - TRANSFORM_FUNC_GM2_2 = 0x00000500, /**< GM2_2转换函数 */ - TRANSFORM_FUNC_GM2_6 = 0x00000600, /**< GM2_6转换函数 */ - TRANSFORM_FUNC_GM2_8 = 0x00000700, /**< GM2_8转换函数 */ - TRANSFORM_FUNC_ST2084 = 0x00000800, /**< ST2084转换函数 */ - TRANSFORM_FUNC_HLG = 0x00000900, /**< HLG转换函数 */ - PRECISION_UNSPECIFIED = 0x00010000, /**< UNSPECIFIED精度 */ - PRECISION_FULL = 0x00020000, /**< FULL精度 */ - PRESION_LIMITED = 0x00030000, /**< LIMITED精度 */ - PRESION_EXTENDED = 0x00040000, /**< EXTENDED精度 */ - BT601_SMPTE170M_FULL = GAMUT_BT601 | TRANSFORM_FUNC_SMPTE_170M | PRECISION_FULL, /**< BT601色域 | SMPTE_170M转换函数 | FULL精度 */ - BT601_SMPTE170M_LIMITED = GAMUT_BT601 | TRANSFORM_FUNC_SMPTE_170M | PRESION_LIMITED, /**< BT601色域 | SMPTE_170M转换函数 | LIMITED精度 */ - BT709_LINEAR_FULL = GAMUT_BT709 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, /**< BT709色域 | LINEAR转换函数 | FULL精度 */ - BT709_LINEAR_EXTENDED = GAMUT_BT709 | TRANSFORM_FUNC_LINEAR | PRESION_EXTENDED, /**< BT709色域 | LINEAR转换函数 | EXTENDED精度 */ - BT709_SRGB_FULL = GAMUT_BT709 | TRANSFORM_FUNC_SRGB | PRECISION_FULL, /**< BT709色域 | SRGB转换函数 | FULL精度 */ - BT709_SRGB_EXTENDED = GAMUT_BT709 | TRANSFORM_FUNC_SRGB | PRESION_EXTENDED, /**< BT709色域 | SRGB转换函数 | EXTENDED精度 */ - BT709_SMPTE170M_LIMITED = GAMUT_BT709 | TRANSFORM_FUNC_SMPTE_170M | PRESION_LIMITED, /**< BT709色域 | SMPTE_170M转换函数 | LIMITED精度 */ - DCI_P3_LINEAR_FULL = GAMUT_DCI_P3 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, /**< DCI_P3色域 | LINEAR转换函数 | FULL精度 */ - DCI_P3_GAMMA26_FULL = GAMUT_DCI_P3 | TRANSFORM_FUNC_GM2_6 | PRECISION_FULL, /**< DCI_P3色域 | GM2_6转换函数 | FULL精度 */ - DISPLAY_P3_LINEAR_FULL = GAMUT_DISPLAY_P3 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, /**< DISPLAY_P3色域 | LINEAR转换函数 | FULL精度 */ - DCI_P3_SRGB_FULL = GAMUT_DCI_P3 | TRANSFORM_FUNC_SRGB | PRECISION_FULL, /**< DCI_P3色域 | SRGB转换函数 | FULL精度 */ - ADOBE_RGB_GAMMA22_FULL = GAMUT_ADOBE_RGB | TRANSFORM_FUNC_GM2_2 | PRECISION_FULL, /**< ADOBE_RGB色域 | GM2_2转换函数 | FULL精度 */ - BT2020_LINEAR_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, /**< BT2020色域 | LINEAR转换函数 | FULL精度 */ - BT2020_SRGB_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_SRGB | PRECISION_FULL, /**< BT2020色域 | SRGB转换函数 | FULL精度 */ - BT2020_SMPTE170M_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_SMPTE_170M | PRECISION_FULL, /**< BT2020色域 | SMPTE_170M转换函数 | FULL精度 */ - BT2020_ST2084_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_ST2084 | PRECISION_FULL, /**< BT2020色域 | ST2084转换函数 | FULL精度 */ - BT2020_HLG_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_HLG | PRECISION_FULL, /**< BT2020色域 | HLG转换函数 | FULL精度 */ - BT2020_ST2084_LIMITED = GAMUT_BT2020 | TRANSFORM_FUNC_ST2084 | PRESION_LIMITED, /**< BT2020色域 | ST2084转换函数 | LIMITED精度 */ + /** 未知的 */ + COLOR_DATA_SPACE_UNKNOWN = 0, + /** BT601色域 */ + GAMUT_BT601 = 0x00000001, + /** BT709色域 */ + GAMUT_BT709 = 0x00000002, + /** DCI_P3色域 */ + GAMUT_DCI_P3 = 0x00000003, + /** SRGB色域 */ + GAMUT_SRGB = 0x00000004, + /** ADOBE_RGB色域 */ + GAMUT_ADOBE_RGB = 0x00000005, + /** DISPLAY_P3色域 */ + GAMUT_DISPLAY_P3 = 0x00000006, + /** BT2020色域 */ + GAMUT_BT2020 = 0x00000007, + /** BT2100_PQ色域 */ + GAMUT_BT2100_PQ = 0x00000008, + /** BT2100_HLG色域 */ + GAMUT_BT2100_HLG = 0x00000009, + /** DISPLAY_BT2020色域 */ + GAMUT_DISPLAY_BT2020 = 0x0000000a, + /** UNSPECIFIED转换函数 */ + TRANSFORM_FUNC_UNSPECIFIED = 0x00000100, + /** LINEAR转换函数 */ + TRANSFORM_FUNC_LINEAR = 0x00000200, + /** SRGB转换函数 */ + TRANSFORM_FUNC_SRGB = 0x00000300, + /** SMPTE_170M转换函数 */ + TRANSFORM_FUNC_SMPTE_170M = 0x00000400, + /** GM2_2转换函数 */ + TRANSFORM_FUNC_GM2_2 = 0x00000500, + /** GM2_6转换函数 */ + TRANSFORM_FUNC_GM2_6 = 0x00000600, + /** GM2_8转换函数 */ + TRANSFORM_FUNC_GM2_8 = 0x00000700, + /** ST2084转换函数 */ + TRANSFORM_FUNC_ST2084 = 0x00000800, + /** HLG转换函数 */ + TRANSFORM_FUNC_HLG = 0x00000900, + /** UNSPECIFIED精度 */ + PRECISION_UNSPECIFIED = 0x00010000, + /** FULL精度 */ + PRECISION_FULL = 0x00020000, + /** LIMITED精度 */ + PRESION_LIMITED = 0x00030000, + /** EXTENDED精度 */ + PRESION_EXTENDED = 0x00040000, + /** BT601色域 | SMPTE_170M转换函数 | FULL精度 */ + BT601_SMPTE170M_FULL = GAMUT_BT601 | TRANSFORM_FUNC_SMPTE_170M | PRECISION_FULL, + /** BT601色域 | SMPTE_170M转换函数 | LIMITED精度 */ + BT601_SMPTE170M_LIMITED = GAMUT_BT601 | TRANSFORM_FUNC_SMPTE_170M | PRESION_LIMITED, + /** BT709色域 | LINEAR转换函数 | FULL精度 */ + BT709_LINEAR_FULL = GAMUT_BT709 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, + /** BT709色域 | LINEAR转换函数 | EXTENDED精度 */ + BT709_LINEAR_EXTENDED = GAMUT_BT709 | TRANSFORM_FUNC_LINEAR | PRESION_EXTENDED, + /** BT709色域 | SRGB转换函数 | FULL精度 */ + BT709_SRGB_FULL = GAMUT_BT709 | TRANSFORM_FUNC_SRGB | PRECISION_FULL, + /** BT709色域 | SRGB转换函数 | EXTENDED精度 */ + BT709_SRGB_EXTENDED = GAMUT_BT709 | TRANSFORM_FUNC_SRGB | PRESION_EXTENDED, + /** BT709色域 | SMPTE_170M转换函数 | LIMITED精度 */ + BT709_SMPTE170M_LIMITED = GAMUT_BT709 | TRANSFORM_FUNC_SMPTE_170M | PRESION_LIMITED, + /** DCI_P3色域 | LINEAR转换函数 | FULL精度 */ + DCI_P3_LINEAR_FULL = GAMUT_DCI_P3 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, + /** DCI_P3色域 | GM2_6转换函数 | FULL精度 */ + DCI_P3_GAMMA26_FULL = GAMUT_DCI_P3 | TRANSFORM_FUNC_GM2_6 | PRECISION_FULL, + /** DISPLAY_P3色域 | LINEAR转换函数 | FULL精度 */ + DISPLAY_P3_LINEAR_FULL = GAMUT_DISPLAY_P3 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, + /** DCI_P3色域 | SRGB转换函数 | FULL精度 */ + DCI_P3_SRGB_FULL = GAMUT_DCI_P3 | TRANSFORM_FUNC_SRGB | PRECISION_FULL, + /** ADOBE_RGB色域 | GM2_2转换函数 | FULL精度 */ + ADOBE_RGB_GAMMA22_FULL = GAMUT_ADOBE_RGB | TRANSFORM_FUNC_GM2_2 | PRECISION_FULL, + /** BT2020色域 | LINEAR转换函数 | FULL精度 */ + BT2020_LINEAR_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_LINEAR | PRECISION_FULL, + /** BT2020色域 | SRGB转换函数 | FULL精度 */ + BT2020_SRGB_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_SRGB | PRECISION_FULL, + /** BT2020色域 | SMPTE_170M转换函数 | FULL精度 */ + BT2020_SMPTE170M_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_SMPTE_170M | PRECISION_FULL, + /** BT2020色域 | ST2084转换函数 | FULL精度 */ + BT2020_ST2084_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_ST2084 | PRECISION_FULL, + /** BT2020色域 | HLG转换函数 | FULL精度 */ + BT2020_HLG_FULL = GAMUT_BT2020 | TRANSFORM_FUNC_HLG | PRECISION_FULL, + /** BT2020色域 | ST2084转换函数 | LIMITED精度 */ + BT2020_ST2084_LIMITED = GAMUT_BT2020 | TRANSFORM_FUNC_ST2084 | PRESION_LIMITED, } ColorDataSpace; /** diff --git a/zh-cn/device_api/hdi/display/display_vgu.h b/zh-cn/device_api/hdi/display/display_vgu.h index e1315d6c..54e8bdbe 100644 --- a/zh-cn/device_api/hdi/display/display_vgu.h +++ b/zh-cn/device_api/hdi/display/display_vgu.h @@ -13,7 +13,7 @@ * limitations under the License. */ -/* * +/** * @addtogroup Display * @{ * @@ -24,7 +24,7 @@ * @since 3.0 */ -/* * +/** * @file display_vgu.h * * @brief 该文件定义2D矢量硬件加速模块相关驱动函数。 @@ -52,7 +52,7 @@ typedef int32_t VGUScalar; typedef PixelFormat VGUPixelFormat; /* < 像素格式 */ typedef BlendType VGUBlendType; /* < 混合操作类型 */ -/* * +/** * @brief 路径坐标数据类型。 * */ @@ -88,7 +88,7 @@ typedef enum { VGU_NO_CONTEXT = -7, /**< 无上下文 */ } VGUResult; -/* * +/** * @brief 线帽。 * */ -- Gitee