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

ID 790148
Date 10/31/2024
Public
Document Table of Contents

ThresholdAdaptiveGaussInit

Initializes the threshold adaptive specification structure for adaptive thresholding with the Gaussian method.

Syntax

IppStatus ippiThresholdAdaptiveGaussInit(IppiSize roiSize, IppiSize maskSize, IppDataType dataType, int numChannels, Ipp32f sigma, IppiThresholdAdaptiveSpec* pSpec);

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 value. 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.

sigma

Value of sigma that is used to calculate a threshold value for the Gaussian method. If sigma value is less than, or equal to zero, sigma is set automatically in compliance with the kernel size.

pSpec

Pointer to the adaptive threshold specification structure.

Description

This function initializes the adaptive threshold specification structure pSpec for adaptive thresholding with the Gaussian method. Before using this function, compute the size of the specification structure using the ThresholdAdaptiveGaussGetBufferSize function.

If sigma is less than, or equal to zero, it is set according to the following formula:

sigma=0.3*((maskSize.width - 1)*0.5 - 1) + 0.8

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 is NULL.
ippStsSizeErr
Indicates an error when dstRoiSize 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