venc_create_chn

产品支持情况

产品	是否支持
Atlas A3 训练系列产品 / Atlas A3 推理系列产品	√
Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件	√
Atlas 训练系列产品	x
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	x

功能说明

创建编码通道。

函数原型

C函数原型

        
             hi_s32 hi_mpi_venc_create_chn(hi_venc_chn chn, const hi_venc_chn_attr *attr);

python函数

        
             ret = acl.himpi.venc_create_chn(chn, attr)

参数说明

参数名	说明
chn	int，解码通道号。 Atlas 推理系列产品，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256。 Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256，其中，JPEGD解码通道总数最多256，VDEC解码通道总数最多32。 Atlas 200I/500 A2 推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。 Atlas A3 训练系列产品 / Atlas A3 推理系列产品，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256，其中，JPEGD解码通道总数最多256，VDEC解码通道总数最多32。说明：对于 Atlas 推理系列产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，VENC通道和JPEGE通道总数 = ( 被分配的VENC硬件单元+JPEGE硬件单元数量之和 / VENC硬件单元+JPEGE硬件单元总数之和 ) * 256，如果通道总数不为整数，则向下取整。对于 Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，昇腾虚拟化实例（Ascend Virtual Instance）场景下，JPEGE通道总数最多256。对于 Atlas 200I/500 A2 推理产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，VENC通道 = ( 被分配的VENC硬件单元 / VENC硬件单元 ) * 128，如果通道总数不为整数，则向下取整。JPEGE的通道数不随算力影响，但JPEGE+VENC的总通道数最大128。昇腾虚拟化实例（Ascend Virtual Instance）在各场景下的算力资源规格，在安装昇腾AI处理器的服务器上使用npu-smi info -t template-info命令查看。
attr	dict，编码通道属性字典，具体请参见hi_venc_chn_attr。

参数名

说明

chn

int，解码通道号。

Atlas 推理系列产品，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256。
Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256，其中，JPEGD解码通道总数最多256，VDEC解码通道总数最多32。
Atlas 200I/500 A2 推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。
Atlas A3 训练系列产品 / Atlas A3 推理系列产品，该参数的取值范围：[0, 256)，JPEGD功能和VDEC功能共用通道，且通道总数最多256，其中，JPEGD解码通道总数最多256，VDEC解码通道总数最多32。

说明：

对于 Atlas 推理系列产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，VENC通道和JPEGE通道总数 = ( 被分配的VENC硬件单元+JPEGE硬件单元数量之和 / VENC硬件单元+JPEGE硬件单元总数之和 ) * 256，如果通道总数不为整数，则向下取整。

对于 Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，昇腾虚拟化实例（Ascend Virtual Instance）场景下，JPEGE通道总数最多256。

对于 Atlas 200I/500 A2 推理产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，VENC通道 = ( 被分配的VENC硬件单元 / VENC硬件单元 ) * 128，如果通道总数不为整数，则向下取整。JPEGE的通道数不随算力影响，但JPEGE+VENC的总通道数最大128。

昇腾虚拟化实例（Ascend Virtual Instance）在各场景下的算力资源规格，在安装昇腾AI处理器的服务器上使用npu-smi info -t template-info命令查看。

attr

dict，编码通道属性字典，具体请参见hi_venc_chn_attr。

返回值说明

返回值	说明
ret	int，错误码。返回0表示成功。返回非0表示失败，参见VENC视频/JPEGE图像编码返回码。

约束说明

单个Device上的通道号不能超出最大的通道号范围。
编码通道属性由三部分组成，编码器属性、码率控制器属性和帧结构类型属性，帧结构类型属性简称GOP（Group of Pictures ）类型属性。
编码器属性必须设置编码码流Buffer深度、获取码流方式、编码profile等，表1详细描述了各种协议的各项属性的特性。
推荐的编码宽高为：3840 * 2160(4k)、1920 * 1080(1080P)、1280 * 720(720P)。
H.264/H.265编码帧存由YHeaderSize、CHeaderSize、YSize、CSize、PmeSize、PmeInfoSize和TmvSize共同构成，编码器默认根据最大宽高计算帧存进行内存分配，在设置通道宽高时需保证根据通道宽高计算的每一部分帧存大小都不能大于最大宽高计算的帧存大小。
码率控制器属性中的输入/输出帧率（src_frame_rate/dst_frame_rate）是用于配合编码过程中的码率（bit_rate）分配，不是最终的播放器显示帧率，若想要设置显示帧率请参考acl.himpi.venc_set_h264_vui或acl.himpi.venc_set_h265_vui接口。
建议用户将码控帧率与显示帧率设置一致，否则播放时的码率可能与用户设置的编码码率不同，播放时的码率会随着所设置的显示帧率而变化。

资源参考

接口调用流程，参见JPEGE图片编码、VENC视频编码。

参考信息

表1 **编码器属性的约束**
编码协议	编码方式	码流 Buffer 深度	获取码流模式	编码 profile
H.264	Frame	mini_buf_mode = 0时，Buffer ≥ max_pic_width * max_pic_height * 3/4。 mini_buf_mode = 1时，Buffer ≥ 32 * 1024 Byte。	Frame/Slice	Baseline Mainprofile Highprofile
JPEG	Frame	mini_buf_mode = 0时，如果原图格式为YUV420，Buffer最小值为原图宽16对齐 * 原图高16对齐 * 3/2。如果原图格式为YUV422 Packed，Buffer最小值为原图宽16对齐 * 原图高16对齐 * 2 mini_buf_mode = 1时，Buffer ≥ 32 * 1024 Byte。	Frame/Ecs	Baseline
H.265	Frame	mini_buf_mode = 0时，Buffer ≥ max_pic_width * max_pic_height * 3/4。 mini_buf_mode = 1时，Buffer ≥ 32 * 1024 Byte。	Frame/Slice	Main profile Main 10 profile（暂不支持）
H.265	Frame	mini_buf_mode = 0时，Buffer ≥ max_pic_width * max_pic_height * (3/4) * (5/4）。 mini_buf_mode = 1时，Buffer ≥ 32 * 1024 Byte	Frame/Slice	Main 10 profile（暂不支持）

父主题： VENC视频/JPEGE图像编码接口