hbVPVideoDecode

typedef struct {
  uint8_t pixelFormat;
  uint32_t inBufSize;
  uint32_t outBufCount;
  hbVPVideoType videoType;
} hbVPVideoDecParam;

Video解码的参数。

成员

成员名称	描述
`pixelFormat`	输入图像的像素格式。当前支持 `HB_VP_IMAGE_FORMAT_NV12` 和 `HB_VP_IMAGE_FORMAT_YUV420` 格式。
`inBufSize`	Video Processing Unit内部输入缓冲区大小，需要满足1024对齐。取值范围[1024, 8192 * 4096 * 3]。通常可按解码后的yuv大小进行设置，并对结果进行1024字节对齐。推荐值为10 * 1024 * 1024。
`outBufCount`	Video Processing Unit内部输出缓冲区个数。取值范围[1，31]，推荐值为5。
`videoType`	编码协议的类型。当前支持 `HB_VP_VIDEO_TYPE_H264` 和 `HB_VP_VIDEO_TYPE_H265` 格式。

int32_t hbVPGetDefaultVideoDecParam(hbVPVideoDecParam *param);

获取解码器默认的解码参数，其中 pixelFormat 参数为 HB_VP_IMAGE_FORMAT_YUV420 ，inBufSize 参数为 10 * 1024 * 1024 ，outBufCount 参数为5。

参数
- [in] param 解码参数。
返回值
- 返回 0 则表示API成功执行，否则执行失败。
接口限制说明
- 在调用接口前，需要将 videoType 指定为 HB_VP_VIDEO_TYPE_H264 或 HB_VP_VIDEO_TYPE_H265。

int32_t hbVPCreateVideoDecContext(hbVPVideoContext *context,
                                  hbVPVideoDecParam const *param);

创建解码器上下文API，创建前需要提前将context初始化为nullptr。

参数
- [out] context 解码器上下文。
- [in] param 解码参数。
返回值
- 返回 0 则表示API成功执行，否则执行失败。
接口限制说明
- Video Processing Unit最高支持创建32路编码或解码的上下文。
- 解码器首帧必须是包含VPS+SPS+PPS帧头信息的IDR帧，否则不能正常解码。
- 解码器不支持包含后向参考帧的B帧码流解码。

int32_t hbVPReleaseVideoDecContext(hbVPVideoContext context);

释放解码器上下文API。

参数
- [in] context 解码器上下文。
返回值
- 返回 0 则表示API成功执行，否则执行失败。

int32_t hbVPVideoDecode(hbUCPTaskHandle_t *taskHandle, 
                        hbVPArray const *srcBuf,
                        hbVPVideoContext context);

调用Video Processing Unit解码API。

参数
- [out] taskHandle 任务句柄，负责算子与UCP架构的交互。
- [in] srcBuf 输入码流文件。
- [in] context 解码器的上下文。
返回值
- 返回 0 则表示API成功执行，否则执行失败。
接口限制说明
- Video解码时，支持的最小分辨率为256x128，最大分辨率为8192x4096。
- 由于Video Processing Unit硬件限制，Video Processing Unit编码或解码时最大支持同时提交31个任务。
- 仅支持使用异步方式创建任务。
- 为了避免系统资源浪费并提高Video Processing Unit解码性能，建议复用输入地址。

int32_t hbVPGetVideoDecOutputBuffer(hbVPImage *outImg,
                                    hbUCPTaskHandle_t taskHandle);

获取解码数据buffer的API。

参数
- [out] outImg 输出YUV图像。
- [in] taskHandle 任务句柄，负责算子与UCP架构的交互。
返回值
- 返回 0 则表示API成功执行，否则执行失败。
接口限制说明
- 输出缓冲区 outImg 由Video Processing Unit内部申请。
- 当任务成功完成后，输出缓冲区中的数据有效；在任务释放阶段，输出缓冲区将被释放。

#hbVPVideoDecode

hbVPVideoDecode