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

ID 790148
Date 3/22/2024
Public
Document Table of Contents

FilterBorderInit

Initializes the filter specification structure for 3D image processing.

Syntax

IppStatus ipprFilterBorderInit_16s(const Ipp16s* pKernel, IpprVolume kernelVolume, int divisor, IppDataType dataType, int numChannels, IpprFilterBorderSpec* pSpec);

IppStatus ipprFilterBorderInit_32f(const Ipp32f* pKernel, IpprVolume kernelVolume, IppDataType dataType, int numChannels, IpprFilterBorderSpec* pSpec);

IppStatus ipprFilterBorderInit_64f(const Ipp64f* pKernel, IpprVolume kernelVolume, IppDataType dataType, int numChannels, IpprFilterBorderSpec* pSpec);

Platform-aware functions

IppStatus ipprFilterBorderInit_16s_L(const Ipp16s* pKernel, IpprVolumeL kernelVolume, int divisor, IppDataType dataType, int numChannels, IpprFilterBorderSpec* pSpec);

IppStatus ipprFilterBorderInit_32f_L(const Ipp32f* pKernel, IpprVolumeL kernelVolume, IppDataType dataType, int numChannels, IpprFilterBorderSpec* pSpec);

IppStatus ipprFilterBorderInit_64f_L(const Ipp64f* pKernel, IpprVolumeL kernelVolume, IppDataType dataType, int numChannels, IpprFilterBorderSpec* pSpec);

Threading Layer (TL) functions based on the Platform Aware API

IppStatus ipprFilterBorderInit_16s_LT(const Ipp16s* pKernel, IpprVolumeL kernelVolume, int divisor, IppDataType dataType, int numChannels, IpprFilterBorderSpec_LT* pSpec);

IppStatus ipprFilterBorderInit_32f_LT(const Ipp32f* pKernel, IpprVolumeL kernelVolume, IppDataType dataType, int numChannels, IpprFilterBorderSpec_LT* pSpec);

IppStatus ipprFilterBorderInit_64f_LT(const Ipp64f* pKernel, IpprVolumeL kernelVolume, IppDataType dataType, int numChannels, IpprFilterBorderSpec_LT* pSpec);

Threading Layer (TL) functions based on the Classic API

IppStatus ipprFilterBorderInit_16s_T(const Ipp16s* pKernel, IpprVolume kernelVolume, int divisor, IppDataType dataType, int numChannels, IpprFilterBorderSpec_T* pSpec);

IppStatus ipprFilterBorderInit_32f_T(const Ipp32f* pKernel, IpprVolume kernelVolume, IppDataType dataType, int numChannels, IpprFilterBorderSpec_T* pSpec);

IppStatus ipprFilterBorderInit_64f_T(const Ipp64f* pKernel, IpprVolume kernelVolume, IppDataType dataType, int numChannels, IpprFilterBorderSpec_T* pSpec);

Include Files

ippi.h

ippi_l.h

ippi_tl.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

kernelVolume

Size of the kernel volume.

pKernel

Pointers to the kernel values.

dataType

Data type of the source image. Possible values are ipp8u, ipp16u, ipp16s, ipp32f, and ipp64f.

divisor

The integer value by which the computed result is divided.

numChannels

Number of channels in the image. Possible value is 1.

pSpec

Pointer to the filter specification structure.

Description

This function operates with VOI. This function initializes the filter specification structure pSpec. Before using this function, you need to compute the size of the specification structure for 3D image processing using the ipprFilterBorderGetSize function.

Return Values

ippStsNoErr

Indicates no error condition. Any other value indicates an error condition.

ippStsNullPtrErr

Indicates an error condition if the pSpec or pKernel pointer is NULL.

ippStsSizeErr

Indicates an error condition if kernelVolume has a field with zero or negative value.

ippStsChannelErr

Indicates an error condition if numChannels has an illegal value.

ippStsDataTypeErr

Indicates an error condition if dataType has an illegal value.

ippStsDivisorErr

Indicates an error condition if the divisor value is zero.

See Also