Start » Filter Reference » Computer Vision » Image Segmentation » ExtractBlobs_Intensity

ExtractBlobs_Intensity

Module:	FoundationBasic

Segments an image into blobs by thresholding using a single value.

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	IntensityThresholdParams	Parameters for thresholding an image
inProcessingParams	PreSplitProcessingParams	Parameters for postprocessing of the extracted region
inSplittingParams	SplittingParams	Parameters for splitting region into blobs
outBlobs	Region Array	Blobs extracted from the input image
outBaseRegion	Region	Region of pixels right after thresholding

Description

This filter can be used to quickly segment an image. It performs a series of operations on inImage:

image is thresholded by ThresholdToRegion 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

Description of usage of this filter can be found in examples and tutorial: Calibration World Coordinates On Original Images, Chocolate Cookies Inspection 3D, Mounts (Blob Analysis), Nails, Screws and Nuts, User Filter Example - Database Access.

ExtractBlobs_Intensity performed on the sample image with inThresholdParams.Polarity = Dark, inThresholdParams.Threshold = 84.0, and inProcessingParams.ClosingRadius = 10.

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_Intensity.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of ExtractBlobs filter group.