7.3.10 视频解码

概述

视频解码模块支持H.264/H.265/JPEG/MJPEG硬件解码。该模块支持多通道实时编码，各通道相互独立，常见的使用场景，包括智能盒子、课堂录播等。

功能描述

基础规格

X3支持的解码规格如下：

硬件解码模块	最大通道数	支持协议	分辨率支持	最大性能
VPU JPU	32	VPU: H.264/H.265 JPU: JPEG/MJPEG	VPU: - H264: max 8192×8192 min：32×32 - H265: max 8192×8192 Min: 8×8 JPU: - JPEG/MJPEG: max 32768×32768 min:16×16	H264/H265: 3840×2160 @60fps JPEG/MJPEG: YUV4:2:0 290M pixel/sec

码流发送方式

X3视频解码器支持按帧发送(VIDEO_MODE_FRAME)码流方式：

用户每次发送完整一帧码流到解码器。解码器就认为该帧码流已经结束，开始解码图像，因此需保证每次调用发送接口发送的码流必须为一帧，否则会出现解码错误。

码流发送方式enMode在VDEC_CHN_ATTR_S解码通道属性结构体中定义，用户可以通过调用HB_VDEC_SetChnAttr()配置解码通道属性函数来完成。

图像输出方式

根据H.264/H.265协议，解码图像可能不会在解码后立即输出。X3视频解码器可以通过设置不同的图像输出方式达到尽快输出的目的。图像输出方式包括以下两种：

解码序：解码图像按照解码的先后顺序输出。
显示序：解码图像按照H.264/H.265协议输出。

根据H.264/H.265协议，视频的解码顺序未必是视频的输出顺序(即显示序)。例如B帧解码时需要前后的P帧作为参数，所以B帧后的P帧先于B帧解码，但B帧先于P帧输出。按解码序输出是保证快速输出的一个必要条件，用户选择按解码序输出，需保证码流的解码序和显示序相同。

按帧发送码流与按解码序输出相结合能达到快速解码和快速输出的目的，用户必须保证每次发送的是完整的一帧码流以及码流的解码序和显示序相同。
按帧发送码流与按显示序输出想结合，注意需要在最后一帧设置码流结束时必配置帧结束标志stream_end为HB_TRUE，否则认为当前帧码流还未结束，会出现解码异常。

图像输出方式enOutPutOrder在VDEC_CHN_ATTR_S解码通道属性结构体中定义，用户可以通过调用HB_VDEC_SetChnAttr()配置解码通道属性函数来完成。

时间戳(PTS)处理

VDEC模块在选择帧发送(VIDEO_MODE_FRAME)模型下发送码流时，解码输出的图像时间戳PTS为发送码流接口(HB_VDEC_SendStream)中用户送入的PTS，解码器不会更改此值。

码流Buffer配置模式

解码码流buffer配置支持外部模式和内部模式。

外部模式：用户通过调用HB_VP_Init()函数进行对Video Pool池初始化，然后可以选择公共pool或者通过HB_SYS_Alloc()函数创建私有的pool池的mmz内存，用于存放需要解码的码流。用户创建的ion内存的buffer数量建议和解码通道中设置的流buffer数量u32StreamBufCnt一致，每一次解码需要把分配的ion内存的虚拟地址首地址赋值给VIDEO_STREAM_S结构体中的vir_ptr字段，需要解码的流大小赋值给VIDEO_STREAM_S结构体中的size字段。解码器内部实际是通过buffer轮转的方式去解码的，即依次取buffer号中的流数。如果图像输出方式设置为显示序，需要把一个GOP内部的所有帧都读取完才开始解码。

通过设置解码器通道属性VDEC_CHN_ATTR_S结构体中的bExternalBitStreamBuff字段为HB_TRUE来使用外部buffer模式。
内部模式：用户通过其他工具，例如FFMPEG来进行对码流的切分(一般以帧模式来读取)，此时用户不需要申请VB缓存，只需要把码流切分之后的buffer地址传递给VIDEO_STREAM_S结构体中的vir_ptr字段，内部会自动做拷贝到编码器申请的流buffer地址空间中，节约了VB的使用。

