Developer Reference

  • 2020
  • 10/21/2020
  • Public Content
Contents

FilterMedian

Filters a 3D image using a median filter.

Syntax

IppStatus ipprFilterMedian_8u_C1V(const Ipp8u*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp8u*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp8u*
pBorderValue
, const IpprFilterMedianSpec*
pSpec
, Ipp8u*
pBuffer
);
IppStatus ipprFilterMedian_16u_C1V(const Ipp16u*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp16u*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp16u*
pBorderValue
, const IpprFilterMedianSpec*
pSpec
, Ipp8u*
pBuffer
);
IppStatus ipprFilterMedian_16s_C1V(const Ipp16s*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp16s*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp16s*
pBorderValue
, const IpprFilterMedianSpec*
pSpec
, Ipp8u*
pBuffer
);
IppStatus ipprFilterMedian_32f_C1V(const Ipp32f*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp32f*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp32f*
pBorderValue
, const IpprFilterMedianSpec*
pSpec
, Ipp8u*
pBuffer
);
IppStatus ipprFilterMedian_64f_C1V(const Ipp64f*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp64f*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp64f*
pBorderValue
, const IpprFilterMedianSpec*
pSpec
, Ipp8u*
pBuffer
);
Threading Layer (TL) functions
IppStatus ipprFilterMedian_8u_C1V_T(const Ipp8u*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp8u*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp8u*
pBorderValue
, const IpprFilterMedianSpec_T*
pSpec
, Ipp8u*
pBuffer
);
IppStatus ipprFilterMedian_16u_C1V_T(const Ipp16u*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp16u*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp16u*
pBorderValue
, const IpprFilterMedianSpec_T*
pSpec
, Ipp8u*
pBuffer
);
IppStatus ipprFilterMedian_16s_C1V_T(const Ipp16s*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp16s*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp16s*
pBorderValue
, const IpprFilterMedianSpec_T*
pSpec
, Ipp8u*
pBuffer
);
IppStatus ipprFilterMedian_32f_C1V_T(const Ipp32f*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp32f*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp32f*
pBorderValue
, const IpprFilterMedianSpec_T*
pSpec
, Ipp8u*
pBuffer
);
IppStatus ipprFilterMedian_64f_C1V_T(const Ipp64f*
pSrc
, int
srcPlaneStep
, int
srcStep
, Ipp64f*
pDst
, int
dstPlaneStep
, int
dstStep
, IpprVolume
dstRoiVolume
, IpprBorderType
borderType
, const Ipp64f*
pBorderValue
, const IpprFilterMedianSpec_T*
pSpec
, Ipp8u*
pBuffer
);
Include Files
ippi.h
ippi_tl.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
Parameters
pSrc
Array of pointers to the planes in the source volume.
srcStep
Distance, in bytes, between the starting points of consecutive lines in each plane of the source volume.
srcPlaneStep
Distance, in bytes, between the starting points of consecutive images in every plane of the source volume.
pDst
Array of pointers to the planes in the destination volume.
dstStep
Distance, in bytes, between the starting points of consecutive lines in each plane of the destination volume.
dstPlaneStep
Distance, in bytes, between the starting points of consecutive images in every plane of the source volume.
dstRoiVolume
Volume of the destination ROI in pixels.
borderType
Type of the border. Possible values are:
ipprBorderInMem
Border is obtained from the source image pixels in memory.
ipprBorderRepl
Border is replicated from the edge pixels.
ipprBorderConst
Border is replicated from the edge pixels.
pBorderValue
Pointer to the constant value to assign to pixels of the constant border.
pSpec
Pointer to the filter specification structure.
pBuffer
Pointer to the work buffer for filtering operations.
Description
Before using this function, you need to initialize the filter specification structure for 3D image processing using the
ipprFilterMedianInit
function.
This function operates with VOI. This function performs median filtering on a source image with the volume. Type of the image border is defined by the value of the border parameter.
Return Values
ippStsNoErr
Indicates no error condition. Any other value indicates an error condition.
ippStsStepErr
Indicates an error condition if
srcPlaneStep
,
srcStep
,
dstPlaneStep
, or
dstStep
has a field with negative value.
ippStsNullPtrErr
Indicates an error condition if the
pSrc
,
pDst
,
pSpec
,
pBorderValue
, or
pBuffer
pointer is
NULL
.
ippStsSizeErr
Indicates an error condition if
dstRoiVolume
has a field with zero or negative 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