跳到主要内容

acl.himpi.vdec_get_chn_param

acl.himpi.vdec_reset_chn​

c函数原型hi_s32 hi_mpi_vdec_reset_chn(hi_vdec_chn chn);
Python函数ret = acl.himpi.vdec_reset_chn(chn)
函数功能解码通道长时间没有反应的情况下或者解码失败等情况下，可以调用此接口复位通道，尝试恢复。
输入说明**chn：**解码通道号。
- Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。
返回值说明ret：int，错误码。
- 返回0表示成功。
- 返回非0表示失败，参见VDEC视频/JPEGD图像解码返回码。
约束说明- 复位前必须保证通道已创建，否则会返回错误码“HI_ERR_VDEC_UNEXIST”。
- 复位前必须停止接收码流，否则返回错误码“HI_ERR_VDEC_NOT_PERM”。
参考资源无

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

acl.himpi.vdec_set_chn_param​

c函数原型hi_s32 hi_mpi_vdec_set_chn_param(hi_vdec_chn chn, const hi_vdec_chn_param *chn_param);
Python函数ret = acl.himpi.vdec_set_chn_param(chn, chn_param)
函数功能改变通道参数的时候调用此接口，设置解码通道参数。
输入说明- chn：解码通道号。
- Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。
- chn_param：解码通道参数字典，具体请参见hi_vdec_chn_param。
返回值说明ret：int，错误码。
- 返回0表示成功。
- 返回非0表示失败，参见VDEC视频/JPEGD图像解码返回码。
约束说明- 必须保证通道已创建，否则会返回错误码“HI_ERR_VDEC_UNEXIST”。
- 该接口可设置通道的一些高级属性，创建通道后有默认值，默认值见数据类型hi_vdec_chn_param的说明。
- 各项参数如超过合法范围，会返回 “HI_ERR_VDEC_ILLEGAL_PARAM”的错误码，各参数范围见数据类型hi_vdec_chn_param的说明。
- 调用acl.himpi.vdec_create_chn接口创建通道时设置按帧发送码流（目前仅支持按帧发送），同时，调用本接口设置解码序输出码流，即c****hn_param["video_param"]["out_order"] = HI_VIDEO_OUT_ORDER_DEC，可以达到快速解码和快速输出的目的，但这种场景不支持解码含有B帧的码流。
参考资源接口调用流程，参见JPEGD图片解码、VDEC视频解码。

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

acl.himpi.vdec_get_chn_param​

c函数原型hi_s32 hi_mpi_vdec_get_chn_param(hi_vdec_chn chn, hi_vdec_chn_param *****chn_param);
Python函数chn_param, ret = acl.himpi.vdec_get_chn_param(chn)
函数功能修改通道参数前可先调用此接口获取通道参数。
输入说明chn：解码通道号。
- Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。
返回值说明chn_param：解码通道参数字典，具体请参见hi_vdec_chn_param。 ret：int，错误码。
- 返回0表示成功。
- 返回非0表示失败，参见VDEC视频/JPEGD图像解码返回码。
约束说明必须保证通道已创建，否则会返回错误码“HI_ERR_VDEC_UNEXIST”。
参考资源接口调用流程，参见JPEGD图片解码、VDEC视频解码。

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

acl.himpi.vdec_set_protocol_param​

c函数原型hi_s32 hi_mpi_vdec_set_protocol_param(hi_vdec_chn chn, const hi_vdec_protocol_param* protocol_param);
Python函数ret = acl.himpi.vdec_set_protocol_param(chn, protocol_param)
函数功能设置协议相关的内存分配通道参数，如slice、pps（Picture Parameter Set）、sps（Sequence Parameter Set）等。 当前版本不支持该接口。
输入说明- chn：解码通道号。
- Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。
- protocol_param：解码通道参数字典，具体请参见hi_vdec_protocol_param。
返回值说明ret：int，错误码。
- 返回0表示成功。
- 返回非0表示失败，参见VDEC视频/JPEGD图像解码返回码。
约束说明- 必须保证通道已创建，否则会返回错误码“HI_ERR_VDEC_UNEXIST”。
- 设置协议参数前必须先停止接收码流，否则返回错误码“HI_ERR_VDEC_NOT_PERM”。
- 切换协议参数时，解码器内部会复位解码通道。
- 协议参数所需的内存是解码器内部根据当前码流实际vps（Video Parameter Set）/sps/pps/slice个数使用vmalloc动态分配的，最大上限不超过此接口设置的最大vps/sps/pps/slice个数。
参考资源无

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

