LabelMarkers

Generate image connected region label markers to be used for later image segmentation. More...

LabelMarkersGetBufferSize
Before calling any of the LabelMarkers functions the application first needs to call the corresponding LabelMarkersGetBufferSize function to determine the amount of device memory to allocate as a working buffer. The application allocated device memory is then passed as the pBuffer parameter to the corresponding LabelMarkers function.
NppStatus	nppiLabelMarkersGetBufferSize_8u_C1R (NppiSize oSizeROI, int *hpBufferSize)
	Calculate scratch buffer size needed for 1 channel 8-bit unsigned integer LabelMarkers function based on destination image oSizeROI width and height. More...
NppStatus	nppiLabelMarkersGetBufferSize_8u32u_C1R (NppiSize oSizeROI, int *hpBufferSize)
	Calculate scratch buffer size needed for 1 channel 8-bit to 1 channel 32-bit unsigned integer LabelMarkers function based on destination image oSizeROI width and height. More...
NppStatus	nppiLabelMarkersGetBufferSize_16u_C1R (NppiSize oSizeROI, int *hpBufferSize)
	Calculate scratch buffer size needed for 1 channel 16-bit unsigned integer LabelMarkers function based on destination image oSizeROI width and height. More...

LabelMarkers
Generate image connected region label markers to be used for later image segmentation. A connected region is any non-zero pixel region bounded by pixel values less than or equal to nMinVal. Pixels outside the ROI are always treated as having values of 0 thus resulting in a connected region segmentation boundary in that direction. Note that while marker label IDs start at ID number 1, they are not generated in any particular order and there may be numeric gaps between sequential marker IDs. The pNumber parameter returns the value of the maximum label ID generated in the first pass. However during convergence passes higher label ID numbers in connected regions containing multiple label ID numbers will be replaced with the lowest label ID number in the region. However, connected region label IDs will be unique unless the value returned by pNumber exceeds the data type range of a destination pixel in which case ID values will roll over causing some to be used on multiple connected regions. If this occurs for 8 bit data it is recommended that you use the 8u32u version of the function for 8 bit data. Pixels not connected to any connected region like those with values less than or equal to nMinVal will be assigned a marker label ID value of 0. Before calling any of the LabelMarkers functions the application first needs to call the corresponding LabelMarkersGetBufferSize 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 LabelMarkers function.
NppStatus	nppiLabelMarkers_8u_C1IR (Npp8u *pSrcDst, int nSrcDstStep, NppiSize oSizeROI, Npp8u nMinVal, NppiNorm eNorm, int *pNumber, Npp8u *pBuffer)
	1 channel 8-bit unsigned integer in place label markers image generation. More...
NppStatus	nppiLabelMarkers_8u32u_C1R (Npp8u *pSrc, int nSrcStep, Npp32u *pDst, int nDstStep, NppiSize oSizeROI, Npp8u nMinVal, NppiNorm eNorm, int *pNumber, Npp8u *pBuffer)
	1 channel 8-bit to 32-bit unsigned integer label markers image generation. More...
NppStatus	nppiLabelMarkers_16u_C1IR (Npp16u *pSrcDst, int nSrcDstStep, NppiSize oSizeROI, Npp16u nMinVal, NppiNorm eNorm, int *pNumber, Npp8u *pBuffer)
	1 channel 16-bit unsigned integer in place label markers image generation. More...

Detailed Description

Generate image connected region label markers to be used for later image segmentation.

Function Documentation

NppStatus nppiLabelMarkers_16u_C1IR	(	Npp16u *	pSrcDst,
		int	nSrcDstStep,
		NppiSize	oSizeROI,
		Npp16u	nMinVal,
		NppiNorm	eNorm,
		int *	pNumber,
		Npp8u *	pBuffer
	)

1 channel 16-bit unsigned integer in place label markers image generation.

Parameters

