FilterRoundGetBufSize

Computes the size of the working buffer for filters with rounding mode.

Syntax

Case 1: Filters with integer 16s kernel

IppStatus, ippiFilterRoundGetBufSize16s_<mod>(IppiSize kernelSize, int roiWidth, int* pBufferSize);

Supported values for mod:

8u_C1R
8u_C3R
8u_C4R
8u_AC4R

Case 2: Filters with integer 32s kernel

IppStatus, ippiFilterRoundGetBufSize32s_<mod>(IppiSize kernelSize, int roiWidth, int* pBufferSize);

Supported values for mod:

16u_C1R 16s_C1R
16u_C3R 16s_C3R
16u_C4R 16s_C4R
16u_AC4R 16s_AC4R

Case 3: Filters with floating-point 32f kernel

IppStatus, ippiFilterRoundGetBufSize32f_<mod>(IppiSize kernelSize, int roiWidth, int* pBufferSize);

Supported values for mod:

8u_C1R 16u_C1R 16s_C1R
8u_C3R 16u_C3R 16s_C3R
8u_C4R 16u_C4R 16s_C4R
8u_AC4R 16u_AC4R 16s_AC4R

Parameters

pSrc

Pointer to the source image ROI.

srcStep

Distance in bytes between starts of consecutive lines in the source image.

pDst

Pointer to the destination image ROI.

dstStep

Distance in bytes between starts of consecutive lines in the destination image.

dstRoiSize

Size of the source and destination ROI in pixels.

pKernel

Pointer to the kernel values.

kernelSize

Size of the rectangular kernel in pixels.

anchor

Anchor cell specifying the rectangular kernel alignment with respect to the position of the input pixel.

divisor

The integer value by which the computed result is divided (for operations on integer data only).

roundMode

Rounding mode, the following values are possible:

Description

The functions ippiFilterRoundGetBufSize16s, ippiFilterRoundGetBufSize32s, ippiFilterRoundGetBufSize32f are declared in the ippi.h file. They operates with ROI (see Regions of Interest in Intel IPP).

These functions compute the size of the working buffer pBufferSize that is required for the function ippiFilter_Round16s, ippiFilter_Round32s, ippiFilter_Round32f respectively.

In some cases the functions may return zero size of buffer.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error.

ippStsNullPtrErr

Indicates an error condition if pBufferSize is NULL.

ippStsSizeErr

Indicates an error condition if kernelSize has a field with a zero or negative value, or roiWidth is less than or equal to 0.

Submit feedback on this help topic

Copyright © 2000 - 2010, Intel Corporation. All rights reserved.