Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
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
.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804