Functions | |
cvbres_t | FBlobBinariseImage (IMG Src, TDRect *Rect, long Index, long Low, long High, IMG Dst) |
Binarize the image using a fixed threshold. More... | |
FBLOB | FBlobCreate (IMG Image, long Index) |
Initializes the FBlob object that is needed for the usage of the FBlob tool. More... | |
cvbres_t | FBlobExec (FBLOB Handle) |
Executes blob analysis with the current settings. More... | |
cvbres_t | FBlobGetBlobSize (FBLOB Handle, long BlobNum, long &Size) |
Returns the size of a found blob in pixels. More... | |
cvbres_t | FBlobGetBoundingBox (FBLOB Handle, long BlobNum, long &x, long &y, long &dx, long &dy) |
Returns the bounding box of a blob object. More... | |
cvbres_t | FBlobGetBoundingBoxEx (FBLOB Handle, long BlobNum, long &x, long &y, long &dx, long &dy) |
Returns the bounding box of a blob object. More... | |
cvbres_t | FBlobGetCenter (FBLOB Handle, long BlobNum, long &CenterX, long &CenterY) |
Returns the center of gravity of the object (moments m10 and m01). More... | |
cvbres_t | FBlobGetCenterEx (FBLOB Handle, long BlobNum, double &CenterX, double &CenterY) |
Returns the center of gravity of the object (moments m10 and m01) in sub-pixels. More... | |
cvbres_t | FBlobGetExecTime (FBLOB Handle, double &Time) |
Returns the execution time of the last blob analysis. More... | |
cvbres_t | FBlobGetLimitArea (FBLOB Handle, long &AreaMin, long &AreaMax) |
Returns the parameter settings for the size of the blob area. More... | |
cvbres_t | FBlobGetLimitHeight (FBLOB Handle, long &Min, long &Max) |
Returns the parameter settings for the blob height. More... | |
cvbres_t | FBlobGetLimitWidth (FBLOB Handle, long &Min, long &Max) |
Returns the parameter settings for the blob width. More... | |
cvbres_t | FBlobGetMaxExecTime (FBLOB Handle, long &MaxTimeMS) |
Returns the maximum execution time the blob analysis should spend. More... | |
cvbres_t | FBlobGetMinMomentPoints (FBLOB Handle, long BlobNum, long &x0, long &y0, long &x1, long &y1) |
Get the points describing the minimum moment axis by intersecting the bounding box with the minimum moment axis going through the center of the blob. More... | |
cvbres_t | FBlobGetMinMomentPointsEx (FBLOB Handle, long BlobNum, long &x0, long &y0, long &x1, long &y1) |
Get the points describing the minimum moment axis by intersecting the bounding box with the minimum moment axis going through the center of the blob. More... | |
cvbres_t | FBlobGetMoments (FBLOB Handle, long BlobNum, double &Min, double &Max, double &Ratio, double &Angle) |
Get the minimum and maximum moments of inertia (2nd order moments), the aspect ratio and the angle of the minimum moment of inertia. More... | |
cvbres_t | FBlobGetNumBlobs (FBLOB Handle, long &Count) |
Retrieve the number of blobs found. More... | |
cvbres_t | FBlobGetObjectFeatureRange (FBLOB Handle, long &FeatureMin, long &FeatureMax) |
Returns the gray-value range that is used for binarizing. More... | |
cvbres_t | FBlobGetObjectTouchBorder (FBLOB Handle, long &Mask) |
Returns the filter setting for objects which are touching one or more borders. More... | |
cvbres_t | FBlobGetSize (FBLOB Handle, long BlobNum, long &Size) |
Returns the size of a found blob in pixels. More... | |
cvbres_t | FBlobGetSkipBinarization (FBLOB Handle, cvbbool_t &Skip) |
Specify whether the binarization should be carried out inside the blob tool or whether the tool may safely assume that the input is already a binarized 8 bits per pixel image. More... | |
cvbres_t | FBlobReset (FBLOB Handle) |
Resets the FBlob object. More... | |
cvbres_t | FBlobSetArea (FBLOB Handle, long Index, long left, long top, long right, long bottom) |
Defines an area of interest to work on in the image. More... | |
cvbres_t | FBlobSetImage (FBLOB Handle, IMG Image, long Index) |
Passes a new image to the FBlob object without the internal tables in the blob object having to be rebuilt. More... | |
cvbres_t | FBlobSetLimitArea (FBLOB Handle, long AreaMin, long AreaMax) |
Sets the parameter settings for the size of the blob area. More... | |
cvbres_t | FBlobSetLimitHeight (FBLOB Handle, long Min, long Max) |
Sets the filter for objects which have a height between Min and Max. More... | |
cvbres_t | FBlobSetLimitWidth (FBLOB Handle, long Min, long Max) |
Sets the filter for objects which have a width between Min and Max. More... | |
cvbres_t | FBlobSetMaxExecTime (FBLOB Handle, long MaxTimeMS) |
Set the maximum time blob should spend in execution. More... | |
cvbres_t | FBlobSetObjectFeature (FBLOB Handle, long Threshold, long Feature) |
Defines a threshold that is used for transformation to a binary image. More... | |
cvbres_t | FBlobSetObjectFeatureRange (FBLOB Handle, long FeatureMin, long FeatureMax) |
Returns the gray-value range that is used for binarizing. More... | |
cvbres_t | FBlobSetObjectTouchBorder (FBLOB Handle, long Mask) |
Sets the filter setting for objects which are touching one or more borders. More... | |
cvbres_t | FBlobSetSkipBinarization (FBLOB Handle, cvbbool_t Skip) |
Specify whether the binarization should be carried out inside the blob tool or whether the tool may safely assume that the input is already a binarized 8 bits per pixel image. More... | |
cvbres_t | FBlobSetSortMode (FBLOB Handle, TBlobSortMode SortMode, long X, long Y, long LastEntry, TBlobSortDirection Order) |
Set up the sort mode and the sorting order of the blob objects. More... | |
cvbres_t | FBlobSetSortParameter (FBLOB Handle, TBlobSortMode SortMode, long X, long Y, TBlobSortDirection Order) |
Set up the sort mode and the sorting order for all blob objects. More... | |
cvbres_t | FBlobSort (FBLOB Handle) |
Sorts the objects by certain criteria. More... | |
BOOL | IsFBlob (FBLOB Handle) |
Check if a handle points to an FBLOB object. More... | |
Binarize the image using a fixed threshold.
[in] | Src | Handle of source image object to binarize. |
[in] | Rect | Area of interest in the image to binarize. |
[in] | Index | Plane index in the source image to binarize. |
[in] | Low | Lower gray-value boundary. |
[in] | High | Upper gray-value boundary. |
[out] | Dst | Handle of destination image. |
FBLOB FBlobCreate | ( | IMG | Image, |
long | Index | ||
) |
Initializes the FBlob object that is needed for the usage of the FBlob tool.
[in] | Image | Handle of image object. May be NULL . |
[in] | Index | Plane index in the image to work on. |
NULL
is returned on an error. cvbres_t FBlobExec | ( | FBLOB | Handle | ) |
cvbres_t FBlobGetBlobSize | ( | FBLOB | Handle, |
long | BlobNum, | ||
long & | Size | ||
) |
cvbres_t FBlobGetBoundingBox | ( | FBLOB | Handle, |
long | BlobNum, | ||
long & | x, | ||
long & | y, | ||
long & | dx, | ||
long & | dy | ||
) |
Returns the bounding box of a blob object.
[in] | Handle | Handle of FBlob object. |
[in] | BlobNum | Number of blob object for which to retrieve the bounding box. |
[out] | x | Left top position of bounding box. |
[out] | y | Left top position of bounding box. |
[out] | dx | Width of the bounding box minus one. |
[out] | dy | Height of the bounding box minus one. |
cvbres_t FBlobGetBoundingBoxEx | ( | FBLOB | Handle, |
long | BlobNum, | ||
long & | x, | ||
long & | y, | ||
long & | dx, | ||
long & | dy | ||
) |
Returns the bounding box of a blob object.
[in] | Handle | Handle of FBlob object. |
[in] | BlobNum | Number of blob object for which to retrieve the bounding box. |
[out] | x | Left top position of bounding box. |
[out] | y | Left top position of bounding box. |
[out] | dx | Width of the bounding box. |
[out] | dy | Height of the bounding box. |
cvbres_t FBlobGetCenter | ( | FBLOB | Handle, |
long | BlobNum, | ||
long & | CenterX, | ||
long & | CenterY | ||
) |
Returns the center of gravity of the object (moments m10 and m01).
[in] | Handle | Handle of FBlob object. |
[in] | BlobNum | Number of blob object. |
[out] | CenterX | X-coordinate of the center of gravity of the object. |
[out] | CenterY | Y-coordinate of the center of gravity of the object. |
cvbres_t FBlobGetCenterEx | ( | FBLOB | Handle, |
long | BlobNum, | ||
double & | CenterX, | ||
double & | CenterY | ||
) |
Returns the center of gravity of the object (moments m10 and m01) in sub-pixels.
[in] | Handle | Handle of FBlob object. |
[in] | BlobNum | Number of blob object. |
[out] | CenterX | X-coordinate of the center of gravity of the object. |
[out] | CenterY | Y-coordinate of the center of gravity of the object. |
cvbres_t FBlobGetExecTime | ( | FBLOB | Handle, |
double & | Time | ||
) |
cvbres_t FBlobGetLimitArea | ( | FBLOB | Handle, |
long & | AreaMin, | ||
long & | AreaMax | ||
) |
Returns the parameter settings for the size of the blob area.
[in] | Handle | Handle of FBlob object. |
[out] | AreaMin | Lower limit of the size of a blob area. |
[out] | AreaMax | Upper limit of the size of a blob area. |
cvbres_t FBlobGetLimitHeight | ( | FBLOB | Handle, |
long & | Min, | ||
long & | Max | ||
) |
Returns the parameter settings for the blob height.
[in] | Handle | Handle of FBlob object. |
[out] | Min | Lower limit of blob height (only blobs that are larger than the lower limit are found). |
[out] | Max | Upper limit of blob height (only blobs that are smaller than the upper limit are found). |
cvbres_t FBlobGetLimitWidth | ( | FBLOB | Handle, |
long & | Min, | ||
long & | Max | ||
) |
Returns the parameter settings for the blob width.
[in] | Handle | Handle of FBlob object. |
[out] | Min | Lower limit of blob width (only blobs that are larger than the lower limit are found). |
[out] | Max | Upper limit of blob width (only blobs that are smaller than the upper limit are found). |
cvbres_t FBlobGetMaxExecTime | ( | FBLOB | Handle, |
long & | MaxTimeMS | ||
) |
Returns the maximum execution time the blob analysis should spend.
[in] | Handle | Handle of FBlob object. |
[out] | MaxTimeMS | Maximum execution time in milliseconds. If the function isn't in use -1 is returned. |
cvbres_t FBlobGetMinMomentPoints | ( | FBLOB | Handle, |
long | BlobNum, | ||
long & | x0, | ||
long & | y0, | ||
long & | x1, | ||
long & | y1 | ||
) |
Get the points describing the minimum moment axis by intersecting the bounding box with the minimum moment axis going through the center of the blob.
[in] | Handle | Handle of FBlob object. |
[in] | BlobNum | Number of blob object. |
[out] | x0 | X-coordinate of the first point on the moment axis. |
[out] | y0 | Y-coordinate of the first point on the moment axis. |
[out] | x1 | X-coordinate of the second point on the moment axis. |
[out] | y1 | Y-coordinate of the second point on the moment axis. |
cvbres_t FBlobGetMinMomentPointsEx | ( | FBLOB | Handle, |
long | BlobNum, | ||
long & | x0, | ||
long & | y0, | ||
long & | x1, | ||
long & | y1 | ||
) |
Get the points describing the minimum moment axis by intersecting the bounding box with the minimum moment axis going through the center of the blob.
[in] | Handle | Handle of FBlob object. |
[in] | BlobNum | Number of blob object. |
[out] | x0 | X-coordinate of the first point on the moment axis. |
[out] | y0 | Y-coordinate of the first point on the moment axis. |
[out] | x1 | X-coordinate of the second point on the moment axis. |
[out] | y1 | Y-coordinate of the second point on the moment axis. |
cvbres_t FBlobGetMoments | ( | FBLOB | Handle, |
long | BlobNum, | ||
double & | Min, | ||
double & | Max, | ||
double & | Ratio, | ||
double & | Angle | ||
) |
Get the minimum and maximum moments of inertia (2nd order moments), the aspect ratio and the angle of the minimum moment of inertia.
[in] | Handle | Handle of FBlob object. |
[in] | BlobNum | Number of blob object. |
[out] | Min | Minimum moment of inertia. The minimum and maximum moments of inertia of the object are calculated from the second-order central moments: |
[out] | Max | Maximum moment of inertia. The minimum and maximum moments of inertia of the object are calculated from the second-order central moments: |
[out] | Ratio | Aspect ratio of the blob (Min/Max). |
[out] | Angle | Angle of the minimum moment of inertia in radians. InertiaMinAngle is the angle in radians (0...p ) that the axis of the minimum moment of inertia encloses together with the X-axis. This parameter is frequently used as a measure for the orientation of an object. The axis always runs through the center of gravity of the area. There are objects, for example circles, which do not have any pronounced direction of this axis. However, FBlob also returns an angle for these objects because sampling effects and the representation of objects in a digital raster also result in a certain angle for a circle. This value is only relevant if, for example, the InertiaRatio parameter shows a significant difference between the minimum and maximum moments of inertia. This angle depends very much on quantization and noise effects. Furthermore, there are objects which have multiple axes of inertia which are of equal weight (e.g. the letter M). Which angle is calculated here again depends on quantization and noise effects. If several identical objects exist in an image, this angle may still assume different values. IntertiaMinAngle is calculated from the central moments: Another way of interpreting this angle is to imagine every image point of an object as an independent point on the XY plane. If a straight line is fitted to this distribution of points by the least squares method, this line runs through the center of gravity of the area and has the angle InertiaMinAngle to the X-axis. |
cvbres_t FBlobGetNumBlobs | ( | FBLOB | Handle, |
long & | Count | ||
) |
cvbres_t FBlobGetObjectFeatureRange | ( | FBLOB | Handle, |
long & | FeatureMin, | ||
long & | FeatureMax | ||
) |
Returns the gray-value range that is used for binarizing.
The two threshold values FeatureMin and FeatureMax define the gray value range that is set to 1. The values under the lower threshold and upper the upper threshold are set to 0.
[in] | Handle | Handle of FBlob object. |
[out] | FeatureMin | Minimum gray-value of features. |
[out] | FeatureMax | Maximum gray-value of features. |
cvbres_t FBlobGetObjectTouchBorder | ( | FBLOB | Handle, |
long & | Mask | ||
) |
Returns the filter setting for objects which are touching one or more borders.
[in] | Handle | Handle of FBlob object. |
[out] | Mask | Currently used border mask. See TBlobTouchBorderFilter for possible settings. |
cvbres_t FBlobGetSize | ( | FBLOB | Handle, |
long | BlobNum, | ||
long & | Size | ||
) |
cvbres_t FBlobGetSkipBinarization | ( | FBLOB | Handle, |
cvbbool_t & | Skip | ||
) |
Specify whether the binarization should be carried out inside the blob tool or whether the tool may safely assume that the input is already a binarized 8 bits per pixel image.
[in] | Handle | Handle of FBlob object. |
[out] | Skip | TRUE specifies that the binarization is skipped. FALSE indicates that the binarization is done inside the blob tool. |
cvbres_t FBlobReset | ( | FBLOB | Handle | ) |
Resets the FBlob object.
[in] | Handle | Handle of FBlob object. |
cvbres_t FBlobSetArea | ( | FBLOB | Handle, |
long | Index, | ||
long | left, | ||
long | top, | ||
long | right, | ||
long | bottom | ||
) |
Defines an area of interest to work on in the image.
[in] | Handle | Handle of FBlob object. |
[in] | Index | Plane index to work on. |
[in] | left | First column of the area of interest. |
[in] | top | First row of the area of interest. |
[in] | right | Last column of the area of interest. |
[in] | bottom | Last row of the area of interest. |
cvbres_t FBlobSetImage | ( | FBLOB | Handle, |
IMG | Image, | ||
long | Index | ||
) |
Passes a new image to the FBlob object without the internal tables in the blob object having to be rebuilt.
[in] | Handle | Handle of FBlob object. |
[in] | Image | Handle of image object. May be NULL . |
[in] | Index | Plane index of the image to work on. |
cvbres_t FBlobSetLimitArea | ( | FBLOB | Handle, |
long | AreaMin, | ||
long | AreaMax | ||
) |
Sets the parameter settings for the size of the blob area.
[in] | Handle | Handle of FBlob object. |
[in] | AreaMin | Lower limit of the size of a blob area. |
[in] | AreaMax | Upper limit of the size of a blob area. |
cvbres_t FBlobSetLimitHeight | ( | FBLOB | Handle, |
long | Min, | ||
long | Max | ||
) |
Sets the filter for objects which have a height between Min and Max.
[in] | Handle | Handle of FBlob object. |
[in] | Min | Lower limit of blob height (only blobs that are larger than the lower limit are found). Set to -1 to turn the filter off. |
[in] | Max | Upper limit of blob height (only blobs that are smaller than the upper limit are found). Set to -1 to turn the filter off. |
cvbres_t FBlobSetLimitWidth | ( | FBLOB | Handle, |
long | Min, | ||
long | Max | ||
) |
Sets the filter for objects which have a width between Min and Max.
[in] | Handle | Handle of FBlob object. |
[in] | Min | Lower limit of blob width (only blobs that are larger than the lower limit are found). Set to -1 to turn the filter off. |
[in] | Max | Upper limit of blob width (only blobs that are smaller than the upper limit are found). Set to -1 to turn the filter off. |
cvbres_t FBlobSetMaxExecTime | ( | FBLOB | Handle, |
long | MaxTimeMS | ||
) |
Set the maximum time blob should spend in execution.
[in] | Handle | Handle of FBlob object. |
[in] | MaxTimeMS | Maximum execution time in milliseconds that should be spent inside blob. |
cvbres_t FBlobSetObjectFeature | ( | FBLOB | Handle, |
long | Threshold, | ||
long | Feature | ||
) |
Defines a threshold that is used for transformation to a binary image.
[in] | Handle | Handle of FBlob object. |
[in] | Threshold | Threshold for conversion to a binary image. |
[in] | Feature | Feature range to be recognized as an object (blob). See TBlobFeatureType for possible features. |
cvbres_t FBlobSetObjectFeatureRange | ( | FBLOB | Handle, |
long | FeatureMin, | ||
long | FeatureMax | ||
) |
Returns the gray-value range that is used for binarizing.
The two threshold values FeatureMin and FeatureMax define the gray value range that is set to 1. The values under the lower threshold and upper the upper threshold are set to 0.
[in] | Handle | Handle of FBlob object. |
[in] | FeatureMin | Minimum gray-value of features. The default value is 128. |
[in] | FeatureMax | Maximum gray-value of features. The default value is 255. |
cvbres_t FBlobSetObjectTouchBorder | ( | FBLOB | Handle, |
long | Mask | ||
) |
Sets the filter setting for objects which are touching one or more borders.
[in] | Handle | Handle of FBlob object. |
[in] | Mask | Border mask to use. See TBlobTouchBorderFilter for possible settings. |
cvbres_t FBlobSetSkipBinarization | ( | FBLOB | Handle, |
cvbbool_t | Skip | ||
) |
Specify whether the binarization should be carried out inside the blob tool or whether the tool may safely assume that the input is already a binarized 8 bits per pixel image.
[in] | Handle | Handle of FBlob object. |
[in] | Skip | TRUE specifies that the binarization is skipped. FALSE indicates that the binarization is done inside the blob tool. |
cvbres_t FBlobSetSortMode | ( | FBLOB | Handle, |
TBlobSortMode | SortMode, | ||
long | X, | ||
long | Y, | ||
long | LastEntry, | ||
TBlobSortDirection | Order | ||
) |
Set up the sort mode and the sorting order of the blob objects.
[in] | Handle | Handle of FBlob object. |
[in] | SortMode | Sort mode (criterion). See TBlobSortMode for possible modes. |
[in] | X | When FBLOB_SORT_DISTANCE is selected, this value defines the X-coordinate for which the distance is calculated. |
[in] | Y | When FBLOB_SORT_DISTANCE is selected, this value defines the Y-coordinate for which the distance is calculated. |
[in] | LastEntry | Number of blobs to be sorted. |
[in] | Order | Sort mode. See TBlobSortDirection for possible orders. |
cvbres_t FBlobSetSortParameter | ( | FBLOB | Handle, |
TBlobSortMode | SortMode, | ||
long | X, | ||
long | Y, | ||
TBlobSortDirection | Order | ||
) |
Set up the sort mode and the sorting order for all blob objects.
[in] | Handle | Handle of FBlob object. |
[in] | SortMode | Sort mode (criterion). See TBlobSortMode for possible modes. |
[in] | X | When FBLOB_SORT_DISTANCE is selected, this value defines the X-coordinate for which the distance is calculated. |
[in] | Y | When FBLOB_SORT_DISTANCE is selected, this value defines the Y-coordinate for which the distance is calculated. |
[in] | Order | Sort mode. See TBlobSortDirection for possible orders. |
cvbres_t FBlobSort | ( | FBLOB | Handle | ) |
Sorts the objects by certain criteria.
[in] | Handle | Handle of FBlob object. |
BOOL IsFBlob | ( | FBLOB | Handle | ) |
Check if a handle points to an FBLOB object.
[in] | Handle | Handle of FBlob object to be checked. |
TRUE
indicates that it is a valid handle, FALSE
otherwise.