通过设置解码器通道属性VDEC_CHN_ATTR_S结构体中的bExternalBitStreamBuff字段为HB_FALSE来使用外部buffer模式

Skip高级跳帧解码

用户可以通过设置解码器通道属性VDEC_CHN_ATTR_S结构体中的enDecMode来控制解码时是否使用跳帧(默认不开启，即所有帧都解码)。可以选择只解码IRAP帧或者只解码参数参数帧，具体可以参考帧skip设置。

带宽优化模式解码

用户可以通过设置解码器通道属性VDEC_CHN_ATTR_S结构体中的bandwidth_Opt来控制解码时是否使用带宽优化(默认是开启)。该模式支持VPU忽略将压缩格式的非参考帧或者线性格式的非显示帧写入frame buffer中，以此来节省带宽。

解码器绑定

解码器绑定后，不可再调用HB_VDEC_GetFrame。

注意事项

H.264/H.265解码得时候第一个帧，要给齐sps，pps，idr，如果只给sps就会报错,报错信息是 FAILED TO DEC_PIC_HDR: ret(1), SEQERR(00005000)

API参考

HB_VDEC_CreateChn：创建视频解码通道。
HB_VDEC_DestroyChn：销毁视频解码通道。
HB_VDEC_StartRecvStream：解码器开始接收用户发送的码流。
HB_VDEC_StopRecvStream：解码器停止接收用户发送的码流。
HB_VDEC_ResetChn：复位解码通道。
HB_VDEC_SendStream：向视频解码通道发送码流数据。
HB_VDEC_GetFrame：获取视频解码通道的解码图像。
HB_VDEC_ReleaseFrame：释放视频解码通道的解码图像。
HB_VDEC_GetFd：获取视频解码通道的设备文件句柄。
HB_VDEC_CloseFd：关闭视频解码通道的设备文件句柄。
HB_VDEC_SetChnAttr：设置解码通道参数。
HB_VDEC_GetChnAttr：获取解码通道参数。
HB_VDEC_QueryStatus：查询解码状态。
HB_VDEC_GetUserData：获取用户数据。
HB_VDEC_ReleaseUserData：释放用户数据。

HB_VDEC_CreateChn

【函数声明】

int32_t HB_VDEC_CreateChn(VDEC_CHN VdChn, const VDEC_CHN_ATTR_S *pstAttr)

【功能描述】

创建视频解码通道。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
pstAttr	解码通道属性指针。	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

HB_VDEC_ResetChn参考代码

HB_VDEC_DestroyChn

【函数声明】

int32_t HB_VDEC_DestroyChn(VDEC_CHN VdChn);

【功能描述】

销毁视频解码通道。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

HB_VDEC_ResetChn参考代码

HB_VDEC_StartRecvStream

【函数声明】

int32_t HB_VDEC_StartRecvStream(VDEC_CHN VdChn);

【功能描述】

解码器开始接收用户发送的码流.。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

HB_VDEC_ResetChn参考代码

HB_VDEC_StopRecvStream

【函数声明】

int32_t HB_VDEC_StopRecvStream(VDEC_CHN VdChn);

【功能描述】

解码器停止接收用户发送的码流。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

HB_VDEC_ResetChn参考代码

HB_VDEC_ResetChn

【函数声明】

int32_t HB_VDEC_ResetChn(VDEC_CHN VdChn);

【功能描述】

