Point类

Dim类

参数	类型	说明
left	int	左侧补边像素数量。
right	int	右侧补边像素数量。
top	int	上方补边像素数量。
bottom	int	下方补边像素数量。

父主题： 通用枚举类型/数据类

Rect类

参数	类型	说明
x0	int	矩形框左上角坐标的横坐标。
y0	int	矩形框左上角坐标的纵坐标。
x1	int	矩形框右下角坐标的横坐标。
y1	int	矩形框右下角坐标的纵坐标。

父主题： 通用枚举类型/数据类

Size类

参数	类型	说明
width	int	图像宽。
height	int	图像高。

父主题： 通用枚举类型/数据类

Point类

参数	类型	说明
x	int	横坐标（以图像左上角为原点）。
y	int	纵坐标（以图像左上角为原点）。

父主题： 通用枚举类型/数据类

VideoDecodeConfig类

表1 保存视频解码的类

参数名	类型	说明
width	int	视频解码缓冲区的宽，取值范围：[128, 4096]，默认值：1920，必须为偶数。并且会自动对齐到 16 （向上对齐）。 请用户根据实际的视频帧数据进行适当设置，需大于或等于实际的视频帧数据宽，否则会无解码输出，设置过大将会产生多余的内存资源开销。
height	int	视频解码缓冲区的高，取值范围：[128, 4096]，默认值：1080，必须输入偶数。 请用户根据实际的视频帧数据进行适当设置，需大于或等于实际的视频帧数据高，否则会无解码输出，设置过大将会产生多余的内存资源开销。
inputVideoFormat	StreamFormat枚举类	输入的视频格式，H.264格式视频支持base.h264_baseline_level、base.h264_main_level、base.h264_high_level三种格式，H.265格式视频只支持base.h265_main_level格式。默认值为：base.h264_main_level。
outputImageFormat	image_format枚举类	解码后输出的图像格式，默认值为：base.nv12。 - Atlas 200I/500 A2 推理产品环境只支持base.nv12、base.nv21两种格式。
skipInterval	int	视频解码的跳帧参数，取值范围：[0, 250]，默认值：0。
cscMatrix	int	色域转换选项，默认值为“0”（即HI_CSC_MATRIX_BT601_WIDE）。 - HI_CSC_MATRIX_BT601_WIDE = 0，基于BT601 wide标准的色域转换矩阵，各参数值参考如下。 text<br> # YUV转RGB：<br> # | R | | 1.000 0.000 1.402 | | Y - 0 |<br> # | G | = | 1.000 -0.344 -0.714 | * | U - 128 | <br> # | B | | 1.000 1.772 0.000 | | V - 128 |<br> # RGB转YUV：<br> # | Y | |-0.5 | | 0.299 0.587 0.114 | | R | <br> # | U | = |127.5 | + | -0.168 -0.331 0.500 | * | G | <br> # | V | |127.5 | | 0.500 -0.419 -0.081 | | B | <br> - HI_CSC_MATRIX_BT601_NARROW =1，基于BT601 narrow标准的色域转换矩阵，各参数值参考如下。 text<br> # YUV转RGB：<br> # | R | | 1.16438 0.00000 1.59602 | | Y - 16 |<br> # | G | = | 1.16438 -0.39176 -0.81297 | * | U - 128 | <br> # | B | | 1.16438 2.01723 0.00000 | | V - 128 |<br> # RGB转YUV：<br> # | Y | |16 | | 0.25679 0.51564 0.10014 | | R | <br> # | U | = |128| + | -0.14491 -0.29099 0.43922 | * | G | <br> # | V | |128| | 0.42941 -0.36779 -0.07143 | | B | <br> - HI_CSC_MATRIX_BT709_WIDE =2，基于BT709 wide标准的色域转换矩阵，各参数值参考如下。 text<br> # YUV转RGB：<br> # | R | | 1.00000 0.00000 1.57480 | | Y - 0 |<br> # | G | = | 1.00000 -0.18732 -0.46812 | * | U - 128 | <br> # | B | | 1.00000 1.85560 0.00000 | | V - 128 |<br> # RGB转YUV：<br> # | Y | |0 | | 0.21260 0.71520 0.07220 | | R | <br> # | U | = |128| + | -0.11457 -0.38543 0.50000 | * | G | <br> # | V | |128| | 0.50000 -0.45415 -0.04585 | | B | <br> - HI_CSC_MATRIX_BT709_NARROW =3，基于BT709 narrow标准的色域转换矩阵，各参数值参考如下。 text<br> # YUV转RGB：<br> # | R | | 1.16438 0.00000 1.79274 | | Y - 16 |<br> # | G | = | 1.16438 -0.21325 -0.53291 | * | U - 128 | <br> # | B | | 1.16438 2.11240 0.00000 | | V - 128 |<br> # RGB转YUV：<br> # | Y | |16 | | 0.18259 0.62825 0.06342 | | R | <br> # | U | = |128| + | -0.09840 -0.33857 0.43922 | * | G | <br> # | V | |128| | 0.42941 -0.39894 -0.04027 | | B | <br> - HI_CSC_MATRIX_BT2020_WIDE =4，基于BT2020 wide标准的色域转换矩阵，各参数值参考如下。 text<br> # YUV转RGB：<br> # | R | | 1.00000 0.00000 1.47460 | | Y - 0 |<br> # | G | = | 1.00000 -0.16455 -0.57135 | * | U - 128 | <br> # | B | | 1.00000 1.88140 0.00000 | | V - 128 |<br> # RGB转YUV：<br> # | Y | |0 | | 0.26270 0.67800 0.05930 | | R | <br> # | U | = |128| + | -0.13963 -0.36037 0.50000 | * | G | <br> # | V | |128| | 0.50000 -0.45979 -0.04021 | | B | <br> - HI_CSC_MATRIX_BT2020_NARROW =5，基于BT2020 narrow标准的色域转换矩阵，各参数值参考如下。 text<br> # YUV转RGB：<br> # | R | | 1.16438 0.00000 1.67868 | | Y - 16 |<br> # | G | = | 1.16438 -0.18733 -0.65042 | * | U - 128 | <br> # | B | | 1.16438 2.14177 0.00000 | | V - 128 |<br> # RGB转YUV：<br> # | Y | |16 | | 0.22564 0.59558 0.05209 | | R | <br> # | U | = |128| + | -0.11992 -0.31656 0.43922 | * | G | <br> # | V | |128| | 0.42941 -0.40389 -0.03533 | | B | <br>

