acldvppVpcMakeBorderAsync

The Atlas 200/300/500 Inference Product does not support this API.

The Atlas Training Series Product does not support this API.

Description

Creates a border around an image (also referred to as padding). This API is asynchronous.

Restrictions

  • The input image resolution must be in the range of [10 × 6, 4096 × 4096]. For details about the restrictions on the input image format, alignment, and memory, see Restrictions on Image Formats, Width and Height Alignment, and Buffers.
  • For details about the restrictions on the output image resolution, format, alignment, and buffer size, see Restrictions.
  • Due to restrictions on downsampling of YUV images, when the output image format is YUV420SP or YUV422SP, note the following:
    • For the YUV420SP output format, it is recommended that the border lengths at the top, bottom, left, and right of the image be even numbers.
    • For the YUV422SP output format, it is recommended that the border lengths at the left and right of the image be even numbers.

Prototype

aclError acldvppVpcMakeBorderAsync(const acldvppChannelDesc *channelDesc,

const acldvppPicDesc *inputDesc,

acldvppPicDesc *outputDesc,

const acldvppBorderConfig *borderConfig,

aclrtStream stream)

Parameters

Parameter

Input/Output

Description

channelDesc

Input

Pointer to the channel description.

Must be the same as the channelDesc argument passed to the acldvppCreateChannel call.

inputDesc

Input

Pointer to the input image description.

outputDesc

Input/Output

Pointer to the output image description.

When outputDesc is an input, the user needs to:

borderConfig

Input

Pointer to the border configuration.

Call acldvppCreateBorderConfig to create a border configuration.

stream

Input

Stream.

Returns

0 on successful task delivery; else, failure.