VPI - 视觉编程接口

3.2 版本

色彩空间

#define VPI_MAKE_COLOR_SPEC_ABBREV(cspace, encoding, xferFunc, range, locHoriz, locVert)
 使用缩写参数创建用户自定义的颜色规格常量。 更多...
 
#define VPI_MAKE_COLOR_SPEC(cspace, encoding, xferFunc, range, locHoriz, locVert)
 创建用户自定义的颜色规格常量。 更多...
 

枚举

enum  VPIColorModel
 定义色彩模型。 更多...
 
enum  VPIColorSpace
 定义 VPIColorSpec 的色原色和白点。 更多...
 
enum  VPIWhitePoint
 定义与 VPIColorSpace 相关的白点。 更多...
 
enum  VPIYCbCrEncoding
 定义特定 VPIColorSpec 中使用的 YCbCr 编码。 更多...
 
enum  VPIColorTransferFunction
 定义特定 VPIColorSpec 中的颜色传递函数。 更多...
 
enum  VPIColorRange
 定义特定 VPIColorSpec 的颜色范围。 更多...
 
enum  VPIChromaLocation
 色度采样位置。 更多...
 
enum  VPIColorSpec
 颜色规格定义。 更多...
 
enum  VPIRawPattern
 定义 RAW 色彩模型使用的拜耳模式。 更多...
 
enum  VPIChromaSubsampling
 定义色度二次采样的方式。 更多...
 

函数

VPIColorSpec vpiMakeColorSpec (VPIColorSpace cspace, VPIYCbCrEncoding encoding, VPIColorTransferFunction xferFunc, VPIColorRange range, VPIChromaLocation locHoriz, VPIChromaLocation locVert)
 创建用户自定义的 VPIColorSpec更多...
 
VPIChromaSubsampling vpiMakeChromaSubsampling (int samplesHoriz, int samplesVert)
 根据水平和垂直采样创建 VPIChromaSubsampling更多...
 
int vpiChromaSubsamplingGetSamplesHoriz (VPIChromaSubsampling css)
 获取每 4 个水平亮度样本组的色度样本数量。 更多...
 
int vpiChromaSubsamplingGetSamplesVert (VPIChromaSubsampling css)
 获取每 4 个垂直亮度样本组的色度样本数量。 更多...
 
VPIChromaLocation vpiColorSpecGetChromaLocHoriz (VPIColorSpec cspec)
 获取给定颜色规格的色度水平采样位置。 更多...
 
VPIChromaLocation vpiColorSpecGetChromaLocVert (VPIColorSpec cspec)
 获取给定颜色规格的色度垂直采样位置。 更多...
 
VPIColorSpec vpiColorSpecSetChromaLoc (VPIColorSpec cspec, VPIChromaLocation locHoriz, VPIChromaLocation locVert)
 设置给定颜色规格的色度采样位置。 更多...
 
VPIColorSpace vpiColorSpecGetSpace (VPIColorSpec cspec)
 获取给定颜色规格的 color_space。 更多...
 
VPIColorSpec vpiColorSpecSetSpace (VPIColorSpec cspec, VPIColorSpace cspace)
 设置给定颜色规格的 color_space。 更多...
 
VPIYCbCrEncoding vpiColorSpecGetYCbCrEncoding (VPIColorSpec cspec)
 获取给定颜色规格的 R'G'B' <-> Y'CbCr 编码方案。 更多...
 
VPIColorSpec vpiColorSpecSetYCbCrEncoding (VPIColorSpec cspec, VPIYCbCrEncoding encoding)
 设置给定颜色规格的 R'G'B' <-> Y'CbCr 编码方案。 更多...
 
VPIColorTransferFunction vpiColorSpecGetTransferFunction (VPIColorSpec cspec)
 获取给定颜色规格的颜色传递函数。 更多...
 
VPIColorSpec vpiColorSpecSetTransferFunction (VPIColorSpec cspec, VPIColorTransferFunction xferFunc)
 设置给定颜色规格的颜色传递函数。 更多...
 
