Function: dvpp_set_roi_config

Applicability

Product

Supported

Atlas 350 Accelerator Card

x

Atlas A3 training product/Atlas A3 inference product

Atlas A2 training product/Atlas A2 inference product

Atlas training product

Atlas inference product

Atlas 200I/500 A2 inference product

Description

Sets an ROI configuration.

Prototype

  • C Prototype
    1
    aclError acldvppSetRoiConfig(acldvppRoiConfig *config, uint32_t left, uint32_t right, uint32_t top, uint32_t bottom)
    
  • Python Function
    1
    ret = acl.media.dvpp_set_roi_config(roi_config, left, right, top, bottom)
    

Parameters

Parameter

Description

roi_config

Int, pointer address of the location data of a specified ROI. Call acl.media.dvpp_create_roi_config in advance to create data.

left

Int, left offset.

  • For the Atlas training product, the value must be an even number. If used to describe the paste ROI, the left offset must be rounded up to the nearest multiple of 16.
  • For the Atlas inference product, the value does not need to be an even number. If used to describe the paste ROI, the left offset must be rounded up to the nearest multiple of 16.
  • For the Atlas A2 training product/Atlas A2 inference product, the value does not need to be an even number or aligned.
  • For the Atlas A3 training product/Atlas A3 inference product, the value does not need to be an even number or aligned.

right

Int, right offset.

  • For the Atlas training product, the value must be an odd number.
  • For the Atlas inference product, the value does not need to be an odd number.
  • For the Atlas A2 training product/Atlas A2 inference product, the value does not need to be an odd number.
  • For the Atlas A3 training product/Atlas A3 inference product, the value does not need to be an odd number.

top

Int, top offset.

  • For the Atlas training product, the value must be an even number.
  • For the Atlas inference product, the value does not need to be an even number.
  • For the Atlas A2 training product/Atlas A2 inference product, the value does not need to be an even number.
  • For the Atlas A3 training product/Atlas A3 inference product, the value does not need to be an even number.

bottom

Int, bottom offset.

  • For the Atlas training product, the value must be an odd number.
  • For the Atlas inference product, the value does not need to be an odd number.
  • For the Atlas A2 training product/Atlas A2 inference product, the value does not need to be an odd number.
  • For the Atlas A3 training product/Atlas A3 inference product, the value does not need to be an odd number.

Return Value

Return Value

Description

ret

Int, error code. 0 on success; else, failure.