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
![]() |
![]() |
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.