VPIColorRange vpiColorSpecGetRange (VPIColorSpec cspec)
 获取给定颜色规格的颜色量化范围。 更多...
 
VPIColorSpec vpiColorSpecSetRange (VPIColorSpec cspec, VPIColorRange range)
 设置给定颜色规格的颜色量化范围。 更多...
 
const char * vpiColorSpecGetName (VPIColorSpec cspec)
 返回颜色规格的字符串表示形式。 更多...
 

详细描述

宏定义文档

◆ VPI_MAKE_COLOR_SPEC_ABBREV

#define VPI_MAKE_COLOR_SPEC_ABBREV (   cspace,
  encoding,
  xferFunc,
  range,
  locHoriz,
  locVert 
)

#include <vpi/ColorSpec.h>

使用缩写参数创建用户自定义的颜色规格常量。

示例

VPIColorSpec cspec = VPI_MAKE_COLOR_SPEC_ABBREV(SPACE_BT709, ENC_sRGB, XFER_sYCC, RANGE_FULL, LOC_ODD, LOC_EVEN);
VPIColorSpec
颜色规格定义。
Definition: ColorSpec.h:162
#define VPI_MAKE_COLOR_SPEC_ABBREV(cspace, encoding, xferFunc, range, locHoriz, locVert)
使用缩写参数创建用户自定义的颜色规格常量。
Definition: ColorSpec.h:256
参数
[输入]cspace色彩空间。
[输入]encodingR'G'B' <-> Y'CbCr 编码。
[输入]xferFunc颜色传递函数。
[输入]range颜色量化范围。
[输入]locHoriz水平色度位置。
[输入]locVert垂直色度位置。
返回值
用户自定义的 VPIColorSpec 常量。

Definition at line 256 of file ColorSpec.h.

◆ VPI_MAKE_COLOR_SPEC

#define VPI_MAKE_COLOR_SPEC (   cspace,
  encoding,
  xferFunc,
  range,
  locHoriz,
  locVert 
)

#include <vpi/ColorSpec.h>

创建用户自定义的颜色规格常量。

示例

@ VPI_COLOR_RANGE_FULL
值覆盖底层类型的完整范围。
Definition: ColorSpec.h:131
@ VPI_COLOR_XFER_sYCC
sYCC 标准指定的颜色传递函数。
Definition: ColorSpec.h:121
@ VPI_COLOR_SPACE_BT709
来自 ITU-R BT.709 标准的色原色,D65 白点。
Definition: ColorSpec.h:90
@ VPI_CHROMA_LOC_ODD
使用奇数坐标对色度进行采样。
Definition: ColorSpec.h:140
@ VPI_CHROMA_LOC_EVEN
使用偶数坐标对色度进行采样。
Definition: ColorSpec.h:138
参数
[输入]cspace色彩空间。
[输入]encodingR'G'B' <-> Y'CbCr 编码。
[输入]xferFunc颜色传递函数。
[输入]range颜色量化范围。
[输入]locHoriz水平色度位置。
[输入]locVert垂直色度位置。
返回值
用户自定义的 VPIColorSpec 常量。

Definition at line 279 of file ColorSpec.h.

枚举类型文档

◆ VPIColorModel

#include <vpi/ColorSpec.h>

定义色彩模型。

色彩模型赋予图像格式的每个通道意义。它们以规范的 XYZW 顺序指定,然后可以被交换到所需的顺序。

枚举器
VPI_COLOR_MODEL_UNDEFINED 

色彩模型未定义。

VPI_COLOR_MODEL_YCbCr 

亮度 + 色度(蓝色-亮度,红色-亮度)。

VPI_COLOR_MODEL_RGB 

红色、绿色、蓝色分量。

VPI_COLOR_MODEL_RAW 

RAW 色彩模型,用于拜耳图像格式。

VPI_COLOR_MODEL_XYZ 

CIE XYZ 三刺激值颜色规格。

Definition at line 76 of file ColorSpec.h.

