acldvppVpcCalcHistAsync

Applicability

Product	Supported
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas 200I/500 A2 inference products	√
Atlas inference products	√
Atlas training products	x

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 channel description. Must be the same as the channelDesc argument passed to the acldvppCreateChannel call.
srcPicDesc	Input	Pointer to the input image description. Call acldvppCreatePicDesc to create an image description. Call the 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. Call acldvppCreateHist to create a histogram description in advance. Calling this API returns the pixel value distribution (0–255) of each color component of each image.
reserve	Input	Pointer to the histogram configuration. This parameter is reserved and can be set to NULL currently.
stream	Input	Stream.

Returns

0 on successful task delivery; else, failure. For details, see aclError.

Restrictions

Requirements on the input resolution:

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

Model

Restrictions

Atlas inference products

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

Atlas A3 training products/Atlas A3 inference products

Atlas A2 training products/Atlas A2 inference products

Atlas 200I/500 A2 inference products

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

Parent topic: VPC