Filter

Filters a volume using a general cuboidal kernel.

Syntax

IppStatus ipprFilter_16s_C1PV(const Ipp16s* const pSrc[], int srcStep, Ipp16s* const pDst[], int dstStep, IpprVolume dstVolume, const Ipp32s* pKernel, IpprVolume kernelVolume, IpprPoint anchor, int divisor, Ipp8u* pBuffer);

Parameters

pSrc

Array of pointers to the planes in the source volume.

srcStep

Distance in bytes between starts of consecutive lines in each plane of the source volume.

pDst

Array of pointers to the planes in the destination volume.

dstStep

Distance in bytes between starts of consecutive lines in each plane of the destination volume.

dstVolume

Size of the processed volume.

pKernel

Pointers to the kernel values.

kernelVolume

Size of the kernel volume.

anchor

Anchor 3d-cell specifying the cuboidal kernel alignment with respect to the position of the input voxel.

divisor

The integer value by which the computed result is divided.

pBuffer

Pointer to the external buffer.

Description

The function ipprFilter is declared in the ippr.h file. It operates with VOI. This function uses the general cuboidal kernel of size kernelVolume to filter a volume VOI. This function sums the products between the kernel coefficients pKernel and voxel values taken over the source voxel neighborhood defined by kernelVolume and anchor. The anchor 3d-cell is specified by its coordinates anchor.x, anchor.y and anchor.z in the coordinate system associated with the right bottom back corner of the kernel. Note the kernel coefficients are used in inverse order. The sum is written to the destination voxel. To ensure valid operation when volume boundary voxels are processed, the application must correctly define additional border voxels.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error.

ippStsNullPtrErr

Indicates an error condition if pSrc, pDst, pKernel or pBuffer pointer is NULL.

ippStsSizeErr

Indicates an error condition if dstVolume or kernelVolume has a field with zero or negative value.

ippStsDivisorErr

Indicates an error condition if the divisor value is zero.

Submit feedback on this help topic

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