Variables | |
__int3264 | BinaryImage |
Contains the handle to the binarized version of the input image. More... | |
double | BlobBoundingBoxHeight |
Height of the bounding box of the blob object. More... | |
double | BlobBoundingBoxWidth |
Width of the bounding box of the blob object. More... | |
double | BlobBoundingBoxX0 |
X-coordinate of the left-top corner of the bounding box belonging to the blob. More... | |
double | BlobBoundingBoxX1 |
X-coordinate of the bottom-right corner of the bounding box belonging to the blob. More... | |
double | BlobBoundingBoxY0 |
Y-coordinate of the left-top corner of the bounding box belonging to the blob. More... | |
double | BlobBoundingBoxY1 |
Y-coordinate of the bottom-right corner of the bounding box belonging to the blob. More... | |
double | BlobCenterX |
Returns the sub-pixel-accurate x-coordinate of the center of gravity of the blob object. More... | |
double | BlobCenterY |
Returns the sub-pixel-accurate y-coordinate of the center of gravity of the blob object. More... | |
long | BlobCount |
Returns the number of Blob objects found in the input image. More... | |
long | BlobIndex |
Select number of blob for which to access result properties. More... | |
double | BlobMaxMoment |
Returns the maximum moment of inertia of the blob object. More... | |
double | BlobMinMoment |
Returns the minimum moment of inertia of the blob object. More... | |
double | BlobMinMomentAxisAngle |
Returns the angle of the minimum moment of inertia of the blob object. More... | |
double | BlobMinMomentAxisX0 |
X-coordinate of the start point of the minimum moment axis. More... | |
double | BlobMinMomentAxisX1 |
X-coordinate of the end point of the minimum moment axis. More... | |
double | BlobMinMomentAxisY0 |
Y-coordinate of the start point of the minimum moment axis. More... | |
double | BlobMinMomentAxisY1 |
Y-coordinate of the end point of the minimum moment axis. More... | |
double | BlobMomentRatio |
Returns the ratio of BlobMinMoment and BlobMaxMoment. More... | |
long | BlobSize |
Returns the size (in pixels) of the blob object. More... | |
boolean | Entire |
If this property is set to TRUE the area passed by the X0, X1, Y0 and Y1 properties is ignored and the complete image will be used for the blob search. More... | |
double | ExecutionTime |
Returns the blob execution time. More... | |
long | FilterBlobHeightMax |
Defines the maximum height of a blob. More... | |
long | FilterBlobHeightMin |
Defines the minimum height of a blob. More... | |
long | FilterBlobSizeMax |
Defines the maximum size of a blob. More... | |
long | FilterBlobSizeMin |
Defines the minimum size of a blob. More... | |
boolean | FilterBlobTouchBorderBottom |
Specifies whether a blob object is ignored when touching the bottom border of the area of interest or the image. More... | |
boolean | FilterBlobTouchBorderLeft |
Specifies whether a blob object is ignored when touching the left border of the area of interest or the image. More... | |
boolean | FilterBlobTouchBorderRight |
Specifies whether a blob object is ignored when touching the right border of the area of interest or the image. More... | |
boolean | FilterBlobTouchBorderTop |
Specifies whether a blob object is ignored when touching the top border of the area of interest or the image. More... | |
long | FilterBlobWidthMax |
Defines the maximum width of a blob. More... | |
long | FilterBlobWidthMin |
Defines the minimum width of a blob. More... | |
__int3264 | Image |
Defines the image object that is assigned to the FBlob Control. More... | |
long | PlaneIndex |
Specifies the color plane to be used if the image assigned to the control consists of more than one plane. More... | |
boolean | SkipBinarization |
Indicates if the binarization of an image will be skipped or not. More... | |
long | SortCenterX |
Define the X-coordinate for the SORT_BY_DISTANCE sort mode. More... | |
long | SortCenterY |
Define the Y-coordinate for the SORT_BY_DISTANCE sort mode. More... | |
FBlobSortMode | SortMode |
Sort mode of the blob objects. More... | |
boolean | SortRising |
Indicates the sort order of the blob objects. More... | |
long | ThresholdLower |
Defines the lower threshold of the gray value range to binarize the image. More... | |
long | ThresholdUpper |
Defines the lower threshold of the gray value range to binarize the image. More... | |
double | X0 |
X-coordinate of the upper left point of the rectangular area of interest. More... | |
double | X1 |
X-coordinate of the lower right point of the rectangular area of interest. More... | |
double | Y0 |
Y-coordinate of the upper left point of the rectangular area of interest. More... | |
double | Y1 |
Y-coordinate of the lower right point of the rectangular area of interest. More... | |
|
readonly |
Contains the handle to the binarized version of the input image.
[out] | BinaryImage | Handle of the binarized input image. |
|
readonly |
Height of the bounding box of the blob object.
[out] | BlobBoundingBoxHeight | Height of the bounding box. |
|
readonly |
Width of the bounding box of the blob object.
[out] | BlobBoundingBoxWidth | Width of the bounding box. |
|
readonly |
X-coordinate of the left-top corner of the bounding box belonging to the blob.
The properties \ref BlobBoundingBoxX0, \ref BlobBoundingBoxY0, \ref BlobBoundingBoxX1 and \ref BlobBoundingBoxY1 contain the coordinates of the left-top and the bottom-right corner of the bounding box belonging to the blob
[out] | BlobBoundingBoxX0 | X-coordinate of the left-top corner. |
|
readonly |
X-coordinate of the bottom-right corner of the bounding box belonging to the blob.
The properties \ref BlobBoundingBoxX0, \ref BlobBoundingBoxY0, \ref BlobBoundingBoxX1 and \ref BlobBoundingBoxY1 contain the coordinates of the left-top and the bottom-right corner of the bounding box belonging to the blob
[out] | BlobBoundingBoxX1 | X-coordinate of the bottom-right corner. |
|
readonly |
Y-coordinate of the left-top corner of the bounding box belonging to the blob.
The properties \ref BlobBoundingBoxX0, \ref BlobBoundingBoxY0, \ref BlobBoundingBoxX1 and \ref BlobBoundingBoxY1 contain the coordinates of the left-top and the bottom-right corner of the bounding box belonging to the blob
[out] | BlobBoundingBoxY0 | Y-coordinate of the left-top corner. |
|
readonly |
Y-coordinate of the bottom-right corner of the bounding box belonging to the blob.
The properties \ref BlobBoundingBoxX0, \ref BlobBoundingBoxY0, \ref BlobBoundingBoxX1 and \ref BlobBoundingBoxY1 contain the coordinates of the left-top and the bottom-right corner of the bounding box belonging to the blob
[out] | BlobBoundingBoxY1 | Y-coordinate of the bottom-right corner. |
|
readonly |
Returns the sub-pixel-accurate x-coordinate of the center of gravity of the blob object.
[out] | BlobCenterX | X-coordinate of the blob center. |
|
readonly |
Returns the sub-pixel-accurate y-coordinate of the center of gravity of the blob object.
[out] | BlobCenterY | Y-coordinate of the blob center. |
|
readonly |
Returns the number of Blob objects found in the input image.
[out] | BlobCount | Number of blobs found in the input image. |
long BlobIndex |
Select number of blob for which to access result properties.
Use this property to browse through the Blobs found during the last \ref Execute call. Valid values range from 0 to \ref BlobCount - 1. \n\n After setting this property to a valid index, the results for that blob are accessible through the properties \ref BlobCenterX, \ref BlobCenterY, \ref BlobBoundingBoxWidth, \ref BlobBoundingBoxHeight, \ref BlobBoundingBoxX0, \ref BlobBoundingBoxY0, \ref BlobBoundingBoxX1, \ref BlobBoundingBoxY1, \ref BlobMinMoment, \ref BlobMaxMoment, \ref BlobMinMomentAxisAngle, \ref BlobMinMomentAxisX0, \ref BlobMinMomentAxisY0, \ref BlobMinMomentAxisX1, \ref BlobMinMomentAxisY1, \ref BlobMomentRatio and \ref BlobSize.
[in,out] | BlobIndex | Number of the blob object for which to access result properties. |
|
readonly |
Returns the maximum moment of inertia of the blob object.
The maximum moment of inertia of the object are calculated from the second-order central moments of the object: <img class="ToDisplay" src="FormelMaxMoments.GIF" align="left" alt="Max moments"><p> </p><p> </p>
[out] | BlobMaxMoment | Maximum moment of inertia. |
|
readonly |
Returns the minimum moment of inertia of the blob object.
The minimum moment of inertia of the object are calculated from the second-order central moments of the object: <img class="ToDisplay" src="FormelMinMoments.GIF" align="left" alt="Min moments"><p> </p><p> </p>
[out] | BlobMinMoment | Minimum moment of inertia. |
|
readonly |
Returns the angle of the minimum moment of inertia of the blob object.
This is the angle in radians (0...pi) at which the axis of the minimum moment of inertia crosses the center of the blob. This parameter is frequently used as a measure for the orientation of an object. There are objects – for example circles – which do not have any pronounced direction of this axis. However, Blob also returns an angle for these objects as well because sampling effects and the representation of objects in a digital raster always result in a certain angle for a circle. \n\n Therefore this value is only relevant if the BlobMomentRatio parameter shows a significant difference between the minimum and maximum moments of inertia. 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. \n\n If several identical objects exist in an image, this angle may still assume different values. \n The BlobMinMomentAxisAngle is calculated from the central 2nd order moments: <img class="ToDisplay" src="FormelMinMomentsAxisAngle.GIF" align="left" alt="FormelMinMomentsAxisAngle.GIF"><p> </p><p> </p><p> </p>
[out] | BlobMomentRatio | Angle of the minimum moment of inertia. |
|
readonly |
X-coordinate of the start point of the minimum moment axis.
The properties \ref BlobMinMomentAxisX0, \ref BlobMinMomentAxisY0, \ref BlobMinMomentAxisX1 and \ref BlobMinMomentAxisY1 return the coordinates of the start-point and endpoint of the axis of minimum inertia of the blob. The start- and endpoint of that axis are determined by intersecting this axis (which runs through the blob's center of gravity) with the bounding box of the blob (so the length of the axis does not actually scale with the value of the minimum moment!).
[out] | BlobMinMomentAxisX0 | X-coordinate of the start point of the minimum moment axis. |
|
readonly |
X-coordinate of the end point of the minimum moment axis.
The properties \ref BlobMinMomentAxisX0, \ref BlobMinMomentAxisY0, \ref BlobMinMomentAxisX1 and \ref BlobMinMomentAxisY1 return the coordinates of the start-point and endpoint of the axis of minimum inertia of the blob. The start- and endpoint of that axis are determined by intersecting this axis (which runs through the blob's center of gravity) with the bounding box of the blob (so the length of the axis does not actually scale with the value of the minimum moment!).
[out] | BlobMinMomentAxisX1 | X-coordinate of the end point of the minimum moment axis. |
|
readonly |
Y-coordinate of the start point of the minimum moment axis.
The properties \ref BlobMinMomentAxisX0, \ref BlobMinMomentAxisY0, \ref BlobMinMomentAxisX1 and \ref BlobMinMomentAxisY1 return the coordinates of the start-point and endpoint of the axis of minimum inertia of the blob. The start- and endpoint of that axis are determined by intersecting this axis (which runs through the blob's center of gravity) with the bounding box of the blob (so the length of the axis does not actually scale with the value of the minimum moment!).
[out] | BlobMinMomentAxisY0 | Y-coordinate of the start point of the minimum moment axis. |
|
readonly |
Y-coordinate of the end point of the minimum moment axis.
The properties \ref BlobMinMomentAxisX0, \ref BlobMinMomentAxisY0, \ref BlobMinMomentAxisX1 and \ref BlobMinMomentAxisY1 return the coordinates of the start-point and endpoint of the axis of minimum inertia of the blob. The start- and endpoint of that axis are determined by intersecting this axis (which runs through the blob's center of gravity) with the bounding box of the blob (so the length of the axis does not actually scale with the value of the minimum moment!).
[out] | BlobMinMomentAxisY1 | Y-coordinate of the end point of the minimum moment axis. |
|
readonly |
Returns the ratio of BlobMinMoment and BlobMaxMoment.
[out] | BlobMomentRatio | Aspect/ratio of the blob. |
|
readonly |
boolean Entire |
If this property is set to TRUE
the area passed by the X0, X1, Y0 and Y1 properties is ignored and the complete image will be used for the blob search.
[in,out] | Entire | TRUE indicates that the complete image will be used, FALSE otherwise. |
TRUE
indicates that the complete image will be used, FALSE
otherwise.
|
readonly |
long FilterBlobHeightMax |
Defines the maximum height of a blob.
[in,out] | FilterBlobHeightMax | Upper limit (only blobs that are below the upper limit are found). |
long FilterBlobHeightMin |
Defines the minimum height of a blob.
[in,out] | FilterBlobHeightMin | Lower limit (only blobs that are above the lower limit are found). |
long FilterBlobSizeMax |
Defines the maximum size of a blob.
[in,out] | FilterBlobSizeMax | Upper limit (only blobs that are smaller than the upper limit are found). |
long FilterBlobSizeMin |
Defines the minimum size of a blob.
[in,out] | FilterBlobSizeMin | Lower limit (only blobs that are greater than the lower limit are found). |
boolean FilterBlobTouchBorderBottom |
Specifies whether a blob object is ignored when touching the bottom border of the area of interest or the image.
[in,out] | FilterBlobTouchBorderBottom | TRUE indicates that blobs touching the bottom border will be ignored, FALSE otherwise. |
TRUE
indicates that blobs touching the bottom border will be ignored, FALSE
otherwise. boolean FilterBlobTouchBorderLeft |
Specifies whether a blob object is ignored when touching the left border of the area of interest or the image.
[in,out] | FilterBlobTouchBorderLeft | TRUE indicates that blobs touching the left border will be ignored, FALSE otherwise. |
TRUE
indicates that blobs touching the left border will be ignored, FALSE
otherwise. boolean FilterBlobTouchBorderRight |
Specifies whether a blob object is ignored when touching the right border of the area of interest or the image.
[in,out] | FilterBlobTouchBorderRight | TRUE indicates that blobs touching the right border will be ignored, FALSE otherwise. |
TRUE
indicates that blobs touching the right border will be ignored, FALSE
otherwise. boolean FilterBlobTouchBorderTop |
Specifies whether a blob object is ignored when touching the top border of the area of interest or the image.
[in,out] | FilterBlobTouchBorderTop | TRUE indicates that blobs touching the top border will be ignored, FALSE otherwise. |
TRUE
indicates that blobs touching the top border will be ignored, FALSE
otherwise. long FilterBlobWidthMax |
Defines the maximum width of a blob.
[in,out] | FilterBlobWidthMax | Upper limit (only blobs that are narrower than the upper limit are found). |
long FilterBlobWidthMin |
Defines the minimum width of a blob.
[in,out] | FilterBlobWidthMin | Lower limit (only blobs that are wider than the lower limit are found). |
__int3264 Image |
Defines the image object that is assigned to the FBlob Control.
[in,out] | Image | Handle of the image object. |
long PlaneIndex |
Specifies the color plane to be used if the image assigned to the control consists of more than one plane.
Valid values are 0 to ImageDimension(cvBlob.Image) - 1. If you specify an invalid value the FBlob \ref CVCError event will be fired (see CVCError headerfile).
[in,out] | PlaneIndex | Plane index to work on. |
boolean SkipBinarization |
Indicates if the binarization of an image will be skipped or not.
This is useful if the incoming image is already a binarized image. In that case, setting the \ref SkipBinarization property to \c TRUE will disable FBlob's internal binarization and thereby save a few milliseconds of processing time. Note that in the binarized image white pixels are considered to be object pixels and black pixels are treated as background.
[in,out] | SkipBinarization | TRUE means that the internal binarization will be skipped, FALSE otherwise. |
TRUE
means that the internal binarization will be skipped, FALSE
otherwise. long SortCenterX |
Define the X-coordinate for the SORT_BY_DISTANCE sort mode.
In this sort mode the results are sorted by their distance from this sort "center" (see also \ref SortMode property).
[in,out] | SortCenterX | X-coordinate of sort center. |
long SortCenterY |
Define the Y-coordinate for the SORT_BY_DISTANCE sort mode.
In this sort mode the results are sorted by their distance from this sort "center" (see also \ref SortMode property).
[in,out] | SortCenterY | Y-coordinate of sort center. |
FBlobSortMode SortMode |
Sort mode of the blob objects.
The objects can be sorted in ascending or descending order - see value \ref SortRising property.
[in,out] | SortMode | Sort mode. See FBlobSortMode for possible modes. |
boolean SortRising |
Indicates the sort order of the blob objects.
The objects can be sorted in ascending or descending order according to various criteria (see \ref SortMode property).
[in,out] | SortRising | TRUE indicates that the blobs are sorted in ascending order, FALSE means that the blobs are sorted in descending order. |
TRUE
means ascending order, FALSE
specifies descending order. long ThresholdLower |
Defines the lower threshold of the gray value range to binarize the image.
The two threshold values \ref ThresholdUpper and \ref ThresholdLower define the gray value range that is set to 255 ("object") in the binarized image. The values under the lower threshold and above the upper threshold are set to 0. The default value is 128.
[in,out] | ThresholdLower | Minimum grey value for thresholding. |
long ThresholdUpper |
Defines the lower threshold of the gray value range to binarize the image.
The two threshold values \ref ThresholdUpper and \ref ThresholdLower define the gray value range that is set to 255 ("object") in the binarized image. The values under the lower threshold and above the upper threshold are set to 0. The default value is 255.
[in,out] | ThresholdUpper | Maximum grey value for thresholding. |
double X0 |
X-coordinate of the upper left point of the rectangular area of interest.
The properties \ref X0, \ref Y0, \ref X1 and \ref Y1 define the area in which the control tries to find blobs.
TRUE
these values will be ignored and the complete image will be used for blob detection. [in,out] | X0 | X-coordinate of the upper left point of the area of interest. |
Entire property, Area of interest (AOI)
double X1 |
X-coordinate of the lower right point of the rectangular area of interest.
The properties \ref X0, \ref Y0, \ref X1 and \ref Y1 define the area in which the control tries to find blobs.
TRUE
these values will be ignored and the complete image will be used for blob detection. [in,out] | X1 | X-coordinate of the lower right point of the area of interest. |
double Y0 |
Y-coordinate of the upper left point of the rectangular area of interest.
The properties \ref X0, \ref Y0, \ref X1 and \ref Y1 define the area in which the control tries to find blobs.
TRUE
these values will be ignored and the complete image will be used for blob detection. [in,out] | Y0 | Y-coordinate of the upper left point of the area of interest. |
double Y1 |
Y-coordinate of the lower right point of the rectangular area of interest.
The properties \ref X0, \ref Y0, \ref X1 and \ref Y1 define the area in which the control tries to find blobs.
TRUE
these values will be ignored and the complete image will be used for blob detection. [in,out] | Y1 | Y-coordinate of the lower right point of the area of interest. |