复位视频解码通道。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

    VDEC_CHN VDEC_Chn = 0;
    int32_t s32Ret = 0;
    int32_t Width = 1920;
    int32_t Height = 1080;
    VDEC_CHN_ATTR_S m_VdecChnAttr ;
    memset(&m_VdecChnAttr , 0, sizeof(VDEC_CHN_ATTR_S));
    m_VdecChnAttr.enType = PT_H264;
    m_VdecChnAttr.enMode = VIDEO_MODE_FRAME;
    m_VdecChnAttr.enPixelFormat = HB_PIXEL_FORMAT_NV12;
    m_VdecChnAttr.u32FrameBufCnt = 10;
    m_VdecChnAttr.u32StreamBufCnt = 10;
    m_VdecChnAttr.u32StreamBufSize = Width * Height * 1.5;
    m_VdecChnAttr.bExternalBitStreamBuf  = HB_TRUE;

    if (m_VdecChnAttr.enType == PT_H265) {
        m_VdecChnAttr.stAttrH265.bandwidth_Opt = HB_TRUE;
        m_VdecChnAttr.stAttrH265.enDecMode = VIDEO_DEC_MODE_NORMAL;
        m_VdecChnAttr.stAttrH265.enOutputOrder = VIDEO_OUTPUT_ORDER_DISP;
        m_VdecChnAttr.stAttrH265.cra_as_bla = HB_FALSE;
        m_VdecChnAttr.stAttrH265.dec_temporal_id_mode = 0;
        m_VdecChnAttr.stAttrH265.target_dec_temporal_id_plus1 = 2;
    }
    if (m_VdecChnAttr.enType == PT_H264) {
        m_VdecChnAttr.stAttrH264.bandwidth_Opt = HB_TRUE;
        m_VdecChnAttr.stAttrH264.enDecMode = VIDEO_DEC_MODE_NORMAL;
        m_VdecChnAttr.stAttrH264.enOutputOrder = VIDEO_OUTPUT_ORDER_DISP;
    }

    s32Ret = HB_VDEC_CreateChn(VDEC_Chn, &m_VdecChnAttr);
    HB_VDEC_SetChnAttr(VDEC_Chn, &m_VdecChnAttr);
    HB_VDEC_StartRecvStream(VDEC_Chn);
    HB_VDEC_StopRecvStream(VDEC_Chn);
    HB_VDEC_ResetChn(VDEC_Chn);
    HB_VDEC_DestroyChn(VDEC_Chn);

HB_VDEC_SendStream

【函数声明】

int32_t HB_VDEC_SendStream(VDEC_CHN VdChn, const VIDEO_STREAM_S *pstStream, int32_t s32MilliSec);

【功能描述】

向视频解码通道发送码流数据

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
pstStream	解码码流数据指针。	输入
s32MilliSec	送码流超时时间。取值范围：[-1, + ∞ ) -1：阻塞。 0：非阻塞。大于 0：超时时间。

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

【参考代码】

HB_VDEC_GetFrame

【函数声明】

int32_t HB_VDEC_GetFrame(VDEC_CHN VdChn, VIDEO_FRAME_S *pstFrameInfo,int32_t s32MilliSec);

【功能描述】

获取视频解码通道的解码图像。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
pstFrameInfo	获取的解码图像信息。	输入
s32MilliSec	获取图像超时时间。取值范围：[-1, + ∞ ) -1：阻塞。 0：非阻塞。大于 0：超时时间。

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

【参考代码】

HB_VDEC_ReleaseFrame

【函数声明】

int32_t HB_VDEC_ReleaseFrame(VDEC_CHN VdChn, const VIDEO_FRAME_S *pstFrameInfo);

【功能描述】

释放视频解码通道的图像。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
pstFrameInfo 解码后的图像信息指针。输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

【参考代码】

HB_VDEC_GetFd

【函数声明】

int32_t HB_VDEC_GetFd(VDEC_CHN VdChn, int32_t *fd);

【功能描述】