acl.himpi.vdec_get_protocol_param​

c函数原型hi_s32 hi_mpi_vdec_get_protocol_param(hi_vdec_chn chn, hi_vdec_protocol_param* protocol_param);
Python函数protocol_param, ret = acl.himpi.vdec_get_protocol_param(chn)
函数功能获取协议相关的内存分配通道参数，如slice、pps（Picture Parameter Set）、sps（Sequence Parameter Set）等。
输入说明- chn：解码通道号。
- Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。
返回值说明- protocol_param：解码通道参数字典，具体请参见hi_vdec_protocol_param。
- ret：int，错误码。
- 返回0表示成功。
- 返回非0表示失败，参见VDEC视频/JPEGD图像解码返回码。
约束说明必须保证通道已创建，否则会返回错误码“HI_ERR_VDEC_UNEXIST”。
参考资源无

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

acl.himpi.vdec_send_stream​

c函数原型hi_s32 hi_mpi_vdec_send_stream(hi_vdec_chn chn, const hi_vdec_stream *stream, hi_vdec_pic_info *vdec_pic_info, hi_s32 milli_sec);
Python函数ret = acl.himpi.vdec_send_stream(chn, stream, vdec_pic_info, milli_sec)
函数功能解码前，向解码通道发送码流数据及存放解码结果的buffer。
输入说明- chn：解码通道号。
- Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，JPEGD功能和VDEC功能共用通道，且通道总数最多128。
- stream：输入码流信息。 该字典内的addr参数配置的地址为Device上的内存地址。
- vdec_pic_info：输出图片信息字典。
- milli_sec：超时时间，单位是毫秒。
- “-1”：阻塞方式。
- “0”：非阻塞方式。
- >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的“milli_sec”参数值为“1”，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。
返回值说明ret：int，错误码。
- 返回0表示成功。
- 返回非0表示失败，参见VDEC视频/JPEGD图像解码返回码。
约束说明- 发送数据前必须保证已经调用acl.himpi.vdec_start_recv_stream接口启动接收码流，否则直接返回该操作不允许的错误码“HI_ERR_VDEC_NOT_PERM”。如果在发送数据过程中停止接收码流，就会立刻返回“HI_ERR_VDEC_NOT_PERM”。
- 发送数据前必须保证通道已经被创建，否则直接返回通道未创建的错误码“HI_ERR_VDEC_UNEXIST”。如果在发送码流过程中复位通道或者销毁通道，就会立刻返回错误码“HI_ERR_VDEC_UNEXIST”。
- 发送码流时需要按照创建解码通道时设置的发送方式（仅支持按帧发送）进行发送。按帧发送时，调用此接口一次，必须发送完整的一帧码流，否则，解码会出现错误。
- 不能发送end_of_stream为0的空码流包（码流长度为0或码流地址为空），否则返回错误码。发送end_of_stream为1的空码流包时，解码器会把所有码流全部解完并输出全部图像。除此之外，其它情况应该把end_of_stream置为0。
- 当码流buffer为空且装不下当前包码流时，会返回参数超出范围的错误码“HI_ERR_VDEC_ILLEGAL_PARAM”。
- 以非阻塞方式发送码流，如果码流缓冲区已满，会立刻返回错误码“HI_ERR_VDEC_BUF_FULL”。
- 以超时方式发送码流，到达设定的超时时间还不能成功发送码流会返回错误码“HI_ERR_VDEC_BUF_FULL”。
- 视频解码时支持设置是否将解码结果写入输出内存中，hi_vdec_stream字典中将“need_display”设置为“0”时，此帧码流的解码结果将不会写入到hi_vdec_pic_info字典中配置的输出内存中，此时允许将输出内存地址配置为“None”。acl.himpi.vdec_get_frame接口仍然能获取到字典 hi_video_frame_info和hi_vdec_stream的信息，但是此时输出内存中无解码结果数据，需要用户释放输出内存（如果用户传入的输出内存地址是“None”，则无需释放）。
- 解码时，输入输出内存均需要在调用acl.himpi.vdec_get_frame接口获取结果之后才能进行释放。
- 视频解码，输入输出内存要求、输入码流格式、输出图片格式请参见VDEC功能及约束说明。
- 图像解码，输入输出内存要求、输入图片格式、输出图片格式请参见JPEGE功能及约束说明。

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

在线提单