acldvppVpcCalcHistAsync

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

Obtains the distribution of color components of each pixel in an image. This API is asynchronous.

Prototype

      
           aclError acldvppVpcCalcHistAsync(acldvppChannelDesc *channelDesc,
acldvppPicDesc *srcPicDesc,
acldvppHist *hist,
void *reserve,
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.
srcPicDesc	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). Note: When the image format is YUV440SP 8-bit or YVU440SP 8-bit, the Y component statistics are accurate, but the UV component statistics are inaccurate.
hist	Input/Output	Pointer to histogram description. Invoke the acldvppCreateHist interface to create the histogram description as the input. This API call returns the pixel value distribution (0–255) of each color component of each image.
reserve	Input	Pointer to the histogram statistics configuration, which is reserved. Currently, the value can be NULL.
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

Requirements on the input resolution:

Model	Restriction
Atlas inference product	Input image resolution: [10 × 6, 4096 × 4096].
Atlas A3 training product / Atlas A3 inference product Atlas A2 training product / Atlas A2 inference product Atlas 200I/500 A2 inference product	Input image resolution: [10 × 6, 4096 × 8192].

Model

Restriction

Atlas inference product

Input image resolution: [10 × 6, 4096 × 4096].

Atlas A3 training product / Atlas A3 inference product

Atlas A2 training product / Atlas A2 inference product

Atlas 200I/500 A2 inference product

Input image resolution: [10 × 6, 4096 × 8192].

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_SEMIPLANAR_444 = 5,    // YUV444SP 8bit
PIXEL_FORMAT_YVU_SEMIPLANAR_444 = 6,    // YVU444SP 8bit
PIXEL_FORMAT_YUYV_PACKED_422 = 7,       // YUV422Packed YUYV 8bit
PIXEL_FORMAT_UYVY_PACKED_422 = 8,       // YUV422Packed UYVY 8bit
PIXEL_FORMAT_YVYU_PACKED_422 = 9,       // YUV422Packed YVYU 8bit
PIXEL_FORMAT_VYUY_PACKED_422 = 10,      // YUV422Packed VYUY 8bit
PIXEL_FORMAT_YUV_PACKED_444 = 11,       // YUV444P 8bit
PIXEL_FORMAT_RGB_888 = 12,              // RGB888
PIXEL_FORMAT_BGR_888 = 13,              // BGR888
PIXEL_FORMAT_YUV_SEMIPLANAR_440 = 1000, // YUV440SP 8bit 
PIXEL_FORMAT_YVU_SEMIPLANAR_440 = 1001, // YVU440SP 8bit

For details about the restrictions on the image format, width and height alignment, and memory, see Restrictions on Image Formats, Width and Height Alignment, and Buffers.

Parent topic: VPC