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

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

See Also