Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public
Document Table of Contents

HistogramGetBufferSize

Computes the size of the specification structure and work buffer for the ippiHistogram function.

Syntax

IppStatus ippiHistogramGetBufferSize(IppDataType dataType, IppiSize roiSize, const int nLevels[], int numChannels, int uniform, int* pSpecSize, int* pBufferSize);

Include Files

ippi.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

dataType

Data type of the source image. Supported values are: ipp8u, ipp16u, ipp16s, and ipp32f.

roiSize

Size of the source image ROI, in pixels.

nLevels

Number of level values. Each channel has a separate number of levels.

numChannels

Number of image channels. Supported values are: 1, 3, and 4.

uniform

Type of levels distribution: 0 - with random step, 1 - with uniform step.

pSpecSize

Pointer to the computed value of the specification structure size, in bytes.

pBufferSize

Pointer to the computed value of the external buffer size.

Description

The ippiHistogramGetBufferSize function computes the size of the histogram specification structure and the size of the external work buffer (in bytes) needed for the Histogram function.

For an example on how to use this function, refer to the example provided with the Histogram function description.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error or a warning.

ippStsNullPtrErr

Indicates an error when one of the specified pointers is NULL.

ippStsSizeErr

Indicates an error when roiSize is less than, or equal to zero.

ippStsHistoNofLevelsErr

Indicates an error when the number of levels is less than 2.

ippStsNumChannelsErr

Indicates an error when the numChannels value differs from 1, 3, or 4.

ippStsDataTypeErr

Indicates an error when the dataType value differs from ipp8u, ipp16u, ipp16s, or ipp32f.

See Also