Function: dvpp_create_roi_config

Applicability

Product

Supported (√/x)

Atlas A3 training products/Atlas A3 inference products

Atlas A2 training products/Atlas A2 inference products

Atlas training products

Atlas inference products

Atlas 200I/500 A2 inference products

Function Usage

Creates data of the acldvppRoiConfig type as an ROI configuration.

To destroy data of the acldvppRoiConfig type, call acl.media.dvpp.destroy_roi_config.

Prototype

  • C Prototype
    1
    acldvppRoiConfig *acldvppCreateRoiConfig(uint32_t left, uint32_t right, uint32_t top, uint32_t bottom)
    
  • Python Function
    1
    dvpp_roi_config = acl.media.dvpp_create_roi_config(left, right, top, bottom)
    

Parameter Description

Parameter

Description

left

Int, left offset.

  • Must be an even number on the Atlas training products. If used to describe the paste ROI, the left offset must be rounded up to the nearest multiple of 16.
  • Can be an odd or even number on the Atlas inference products. If used to describe the paste ROI, the left offset must be rounded up to the nearest multiple of 16.
  • Can be an odd or even number on the Atlas A2 training products/Atlas A2 inference products (no alignment requirement).
  • Can be an odd or even number on the Atlas A3 training products/Atlas A3 inference products (no alignment requirement).

right

Int, right offset.

  • Must be an odd number on the Atlas training products.
  • Can be an odd or even number on the Atlas inference products.
  • Can be an odd or even number on the Atlas A2 training products/Atlas A2 inference products.
  • Can be an odd or even number on the Atlas A3 training products/Atlas A3 inference products.

top

Int, top offset.

  • Must be an even number on the Atlas training products.
  • Can be an odd or even number on the Atlas inference products.
  • Can be an odd or even number on the Atlas A2 training products/Atlas A2 inference products.
  • Can be an odd or even number on the Atlas A3 training products/Atlas A3 inference products.

bottom

Int, bottom offset.

  • Must be an odd number on the Atlas training products.
  • Can be an odd or even number on the Atlas inference products.
  • Can be an odd or even number on the Atlas A2 training products/Atlas A2 inference products.
  • Can be an odd or even number on the Atlas A3 training products/Atlas A3 inference products.

Return Value Description

Return Value

Description

dvpp_roi_config

Int, pointer address of the data of the acldvppRoiConfig type.

  • If a non-zero value is returned, the operation is successful.
  • If 0 is returned, the operation fails.