Back to Adaptive 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 | |
inRegionProcessingParams | RegionProcessingParams | Parameters for opening and closing of a region | |
inBlobSplittingParams | BlobSplittingParams | Parameters for splitting region into blobs | |
outBlobs | RegionArray | Blobs extracted from the input image | |
diagBlobAreas | IntegerArray | Areas of extracted blobs | |
diagBaseRegion | 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 using parameters from inRegionProcessingParams
- resulting region is split into blobs by SplitRegionIntoBlobs using parameters from inBlobSplittingParams
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 Basic Complexity Level.
Filter Group
This filter is member of ExtractBlobs filter group.
See Also
- ExtractBlobs_Intensity – Segments an image into blobs by thresholding.
- ExtractBlobs_Dynamic – Segments an image into blobs by dynamic thresholding.
- ExtractBlobs_DoG – Segments an image into blobs by thresholding Difference of Gaussians.