You are here: Start » AVL.NET » Function Reference » Computer Vision » Image Segmentation » 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
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. |