昇腾社区首页
中文
注册
开发者
下载
支持
积分兑换 NEW

vdec_get_jpegd_output_info

产品支持情况

产品

是否支持

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

√

Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件

√

Atlas 训练系列产品

x

Atlas 推理系列产品

√

Atlas 200I/500 A2 推理产品

√

Atlas 200/300/500 推理产品

x

功能说明

图片解码场景下，根据输入码流，获取按源图格式或指定图片格式输出时的图片宽、高、宽Stride、高Stride、解码后占用的内存大小、图片格式等信息。

该接口会检查图片格式是否支持解码，如果遇到不支持的码流则该接口会返回“HI_ERR_VDEC_NOT_SUPPORT”错误码，该错误码的详细描述请参见公共返回码。

函数原型

  • C函数原型 
    1
    		 
    hi_s32 hi_mpi_vdec_get_jpegd_output_info(const hi_vdec_stream *stream, const hi_pixel_format output_format, hi_img_info *img_info)
  • python函数 
    1
    		 
    img_info, ret = acl.himpi.vdec_get_jpegd_output_info(stream, output_format)

参数说明

参数名

说明

stream

dict，输入码流信息字典。具体参见hi_vdec_stream。

Atlas 推理系列产品 ，标准形态下，在Host上调用本接口时，该字典内的addr参数配置的地址必须是Host上的内存地址。

Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，在Host上调用本接口时，该字典内的addr参数配置的地址必须是Host上的内存地址。

Atlas 200I/500 A2 推理产品 ，EP模式下，在Host上调用本接口时，该字典内的addr参数配置的地址必须是Host上的内存地址。

Atlas 200I/500 A2 推理产品 ，RC模式下，在Device上调用本接口时，该字典内的addr参数配置的地址必须是Device上的内存地址。

Atlas A3 训练系列产品 / Atlas A3 推理系列产品 ，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。

output_format

int，输出图片格式。

若按源图格式获取相关信息，则将该参数值设置为HI_PIXEL_FORMAT_UNKNOWN = 0。若按指定格式获取相关信息，则将该参数值设置为对应的图片格式，支持的图片格式请参见图片格式、宽高对齐、内存约束。

返回值说明

返回值

说明

img_info

dict，输出图片信息字典，包含图片宽、高、宽Stride、高Stride、解码后占用的内存大小、图片格式等信息。其中，输出图片格式，通过“pixel_format”参数返回。具体参见hi_img_info。

ret
int，错误码。