Intel® Integrated Performance Primitives Developer Reference

Developer Reference

  • 2021
  • 01/15/2021
  • Public Content
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.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.