Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
Contents

FilterSeparableInit

Initializes the filter specification structure.

Syntax

IppStatus ippiFilterSeparableInit_16s(const Ipp16s*
pRowKernel
, const Ipp16s*
pColumnKernel
, IppiSize
kernelSize
, int
divisor
, int
scaleFactor
, IppDataType
dataType
, int
numChannels
, IppiFilterSeparableSpec*
pSpec
);
IppStatus ippiFilterSeparableInit_32f(const Ipp32f*
pRowKernel
, const Ipp32f*
pColumnKernel
, IppiSize
kernelSize
, IppDataType
dataType
, int
numChannels
, IppiFilterSeparableSpec*
pSpec
);
Platform-aware functions
IppStatus ippiFilterSeparableInit_16s_L(const Ipp16s*
pRowKernel
, const Ipp16s*
pColumnKernel
, IppiSize
kernelSize
, int
divisor
, int
scaleFactor
, IppDataType
dataType
, int
numChannels
, IppiFilterSeparableSpec*
pSpec
);
IppStatus ippiFilterSeparableInit_32f_L(const Ipp32f*
pRowKernel
, const Ipp32f*
pColumnKernel
, IppiSize
kernelSize
, IppDataType
dataType
, int
numChannels
, IppiFilterSeparableSpec*
pSpec
);
Include Files
ippcv.h
ippcv_l.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
,
ippi.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
,
ippi.lib
Parameters
pRowKernel
,
pColumnKernel
Pointer to the row and column kernel values.
kernelSize
Size of the rectangular kernel in pixels.
divisor
Integer value by which the computed result is divided.
scaleFactor
Integer value by which the computed result is divided.
dataType
Data type of the source image. Possible values are
Ipp8u
,
Ipp16s
,
Ipp16u
,
Ipp32f
.
numChannels
Number of channels in the image. Possible values are 1, 3, and 4.
pSpec
Pointer to the filter specification structure.
Description
This function initializes the filter specification structure
pSpec
in the external buffer. Before using this function, you need to compute the size of the specification structure using the
FilterSeparableGetSpecSize
function. This structure is used by the
FilterSeparable
function that performs filtering operations on the source image pixels.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error.
ippStsNullPtrErr
Indicates an error condition if one of the specified pointers is
NULL
.
ippStsSizeErr
Indicates an error condition if
kernelSize
has a field with a zero or negative value.
ippStsDataTypeErr
Indicates an error condition if
dataType
has an illegal value.
ippStsChannelErr
Indicates an error condition if
numChannels
has an illegal value.
ippStsDivisorErr
Indicates an error condition if
divisor
has a zero 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