◆ VPIColorSpace

#include <vpi/ColorSpec.h>

定义 VPIColorSpec 的色原色和白点。

枚举器
VPI_COLOR_SPACE_SENSOR 

来自用于捕获图像的传感器的色彩空间。

VPI_COLOR_SPACE_BT601 

来自 ITU-R BT.601/625 行标准(也称为 EBU 3213-E)的色原色。

VPI_COLOR_SPACE_BT709 

来自 ITU-R BT.709 标准的色原色,D65 白点。

VPI_COLOR_SPACE_BT2020 

来自 ITU-R BT.2020 标准的色原色,D65 白点。

VPI_COLOR_SPACE_DCIP3 

来自 DCI-P3 标准的色原色,D65 白点。

VPI_COLOR_SPACE_UNDEFINED 

色彩空间未定义。

Definition at line 86 of file ColorSpec.h.

◆ VPIWhitePoint

#include <vpi/ColorSpec.h>

定义与 VPIColorSpace 相关的白点。

枚举器
VPI_WHITE_POINT_D65 

D65 白点,K = 6504。

VPI_WHITE_POINT_UNDEFINED 

白点未定义。

Definition at line 98 of file ColorSpec.h.

◆ VPIYCbCrEncoding

#include <vpi/ColorSpec.h>

定义特定 VPIColorSpec 中使用的 YCbCr 编码。

枚举器
VPI_YCbCr_ENC_UNDEFINED 

编码未定义。

通常用于非 YCbCr 颜色规格。

VPI_YCbCr_ENC_BT601 

ITU-R BT.601 标准指定的编码。

VPI_YCbCr_ENC_BT709 

ITU-R BT.709 标准指定的编码。

VPI_YCbCr_ENC_BT2020 

ITU-R BT.2020 标准指定的编码。

VPI_YCbCr_ENC_BT2020c 

ITU-R BT.2020 标准指定的恒定亮度编码。

VPI_YCbCr_ENC_SMPTE240M 

SMPTE 240M 标准指定的编码。

Definition at line 106 of file ColorSpec.h.

◆ VPIColorTransferFunction

#include <vpi/ColorSpec.h>

定义特定 VPIColorSpec 中的颜色传递函数。

枚举器
VPI_COLOR_XFER_LINEAR 

线性颜色传递函数。

VPI_COLOR_XFER_sRGB 

sRGB 标准指定的颜色传递函数。

VPI_COLOR_XFER_sYCC 

sYCC 标准指定的颜色传递函数。

VPI_COLOR_XFER_PQ 

感知量化器颜色传递函数。

VPI_COLOR_XFER_BT709 

ITU-R BT.709 标准指定的颜色传递函数。

VPI_COLOR_XFER_BT2020 

ITU-R BT.2020 标准指定的颜色传递函数。

VPI_COLOR_XFER_SMPTE240M 

SMPTE 240M 标准指定的颜色传递函数。

Definition at line 117 of file ColorSpec.h.

◆ VPIColorRange

#include <vpi/ColorSpec.h>

定义特定 VPIColorSpec 的颜色范围。

枚举器
VPI_COLOR_RANGE_FULL 

值覆盖底层类型的完整范围。

VPI_COLOR_RANGE_LIMITED 

值覆盖底层类型的有限范围。

Definition at line 129 of file ColorSpec.h.

◆ VPIChromaLocation

#include <vpi/ColorSpec.h>

色度采样位置。

枚举器
VPI_CHROMA_LOC_EVEN 

使用偶数坐标对色度进行采样。

VPI_CHROMA_LOC_CENTER 

在偶数和奇数坐标之间精确地对色度进行采样。

VPI_CHROMA_LOC_ODD 

使用奇数坐标对色度进行采样。

VPI_CHROMA_LOC_BOTH 

从偶数和奇数坐标采样色度。

当不进行二次采样时使用。

Definition at line 136 of file ColorSpec.h.

◆ VPIColorSpec

#include <vpi/ColorSpec.h>

