You are here: Start » AVL.NET » Function Reference » Computer Vision » Image Segmentation » AVL.ExtractBlobs_Color
AVL.ExtractBlobs_Color
Segments an image into blobs by color-based thresholding.
| Namespace: | AvlNet |
|---|---|
| Assembly: | AVL.NET.dll |
Syntax
C++
C#
public static void ExtractBlobs_Color ( AvlNet.Image inImage, NullableRef<AvlNet.ShapeRegion> inRoi, AvlNet.CoordinateSystem2D? inRoiAlignment, AvlNet.ColorThresholdParams inThresholdParams, AvlNet.PreSplitProcessingParams inProcessingParams, AvlNet.SplittingParams inSplittingParams, IList<AvlNet.Region> outBlobs, AvlNet.Region outBaseRegion )
Parameters
| Name | Type | Range | Default | Description | |
|---|---|---|---|---|---|
 | inImage | AvlNet.Image | Image from which blobs are extracted. | ||
| inRoi | AvlNet.NullableRef<AvlNet.ShapeRegion> | Range of pixels to be processed. Default value: atl::NIL. | ||
| inRoiAlignment | AvlNet.CoordinateSystem2D? | Adjusts the region. Default value: atl::NIL. | ||
| inThresholdParams | AvlNet.ColorThresholdParams | Parameters for color-based thresholding. | ||
| inProcessingParams | AvlNet.PreSplitProcessingParams | Parameters for postprocessing of the extracted region. | ||
| inSplittingParams | AvlNet.SplittingParams | Parameters for splitting region into blobs. | ||
 | outBlobs | System.Collections.Generic.IList<AvlNet.Region> | Blobs extracted from the input image. | ||
| outBaseRegion | AvlNet.Region | Region of pixels right after thresholding. |
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
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. |
