NVIDIA 2D Image And Signal Performance Primitives (NPP)  Version 11.4.0.*
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Functions
MorphBlackHatBorder

Morphological close pixel result minus source pixel with border control. More...

Functions

NppStatus  nppiMorphBlackHatBorder_8u_C1R_Ctx (const Npp8u *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
  1 channel 8-bit unsigned integer morphological black hat with border control. More...
 
NppStatus  nppiMorphBlackHatBorder_8u_C1R (const Npp8u *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType)
 
NppStatus  nppiMorphBlackHatBorder_8u_C3R_Ctx (const Npp8u *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
  3 channel 8-bit unsigned integer morphological black hat with border control. More...
 
NppStatus  nppiMorphBlackHatBorder_8u_C3R (const Npp8u *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType)
 
NppStatus  nppiMorphBlackHatBorder_8u_C4R_Ctx (const Npp8u *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
  4 channel 8-bit unsigned integer morphological black hat with border control. More...
 
NppStatus  nppiMorphBlackHatBorder_8u_C4R (const Npp8u *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp8u *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType)
 
NppStatus  nppiMorphBlackHatBorder_16u_C1R_Ctx (const Npp16u *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp16u *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
  1 channel 16-bit unsigned integer morphological black hat with border control. More...
 
NppStatus  nppiMorphBlackHatBorder_16u_C1R (const Npp16u *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp16u *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType)
 
NppStatus  nppiMorphBlackHatBorder_16s_C1R_Ctx (const Npp16s *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp16s *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
  1 channel 16-bit signed integer morphological black hat with border control. More...
 
NppStatus  nppiMorphBlackHatBorder_16s_C1R (const Npp16s *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp16s *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType)
 
NppStatus  nppiMorphBlackHatBorder_32f_C1R_Ctx (const Npp32f *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
  1 channel 32-bit floating point morphological black hat with border control. More...
 
NppStatus  nppiMorphBlackHatBorder_32f_C1R (const Npp32f *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType)
 
NppStatus  nppiMorphBlackHatBorder_32f_C3R_Ctx (const Npp32f *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
  3 channel 32-bit floating point morphological black hat with border control. More...
 
NppStatus  nppiMorphBlackHatBorder_32f_C3R (const Npp32f *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType)
 
NppStatus  nppiMorphBlackHatBorder_32f_C4R_Ctx (const Npp32f *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType, NppStreamContext nppStreamCtx)
  4 channel 32-bit floating point morphological black hat with border control. More...
 
NppStatus  nppiMorphBlackHatBorder_32f_C4R (const Npp32f *pSrc, int nSrcStep, NppiSize oSrcSize, NppiPoint oSrcOffset, Npp32f *pDst, int nDstStep, NppiSize oSizeROI, const Npp8u *pMask, NppiSize oMaskSize, NppiPoint oAnchor, Npp8u *pBuffer, NppiBorderType eBorderType)
 

Detailed Description

Morphological close pixel result minus source pixel with border control.

Morphological black hat computes the output pixel as the morphological close pixel value of the pixels under the mask minus the source pixel value. Pixels who's corresponding mask values are zero do not participate in the maximum or minimum search.

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. The mask is centered over the source image pixel being tested.

Before calling any of the MorphBlackHatBorder functions the application first needs to call the corresponding MorphGetBufferSize to determine the amount of device memory to allocate as a working buffer. The allocated device memory is then passed as the pBuffer parameter to the corresponding MorphBlackHatBorder function.

Use the oSrcOffset and oSrcSize parameters to control where the border control operation is applied to the source image ROI borders.

Currently only the NPP_BORDER_REPLICATE border type operation is supported.

Common parameters for nppiMorphBlackHatBorder functions include:

Parameters
pSrc Source-Image Pointer.
nSrcStep Source-Image Line Step.
oSrcSize Source image width and height in pixels relative to pSrc.
oSrcOffset Source image starting point relative to pSrc.
pDst Destination-Image Pointer.
nDstStep Destination-Image Line Step.
oSizeROI Region-of-Interest (ROI).
pMask Pointer to the start address of the mask array
oMaskSize Width and Height mask array.
oAnchor X and Y offsets of the mask origin frame of reference w.r.t the source pixel.
pBuffer Pointer to device memory scratch buffer at least as large as value returned by the corresponding MorphGetBufferSize call.
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 nppiMorphBlackHatBorder_16s_C1R ( const Npp16s pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp16s pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType 
)
NppStatus nppiMorphBlackHatBorder_16s_C1R_Ctx ( const Npp16s pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp16s pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType,
NppStreamContext  nppStreamCtx 
)

1 channel 16-bit signed integer morphological black hat with border control.

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

NppStatus nppiMorphBlackHatBorder_16u_C1R ( const Npp16u pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp16u pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType 
)
NppStatus nppiMorphBlackHatBorder_16u_C1R_Ctx ( const Npp16u pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp16u pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType,
NppStreamContext  nppStreamCtx 
)

1 channel 16-bit unsigned integer morphological black hat with border control.

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

NppStatus nppiMorphBlackHatBorder_32f_C1R ( const Npp32f pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp32f pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType 
)
NppStatus nppiMorphBlackHatBorder_32f_C1R_Ctx ( const Npp32f pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp32f pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType,
NppStreamContext  nppStreamCtx 
)

1 channel 32-bit floating point morphological black hat with border control.

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

NppStatus nppiMorphBlackHatBorder_32f_C3R ( const Npp32f pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp32f pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType 
)
NppStatus nppiMorphBlackHatBorder_32f_C3R_Ctx ( const Npp32f pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp32f pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType,
NppStreamContext  nppStreamCtx 
)

3 channel 32-bit floating point morphological black hat with border control.

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

NppStatus nppiMorphBlackHatBorder_32f_C4R ( const Npp32f pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp32f pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType 
)
NppStatus nppiMorphBlackHatBorder_32f_C4R_Ctx ( const Npp32f pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp32f pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType,
NppStreamContext  nppStreamCtx 
)

4 channel 32-bit floating point morphological black hat with border control.

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

NppStatus nppiMorphBlackHatBorder_8u_C1R ( const Npp8u pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp8u pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType 
)
NppStatus nppiMorphBlackHatBorder_8u_C1R_Ctx ( const Npp8u pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp8u pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType,
NppStreamContext  nppStreamCtx 
)

1 channel 8-bit unsigned integer morphological black hat with border control.

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

NppStatus nppiMorphBlackHatBorder_8u_C3R ( const Npp8u pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp8u pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType 
)
NppStatus nppiMorphBlackHatBorder_8u_C3R_Ctx ( const Npp8u pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp8u pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType,
NppStreamContext  nppStreamCtx 
)

3 channel 8-bit unsigned integer morphological black hat with border control.

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

NppStatus nppiMorphBlackHatBorder_8u_C4R ( const Npp8u pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp8u pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType 
)
NppStatus nppiMorphBlackHatBorder_8u_C4R_Ctx ( const Npp8u pSrc,
int  nSrcStep,
NppiSize  oSrcSize,
NppiPoint  oSrcOffset,
Npp8u pDst,
int  nDstStep,
NppiSize  oSizeROI,
const Npp8u pMask,
NppiSize  oMaskSize,
NppiPoint  oAnchor,
Npp8u pBuffer,
NppiBorderType  eBorderType,
NppStreamContext  nppStreamCtx 
)

4 channel 8-bit unsigned integer morphological black hat with border control.

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