acldvppVpcEqualizeHistAsync

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

The Atlas Training Series Product does not support this API.

Description

Remaps the image colors. This API is asynchronous.

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 image alignment requirements, see Restrictions on Image Formats, Width and Height Alignment, and Buffers.

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.

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:

lutMap

Input

Pointer to the color remapping LUT.

Call acldvppCreateLutMap to create data of the acldvppLutMap type and call acldvppGetLutMapData to obtain the memory pointer. You also need to write the color remapping LUT data to the memory and pass the data of the acldvppLutMap type to acldvppVpcEqualizeHistAsync as the input.

stream

Input

Stream.

Returns

0 on successful task delivery; else, failure.