FilterGaussPyramidLayerDownBorder

Filters the image using a separable Gaussian filter kernel with user supplied floating point coefficients with downsampling and border control. More...

Functions
NppStatus	nppiGetFilterGaussPyramidLayerDownBorderDstROI (int nSrcROIWidth, int nSrcROIHeight, NppiSize *pDstSizeROI, Npp32f nRate)
	Calculate destination image SizeROI width and height from source image ROI width and height and downsampling rate. More...
NppStatus	nppiFilterGaussPyramidLayerDownBorder_8u_C1R_Ctx (const Npp8u *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
	Single channel 8-bit unsigned Gauss filter with downsampling and border control. More...
NppStatus	nppiFilterGaussPyramidLayerDownBorder_8u_C1R (const Npp8u *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType)
NppStatus	nppiFilterGaussPyramidLayerDownBorder_8u_C3R_Ctx (const Npp8u *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
	Three channel 8-bit unsigned Gauss filter with downsampling and border control. More...
NppStatus	nppiFilterGaussPyramidLayerDownBorder_8u_C3R (const Npp8u *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType)
NppStatus	nppiFilterGaussPyramidLayerDownBorder_16u_C1R_Ctx (const Npp16u *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp16u *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
	Single channel 16-bit unsigned Gauss filter with downsampling and border control. More...
NppStatus	nppiFilterGaussPyramidLayerDownBorder_16u_C1R (const Npp16u *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp16u *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType)
NppStatus	nppiFilterGaussPyramidLayerDownBorder_16u_C3R_Ctx (const Npp16u *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp16u *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
	Three channel 16-bit unsigned Gauss filter with downsampling and border control. More...
NppStatus	nppiFilterGaussPyramidLayerDownBorder_16u_C3R (const Npp16u *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp16u *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType)
NppStatus	nppiFilterGaussPyramidLayerDownBorder_32f_C1R_Ctx (const Npp32f *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
	Single channel 32-bit floating-point Gauss filter downsampling and with border control. More...
NppStatus	nppiFilterGaussPyramidLayerDownBorder_32f_C1R (const Npp32f *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType)
NppStatus	nppiFilterGaussPyramidLayerDownBorder_32f_C3R_Ctx (const Npp32f *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
	Three channel 32-bit floating-point Gauss filter with downsampling and border control. More...
NppStatus	nppiFilterGaussPyramidLayerDownBorder_32f_C3R (const Npp32f *pSrc, Npp32s nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, Npp32s nDstStep, NppiSize oSizeROI, Npp32f nRate, const int nFilterTaps, const Npp32f *pKernel, NppiBorderType eBorderType)

Detailed Description

Filters the image using a separable Gaussian filter kernel with user supplied floating point coefficients with downsampling and border control.

If the downsampling rate is equivalent to an integer value then unnecessary source pixels are just skipped. If any portion of the mask overlaps the source image boundary the requested border type operation is applied to all mask pixels which fall outside of the source image.

Currently only the NPP_BORDER_MIRROR and NPP_BORDER_REPLICATE border type operations are supported.

Common parameters for nppiFilterGaussPyramidLayerDownBorder functions include:

Parameters

pSrc	Source-Image Pointer.
nSrcStep	Source-Image Line Step.
oSrcSize	Source image width and height in pixels relative to pSrc.
oSrcOffset	The pixel offset that pSrc points to relative to the origin of the source image.
pDst	Destination-Image Pointer.
nDstStep	Destination-Image Line Step.
oSizeROI	Region-of-Interest (ROI).
nRate	The downsampling rate to be used. For integer equivalent rates unnecessary source pixels are just skipped. For non-integer rates the source image is bilinear interpolated. nRate must be > 1.0F and <= 10.0F.
nFilterTaps	The number of filter taps where nFilterTaps = 2 * ((int)((float)ceil(radius) + 0.5F) ) + 1.
pKernel	Pointer to an array of nFilterTaps kernel coefficients which sum to 1.0F.
eBorderType	The border type operation to be applied at source image border boundaries.
nppStreamCtx	Application Managed Stream Context.

Returns

Image Data Related Error Codes, ROI Related Error Codes

Function Documentation

NppStatus nppiFilterGaussPyramidLayerDownBorder_16u_C1R	(	const Npp16u *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp16u *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType
	)

NppStatus nppiFilterGaussPyramidLayerDownBorder_16u_C1R_Ctx	(	const Npp16u *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp16u *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType,
		NppStreamContext	nppStreamCtx
	)

Single channel 16-bit unsigned Gauss filter with downsampling and border control.

For common parameter descriptions, see Common parameters for nppiFilterGaussPyramidLayerDownBorder functions.

NppStatus nppiFilterGaussPyramidLayerDownBorder_16u_C3R	(	const Npp16u *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp16u *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType
	)

NppStatus nppiFilterGaussPyramidLayerDownBorder_16u_C3R_Ctx	(	const Npp16u *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp16u *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType,
		NppStreamContext	nppStreamCtx
	)

Three channel 16-bit unsigned Gauss filter with downsampling and border control.

For common parameter descriptions, see Common parameters for nppiFilterGaussPyramidLayerDownBorder functions.

NppStatus nppiFilterGaussPyramidLayerDownBorder_32f_C1R	(	const Npp32f *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp32f *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType
	)

NppStatus nppiFilterGaussPyramidLayerDownBorder_32f_C1R_Ctx	(	const Npp32f *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp32f *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType,
		NppStreamContext	nppStreamCtx
	)

Single channel 32-bit floating-point Gauss filter downsampling and with border control.

For common parameter descriptions, see Common parameters for nppiFilterGaussPyramidLayerDownBorder functions.

NppStatus nppiFilterGaussPyramidLayerDownBorder_32f_C3R	(	const Npp32f *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp32f *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType
	)

NppStatus nppiFilterGaussPyramidLayerDownBorder_32f_C3R_Ctx	(	const Npp32f *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp32f *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType,
		NppStreamContext	nppStreamCtx
	)

Three channel 32-bit floating-point Gauss filter with downsampling and border control.

For common parameter descriptions, see Common parameters for nppiFilterGaussPyramidLayerDownBorder functions.

NppStatus nppiFilterGaussPyramidLayerDownBorder_8u_C1R	(	const Npp8u *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp8u *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType
	)

NppStatus nppiFilterGaussPyramidLayerDownBorder_8u_C1R_Ctx	(	const Npp8u *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp8u *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType,
		NppStreamContext	nppStreamCtx
	)

Single channel 8-bit unsigned Gauss filter with downsampling and border control.

For common parameter descriptions, see Common parameters for nppiFilterGaussPyramidLayerDownBorder functions.

NppStatus nppiFilterGaussPyramidLayerDownBorder_8u_C3R	(	const Npp8u *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp8u *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType
	)

NppStatus nppiFilterGaussPyramidLayerDownBorder_8u_C3R_Ctx	(	const Npp8u *	pSrc,
		Npp32s	nSrcStep,
		NppiSize	oSrcSize,
		NppiPoint	oSrcOffset,
		Npp8u *	pDst,
		Npp32s	nDstStep,
		NppiSize	oSizeROI,
		Npp32f	nRate,
		const int	nFilterTaps,
		const Npp32f *	pKernel,
		NppiBorderType	eBorderType,
		NppStreamContext	nppStreamCtx
	)

Three channel 8-bit unsigned Gauss filter with downsampling and border control.

For common parameter descriptions, see Common parameters for nppiFilterGaussPyramidLayerDownBorder functions.

NppStatus nppiGetFilterGaussPyramidLayerDownBorderDstROI	(	int	nSrcROIWidth,
		int	nSrcROIHeight,
		NppiSize *	pDstSizeROI,
		Npp32f	nRate
	)

Calculate destination image SizeROI width and height from source image ROI width and height and downsampling rate.

It is highly recommended that this function be use to determine the destination image ROI for consistent results.

Parameters

nSrcROIWidth	The desired source image ROI width, must be <= oSrcSize.width.
nSrcROIHeight	The desired source image ROI height, must be <= oSrcSize.height.
pDstSizeROI	Host memory pointer to the destination image roi_specification.
nRate	The downsampling or upsampling rate to be used. For integer equivalent rates unnecessary source pixels are just skipped. For non-integer rates the source image is bilinear interpolated. nRate must be > 1.0F and <= 10.0F.

Returns

Image Data Related Error Codes, ROI Related Error Codes