hi_mpi_venc_set_intra_refresh

Applicability

Product	Supported
Atlas A3 training products/Atlas A3 inference products	☓
Atlas A2 training products/Atlas A2 inference products	☓
Atlas 200I/500 A2 inference products	√
Atlas inference products	√
Atlas training products	☓

Description

Sets I-slice refreshing parameters in P-frames.

Prototype

hi_s32 hi_mpi_venc_set_intra_refresh (hi_venc_chn chn, const hi_venc_intra_refresh *intra_refresh);

Parameters

Parameter	Input/Output	Description
chn	Input	Encoding channel ID. Atlas 200I/500 A2 inference products: The value range of the encoding channel ID is [0, 128). The JPEGE and VENC functions share the same channels, and the maximum number of channels is 128. Atlas inference products: The value range of the encoding channel ID is [0, 256). The JPEGE and VENC functions share the same channels, and the maximum number of channels is 256.
intra_refresh	Input	I-slice refreshing parameters.

Parameter

Input/Output

Description

chn

Input

Encoding channel ID.

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

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

intra_refresh

Input

I-slice refreshing parameters.

Returns

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

Restrictions

Only H.265/H.264 encoding channels in HI_VENC_GOP_MODE_NORMAL_P mode are supported.
After hi_mpi_venc_set_ref_param is called to set advanced frame skipping reference, this API needs to be called again. pred_en cannot be set to 0.
After a channel is created and before encoding is started, you are advised to call hi_mpi_venc_get_intra_refresh to obtain I-slice refreshing parameters in P-frames, and then call this API to set the parameters.
An I-frame is generated when this API is called to enable I-slice refreshing in P-frames, but parameters set by calling this API take effect when the IDR frame of the next GOP is encoded. Parameters set by calling this API take effect immediately when I-slice refreshing in P-frames is disabled.

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