获取解码通道对应的设备文件句柄。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
fd	返回编码通道文件句柄。	输出

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

    VDEC_CHN VDEC_Chn = 0;
    int32_t fd = 0;
    int32_t s32Ret = 0;
    int32_t Width = 1920;
    int32_t Height = 1080;
    VDEC_CHN_ATTR_S m_VdecChnAttr ;
    memset(&m_VdecChnAttr , 0, sizeof(VDEC_CHN_ATTR_S));
    m_VdecChnAttr.enType = PT_H264;
    m_VdecChnAttr.enMode = VIDEO_MODE_FRAME;
    m_VdecChnAttr.enPixelFormat = HB_PIXEL_FORMAT_NV12;
    m_VdecChnAttr.u32FrameBufCnt = 10;
    m_VdecChnAttr.u32StreamBufCnt = 10;
    m_VdecChnAttr.u32StreamBufSize = Width * Height * 1.5;
    m_VdecChnAttr.bExternalBitStreamBuf  = HB_TRUE;
    if (m_VdecChnAttr.enType == PT_H265) {
        m_VdecChnAttr.stAttrH265.bandwidth_Opt = HB_TRUE;
        m_VdecChnAttr.stAttrH265.enDecMode = VIDEO_DEC_MODE_NORMAL;
        m_VdecChnAttr.stAttrH265.enOutputOrder = VIDEO_OUTPUT_ORDER_DISP;
        m_VdecChnAttr.stAttrH265.cra_as_bla = HB_FALSE;
        m_VdecChnAttr.stAttrH265.dec_temporal_id_mode = 0;
        m_VdecChnAttr.stAttrH265.target_dec_temporal_id_plus1 = 2;
    }
    if (m_VdecChnAttr.enType == PT_H264) {
        m_VdecChnAttr.stAttrH264.bandwidth_Opt = HB_TRUE;
        m_VdecChnAttr.stAttrH264.enDecMode = VIDEO_DEC_MODE_NORMAL;
        m_VdecChnAttr.stAttrH264.enOutputOrder = VIDEO_OUTPUT_ORDER_DISP;
    }

    s32Ret = HB_VDEC_CreateChn(VDEC_Chn, &m_VdecChnAttr);
    HB_VDEC_SetChnAttr(VDEC_Chn, &m_VdecChnAttr);
    HB_VDEC_GetFd(VDEC_Chn, &fd);
    HB_VDEC_CloseFd(VDEC_Chn, fd);
    s32Ret = HB_VDEC_DestroyChn(VDEC_Chn);

HB_VDEC_CloseFd

【函数声明】

int32_t HB_VDEC_CloseFd(VDEC_CHN VdChn, int32_t fd);

【功能描述】

关闭解码通道对应的设备文件句柄。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
fd	设置编码通道文件句柄。	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

HB_VDEC_GetFd参考代码

HB_VDEC_GetChnAttr

【函数声明】

int32_t HB_VDEC_GetChnAttr(VDEC_CHN VdChn, VDEC_CHN_ATTR_S *pstAttr);

【功能描述】

