hi_vdec_chn_attr

说明

定义解码通道属性字典。

定义

hi_vdec_chn_attr= {"type": hi_payload_type, # RW; video type to be decoded
                    "mode": hi_vdec_send_mode, # RW; send by stream or by frame
                    "pic_width": pic_width, # RW; max pic width
                    "pic_height": pic_height, # RW; max pic height
                    "stream_buf_size": stream_buf_size, # stream buf size(Byte)
                    "frame_buf_size": frame_buf_size, # RW; frame buf size(Byte)
                    "frame_buf_cnt": frame_buf_cnt, # RW; frame buf num
                    "video_attr": hi_vdec_video_attr} # RW; structure with video

成员

成员名称

描述

type

整型,解码协议类型值,静态属性。

mode

整型,码流发送方式,静态属性。

Atlas 推理系列产品上,H.264/H.265/JPEG仅支持按帧发送码流。

Atlas 200I/500 A2推理产品上,VDEC视频解码场景下,H.264/H.265仅支持按帧发送码流;JPEG图片解码场景下,该参数预留。

Atlas A2训练系列产品/Atlas 800I A2推理产品上,VDEC视频解码场景下,H.264/H.265仅支持按帧发送码流;JPEG图片解码场景下,该参数预留。

pic_width

整型,通道支持的解码图像最大宽(以像素为单位),静态属性。

Atlas 200I/500 A2推理产品上,JPEG图片解码场景下,该参数预留。

Atlas A2训练系列产品/Atlas 800I A2推理产品上,JPEG图片解码场景下,该参数预留。

pic_height

整型,通道支持的解码图像最大高(以像素为单位),静态属性。

Atlas 200I/500 A2推理产品上,JPEG图片解码场景下,该参数预留。

Atlas A2训练系列产品/Atlas 800I A2推理产品上,JPEG图片解码场景下,该参数预留。

stream_buf_size

整型,码流缓存的大小,静态属性。

取值范围:大于或等于解码通道大小(宽 * 高)的 3/4倍,即YUV420图像大小的一半(宽 * 高 * 3/2 * 1/2),小于或等于1024 * 1024 * 1024,以Byte为单位。

推荐值:一幅YUV420解码图像大小。即:宽 * 高 * 1.5。

frame_buf_size

整型,解码图像帧存Buffer大小,以Byte为单位。JPEGD图像解码不需要设置该参数。

取值范围:大于或等于0。

  • 取值为0时,VDEC内部将根据实际码流信息自动分配合适的帧存大小。
  • 取值大于0时,用户需保证(“帧存大小” * 参考帧个数实际所需最小帧存大小 * 实际所需最小参考帧个数),否则不能正常解码。

实际所需最小帧存大小,用户需先根据码流中的SPS(Sequence Parameter Set)信息获取输入码流的宽、高、比特位宽,再调用acl.himpi.vdec_get_pic_buf_size接口获取实际所需最小帧存大小。

frame_buf_cnt

整型,解码图像帧存个数。JPEGD图像解码不需要设置该参数。

取值范围:大于或等于0。

  • 一般情况下,设置为0,VDEC内部将根据实际码流信息自动分配合适的帧存个数。
  • 如果客户需要限制VDEC解码帧存大小,则设置为大于0的值,用户需保证(帧存大小 * 参考帧个数实际需要最小帧存大小 * 实际需要最小参考帧个数),否则不能正常解码。

实际所需最小参考帧个数,用户需先根据码流中的SPS(Sequence Parameter Set)信息获取码流参考帧个数,H.264/H.265解码所需帧存个数 = 参考帧 + 显示帧 + 1。

video_attr

字典,视频(H.264/H.265)解码通道属性。

注意事项

设置通道属性的图像宽和高,若用户清楚码流的具体宽高,建议以实际值来设置。若是不清楚,建议以此码流的最大规格来创建。但是最大规格是4096 * 4096,不能超过此值。