Back to Adaptive Vision Library website

You are here: Start » Function Reference » Computer Vision » Image Segmentation » ExtractBlobs_Intensity

ExtractBlobs_Intensity


Header: AVL.h
Namespace: avl
Module: FoundationBasic

Segments an image into blobs by thresholding.

Syntax

C++
C#
 
void avl::ExtractBlobs_Intensity
(
	const avl::Image& inImage,
	atl::Optional<const avl::ShapeRegion&> inRoi,
	atl::Optional<const avl::CoordinateSystem2D&> inRoiAlignment,
	const avl::IntensityThresholdParams& inThresholdParams,
	const avl::RegionProcessingParams& inRegionProcessingParams,
	const avl::BlobSplittingParams& inBlobSplittingParams,
	atl::Array<avl::Region>& outBlobs,
	atl::Array<int>& diagBlobAreas,
	avl::Region& diagBaseRegion
)

Parameters

Name Type Default Description
Input value
inImage const Image& Image from which blobs are extracted
Input value
inRoi Optional<const ShapeRegion&> NIL Range of pixels to be processed
Input value
inRoiAlignment Optional<const CoordinateSystem2D&> NIL Adjusts the region
Input value
inThresholdParams const IntensityThresholdParams& Parameters for thresholding an image
Input value
inRegionProcessingParams const RegionProcessingParams& Parameters for opening and closing of a region
Input value
inBlobSplittingParams const BlobSplittingParams& Parameters for splitting region into blobs
Output value
outBlobs Array<Region>& Blobs extracted from the input image
Diagnostic input
diagBlobAreas Array<int>& Areas of extracted blobs
Diagnostic input
diagBaseRegion 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 using parameters from inRegionProcessingParams
  • resulting region is split into blobs by SplitRegionIntoBlobs using parameters from inBlobSplittingParams

Examples

ExtractBlobs_Intensity performed on the sample image with inThresholdParams.MaxIntensity = 84.0 and inRegionProcessingParams.ClosingRadius = 10.

Errors

List of possible exceptions:

Error type Description
DomainError Region exceeds an input image in ExtractBlobs_Intensity.

See Also

  • ExtractBlobs_DoG – Segments an image into blobs by thresholding Difference of Gaussians.