Developer Reference

  • 2020
  • 07/15/2020
  • 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

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804