Blob search methods. More...

Classes
class	BlobFilter
	Class to build a filter for the blob search. More...

class	BlobResult
	Container for a blob analysis result. More...

Enumerations
enum class	BlobRangeFilter { Size , Width , Height }
	Defines the attribute for a blob filter range. More...

enum class	BlobBorderFilter : std::uint32_t { None = 0 , Right = 1 , Top = 2 , Left = 4 , Bottom = 8 , All = 15 }
	Enumeration for filtering blobs that touch the boundaries of the AOI specified for blob extraction. More...

Functions
std::vector< BlobResult >	BinarizeAndSearchBlobs (const ImagePlane &plane, ValueRange< int > binarizationThreshold)
	Searches for all blobs in the given image plane. More...

std::vector< BlobResult >	BinarizeAndSearchBlobs (const ImagePlane &plane, ValueRange< int > binarizationThreshold, Rect< int > aoi)
	Searches for all blobs in the given image plane. More...

std::vector< BlobResult >	BinarizeAndSearchBlobs (const ImagePlane &plane, ValueRange< int > binarizationThreshold, const BlobFilter &filter)
	Searches for all blobs in the given image plane. More...

std::vector< BlobResult >	BinarizeAndSearchBlobs (const ImagePlane &plane, ValueRange< int > binarizationThreshold, Rect< int > aoi, const BlobFilter &filter)
	Searches for all blobs in the given image plane. More...

std::vector< BlobResult >	SearchBlobs (const Image &binarizedImage)
	Searches for all blobs in the given binarized image. More...

std::vector< BlobResult >	SearchBlobs (const Image &binarizedImage, Rect< int > aoi)
	Searches for all blobs in the given binarized image. More...

std::vector< BlobResult >	SearchBlobs (const Image &binarizedImage, const BlobFilter &filter)
	Searches for all blobs in the given binarized image. More...

std::vector< BlobResult >	SearchBlobs (const Image &binarizedImage, Rect< int > aoi, const BlobFilter &filter)
	Searches for all blobs in the given binarized image. More...

Detailed Description

Blob search methods.

Online Manual: Common Vision Blox-Tool Blob

Example: Foundation/QmlBlobSearch

Remarks: CMake users: Link to imported target CVB::CvbFoundationBlob

Enumeration Type Documentation

◆ BlobBorderFilter

enum class BlobBorderFilter : std::uint32_t

strong

Enumeration for filtering blobs that touch the boundaries of the AOI specified for blob extraction.

These values can be OR combined.

Enumerator
None	Do not filter out those blobs that touch a border.
Right	Filter out those blobs that touch the right border.
Top	Filter out those blobs that touch the top border.
Left	Filter out those blobs that touch the left border.
Bottom	Filter out those blobs that touch the bottom border.
All	Filter out those blobs that touch any border.

◆ BlobRangeFilter

enum class BlobRangeFilter

strong

Defines the attribute for a blob filter range.

Enumerator
Size	Area of the blob in pixels.
Width	Width of the blob in pixels.
Height	Height of the blob in pixels.

Function Documentation

◆ BinarizeAndSearchBlobs() [1/4]

std::vector< BlobResult > BinarizeAndSearchBlobs	(	const ImagePlane &	plane,
		ValueRange< int >	binarizationThreshold
	)

inline

Searches for all blobs in the given image plane.

Parameters

[in]	plane	Image plane to process.
[in]	binarizationThreshold	Minimum and maximum gray values (inclusive) to be considered as an object.

Returns: Unordered blob results.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ BinarizeAndSearchBlobs() [2/4]

std::vector< BlobResult > BinarizeAndSearchBlobs	(	const ImagePlane &	plane,
		ValueRange< int >	binarizationThreshold,
		const BlobFilter &	filter
	)

inline

Searches for all blobs in the given image plane.

Parameters

[in]	plane	Image plane to process.
[in]	binarizationThreshold	Minimum and maximum gray values (inclusive) to be considered as an object.
[in]	filter	Filter which blobs are to be returned.

Returns: Unordered blob results.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ BinarizeAndSearchBlobs() [3/4]

std::vector< BlobResult > BinarizeAndSearchBlobs	(	const ImagePlane &	plane,
		ValueRange< int >	binarizationThreshold,
		Rect< int >	aoi
	)

inline

Searches for all blobs in the given image plane.

Parameters

[in]	plane	Image plane to process.
[in]	binarizationThreshold	Minimum and maximum gray values (inclusive) to be considered as an object.
[in]	aoi	Region in which blobs are to be searched.

Returns: Unordered blob results.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ BinarizeAndSearchBlobs() [4/4]

std::vector< BlobResult > BinarizeAndSearchBlobs	(	const ImagePlane &	plane,
		ValueRange< int >	binarizationThreshold,
		Rect< int >	aoi,
		const BlobFilter &	filter
	)

inline

Searches for all blobs in the given image plane.

Parameters

[in]	plane	Image plane to process.
[in]	binarizationThreshold	Minimum and maximum gray values (inclusive) to be considered as an object.
[in]	aoi	Region in which blobs are to be searched.
[in]	filter	Filter which blobs are to be returned.

Returns: Unordered blob results.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ SearchBlobs() [1/4]

std::vector< BlobResult > SearchBlobs ( const Image & binarizedImage )

inline

Searches for all blobs in the given binarized image.

Parameters

[in] binarizedImage Image consisting only of 0 and 255.

Returns: Unordered blob results.

Exceptions

Any	exception derived from std::exception including CvbException.

Image containing pixels with values 0 or 255. 255 marks an object.

◆ SearchBlobs() [2/4]

std::vector< BlobResult > SearchBlobs	(	const Image &	binarizedImage,
		const BlobFilter &	filter
	)

inline

Searches for all blobs in the given binarized image.

Parameters

[in]	binarizedImage	Image consisting only of 0 and 255.
[in]	filter	Filter which blobs are to be returned.

Returns: Unordered blob results.

Exceptions

Any	exception derived from std::exception including CvbException.

Image containing pixels with values 0 or 255. 255 marks an object.

◆ SearchBlobs() [3/4]

std::vector< BlobResult > SearchBlobs	(	const Image &	binarizedImage,
		Rect< int >	aoi
	)

inline

Searches for all blobs in the given binarized image.

Parameters

[in]	binarizedImage	Image consisting only of 0 and 255.
[in]	aoi	Region in which blobs are to be searched.

Returns: Unordered blob results.

Exceptions

Any	exception derived from std::exception including CvbException.

Image containing pixels with values 0 or 255. 255 marks an object.

◆ SearchBlobs() [4/4]

std::vector< BlobResult > SearchBlobs	(	const Image &	binarizedImage,
		Rect< int >	aoi,
		const BlobFilter &	filter
	)

inline

Searches for all blobs in the given binarized image.

Parameters

[in]	binarizedImage	Image consisting only of 0 and 255.
[in]	aoi	Region in which blobs are to be searched.
[in]	filter	Filter which blobs are to be returned.

Returns: Unordered blob results.

Exceptions

Any	exception derived from std::exception including CvbException.

Image containing pixels with values 0 or 255. 255 marks an object.

Classes

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

◆ BlobBorderFilter

◆ BlobRangeFilter

Function Documentation

◆ BinarizeAndSearchBlobs() [1/4]

◆ BinarizeAndSearchBlobs() [2/4]

◆ BinarizeAndSearchBlobs() [3/4]

◆ BinarizeAndSearchBlobs() [4/4]

◆ SearchBlobs() [1/4]

◆ SearchBlobs() [2/4]

◆ SearchBlobs() [3/4]

◆ SearchBlobs() [4/4]