颜色规格定义。

这些颜色规格定义了如何解释颜色信息。它由几个参数定义

这些参数共同定义了颜色表示如何在色品图上映射到其相应的绝对颜色。

枚举器
VPI_COLOR_SPEC_INVALID 

无效的颜色规格。

当未选择颜色规格时使用。

VPI_COLOR_SPEC_DEFAULT 

默认颜色规格。

表明颜色规格将被推断。

VPI_COLOR_SPEC_UNDEFINED 

未定义颜色规格。

当颜色规格不相关或未定义时使用。颜色规格可以从上下文中推断。如果不可能,将使用下面定义的每个颜色规格组件的值。

VPI_COLOR_SPEC_BT601 

定义 ITU-R BT.601 标准的颜色规格,有限范围,具有 BT.709 色度值和传递函数。

VPI_COLOR_SPEC_BT601_ER 

定义 ITU-R BT.601 标准的颜色规格,完整范围,具有 BT.709 色度值和传递函数。

VPI_COLOR_SPEC_BT709 

定义 ITU-R BT.709 标准的颜色规格,有限范围。

VPI_COLOR_SPEC_BT709_ER 

定义 ITU-R BT.709 标准的颜色规格,完整范围。

VPI_COLOR_SPEC_BT709_LINEAR 

定义 ITU-R BT.709 标准的颜色规格,有限范围和线性传递函数。

VPI_COLOR_SPEC_BT2020 

定义 ITU-R BT.2020 标准的颜色规格,有限范围。

VPI_COLOR_SPEC_BT2020_ER 

定义 ITU-R BT.2020 标准的颜色规格,完整范围。

VPI_COLOR_SPEC_BT2020_LINEAR 

定义 ITU-R BT.2020 标准的颜色规格,有限范围和线性传递函数。

VPI_COLOR_SPEC_BT2020_PQ 

定义 ITU-R BT.2020 标准的颜色规格,有限范围和感知量化器传递函数。

VPI_COLOR_SPEC_BT2020_PQ_ER 

定义 ITU-R BT.2020 标准的颜色规格,完整范围和感知量化器传递函数。

VPI_COLOR_SPEC_BT2020c 

定义用于恒定亮度的 ITU-R BT.2020 标准的颜色规格,有限范围。

VPI_COLOR_SPEC_BT2020c_ER 

定义用于恒定亮度的 ITU-R BT.2020 标准的颜色规格,完整范围。

VPI_COLOR_SPEC_MPEG2_BT601 

定义使用 ITU-R BT.601 编码的 MPEG2 标准的颜色规格。

VPI_COLOR_SPEC_MPEG2_BT709 

定义使用 ITU-R BT.709 编码的 MPEG2 标准的颜色规格。

VPI_COLOR_SPEC_MPEG2_SMPTE240M 

定义使用 SMPTE 240M 编码的 MPEG2 标准的颜色规格。

VPI_COLOR_SPEC_sRGB 

定义 sRGB 标准的颜色规格。

VPI_COLOR_SPEC_sYCC 

定义 sYCC 标准的颜色规格。

VPI_COLOR_SPEC_SMPTE240M 

定义 SMPTE 240M 标准的颜色规格,有限范围。

VPI_COLOR_SPEC_DISPLAYP3 

定义 Display P3 标准的颜色规格,具有 sRGB 颜色传递函数。

VPI_COLOR_SPEC_DISPLAYP3_LINEAR 

定义 Display P3 标准的颜色规格,具有线性颜色传递函数。

VPI_COLOR_SPEC_SENSOR 

用于来自图像传感器的图像的颜色规格,正好在去马赛克之后。

Definition at line 161 of file ColorSpec.h.

◆ VPIRawPattern

#include <vpi/ColorSpec.h>

定义 RAW 色彩模型使用的拜耳模式。

R、G、B 代表色原色红色、绿色、蓝色。C 代表透明通道,它允许所有光线通过。

枚举器
VPI_RAW_INVALID 

无效的 RAW 模式。

