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

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

ThresholdAdaptiveGaussGetBufferSize

Computes the size of the adaptive threshold specification structure and the size of the work buffer for adaptive thresholding with the Gaussian method.

Syntax

IppStatus ippiThresholdAdaptiveGaussGetBufferSize(IppiSize roiSize, IppiSize maskSize, IppDataType dataType, int numChannels, 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

roiSize

Size of the destination image ROI, in pixels.

maskSize

Size of the kernel that is used to calculate a threshold level. Width and height of maskSize must be equal and odd.

dataType

Data type of the source and destination images. Possible value is ipp8u.

numChannels

Number of channels in the images. Possible value is 1.

pSpecSize

Pointer to the size of the adaptive threshold specification structure.

pBufferSize

Pointer to the size (in bytes) of the external work buffer.

Description

This function computes the size, in bytes, of the adaptive threshold specification structure and the size of the external work buffer needed for the ThresholdAdaptiveGauss function. The results are stored in pSpecSize and pBufferSize.

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

Return Values

ippStsNoErr
Indicates no error. Any other value indicates an error.
ippStsNullPtrErr
Indicates an error when pSpecSize or pBufferSize is NULL.
ippStsSizeErr
Indicates an error when roiSize has a field with a zero or negative value.
ippStsMaskSizeErr
Indicates an error when maskSize has a field with a zero or negative value, or fields of maskSize are not equal.
ippStsDataTypeErr
Indicates an error when dataType has an illegal value.
ippStsNumChannelsErr
Indicates an error when numChannels has an illegal value.

See Also