获取视频解码通道参数。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
pstAttr	解码后的通道属性指针。	输出

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

    VDEC_CHN VDEC_Chn = 0;
    int32_t s32Ret = 0;
    int32_t Width = 1920;
    int32_t Height = 1080;

    VDEC_CHN_ATTR_S m_VdecChnAttr ;
    memset(&m_VdecChnAttr , 0, sizeof(VDEC_CHN_ATTR_S));
    m_VdecChnAttr.enType = PT_H264;
    m_VdecChnAttr.enMode = VIDEO_MODE_FRAME;
    m_VdecChnAttr.enPixelFormat = HB_PIXEL_FORMAT_NV12;
    m_VdecChnAttr.u32FrameBufCnt = 10;
    m_VdecChnAttr.u32StreamBufCnt = 10;
    m_VdecChnAttr.u32StreamBufSize = Width * Height * 1.5;
    m_VdecChnAttr.bExternalBitStreamBuf  = HB_TRUE;

    if (m_VdecChnAttr.enType == PT_H265) {
        m_VdecChnAttr.stAttrH265.bandwidth_Opt = HB_TRUE;
        m_VdecChnAttr.stAttrH265.enDecMode = VIDEO_DEC_MODE_NORMAL;
        m_VdecChnAttr.stAttrH265.enOutputOrder = VIDEO_OUTPUT_ORDER_DISP;
        m_VdecChnAttr.stAttrH265.cra_as_bla = HB_FALSE;
        m_VdecChnAttr.stAttrH265.dec_temporal_id_mode = 0;
        m_VdecChnAttr.stAttrH265.target_dec_temporal_id_plus1 = 2;
    }
    if (m_VdecChnAttr.enType == PT_H264) {
        m_VdecChnAttr.stAttrH264.bandwidth_Opt = HB_TRUE;
        m_VdecChnAttr.stAttrH264.enDecMode = VIDEO_DEC_MODE_NORMAL;
        m_VdecChnAttr.stAttrH264.enOutputOrder = VIDEO_OUTPUT_ORDER_DISP;
    }

    s32Ret = HB_VDEC_CreateChn(VDEC_Chn, &m_VdecChnAttr);
    HB_VDEC_SetChnAttr(VDEC_Chn, &m_VdecChnAttr);
    HB_VDEC_GetChnAttr(VDEC_Chn, &VdecChnAttr);
    s32Ret = HB_VDEC_DestroyChn(VDEC_Chn);

HB_VDEC_SetChnAttr

【函数声明】

int32_t HB_VDEC_SetChnAttr(VDEC_CHN VdChn, const VDEC_CHN_ATTR_S *pstAttr);

【功能描述】

设置视频解码通道参数。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
pstAttr	解码后的通道属性指针。	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

HB_VDEC_GetChnAttr参考代码

HB_VDEC_QueryStatus

【函数声明】

int32_t HB_VDEC_QueryStatus(VDEC_CHN VdChn, VDEC_CHN_STATUS_S *pstStatus);

【功能描述】

查询解码通道状态。

【参数描述】

参数名称	描述	输入/输出
VdChn	解码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
pstStatus	解码通道的状态指针。	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

HB_VDEC_GetUserData

【函数声明】

int32_t HB_VDEC_GetUserData(VDEC_CHN VdChn, VDEC_USERDATA_S *pstUserData, int32_t s32MilliSec);

【功能描述】

获取视频解码通道用户数据。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
pstUserData	用户数据指针。	输入
s32MilliSec	超时时间。	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

HB_VDEC_ReleaseUserData

【函数声明】

int32_t HB_VDEC_ReleaseUserData(VDEC_CHN VdChn, VDEC_USERDATA_S *pstUserData);

【功能描述】

释放解码通道用户数据。

【参数描述】

参数名称	描述	输入/输出
VdChn	编码通道号。取值范围：[0, VDEC_MAX_CHN_NUM)。	输入
pstUserData	用户数据指针	输入

【返回值】

返回值	描述
0	成功
非0	失败，返回错误码。

【注意事项】

无

【参考代码】

HB_VDEC_GetFd参考代码

数据结构

VIDEO_MODE_E

【描述】

定义码流发送方式。

【结构定义】

typedef enum HB_VIDEO_MODE_E {
    VIDEO_MODE_FRAME = 1,
    VIDEO_MODE_BUTT
} VIDEO_MODE_E;

【成员说明】

成员	含义
VIDEO_MODE_FRAME	按帧方式发送码流。以帧为单位。

VIDEO_OUTPUT_ORDER_E

【描述】

定义视频解码输出顺序枚举。

【结构定义】

typedef enum HB_VIDEO_OUTPUT_ORDER_E {
    VIDEO_OUTPUT_ORDER_DISP = 0,
    VIDEO_OUTPUT_ORDER_DEC,
    VIDEO_OUTPUT_ORDER_BUTT
} VIDEO_OUTPUT_ORDER_E;

【成员说明】