VPI_RAW_BAYER_RGGB 

X 通道映射到样本的拜耳格式如下

  • span 1: R G R G R G R G
  • span 2: G B G B G B G B (Y,Z,W 被丢弃)
VPI_RAW_BAYER_BGGR 

X 通道映射到样本的拜耳格式如下

  • span 1: B G B G B G B G
  • span 2: G R G R G R G R
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_GRBG 

X 通道映射到样本的拜耳格式如下

  • span 1: G R G R G R G R
  • span 2: B G B G B G B G
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_GBRG 

X 通道映射到样本的拜耳格式如下

  • span 1: G B G B G B G B
  • span 2: R G R G R G R G
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_RCCB 

X 通道映射到样本的拜耳格式如下

  • span 1: R C R C R C R C
  • span 2: C B C B C B C B
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_BCCR 

X 通道映射到样本的拜耳格式如下

  • span 1: B C B C B C B C
  • span 2: C R C R C R C R
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_CRBC 

X 通道映射到样本的拜耳格式如下

  • span 1: C R C R C R C R
  • span 2: B C B C B C B C
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_CBRC 

X 通道映射到样本的拜耳格式如下

  • span 1: C B C B C B C B
  • span 2: R C R C R C R C
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_RCCC 

X 通道映射到样本的拜耳格式如下

  • span 1: R C R C R C R C
  • span 2: C C C C C C C C
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_CRCC 

X 通道映射到样本的拜耳格式如下

  • span 1: C R C R C R C R
  • span 2: C C C C C C C C
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_CCRC 

X 通道映射到样本的拜耳格式如下

  • span 1: C C C C C C C C
  • span 2: R C R C R C R C
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_CCCR 

X 通道映射到样本的拜耳格式如下

  • span 1: C C C C C C C C
  • span 2: C R C R C R C R
    (Y,Z,W 被丢弃)
VPI_RAW_BAYER_CCCC 

X 通道映射到样本的拜耳格式如下

  • span 1: C C C C C C C C
  • span 2: C C C C C C C C
    (Y,Z,W 被丢弃)

Definition at line 302 of file ColorSpec.h.

◆ VPIChromaSubsampling

#include <vpi/ColorSpec.h>

定义色度二次采样是如何完成的。

这仅适用于色彩模型为 YUV 的图像格式。其他图像格式必须使用 VPI_CSS_NONE。色度二次采样由 2 个参数定义

  • 相对于亮度分辨率的水平分辨率。
  • 相对于亮度分辨率的垂直分辨率。
枚举器
VPI_CSS_INVALID 

无效的色度二次采样。

VPI_CSS_NONE 

当不进行色度二次采样时使用,特别是对于没有色度分量的颜色规格。

VPI_CSS_444 

4:4:4 二次采样。

色度具有完整的水平和垂直分辨率,意味着没有色度二次采样。

VPI_CSS_422 

4:2:2 BT.601 二次采样。

色度具有一半水平分辨率和完整垂直分辨率。

VPI_CSS_422R 

4:2:2R BT.601 二次采样。

色度具有完整水平分辨率和一半垂直分辨率。

VPI_CSS_411 

4:1:1 二次采样。

色度具有 1/4 水平分辨率和完整垂直分辨率。

VPI_CSS_411R 

4:1:1 二次采样。

色度具有完整水平分辨率和 1/4 垂直分辨率。

VPI_CSS_420 

4:2:0 二次采样。

色度具有一半水平和垂直分辨率。

Definition at line 399 of file ColorSpec.h.

函数文档

◆ vpiMakeColorSpec()

VPIColorSpec vpiMakeColorSpec ( VPIColorSpace  cspace,
VPIYCbCrEncoding  encoding,
VPIColorTransferFunction  xferFunc,
VPIColorRange  range,
VPIChromaLocation  locHoriz,
VPIChromaLocation  locVert 
)

#include <vpi/ColorSpec.h>

创建用户自定义的 VPIColorSpec

