CVB++ 15.0
Cvb::Foundation::Blob Namespace Reference

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< BlobResultBinarizeAndSearchBlobs (const ImagePlane &plane, ValueRange< int > binarizationThreshold)
 Searches for all blobs in the given image plane. More...
 
std::vector< BlobResultBinarizeAndSearchBlobs (const ImagePlane &plane, ValueRange< int > binarizationThreshold, Rect< int > aoi)
 Searches for all blobs in the given image plane. More...
 
std::vector< BlobResultBinarizeAndSearchBlobs (const ImagePlane &plane, ValueRange< int > binarizationThreshold, const BlobFilter &filter)
 Searches for all blobs in the given image plane. More...
 
std::vector< BlobResultBinarizeAndSearchBlobs (const ImagePlane &plane, ValueRange< int > binarizationThreshold, Rect< int > aoi, const BlobFilter &filter)
 Searches for all blobs in the given image plane. More...
 
std::vector< BlobResultSearchBlobs (const Image &binarizedImage)
 Searches for all blobs in the given binarized image. More...
 
std::vector< BlobResultSearchBlobs (const Image &binarizedImage, Rect< int > aoi)
 Searches for all blobs in the given binarized image. More...
 
std::vector< BlobResultSearchBlobs (const Image &binarizedImage, const BlobFilter &filter)
 Searches for all blobs in the given binarized image. More...
 
std::vector< BlobResultSearchBlobs (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]planeImage plane to process.
[in]binarizationThresholdMinimum and maximum gray values (inclusive) to be considered as an object.
Returns
Unordered blob results.
Exceptions
Anyexception 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]planeImage plane to process.
[in]binarizationThresholdMinimum and maximum gray values (inclusive) to be considered as an object.
[in]filterFilter which blobs are to be returned.
Returns
Unordered blob results.
Exceptions
Anyexception 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]planeImage plane to process.
[in]binarizationThresholdMinimum and maximum gray values (inclusive) to be considered as an object.
[in]aoiRegion in which blobs are to be searched.
Returns
Unordered blob results.
Exceptions
Anyexception 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]planeImage plane to process.
[in]binarizationThresholdMinimum and maximum gray values (inclusive) to be considered as an object.
[in]aoiRegion in which blobs are to be searched.
[in]filterFilter which blobs are to be returned.
Returns
Unordered blob results.
Exceptions
Anyexception 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]binarizedImageImage consisting only of 0 and 255.
Returns
Unordered blob results.
Exceptions
Anyexception 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]binarizedImageImage consisting only of 0 and 255.
[in]filterFilter which blobs are to be returned.
Returns
Unordered blob results.
Exceptions
Anyexception 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]binarizedImageImage consisting only of 0 and 255.
[in]aoiRegion in which blobs are to be searched.
Returns
Unordered blob results.
Exceptions
Anyexception 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]binarizedImageImage consisting only of 0 and 255.
[in]aoiRegion in which blobs are to be searched.
[in]filterFilter which blobs are to be returned.
Returns
Unordered blob results.
Exceptions
Anyexception derived from std::exception including CvbException.

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