hi_mpi_venc_set_jpeg_param

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	☓

Function Description

Sets the advanced quantization table (QT) parameters of a JPEG encoding channel.

This API must be called after an encoding channel is created and before the channel is destroyed.

You can call hi_mpi_venc_get_jpeg_param to obtain the current parameter, modify the parameter, and then call this API to set the parameter. When the qfactor parameter in the hi_venc_jpeg_param structure is set to 0xFFFFFFFF, the Cb component (blue) and Cr component (red) in the QT must be the same.

Prototype

hi_s32 hi_mpi_venc_set_jpeg_param(hi_venc_chn chn, const hi_venc_jpeg_param *jpeg_param)

Parameters

Parameter	Input/Output	Description
chn	Input	Encoding channel ID. Atlas 350 Accelerator Card: encoding channel ID. The value range is as follows: [0, 256). The maximum number of JPEGE channels is 256. Atlas A3 training product/Atlas A3 inference product: The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256. Atlas A2 training product/Atlas A2 inference product: The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256. Atlas 200I/500 A2 inference product: The value range of this parameter is [0, 128). The JPEGE, and VENC functions share the same channels, and the maximum number of channels is 128. For the Atlas inference product, the value range of the encoding channel ID is [0, 256). The JPEGE and VENC functions share channels. The maximum number of channels is 256.
jpeg_param	Input	Pointer to the advanced parameters of a JPEG encoding channel.

Parameter

Input/Output

Description

chn

Input

Encoding channel ID.

Atlas 350 Accelerator Card: encoding channel ID. The value range is as follows: [0, 256). The maximum number of JPEGE channels is 256.

Atlas A3 training product/Atlas A3 inference product: The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256.

Atlas A2 training product/Atlas A2 inference product: The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256.

Atlas 200I/500 A2 inference product: The value range of this parameter is [0, 128). The JPEGE, and VENC functions share the same channels, and the maximum number of channels is 128.

For the Atlas inference product, the value range of the encoding channel ID is [0, 256). The JPEGE and VENC functions share channels. The maximum number of channels is 256.

jpeg_param

Input

Pointer to the advanced parameters of a JPEG encoding channel.

Returns

0: success
Other values: failure. For details, see VENC/JPEGE Return Codes.

Parent topic: Video Encoding (VENC) and JPEG Encoder (JPEGE)