参数
[输入]cspace色彩空间。
[输入]encodingR'G'B' <-> Y'CbCr 编码。
[输入]xferFunc颜色传递函数。
[输入]range颜色量化范围。
[输入]locHoriz水平色度位置。
[输入]locVert垂直色度位置。
返回值
用户自定义的 VPIColorSpec

◆ vpiMakeChromaSubsampling()

VPIChromaSubsampling vpiMakeChromaSubsampling ( int  samplesHoriz,
int  samplesVert 
)

#include <vpi/ColorSpec.h>

根据水平和垂直采样创建 VPIChromaSubsampling

参数
[输入]samplesHoriz水平样本数,1、2 或 4。
[输入]samplesVert垂直样本数,1、2 或 4。
返回值
色度二次采样枚举。
返回值
VPI_CSS_NONE色度二次采样未定义。

◆ vpiChromaSubsamplingGetSamplesHoriz()

int vpiChromaSubsamplingGetSamplesHoriz ( VPIChromaSubsampling  css)

#include <vpi/ColorSpec.h>

获取每 4 个水平亮度样本组的色度样本数量。

参数
[输入]css要查询的色度二次采样。
  • css 必须有效。
返回值
每 4 个水平亮度样本组的色度样本数量。
返回值
0css 无效。

◆ vpiChromaSubsamplingGetSamplesVert()

int vpiChromaSubsamplingGetSamplesVert ( VPIChromaSubsampling  css)

#include <vpi/ColorSpec.h>

获取每 4 个垂直亮度样本组的色度样本数量。

参数
[输入]css要查询的色度二次采样。
  • css 必须有效。
返回值
每 4 个垂直亮度样本组的色度样本数量。
返回值
0css 无效。

◆ vpiColorSpecGetChromaLocHoriz()

VPIChromaLocation vpiColorSpecGetChromaLocHoriz ( VPIColorSpec  cspec)

#include <vpi/ColorSpec.h>

获取给定颜色规格的色度水平采样位置。

参数
[输入]cspec要查询的颜色规格。
  • 颜色规格必须有效。
返回值
相对于亮度水平坐标的色度样本位置。
返回值
VPI_CHROMA_LOC_BOTHcspec 无效。

◆ vpiColorSpecGetChromaLocVert()

VPIChromaLocation vpiColorSpecGetChromaLocVert ( VPIColorSpec  cspec)

#include <vpi/ColorSpec.h>

获取给定颜色规格的色度垂直采样位置。

参数
[输入]cspec要查询的颜色规格。
  • 颜色规格必须有效。
返回值
相对于亮度垂直坐标的色度样本位置。
返回值
VPI_CHROMA_LOC_BOTHcspec 无效。

◆ vpiColorSpecSetChromaLoc()

VPIColorSpec vpiColorSpecSetChromaLoc ( VPIColorSpec  cspec,
VPIChromaLocation  locHoriz,
VPIChromaLocation  locVert 
)

#include <vpi/ColorSpec.h>

设置给定颜色规格的色度样本位置。

参数
[输入]cspec要修改的颜色规格。
  • cspec 必须有效。
[输入]locHoriz相对于亮度坐标的水平色度采样位置。
[输入]locVert相对于亮度坐标的垂直色度采样位置。
返回值
具有更新的色度位置的新颜色规格。
返回值
VPI_COLOR_SPEC_INVALIDcspec 无效。

◆ vpiColorSpecGetSpace()

VPIColorSpace vpiColorSpecGetSpace ( VPIColorSpec  cspec)

#include <vpi/ColorSpec.h>

获取给定颜色规格的 color_space。

参数
[输入]cspec要查询的颜色规格。
  • cspec 必须有效。
返回值
与颜色规格关联的 color_space。
返回值
VPI_COLOR_SPACE_UNDEFINEDcspec 无效。

◆ vpiColorSpecSetSpace()

VPIColorSpec vpiColorSpecSetSpace ( VPIColorSpec  cspec,
VPIColorSpace  cspace 
)

