acldvppVpcEqualizeHistAsync

Applicability

Product	Supported
Atlas 350 Accelerator Card	☓
Atlas A3 training product / Atlas A3 inference product	√
Atlas A2 training product / Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	☓

Function Description

Remaps the image colors. This API is asynchronous.

Prototype

      
           aclError acldvppVpcEqualizeHistAsync(const acldvppChannelDesc *channelDesc,
const acldvppPicDesc *inputDesc,
acldvppPicDesc *outputDesc,
const acldvppLutMap *lutMap,
aclrtStream stream)

Parameters

Parameter	Input/Output	Description
channelDesc	Input	Pointer to the channel description. The value must be the same as that of channelDesc specified when the acldvppCreateChannel API is called to create a channel.
inputDesc	Input	Pointer to the input image description. Call the acldvppCreatePicDesc API to create the image description. Call acldvppSetPicDesc series to set the image description (including the buffer address, buffer size, image format, and image resolution).
outputDesc	Input/Output	Pointer to the output image description. When outputDesc is an input, the user needs to: Call the acldvppCreatePicDesc API to create the image description. Call acldvppSetPicDesc series to set the image description (including the buffer address, buffer size, image format, and image resolution).
lutMap	Input	Pointer to the color remapping LUT. Call the acldvppCreateLutMap API to create data of the acldvppLutMap type (indicating the color remapping table), call the acldvppGetLutMapData API to obtain the memory pointer, and write the color remapping table data to the memory, then, the data of the acldvppLutMap type is passed to acldvppVpcEqualizeHistAsync as the input parameter.
stream	Input	Stream. For details about the type definition, see aclrtStream.

Returns

If the return value is 0, the task is successfully delivered. If the return value is not 0, the task fails to be delivered. For details, see aclError.

Restrictions

The input image resolution must be in the range of [10 × 6, 4096 × 4096].

The following enum values of acldvppPixelFormat are supported for the input image format:

PIXEL_FORMAT_YUV_400 = 0,              // YUV400 8bit
PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1,   // YUV420SP NV12 8bit   
PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2,   // YUV420SP NV21 8bit 
PIXEL_FORMAT_YUV_SEMIPLANAR_422 = 3,   // YUV422SP 8bit
PIXEL_FORMAT_YVU_SEMIPLANAR_422 = 4,   // YVU422SP 8bit
PIXEL_FORMAT_YUV_PACKED_444 = 11,      // YUV444P 8bit
PIXEL_FORMAT_RGB_888 = 12,             // RGB888
PIXEL_FORMAT_BGR_888 = 13,             // BGR888

The output image resolution, image format, and widthStride and heightStride alignment requirements are consistent with those for the input.
For details about the alignment requirements of different image formats, see Restrictions on Image Formats, Width and Height Alignment, and Buffers.

Parent topic: VPC