跳到主要内容

hi_vdec_video_attr

hi_quick_mark_mode​

说明​

定义快速释放参考帧模式枚举。

定义​

typedef enum {
    HI_QUICK_MARK_ADAPT = 0,
    HI_QUICK_MARK_FORCE,
    HI_QUICK_MARK_NONE,
    HI_QUICK_MARK_BUTT
}hi_quick_mark_mode;

成员​

成员名称描述
HI_QUICK_MARK_ADAPT自适应模式。预留参数，暂未支持。
HI_QUICK_MARK_FORCE强制模式。预留参数，暂未支持。
HI_QUICK_MARK_NONE普通模式。预留参数，暂未支持。
HI_QUICK_MARK_BUTT保留值。

父主题： VDEC视频/JPEGD图像解码

hi_vdec_pic_info​

说明​

定义视频原始图像帧结构。

定义​

typedef struct {
    hi_u32 width;
    hi_u32 height;
    hi_u32 width_stride;
    hi_u32 height_stride;
    hi_pixel_format pixel_format;
    hi_u64 vir_addr;
    hi_u32 buffer_size;
    hi_s16 offset_top;            
    hi_s16 offset_bottom;     
    hi_s16 offset_left;           
    hi_s16 offset_right;         
}hi_vdec_pic_info;

成员​

成员名称描述
width图像宽度，视频解码时使用该参数。
- Atlas 200/500 A2推理产品，视频解码场景下，支持对输出图片进行缩放，缩放算法默认为业界通用的Bilinear算法（与OpenCV算法的计算过程类似），当输入码流宽度小于或等于4096时，解码图像经过缩放后的输出宽度范围为[10, 8192]；当输入码流宽度大于4096时，解码图像经过缩放后的输出宽度范围为[128, 8192]。 以下场景，VDEC不对输出图片进行缩放：在hi_vdec_pic_info结构体内，将width参数值和height参数值同时设置为0。
height图像高度，视频解码时使用该参数。
- Atlas 200/500 A2推理产品，视频解码场景下，支持对输出图片进行缩放，缩放算法默认为业界通用的Bilinear算法（与OpenCV算法的计算过程类似），当输入码流宽度小于或等于4096时，解码图像经过缩放后的输出高度范围为[6, 8192]；当输入码流宽度大于4096时，解码图像经过缩放后的输出高度范围为[128, 8192]。
width_stride图像宽度步长，视频解码时，YUV420 semi-planar/YVU420 semi-planar输出时，该值为宽向上16对齐；RGB888/BGR888输出时，该值为宽向上16对齐，再乘3。 取值范围：[32, 16384]。
height_stride图像高度步长，视频解码时，YUV420 semi-planar/YVU420 semi-planar输出时，该值为高向上2对齐；RGB888/BGR888输出时，该值等于高。 取值范围：[6, 16384]。
pixel_format图像像素格式。图像或视频解码时使用该参数。VDEC视频解码输出图片格式参见VDEC功能及约束说明，JPEGD图片解码输出图片格式参见JPEGD功能及约束说明。
vir_addr解码输出数据在内存中的起始地址。 隔行码流场景下，隔行码流每帧发送两场，带两块输出内存；解码时其中一块内存无图像输出，属于正常现象，用户需及时释放内存；隔行码流的解码输出数据都在奇数场对应的输出buffer中。
buffer_size存放解码图像的缓冲区大小。
offset_top解码区域相对原图的顶部偏移，JPEG图片解码场景下按指定区域解码时配置，如图1所示，若无需按指定区域解码，需将此值初始化为0。
offset_bottom解码区域相对原图的底部偏移，JPEG图片解码场景下按指定区域解码时配置，如图1所示，若无需按指定区域解码，需将此值初始化为0。
offset_left解码区域相对原图的左侧偏移，JPEG图片解码场景下按指定区域解码时配置，如图1所示，若无需按指定区域解码，需将此值初始化为0。
offset_right解码区域相对原图的右侧偏移，JPEG图片解码场景下按指定区域解码时配置，如图1所示，若无需按指定区域解码，需将此值初始化为0。

注意事项​

10bit的数据经过VPC处理（图像处理）之后均会变成8bit。

参考信息​

JPEG图片解码场景下，按区域解码的功能示意图如下。

使用区域解码存在以下约束：

  • 对于jpeg图片解码进行区域解码，不支持旋转、软件解码图片；
  • 区域解码的范围不能超出原图大小，并且最小支持32*32，最大支持16384*16384；
  • 使用以下图片格式时，对各偏移值的约束如下：
    • HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420或HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420格式：offset_top和offset_left必须为偶数，（height - offset_bottom）和（width - offset_right）必须为偶数。
    • HI_PIXEL_FORMAT_YUV_SEMIPLANAR_422或HI_PIXEL_FORMAT_YVU_SEMIPLANAR_422格式：offset_left必须为偶数，（width - offset_right）必须为偶数。
    • HI_PIXEL_FORMAT_YUV_SEMIPLANAR_440或HI_PIXEL_FORMAT_YVU_SEMIPLANAR_440：offset_top必须为偶数，（height - offset_bottom）必须为偶数。

