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

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

ThresholdAdaptiveBoxGetBufferSize

Computes the size of the work buffer for adaptive thresholding with the Box method.

Syntax

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

pBufferSize

Pointer to the size, in bytes, of the external work buffer.

Description

This function computes the size, in bytes, of the external work buffer needed for the ThresholdAdaptiveBox function. The result is stored in pBufferSize.

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

Return Values

ippStsNoErr
Indicates no error. Any other value indicates an error.
ippStsNullPtrErr
Indicates an error when 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