Visible to Intel only — GUID: GUID-CFC6F0BB-DAD9-4906-8610-26ACF3D4EF3C
Visible to Intel only — GUID: GUID-CFC6F0BB-DAD9-4906-8610-26ACF3D4EF3C
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. |