Back to Aurora Vision Library website

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


Header: AVL.h
Namespace: avl
Module: FoundationBasic

Segments an image into blobs by color-based thresholding.


void avl::ExtractBlobs_Color
	const avl::Image& inImage,
	atl::Optional<const avl::ShapeRegion&> inRoi,
	atl::Optional<const avl::CoordinateSystem2D&> inRoiAlignment,
	const avl::ColorThresholdParams& 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 ColorThresholdParams& Parameters for color-based 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


For input inImage only pixel formats are supported: 1⨯uint8, 2⨯uint8, 3⨯uint8, 4⨯uint8.

Read more about pixel formats in Image documentation.


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


ExtractBlobs_Color performed on the sample image with inThresholdParams.RgbColor = (189, 36, 25), inThresholdParams.MaxDifference = 40.0 and inProcessingParams.ClosingRadius = 5.


List of possible exceptions:

Error type Description
DomainError Region exceeds an input image in ExtractBlobs_Color.
DomainError Not supported inImage pixel format in ExtractBlobs_Color. Supported formats: 1xUInt8, 2xUInt8, 3xUInt8, 4xUInt8.

See Also