Intel® Integrated Performance Primitives Developer Reference

Developer Reference

  • 2021
  • 03/26/2021
  • Public Content
Contents

FilterBorderGetSize

Computes the size of the filter specification structure and the size of the work buffer for 3D image processing.

Syntax

IppStatus ipprFilterBorderGetSize(IpprVolume
kernelVolume
, IpprVolume
dstRoiVolume
, IppDataType
dataType
, IppDataType
kernelType
, int
numChannels
, int*
pSpecSize
, int*
pBufferSize
);
Platform-aware function
IppStatus ipprFilterBorderGetSize_L(IpprVolumeL
kernelVolume
, IpprVolumeL
dstRoiVolume
, IppDataType
dataType
, IppDataType
kernelType
, int
numChannels
, IppSizeL*
pSpecSize
, IppSizeL*
pBufferSize
);
Threading Layer (TL) function based on the Platform Aware API
IppStatus ipprFilterBorderGetSize_LT(IpprVolumeL
kernelVolume
, IpprVolumeL
dstRoiVolume
, IppDataType
dataType
, IppDataType
kernelType
, int
numChannels
, IppSizeL*
pSpecSize
, IppSizeL*
pBufferSize
);
Threading Layer (TL) function based on the Classic API
IppStatus ipprFilterBorderGetSize_T(IpprVolume
kernelVolume
, IpprVolume
dstRoiVolume
, IppDataType
dataType
, IppDataType
kernelType
, int
numChannels
, int*
pSpecSize
, int*
pBufferSize
);
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.
dstRoiVolume
Maximal size of the destination image ROI (in pixels).
dataType
Data type of the source image. Possible values are
ipp8u
,
ipp16u
,
ipp16s
,
ipp32f
, and
ipp64f
.
kernelType
Data type of the filter kernel. Possible values are
ipp16s
,
ipp32f
, and
ipp64f
.
numChannels
Number of channels in the image. Possible value is 1.
pSpecSize
Pointer to the size of the filter specification structure.
pBufferSize
Pointer to the size of the work buffer required for filtering.
Description
This function operates with VOI. This function computes the size of the filter specification structure
pSpec
 and the size of the buffer required for 3D image filtering operations. Call this function before using the
ipprFilterBorderInit
 function.
Return Values
ippStsNoErr
Indicates no error condition. Any other value indicates an error condition.
ippStsNullPtrErr
Indicates an error condition if the
pSpecSize
 or
pBufferSize
 pointer is
NULL
.
ippStsSizeErr
Indicates an error condition if
dstRoiVolume
 or
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 the combination of
kernelType
 and
dataType
 has an illegal value.

Product and Performance Information

1

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