8.10. 视频解码
8.10.1. 概述
视频解码模块支持H.264/H.265/JPEG/MJPEG硬件解码。该模块支持多通道实时编码，各通道相互独立，常见的使用场景，包括智能盒子、课堂录播等。
8.10.2. 功能描述
8.10.2.1. 基础规格
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 |
8.10.2.2. 码流发送方式
X3视频解码器支持按帧发送(VIDEO_MODE_FRAME)码流方式：
用户每次发送完整一帧码流到解码器。解码器就认为该帧码流已经结束，开始解码图像，因此需保证每次调用发送接口发送的码流必须为一帧，否则会出现解码错误。
码流发送方式enMode在VDEC_CHN_ATTR_S解码通道属性结构体中定义，用户可以通过调用HB_VDEC_SetChnAttr()配置解码通道属性函数来完成。
8.10.2.3. 图像输出方式
根据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()配置解码通道属性函数来完成。
8.10.2.4. 时间戳(PTS)处理
VDEC模块在选择帧发送(VIDEO_MODE_FRAME)模型下发送码流时，解码输出的图像时间戳PTS为发送码流接口(HB_VDEC_SendStream)中用户送入的PTS，解码器不会更改此值。
8.10.2.5. 码流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模式
8.10.2.6. Skip高级跳帧解码
用户可以通过设置解码器通道属性VDEC_CHN_ATTR_S结构体中的enDecMode来控制解码时是否使用跳帧(默认不开启，即所有帧都解码)。可以选择只解码IRAP帧或者只解码参数参数帧，具体可以参考帧skip设置。
8.10.2.7. 带宽优化模式解码
用户可以通过设置解码器通道属性VDEC_CHN_ATTR_S结构体中的bandwidth_Opt来控制解码时是否使用带宽优化(默认是开启)。 该模式支持VPU忽略将压缩格式的非参考帧或者线性格式的非显示帧写入frame buffer中，以此来节省带宽。
8.10.2.8. 解码器绑定
解码器绑定后，不可再调用HB_VDEC_GetFrame。
8.10.2.9. 注意事项
H.264/H.265解码得时候第一个帧，要给齐sps，pps，idr，如果只给sps就会报错,报错信息是 FAILED TO DEC_PIC_HDR: ret(1), SEQERR(00005000)
8.10.3. 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：释放用户数据。
8.10.3.1. 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参考代码
8.10.3.2. HB_VDEC_DestroyChn
【函数声明】
int32_t HB_VDEC_DestroyChn(VDEC_CHN VdChn);
【功能描述】
销毁视频解码通道。
【参数描述】
| 参数名称 | 描述 | 输入/输出 |
|---|---|---|
| VdChn | 编码通道号。 取值范围：[0, VDEC_MAX_CHN_NUM)。 |
输入 |
【返回值】
| 返回值 | 描述 |
|---|---|
| 0 | 成功 |
| 非0 | 失败，返回错误码。 |
【注意事项】
无
【参考代码】
HB_VDEC_ResetChn参考代码
8.10.3.3. HB_VDEC_StartRecvStream
【函数声明】
int32_t HB_VDEC_StartRecvStream(VDEC_CHN VdChn);
【功能描述】
解码器开始接收用户发送的码流.。
【参数描述】
| 参数名称 | 描述 | 输入/输出 |
|---|---|---|
| VdChn | 编码通道号。 取值范围：[0, VDEC_MAX_CHN_NUM)。 |
输入 |
【返回值】
| 返回值 | 描述 |
|---|---|
| 0 | 成功 |
| 非0 | 失败，返回错误码。 |
【注意事项】
无
【参考代码】
HB_VDEC_ResetChn参考代码
8.10.3.4. HB_VDEC_StopRecvStream
【函数声明】
int32_t HB_VDEC_StopRecvStream(VDEC_CHN VdChn);
【功能描述】
解码器停止接收用户发送的码流。
【参数描述】
| 参数名称 | 描述 | 输入/输出 |
|---|---|---|
| VdChn | 编码通道号。 取值范围：[0, VDEC_MAX_CHN_NUM)。 |
输入 |
【返回值】
| 返回值 | 描述 |
|---|---|
| 0 | 成功 |
| 非0 | 失败，返回错误码。 |
【注意事项】
无
【参考代码】
HB_VDEC_ResetChn参考代码
8.10.3.5. 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);
8.10.3.6. 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 | 失败，返回错误码。 |
【注意事项】
【参考代码】
8.10.3.7. 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 | 失败，返回错误码。 |
【注意事项】
【参考代码】
8.10.3.8. 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 | 失败，返回错误码。 |
【注意事项】
【参考代码】
8.10.3.9. 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);
8.10.3.10. 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参考代码
8.10.3.11. 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);
8.10.3.12. 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参考代码
8.10.3.13. 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 | 失败，返回错误码。 |
【注意事项】
无
【参考代码】
8.10.3.14. 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 | 失败，返回错误码。 |
【注意事项】
无
【参考代码】
8.10.3.15. 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参考代码
8.10.4. 数据结构
8.10.4.1. VIDEO_MODE_E
【描述】
定义码流发送方式。
【结构定义】
typedef enum HB_VIDEO_MODE_E {
VIDEO_MODE_FRAME = 1,
VIDEO_MODE_BUTT
} VIDEO_MODE_E;
【成员说明】
| 成员 | 含义 |
|---|---|
| VIDEO_MODE_FRAME | 按帧方式发送码流。 以帧为单位。 |
8.10.4.2. 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 | 解码序输出。 |
8.10.4.3. 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 |
8.10.4.4. 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中，以此来节省带宽。 |
8.10.4.5. 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才会解码一张图像 |
8.10.4.6. 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 | 指定解码区域 |
8.10.4.7. 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 | 指定解码区域 |
8.10.4.8. 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 |
种协议的编码器属性 |
8.10.4.9. 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 | 用户数据虚拟地址 |
8.10.4.10. 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 |
8.10.5. 错误码
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 | 空指针 |
8.10.6. 参考代码
VDEC部分示例代码可以参考，sample_video_codec。