venc_set_intra_refresh

Applicability

Product

Supported

Atlas 350 Accelerator Card

x

Atlas A3 training product/Atlas A3 inference product

x

Atlas A2 training product/Atlas A2 inference product

x

Atlas training product

x

Atlas inference product

Atlas 200I/500 A2 inference product

Description

Sets Islice refreshing parameters in P-frames.

Prototype

  • C Prototype
    1
    hi_s32 hi_mpi_venc_set_intra_refresh(hi_venc_chn chn, const hi_venc_intra_refresh *intra_refresh)
    
  • Python Function
    1
    ret = acl.himpi.venc_set_intra_refresh(chn, intra_refresh)
    

Parameters

Parameter

Description

chn

Int, encoding channel ID.
  • 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.
  • For the Atlas 200I/500 A2 inference product, the value range of the encoding channel ID is [0, 128). The JPEGE and VENC functions share channels. The maximum number of channels is 128.

intra_refresh

Dict, Islice refreshing parameter dictionary. For details, see hi_venc_intra_refresh.

Return Value

Return Value

Description

ret

ret: int, error code.

Restrictions

  • Only H.265/H.264 encoding channels in HI_VENC_GOP_MODE_NORMAL_P mode are supported.
  • This API needs to be called again to set parameters after acl.himpi.venc_set_ref_param is called to set advanced frame skipping reference. pred_en cannot be set to 0.
  • After a channel is created and before encoding is started, you are advised to call acl.himpi.venc_get_intra_refresh to obtain Islice 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 Islice refreshing in P-frames, but parameters configured by calling this API take effect until the IDR frame of the next GOP is encoded. However, the parameters take effect immediately when the Islice refreshing is disabled.