父主题： 通用枚举类型/数据类

VideoEncodeConfig类

参数名	类型	说明
width	int	编码后视频帧数据的宽，默认值：1920，必须与待编码图片的宽（original_width）一致。 - Atlas 200I/500 A2 推理产品，取值范围：[128, 1920]，输入的视频宽需要对齐16。
height	int	编码后视频帧数据的高，默认值：1080，必须与待编码图片的高（original_height）一致。 - Atlas 200I/500 A2 推理产品，取值范围：[128, 1920]，输入的视频高需要对齐2。
outputVideoFormat	StreamFormat枚举类	编码后输出的视频格式，默认值为：base.h264_main_level。
inputImageFormat	image_format枚举类	输入的图像格式，只支持base.nv12、base.nv21两种格式，默认值为：base.nv12。
keyFrameInterval	int	视频I帧间隔大小，默认为30，取值范围[1, 2000]。
srcRate	int	输入码流帧率，单位fps，默认为30。 - Atlas 200I/500 A2 推理产品，取值范围：[1, 120]。
rcMode	int	指定码率控制模式，默认值为0，取值如下： - 0：默认模式，Atlas 200I/500 A2 推理产品默认为CBR模式。 - 1：变码率VBR模式。 - 2：定码率CBR模式。
maxBitRate	int	输出码率，单位kbps，默认值为300。 - Atlas 200I/500 A2 推理产品，取值范围：[10, 30000]。
ipProp	int	一个GOP内单个I帧bit数和单个P帧bit数的比例，默认值为70，取值范围[1, 100]。

推荐配置

以下为视频采集场景下推荐的参数配置，可以保证较好的视频编码质量，其他场景下请根据实际应用对应调整。

画质/分辨率	srcRate	keyFrameInterval	maxBitRate
4K 3840 * 2160/4096 * 2160	25或30	50或60	- H.264： 8000 ~ 12000 - H.265： 8000 ~ 12000
2K 2560 * 1440	25或30	50或60	- H.264： 6000 ~ 10000 - H.265： 6000 ~ 10000
1080P（蓝光） 1920 * 1080	25或30	50或60	- H.264： 20006000 - H.265： 10004000
720P（高清） 1280 * 720	25或30	50或60	- H.264： 10003000 - H.265： 8002000
480P/D1_N（标清） 854 * 480/720 * 480	25或30	50或60	- H.264： 6001400 - H.265： 300700
576P/D1 （标清） 720 * 576	25或30	50或60	- H.264： 6001400 - H.265： 300700
270P（流畅） 480 * 270	25或30	50或60	-
CIF P/N 352 * 288/320 * 240	25或30	50或60	- H.264： 250 - H.265： 250

父主题： 通用枚举类型/数据类

RoiBox

功能

裁剪框的定义。

结构定义

class RoiBox:
    def __init__(self):
        self.x0 = None
        self.y0 = None
        self.x1 = None
        self.y1 = None

参数说明

参数名	类型	说明
x0	float	左上角横坐标。
y0	float	左上角纵坐标。
x1	float	右下角横坐标。
y1	float	右下角纵坐标。

父主题： 流程编排数据类

在线提单