You are here: Start » Function Reference » Computer Vision » Image Segmentation » ExtractBlobs_Intensity

ExtractBlobs_Intensity

Header:	AVL.h
Namespace:	avl
Module:	FoundationBasic

Segments an image into blobs by thresholding using a single value.

Syntax

void avl::ExtractBlobs_Intensity
(
	const avl::Image& inImage,
	atl::Optional<const avl::ShapeRegion&> inRoi,
	atl::Optional<const avl::CoordinateSystem2D&> inRoiAlignment,
	const avl::IntensityThresholdParams& inThresholdParams,
	const avl::PreSplitProcessingParams& inProcessingParams,
	const avl::SplittingParams& inSplittingParams,
	atl::Array<avl::Region>& outBlobs,
	avl::Region& outBaseRegion
)

Parameters

Name	Type	Default	Description
inImage	const Image&		Image from which blobs are extracted
inRoi	Optional<const ShapeRegion&>	NIL	Range of pixels to be processed
inRoiAlignment	Optional<const CoordinateSystem2D&>	NIL	Adjusts the region
inThresholdParams	const IntensityThresholdParams&		Parameters for thresholding an image
inProcessingParams	const PreSplitProcessingParams&		Parameters for postprocessing of the extracted region
inSplittingParams	const SplittingParams&		Parameters for splitting region into blobs
outBlobs	Array<Region>&		Blobs extracted from the input image
outBaseRegion	Region&		Region of pixels right after thresholding

Description

This filter can be used to quickly segment an image. It performs a series of operations on inImage:

image is thresholded by ThresholdToRegion using parameters from inThresholdParams
resulting region is opened and then closed by OpenRegion and CloseRegion, also holes are removed by FillRegionHoles using parameters from inProcessingParams
resulting region is split into blobs by SplitRegionIntoBlobs using parameters from inSplittingParams

Examples

ExtractBlobs_Intensity performed on the sample image with inThresholdParams.Polarity = Dark, inThresholdParams.Threshold = 84.0, and inProcessingParams.ClosingRadius = 10.

Errors

List of possible exceptions: