Developer Reference

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

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