NVIDIA Performance Primitives (NPP)  Version 10.0
Functions
Filter
Convolution

General purpose 2D convolution filter. More...

Functions

NppStatus  nppiFilter_8u_C1R (const Npp8u *pSrc, Npp32s nSrcStep, Npp8u *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Single channel 8-bit unsigned convolution filter. More...
 
NppStatus  nppiFilter_8u_C3R (const Npp8u *pSrc, Npp32s nSrcStep, Npp8u *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Three channel 8-bit unsigned convolution filter. More...
 
NppStatus  nppiFilter_8u_C4R (const Npp8u *pSrc, Npp32s nSrcStep, Npp8u *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Four channel channel 8-bit unsigned convolution filter. More...
 
NppStatus  nppiFilter_8u_AC4R (const Npp8u *pSrc, Npp32s nSrcStep, Npp8u *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Four channel 8-bit unsigned convolution filter, ignoring alpha channel. More...
 
NppStatus  nppiFilter_16u_C1R (const Npp16u *pSrc, Npp32s nSrcStep, Npp16u *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Single channel 16-bit unsigned convolution filter. More...
 
NppStatus  nppiFilter_16u_C3R (const Npp16u *pSrc, Npp32s nSrcStep, Npp16u *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Three channel 16-bit unsigned convolution filter. More...
 
NppStatus  nppiFilter_16u_C4R (const Npp16u *pSrc, Npp32s nSrcStep, Npp16u *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Four channel channel 16-bit unsigned convolution filter. More...
 
NppStatus  nppiFilter_16u_AC4R (const Npp16u *pSrc, Npp32s nSrcStep, Npp16u *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Four channel 16-bit unsigned convolution filter, ignoring alpha channel. More...
 
NppStatus  nppiFilter_16s_C1R (const Npp16s *pSrc, Npp32s nSrcStep, Npp16s *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Single channel 16-bit convolution filter. More...
 
NppStatus  nppiFilter_16s_C3R (const Npp16s *pSrc, Npp32s nSrcStep, Npp16s *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Three channel 16-bit convolution filter. More...
 
NppStatus  nppiFilter_16s_C4R (const Npp16s *pSrc, Npp32s nSrcStep, Npp16s *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Four channel channel 16-bit convolution filter. More...
 
NppStatus  nppiFilter_16s_AC4R (const Npp16s *pSrc, Npp32s nSrcStep, Npp16s *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32s *pKernel, NppiSize oKernelSize, NppiPoint oAnchor, Npp32s nDivisor)
  Four channel 16-bit convolution filter, ignoring alpha channel. More...
 
NppStatus  nppiFilter_32f_C1R (const Npp32f *pSrc, Npp32s nSrcStep, Npp32f *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32f *pKernel, NppiSize oKernelSize, NppiPoint oAnchor)
  Single channel 32-bit float convolution filter. More...
 
NppStatus  nppiFilter_32f_C2R (const Npp32f *pSrc, Npp32s nSrcStep, Npp32f *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32f *pKernel, NppiSize oKernelSize, NppiPoint oAnchor)
  Two channel 32-bit float convolution filter. More...
 
NppStatus  nppiFilter_32f_C3R (const Npp32f *pSrc, Npp32s nSrcStep, Npp32f *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32f *pKernel, NppiSize oKernelSize, NppiPoint oAnchor)
  Three channel 32-bit float convolution filter. More...
 
NppStatus  nppiFilter_32f_C4R (const Npp32f *pSrc, Npp32s nSrcStep, Npp32f *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32f *pKernel, NppiSize oKernelSize, NppiPoint oAnchor)
  Four channel 32-bit float convolution filter. More...
 
NppStatus  nppiFilter_32f_AC4R (const Npp32f *pSrc, Npp32s nSrcStep, Npp32f *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp32f *pKernel, NppiSize oKernelSize, NppiPoint oAnchor)
  Four channel 32-bit float convolution filter, ignoring alpha channel. More...
 
NppStatus  nppiFilter_64f_C1R (const Npp64f *pSrc, Npp32s nSrcStep, Npp64f *pDst, Npp32s nDstStep, NppiSize oSizeROI, const Npp64f *pKernel, NppiSize oKernelSize, NppiPoint oAnchor)
  Single channel 64-bit float convolution filter. More...
 

Detailed Description

General purpose 2D convolution filter.

Pixels under the mask are multiplied by the respective weights in the mask and the results are summed. Before writing the result pixel the sum is scaled back via division by nDivisor.

Common parameters for nppiFilter functions include:

Parameters
pSrc Source-Image Pointer.
nSrcStep Source-Image Line Step.
pDst Destination-Image Pointer.
nDstStep Destination-Image Line Step.
oSizeROI Region-of-Interest (ROI).
pKernel Pointer to the start address of the kernel coefficient array. Coeffcients are expected to be stored in reverse order.
oKernelSize Width and Height of the rectangular kernel.
oAnchor X and Y offsets of the kernel origin frame of reference relative to the source pixel.
nDivisor The factor by which the convolved summation from the Filter operation should be divided. If equal to the sum of coefficients, this will keep the maximum result value within full scale.
Returns
Image Data Related Error Codes, ROI Related Error Codes

Function Documentation

NppStatus nppiFilter_16s_AC4R ( const Npp16s *  pSrc,
Npp32s  nSrcStep,
Npp16s *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Four channel 16-bit convolution filter, ignoring alpha channel.

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

NppStatus nppiFilter_16s_C1R ( const Npp16s *  pSrc,
Npp32s  nSrcStep,
Npp16s *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Single channel 16-bit convolution filter.

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

NppStatus nppiFilter_16s_C3R ( const Npp16s *  pSrc,
Npp32s  nSrcStep,
Npp16s *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Three channel 16-bit convolution filter.

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

NppStatus nppiFilter_16s_C4R ( const Npp16s *  pSrc,
Npp32s  nSrcStep,
Npp16s *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Four channel channel 16-bit convolution filter.

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

NppStatus nppiFilter_16u_AC4R ( const Npp16u *  pSrc,
Npp32s  nSrcStep,
Npp16u *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Four channel 16-bit unsigned convolution filter, ignoring alpha channel.

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

NppStatus nppiFilter_16u_C1R ( const Npp16u *  pSrc,
Npp32s  nSrcStep,
Npp16u *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Single channel 16-bit unsigned convolution filter.

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

NppStatus nppiFilter_16u_C3R ( const Npp16u *  pSrc,
Npp32s  nSrcStep,
Npp16u *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Three channel 16-bit unsigned convolution filter.

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

NppStatus nppiFilter_16u_C4R ( const Npp16u *  pSrc,
Npp32s  nSrcStep,
Npp16u *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Four channel channel 16-bit unsigned convolution filter.

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

NppStatus nppiFilter_32f_AC4R ( const Npp32f *  pSrc,
Npp32s  nSrcStep,
Npp32f *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32f *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor 
)

Four channel 32-bit float convolution filter, ignoring alpha channel.

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

NppStatus nppiFilter_32f_C1R ( const Npp32f *  pSrc,
Npp32s  nSrcStep,
Npp32f *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32f *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor 
)

Single channel 32-bit float convolution filter.

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

NppStatus nppiFilter_32f_C2R ( const Npp32f *  pSrc,
Npp32s  nSrcStep,
Npp32f *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32f *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor 
)

Two channel 32-bit float convolution filter.

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

NppStatus nppiFilter_32f_C3R ( const Npp32f *  pSrc,
Npp32s  nSrcStep,
Npp32f *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32f *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor 
)

Three channel 32-bit float convolution filter.

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

NppStatus nppiFilter_32f_C4R ( const Npp32f *  pSrc,
Npp32s  nSrcStep,
Npp32f *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32f *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor 
)

Four channel 32-bit float convolution filter.

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

NppStatus nppiFilter_64f_C1R ( const Npp64f *  pSrc,
Npp32s  nSrcStep,
Npp64f *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp64f *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor 
)

Single channel 64-bit float convolution filter.

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

NppStatus nppiFilter_8u_AC4R ( const Npp8u *  pSrc,
Npp32s  nSrcStep,
Npp8u *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Four channel 8-bit unsigned convolution filter, ignoring alpha channel.

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

NppStatus nppiFilter_8u_C1R ( const Npp8u *  pSrc,
Npp32s  nSrcStep,
Npp8u *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Single channel 8-bit unsigned convolution filter.

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

NppStatus nppiFilter_8u_C3R ( const Npp8u *  pSrc,
Npp32s  nSrcStep,
Npp8u *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Three channel 8-bit unsigned convolution filter.

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

NppStatus nppiFilter_8u_C4R ( const Npp8u *  pSrc,
Npp32s  nSrcStep,
Npp8u *  pDst,
Npp32s  nDstStep,
NppiSize  oSizeROI,
const Npp32s *  pKernel,
NppiSize  oKernelSize,
NppiPoint  oAnchor,
Npp32s  nDivisor 
)

Four channel channel 8-bit unsigned convolution filter.

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