Visible to Intel only — GUID: GUID-E258EE4E-F234-4AD3-8F23-85EC8966C180
Visible to Intel only — GUID: GUID-E258EE4E-F234-4AD3-8F23-85EC8966C180
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.