Back to Aurora Vision Library website

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

ExtractBlobs_Color


Header: AVL.h
Namespace: avl
Module: FoundationBasic

Segments an image into blobs by color-based thresholding.

Syntax

C++
C#
 
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
)

Parameters

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

Requirements

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

Read more about pixel formats in Image documentation.

Description

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

Examples

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

Errors

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