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);

IppStatus ippiFilterSeparableInit_16s_T(const Ipp16s* pRowKernel, const Ipp16s* pColumnKernel, IppiSize kernelSize, int divisor, int scaleFactor, IppDataType dataType, int numChannels, IppiFilterSeparableSpec* pSpec);

IppStatus ippiFilterSeparableInit_32f_T(const Ipp32f* pRowKernel, const Ipp32f* pColumnKernel, IppiSize kernelSize, IppDataType dataType, int numChannels, IppiFilterSeparableSpec* pSpec);

IppStatus ippiFilterSeparableInit_16s_LT(const Ipp16s* pRowKernel, const Ipp16s* pColumnKernel, IppiSize kernelSize, int divisor, int scaleFactor, IppDataType dataType, int numChannels, IppiFilterSeparableSpec* pSpec);

IppStatus ippiFilterSeparableInit_32f_LT(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.