pSrcDst	In-Place Image Pointer.
nSrcDstStep	Source-Image Line Step.
oSizeROI	Region-of-Interest (ROI).
nMinVal	Pixel values less than or equal to nMinVal will be excluded as members of any connected region and given a label ID of 0..
eNorm	Type of pixel connectivity test to use, nppiNormInf will use 8 way connectivity and nppiNormL1 will use 4 way connectivity.
pNumber	Pointer to host memory integer value where the maximum generated marker label ID will be returned.
pBuffer	Pointer to device memory scratch buffer at least as large as value returned by the corresponding LabelMarkersGetBufferSize call.

Returns

Image Data Related Error Codes, ROI Related Error Codes

NppStatus nppiLabelMarkers_8u32u_C1R	(	Npp8u *	pSrc,
		int	nSrcStep,
		Npp32u *	pDst,
		int	nDstStep,
		NppiSize	oSizeROI,
		Npp8u	nMinVal,
		NppiNorm	eNorm,
		int *	pNumber,
		Npp8u *	pBuffer
	)

1 channel 8-bit to 32-bit unsigned integer label markers image generation.

Parameters

pSrc	Source-Image Pointer.
nSrcStep	Source-Image Line Step.
pDst	Destination-Image Pointer.
nDstStep	Destination-Image Line Step.
oSizeROI	Region-of-Interest (ROI).
nMinVal	Pixel values less than or equal to nMinVal will be excluded as members of any connected region and given a label ID of 0..
eNorm	Type of pixel connectivity test to use, nppiNormInf will use 8 way connectivity and nppiNormL1 will use 4 way connectivity.
pNumber	Pointer to host memory integer value where the maximum generated marker label ID will be returned.
pBuffer	Pointer to device memory scratch buffer at least as large as value returned by the corresponding LabelMarkersGetBufferSize call.

Returns

Image Data Related Error Codes, ROI Related Error Codes

NppStatus nppiLabelMarkers_8u_C1IR	(	Npp8u *	pSrcDst,
		int	nSrcDstStep,
		NppiSize	oSizeROI,
		Npp8u	nMinVal,
		NppiNorm	eNorm,
		int *	pNumber,
		Npp8u *	pBuffer
	)

1 channel 8-bit unsigned integer in place label markers image generation.

Parameters

pSrcDst	In-Place Image Pointer.
nSrcDstStep	Source-Image Line Step.
oSizeROI	Region-of-Interest (ROI).
nMinVal	Pixel values less than or equal to nMinVal will be excluded as members of any connected region and given a label ID of 0..
eNorm	Type of pixel connectivity test to use, nppiNormInf will use 8 way connectivity and nppiNormL1 will use 4 way connectivity.
pNumber	Pointer to host memory integer value where the maximum generated marker label ID will be returned.
pBuffer	Pointer to device memory scratch buffer at least as large as value returned by the corresponding LabelMarkersGetBufferSize call.

Returns

Image Data Related Error Codes, ROI Related Error Codes

NppStatus nppiLabelMarkersGetBufferSize_16u_C1R	(	NppiSize	oSizeROI,
		int *	hpBufferSize
	)

Calculate scratch buffer size needed for 1 channel 16-bit unsigned integer LabelMarkers function based on destination image oSizeROI width and height.

Parameters

oSizeROI	Region-of-Interest (ROI).
hpBufferSize	Required buffer size in bytes.

NppStatus nppiLabelMarkersGetBufferSize_8u32u_C1R	(	NppiSize	oSizeROI,
		int *	hpBufferSize
	)

Calculate scratch buffer size needed for 1 channel 8-bit to 1 channel 32-bit unsigned integer LabelMarkers function based on destination image oSizeROI width and height.

Parameters

oSizeROI	Region-of-Interest (ROI).
hpBufferSize	Required buffer size in bytes.

NppStatus nppiLabelMarkersGetBufferSize_8u_C1R	(	NppiSize	oSizeROI,
		int *	hpBufferSize
	)

Calculate scratch buffer size needed for 1 channel 8-bit unsigned integer LabelMarkers function based on destination image oSizeROI width and height.

Parameters

oSizeROI	Region-of-Interest (ROI).
hpBufferSize	Required buffer size in bytes.