成员	含义
VIDEO_OUTPUT_ORDER_DISP	显示序输出。
VIDEO_OUTPUT_ORDER_DEC	解码序输出。

VIDEO_DEC_MODE_E

【描述】

定义视频解码模式枚举。

【结构定义】

typedef enum HB_VIDEO_DEC_MODE_E {
    VIDEO_DEC_MODE_NORMAL = 0,
    VIDEO_DEC_MODE_IRAP,
    VIDEO_DEC_MODE_REF,
    VIDEO_DEC_MODE_THUMB,
    VIDEO_DEC_MODE_BUTT
} VIDEO_DEC_MODE_E;

【成员说明】

成员	含义
VIDEO_DEC_MODE_NORMAL	Decode IPB frame
VIDEO_DEC_MODE_IRAP	Decode IRAP frame
VIDEO_DEC_MODE_REF	Decode reference frame
VIDEO_DEC_MODE_THUMB	Decode IRAP fream without DPB

VDEC_ATTR_H264_S

【描述】

定义H264解码参数。

【结构定义】

typedef struct HB_VDEC_ATTR_H264_S {
    VIDEO_DEC_MODE_E enDecMode;
    VIDEO_OUTPUT_ORDER_E enOutputOrder;
    HB_BOOL bandwidth_Opt;
} VDEC_ATTR_H264_S;

【成员说明】

成员	含义
enDecMode	解码模式，正常解码还是skip跳帧模式解码。
enOutputOrder	解码图像输出顺序，是解码序输出还是显示序输出。
bandwidth_Opt	使能节省带宽模式，该模式支持VPU忽略将压缩格式的非参考帧或者线性格式的非显示帧写入frame buffer中，以此来节省带宽。

VDEC_ATTR_H265_S

【描述】

定义H265解码参数。

【结构定义】

typedef struct HB_VDEC_ATTR_H265_S {
    VIDEO_DEC_MODE_E enDecMode;
    VIDEO_OUTPUT_ORDER_E enOutputOrder;
    HB_BOOLcra_as_bla;
    HB_BOOL bandwidth_Opt;
    uint32_t dec_temporal_id_mode;
    uint32_t target_dec_temporal_id_plus1;
} VDEC_ATTR_H265_S;

【成员说明】

成员	含义
enDecMode	解码模式，正常解码还是skip跳帧模式解码。
enOutputOrder	解码图像输出顺序，是解码序输出还是显示序输出。
cra_as_bla	使能CRA作为BLA处理
bandwidth_Opt	使能节省带宽模式，该模式支持VPU忽略将压缩格式的非参考帧或者线性格式的非显示帧写入frame buffer中，以此来节省带宽。
dec_temporal_id_mode	指定temporal id的选择模式。0是使用绝对值模式，1是使用相对值模式
target_dec_temporal_id_plus1	该值等于0x0，tempral ID在任何范围内，都会解码图像该值在【0x1~0x6】范围内，如果tempral ID小于等于TARGET_DEC_TEMP_ID才会解码一张图像

VDEC_ATTR_MJPEG_S

【描述】

定义MJPEG解码参数。

【结构定义】

typedef struct HB_VDEC_ATTR_MJPEG_S {
    CODEC_ROTATION_E enRotation;
    MIRROR_FLIP_E enMirrorFlip;
    VIDEO_CROP_INFO_S stCropCfg;
} VDEC_ATTR_MJPEG_S;

【成员说明】

成员	含义
enRotation	指定旋转角度，包括0，90，180，270
enMirrorFlip;	指定镜像模式
stCropCfg	指定解码区域

VDEC_ATTR_JPEG_S

【描述】

定义JPEG解码参数。【结构定义】

typedef struct HB_VDEC_ATTR_JPEG_S {
    CODEC_ROTATION_E enRotation;
    MIRROR_FLIP_E enMirrorFlip;
    VIDEO_CROP_INFO_S stCropCfg;
} VDEC_ATTR_JPEG_S;

