vdec_set_chn_param

Applicability

Product

Supported (√/x)

Atlas A3 training products / Atlas A3 inference products

Atlas A2 training products / Atlas A2 inference products

Atlas training products

x

Atlas inference products

Atlas 200I/500 A2 inference products

Function Usage

Sets the decoding channel parameters.

Prototype

  • C Prototype
    1
    hi_s32 hi_mpi_vdec_set_chn_param(hi_vdec_chn chn, const hi_vdec_chn_param *chn_param);
    
  • Python Function
    1
    ret = acl.himpi.vdec_set_chn_param(chn, chn_param)
    

Parameter Description

Parameter

Description

chn

Int, decoding channel ID.

  • Atlas inference products : The value range of this parameter is [0, 256). The JPEGD and VDEC functions share the same channels, and the maximum number of channels is 256.
  • Atlas A2 training products / Atlas A2 inference products : The value range of this parameter is [0, 256). The JPEGD and VDEC functions share the same channels, and the maximum number of channels is 256. Among them, a maximum of 256 JPEGD decoding channels and 32 VDEC decoding channels are supported.
  • Atlas 200I/500 A2 inference products : The value range of this parameter is [0, 128). The JPEGD and VDEC functions share the same channels, and the maximum number of channels is 128.
  • Atlas A3 training products / Atlas A3 inference products : The value range of this parameter is [0, 256). The JPEGD and VDEC functions share the same channels, and the maximum number of channels is 256. Among them, a maximum of 256 JPEGD decoding channels and 32 VDEC decoding channels are supported.

chn_param

Dict, dictionary of decoding channel parameters. For details, see hi_vdec_chn_param.

Return Value Description

Return Value

Description

ret

Int, error code.

Restrictions

  • Ensure that a channel has been created. Otherwise, the error code HI_ERR_VDEC_UNEXIST is returned.
  • This API can be used to set advanced channel parameters. A created channel has default values for these parameters, as described in hi_vdec_chn_param.
  • If the value of a parameter is out of the valid range, the error code HI_ERR_VDEC_ILLEGAL_PARAM is returned. For the value range of each parameter, see the description of hi_vdec_chn_param.
  • When creating a channel by calling acl.himpi.vdec_create_chn, set streams to be sent by frame (currently, streams can be sent only by frame). In addition, you can call this API to set the output stream order to the decoding sequence, that is, chn_param["video_param"]["out_order"] = HI_VIDEO_OUT_ORDER_DEC, to implement fast decoding and output. However, this does not support streams containing B frames.

Reference

For the API call sequence, see JPEGE, and VENC.