#include <vpi/ColorSpec.h>

设置给定颜色规格的 color_space。

参数
[输入]cspec要更新的颜色规格。
  • cspec 必须有效。
[输入]cspace新的 color_space。
返回值
具有更新的 color_space 的新颜色规格。
返回值
VPI_COLOR_SPEC_INVALIDcspec 无效。
VPI_COLOR_SPEC_INVALIDcspace 无效。

◆ vpiColorSpecGetYCbCrEncoding()

VPIYCbCrEncoding vpiColorSpecGetYCbCrEncoding ( VPIColorSpec  cspec)

#include <vpi/ColorSpec.h>

获取给定颜色规格的 R'G'B' <-> Y'CbCr 编码方案。

参数
[输入]cspec要查询的颜色规格。
  • cspec 必须有效。
返回值
与颜色规格关联的 Y'CbCr 编码方案。
返回值
VPI_YCbCr_ENC_UNDEFINEDcspec 无效。

◆ vpiColorSpecSetYCbCrEncoding()

VPIColorSpec vpiColorSpecSetYCbCrEncoding ( VPIColorSpec  cspec,
VPIYCbCrEncoding  encoding 
)

#include <vpi/ColorSpec.h>

设置给定颜色规格的 R'G'B' <-> Y'CbCr 编码方案。

参数
[输入]cspec要更新的颜色规格。
  • cspec 必须有效。
[输入]encoding新的 Y'CbCr 编码方案。
返回值
具有更新的 Y'CbCr 编码方案的新颜色规格。
返回值
VPI_COLOR_SPEC_INVALIDcspec 无效。

◆ vpiColorSpecGetTransferFunction()

VPIColorTransferFunction vpiColorSpecGetTransferFunction ( VPIColorSpec  cspec)

#include <vpi/ColorSpec.h>

获取给定颜色规格的颜色传递函数。

参数
[输入]cspec要查询的颜色规格。
  • cspec 必须有效。
返回值
给定颜色规格的颜色传递函数。
返回值
VPI_COLOR_XFER_LINEAR如果 cspec 无效。

◆ vpiColorSpecSetTransferFunction()

VPIColorSpec vpiColorSpecSetTransferFunction ( VPIColorSpec  cspec,
VPIColorTransferFunction  xferFunc 
)

#include <vpi/ColorSpec.h>

设置给定颜色规格的颜色传递函数。

参数
[输入]cspec要更新的颜色规格。
  • cspec 必须有效。
[输入]xferFunc新的颜色传递函数。
返回值
具有更新颜色传递函数的新颜色规格。
返回值
VPI_COLOR_SPEC_INVALIDcspec 无效。

◆ vpiColorSpecGetRange()

VPIColorRange vpiColorSpecGetRange ( VPIColorSpec  cspec)

#include <vpi/ColorSpec.h>

获取给定颜色规格的颜色量化范围。

参数
[输入]cspec要查询的颜色规格。
  • cspec 必须有效。
返回值
给定颜色规格的颜色量化范围。
返回值
VPI_COLOR_RANGE_FULLcspec 无效。

◆ vpiColorSpecSetRange()

VPIColorSpec vpiColorSpecSetRange ( VPIColorSpec  cspec,
VPIColorRange  range 
)

#include <vpi/ColorSpec.h>

设置给定颜色规格的颜色量化范围。

参数
[输入]cspec要更新的颜色规格。
  • cspec 必须有效。
[输入]range新的颜色量化范围。
返回值
具有更新颜色量化范围的新颜色规格。
返回值
VPI_COLOR_SPEC_INVALIDcspec 无效。

◆ vpiColorSpecGetName()

const char* vpiColorSpecGetName ( VPIColorSpec  cspec)

#include <vpi/ColorSpec.h>

返回颜色规格的字符串表示形式。

参数
[输入]cspec要返回其名称的颜色规格。
返回值
颜色规格的字符串表示形式。返回的字符串在从同一调用线程下次调用此函数之前有效。返回的指针不得释放。