【成员说明】

成员	含义
enRotation	指定旋转角度，包括0，90，180，270
enMirrorFlip;	指定镜像模式
stCropCfg	指定解码区域

VDEC_CHN_ATTR_S

【描述】

定义解码通道属性。

【结构定义】

typedef struct HB_VDEC_CHN_ATTR_S {
    PAYLOAD_TYPE_E enType;
    VIDEO_MODE_E enMode;
    PIXEL_FORMAT_E enPixelFormat;
    uint32_t u32StreamBufSize;
    uint32_t u32StreamBufCnt;
    HB_BOOL bExternalBitStreamBuf；
    uint32_t u32FrameBufCnt;
    uint32_t vlc_buf_size;
    union {
        VDEC_ATTR_H264_S stAttrH264;
        VDEC_ATTR_H265_S stAttrH265;
        VDEC_ATTR_MJPEG_S stAttrMjpeg;
        VDEC_ATTR_JPEG_S stAttrJpeg;
    };
} VDEC_CHN_ATTR_S;

【成员说明】

成员	含义
enType	码流类型，例如是H264还是H265等等
enMode	解码模式，只支持帧模式
enPixelFormat	解码输出像素格式
u32StreamBufSize	用于解码输入的stream流buffer大小
u32StreamBufCnt	用于解码输入的strema流buffer数量
bExternalBitStreamBuf	Stream流使用外部还是内部buffer进行解码
u32FrameBufCnt	用于解码输出的frame buffer数量
vlc_buf_size	解码器vlc buffer大小
stAttrH264/stAttrH265 stAttrMjpeg/stAttrJpeg	种协议的编码器属性

HB_VDEC_USERDATA_S

【描述】

定义解码用户数据结构体。

【结构定义】

typedef struct HB_VDEC_USERDATA_S {
    HB_BOOL  bValid;
    uint32_t   u32Len;
    uint64_t   u64PhyAddr;
    uint8_t*   pu8Addr;
} VDEC_USERDATA_S;

【成员说明】

成员	含义
bValid	是否使能
u32Len	用户数据长度
u64PhyAddr	用户数据物理地址
pu8Addr	用户数据虚拟地址

HB_VDEC_CHN_STATUS_S

【描述】

定义解码通道状态结构体。

【结构定义】

typedef struct HB_VDEC_CHN_STATUS_S {
	uint32_t cur_input_buf_cnt;
	uint64_t cur_input_buf_size;
	uint64_t cur_output_buf_cnt;
	uint64_t cur_output_buf_size;
	uint32_t left_recv_frame;
	uint32_t left_enc_frame;
	uint32_t total_input_buf_cnt;
	uint32_t total_output_buf_cnt;
	int32_t pipeline;
	int32_t channel_port_id;
} VDEC_CHN_STATUS_S;

【成员说明】

成员	含义
cur_input_buf_cnt	当前输入未解码码流个数
cur_input_buf_size	当前输入码流buffer size
cur_output_buf_cnt	当前已完成解码码流个数
cur_output_buf_size	当前已解码码流buffer size
left_recv_frame	剩余需要接收帧数
left_enc_frame	剩余需要编码帧数
total_input_buf_cnt	总计输入码流个数
total_output_buf_cnt	总计解码个数
pipeline	pipeline
channel_port_id	channel id

错误码

VDEC 错误码如下表：