图1 按区域解码功能示意图

父主题： VDEC视频/JPEGD图像解码

hi_vdec_video_attr​

说明​

定义视频解码视频属性。

定义​

typedef struct {
    hi_u32 ref_frame_num;  
    hi_bool temporal_mvp_en; 
    hi_u32 tmv_buf_size; 
}hi_vdec_video_attr;

成员​

成员名称描述
ref_frame_num参考帧的数目，用于决定解码时需要的参考帧个数，会较大的影响内存VB（Vedio Buffer）块占用，根据实际情况设置合适的值。如果此处设置的值大于实际码流中的参考帧数量，系统内部会根据实际码流的参考帧数量进行调整，以节省内存，但不超过当前所设置的参数值。 取值范围：[0, 16]，以帧为单位。 不知情的情况下，其他码流：推荐设为5。 测试码流：推荐设为16。 静态属性。
temporal_mvp_en是否支持时域运动矢量预测。 取值范围：[0, 1]。 如果H.264解码不需要解码B帧，或者H.265解码不需要解码“支持时域运动矢量预测（sps_temporal_mvp_enabled_flag =1）的码流”，则配置temporal_mvp_en为0，否则配置为1。当配置为0时，可不分配输出TMV信息的VB块，节省内存。 注意：调用hi_mpi_vdec_set_chn_param接口设置通道参数时，只支持将hi_video_dec_mode设置为HI_VIDEO_DEC_MODE_IPB（表示解码I、P、B帧），因此解码H.264码流时只能将temporal_mvp_en配置为1。
tmv_buf_size视频解码图像TMV（Temporal Motion Vector）缓存大小，以Byte为单位，temporal_mvp_en为1时有效。用户可先调用hi_vdec_get_tmv_buf_size接口获取视频解码图像TMV缓存大小*。*

父主题： VDEC视频/JPEGD图像解码

hi_vdec_chn_attr​

说明​

定义解码通道属性结构体。

定义​

typedef struct {
    hi_payload_type type;          
    hi_vdec_send_mode mode;           
    hi_u32 pic_width;                  
    hi_u32 pic_height;                 
    hi_u32 stream_buf_size;          
    hi_u32 frame_buf_size;           
    hi_u32 frame_buf_cnt;           

    union {
        hi_vdec_video_attr video_attr; 
    };
}hi_vdec_chn_attr;

成员​

成员名称描述
type解码协议类型枚举值。 静态属性。
mode码流发送方式。静态属性。 Atlas 200/500 A2推理产品上，VDEC视频解码场景下，H.264/H.265仅支持按帧发送码流；JPEG图片解码场景下，该参数预留。
pic_width通道支持的解码图像最大宽（以像素为单位）。静态属性。 Atlas 200/500 A2推理产品上，JPEG图片解码场景下，该参数预留。
pic_height通道支持的解码图像最大高（以像素为单位）。静态属性。 Atlas 200/500 A2推理产品上，JPEG图片解码场景下，该参数预留。
stream_buf_size输入码流缓存大小。 取值范围：大于或等于解码通道大小（宽*高）的 3/4倍，即YUV420图像大小的一半（宽*高*3/2*1/2），小于或等于1024*1024*1024，以 Byte 为单位。 推荐值：一幅YUV420解码图像大小。即：宽*高*1.5。 静态属性。
frame_buf_size解码图像帧存大小，以Byte为单位。JPEGD图像解码不需要设置该参数。 取值范围：大于或等于0，取值为0时，VDEC内部将根据实际码流信息自动分配合适的帧存大小；取值大于0时，用户需保证（帧存大小*参考帧个数 >= 实际所需最小帧存大小*实际所需最小参考帧个数），否则不能正常解码。实际所需最小帧存大小，用户需先根据码流中的SPS（Sequence Parameter Set）信息获取输入码流的宽、高、比特位宽，再调用hi_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，不能超过此值。

父主题： VDEC视频/JPEGD图像解码

hi_h264_protocol_param​

说明​

与 H.264 协议相关的内存分配参数。

定义​

typedef struct {
    hi_s32 max_slice_num;  
    hi_s32 max_sps_num;  
    hi_s32 max_pps_num;  
}hi_h264_protocol_param;

成员​

成员名称描述
max_slice_num该通道解码支持的最大Slice个数。 取值范围：[1, 300]。 Default：16。
max_sps_num该通道解码支持的最大SPS个数。 取值范围：[1, 32]。 Default：2。
max_pps_num该通道解码支持的最大PPS个数。 取值范围：[1, 256]。 Default：2。

父主题： VDEC视频/JPEGD图像解码

在线提单