Back to Aurora Vision Library website

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


Header: AVL.h
Namespace: avl
Module: FoundationBasic

Segments an image into blobs by dynamic thresholding.


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


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


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


ExtractBlobs_Dynamic performed on the sample image with inThresholdParams.Polarity = Dark, inThresholdParams.Threshold = 5.0, and inProcessingParams.ClosingRadius = 3


List of possible exceptions:

Error type Description
DomainError Region exceeds an input image in ExtractBlobs_Dynamic.

See Also