Back to Aurora Vision Studio website
You are here: Start » Filter Reference » Computer Vision » Image Segmentation » ExtractBlobs_Color
Module: | FoundationBasic |
---|
Segments an image into blobs by color-based thresholding.
Name | Type | Description | |
---|---|---|---|
inImage | Image | Image from which blobs are extracted | |
inRoi | ShapeRegion* | Range of pixels to be processed | |
inRoiAlignment | CoordinateSystem2D* | Adjusts the region | |
inThresholdParams | ColorThresholdParams | Parameters for color-based thresholding | |
inProcessingParams | PreSplitProcessingParams | Parameters for postprocessing of the extracted region | |
inSplittingParams | SplittingParams | Parameters for splitting region into blobs | |
outBlobs | RegionArray | Blobs extracted from the input image | |
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:
- image is thresholded by ThresholdToRegion_Color 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
Errors
This filter can throw an exception to report error. Read how to deal with errors in Error Handling.
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. |
Complexity Level
This filter is available on Advanced Complexity Level.
Filter Group
This filter is member of ExtractBlobs filter group.
See Also
- ExtractBlobs_Intensity – Segments an image into blobs by thresholding using a single value.
- ExtractBlobs_Dynamic – Segments an image into blobs by dynamic thresholding.