You are here: Start » Filter Reference » Computer Vision » Image Segmentation » ExtractBlobs_Color
Advanced| 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
 |
 |
ExtractBlobs_Color performed on the sample image with inThresholdParams.RgbColor = (189, 36, 25), inThresholdParams.MaxDifference = 40.0 and inProcessingParams.ClosingRadius = 5.
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.
