venc_start_chn

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

Enables an encoding channel to start receiving source images. The encoding channel automatically stops receiving images when the specified receive limit is reached.

Prototype

C Prototype

        
             hi_s32 hi_mpi_venc_start_chn (hi_venc_chn chn, const hi_venc_start_param *recv_param);

Python Function

        
             ret = acl.himpi.venc_start_chn(chn, recv_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.
recv_param	Dict, dictionary of image receive parameters, which specifies the number of frames to receive. For details, see hi_venc_start_param.

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.

recv_param

Dict, dictionary of image receive parameters, which specifies the number of frames to receive. For details, see hi_venc_start_param.

Return Value Description

Return Value	Description
ret	Int, error code. 0: success. Other values: failures. For details, see VENC/JPEGE Return Codes.

Restrictions

Ensure that a channel has been created. Otherwise, the error code HI_ERR_VENC_UNEXIST is returned.
The value -1 indicates that an unspecified number of frames will be received.
For a channel already in the image receiving progress, if this API is called to specify its frame receive limit, an error code is returned indicating that this request is illegal.
If a channel has started to receive images, you can call this API again without specifying the number of frames to be received before the channel stops receiving images.
The encoder starts encoding images only after its channel has started receiving images.

Reference

For the API call sequence, see JPEGE and VENC.

Parent topic: VENC/JPEGE APIs