错误码	宏定义	描述
-269024256	HB_ERR_VDEC_UNKNOWN	未知错误
-269024257	HB_ERR_VDEC_NOT_FOUND	VDEC通道未找到
-269024258	HB_ERR_VDEC_OPEN_FAIL	打开VDEC通道识别
-269024259	HB_ERR_VDEC_RESPONSE_TIMEOUT	操作VDEC通道无响应
-269024260	HB_ERR_VDEC_INIT_FAIL	初始化VDEC模块失败
-269024261	HB_ERR_VDEC_OPERATION_NOT_ALLOWDED	操作不允许
-269024262	HB_ERR_VDEC_NOMEM	VDEC内存不够
-269024263	HB_ERR_VDEC_NO_FREE_CHANNEL	没有空的VDEC通道
-269024264	HB_ERR_VDEC_ILLEGAL_PARAM	参数错误
-269024265	HB_ERR_VDEC_INVALID_CHNID	错误的通道号
-269024266	HB_ERR_VDEC_INVALID_BUF	错误的buffer块
-269024267	HB_ERR_VDEC_INVALID_CMD	错误的命令
-269024268	HB_ERR_VDEC_WAIT_TIMEOUT	等待超时
-269024269	HB_ERR_VDEC_FILE_OPERATION_FAIL	操作失败
-269024270	HB_ERR_VDEC_PARAMS_SET_FAIL	设置参数失败
-269024271	HB_ERR_VDEC_PARAMS_GET_FAIL	获取参数失败
-269024272	HB_ERR_VDEC_EXIST	VDEC 通道已存在
-269024273	HB_ERR_VDEC_UNEXIST	VDEC通道不存在
-269024274	HB_ERR_VDEC_NULL_PTR	空指针

参考代码

VDEC部分示例代码可以参考，sample_video_codec。

7.3.10 视频解码

概述​

功能描述​

基础规格​

码流发送方式​

图像输出方式​

时间戳(PTS)处理​

码流Buffer配置模式​

Skip高级跳帧解码​

带宽优化模式解码​

解码器绑定​

注意事项​

API参考​

HB_VDEC_CreateChn​

HB_VDEC_DestroyChn​

HB_VDEC_StartRecvStream​

HB_VDEC_StopRecvStream​

HB_VDEC_ResetChn​

HB_VDEC_SendStream​

HB_VDEC_GetFrame​

HB_VDEC_ReleaseFrame​

HB_VDEC_GetFd​

HB_VDEC_CloseFd​

HB_VDEC_GetChnAttr​

HB_VDEC_SetChnAttr​

HB_VDEC_QueryStatus​

HB_VDEC_GetUserData​

HB_VDEC_ReleaseUserData​

数据结构​

VIDEO_MODE_E​

VIDEO_OUTPUT_ORDER_E​

VIDEO_DEC_MODE_E​

VDEC_ATTR_H264_S​

VDEC_ATTR_H265_S​

VDEC_ATTR_MJPEG_S​

VDEC_ATTR_JPEG_S​

VDEC_CHN_ATTR_S​

HB_VDEC_USERDATA_S​

HB_VDEC_CHN_STATUS_S​

错误码​

参考代码​

概述

功能描述

基础规格

码流发送方式

图像输出方式

时间戳(PTS)处理

码流Buffer配置模式

Skip高级跳帧解码

带宽优化模式解码

解码器绑定

注意事项

API参考

HB_VDEC_CreateChn

HB_VDEC_DestroyChn

HB_VDEC_StartRecvStream

HB_VDEC_StopRecvStream

HB_VDEC_ResetChn

HB_VDEC_SendStream

HB_VDEC_GetFrame

HB_VDEC_ReleaseFrame

HB_VDEC_GetFd

HB_VDEC_CloseFd

HB_VDEC_GetChnAttr

HB_VDEC_SetChnAttr

HB_VDEC_QueryStatus

HB_VDEC_GetUserData

HB_VDEC_ReleaseUserData

数据结构

VIDEO_MODE_E

VIDEO_OUTPUT_ORDER_E

VIDEO_DEC_MODE_E

VDEC_ATTR_H264_S

VDEC_ATTR_H265_S

VDEC_ATTR_MJPEG_S

VDEC_ATTR_JPEG_S

VDEC_CHN_ATTR_S

HB_VDEC_USERDATA_S

HB_VDEC_CHN_STATUS_S

错误码

参考代码