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.

Syntax

IppStatus ippiFilterBorderGetSize (IppiSize kernelSize, IppiSize dstRoiSize, IppDataType dataType, IppDataType kernelType, int numChannels, int* pSpecSize, int* pBufferSize);

Include Files

ippi.h

Domain Dependencies

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

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

Parameters

kernelSize

Size of the rectangular kernel in pixels.

dstRoiSize

Maximal size of the destination image ROI (in pixels).

dataType

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

kernelType

Data type of the filter kernel. Possible values are ipp16s, ipp32f, or ipp64f.

numChannels

Number of channels in the image. Possible values are 1, 3, or 4.

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 ROI.

This function computes the size of the filter specification structure pSpec and the size of the buffer required for filtering operations. Call this function before using the ippiFilterBorderInit function.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when one of the specified pointers is NULL.

ippStsSizeErr

Indicates an error when kernelSize has a field with a zero or negative value, or if dstRoiSize is less than 1.

ippStsDataTypeErr

Indicates an error when dataType or kernelType has an illegal value.

ippStsChannelErr

Indicates an error when numChannels has an illegal value.

See Also