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

ID 790148
Date 3/22/2024
Public
Document Table of 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);

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.

See Also