Blob OCX Reference 14.0
Properties Initialisation

Properties

long ConvexProjections [get, set]
 Defines the number of convex projections. More...
 
boolean Entire [get, set]
 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 instead to search Blobs. More...
 
boolean ExtractBlobCenterAndMoments [get, set]
 For reasons of speed, it is possible to set different extraction modes so that unnecessary parameters are not calculated. More...
 
boolean ExtractBlobConvexPerimeter [get, set]
 For reasons of speed, it is possible to set different extraction modes so that unnecessary parameters are not calculated. More...
 
boolean ExtractBlobPerimeter [get, set]
 For reasons of speed, it is possible to set different extraction modes so that unnecessary parameters are not calculated. More...
 
boolean ExtractBlobPixelData [get, set]
 For reasons of speed, it is possible to set different extraction modes so that unnecessary parameters are not calculated. More...
 
__int3264 Image [get, set]
 Defines the image object that is assigned to the Common Vision Blob Control. More...
 
double MemoryUsageFactor [get, set]
 This property sets the memory size of internal tables. More...
 
long PlaneIndex [get, set]
 Used to define the colour plane to be used if the image assigned to the control consists of more than one plane. More...
 
long SortCenterX [get, set]
 If #SORT_BY_DISTANCE is selected via the #SortMode property, this value defines the x-coordinate for which the distance is calculated. More...
 
long SortCenterY [get, set]
 If #SORT_BY_DISTANCE is selected via the #SortMode property, this value defines the y-coordinate for which the distance is calculated. More...
 
BlobSortMode SortMode [get, set]
 Following extraction, the objects can be sorted by various criteria. More...
 
boolean SortRising [get, set]
 Following extraction, the objects can be sorted in ascending or descending order. More...
 
long ThresholdLower [get, set]
 Minimum grey value belonging to the object. More...
 
long ThresholdUpper [get, set]
 Maximum grey value belonging to the object. More...
 
double X0 [get, set]
 Returns the x-coordinate of upper left point of the the area in which the control tries to find blobs. More...
 
double X1 [get, set]
 Returns the x-coordinate of lower right point of the the area in which the control tries to find blobs. More...
 
double Y0 [get, set]
 Returns the y-coordinate of upper left point of the the area in which the control tries to find blobs. More...
 
double Y1 [get, set]
 Returns the y-coordinate of lower right point of the the area in which the control tries to find blobs. More...
 

Detailed Description

Properties

◆ ConvexProjections

long ConvexProjections
getset

Defines the number of convex projections.

Projections are applied to the object from the sides defined by this number (see #BlobConvexPerimeter). 
The more projections, the more precise the approximation to the perimeter. 
The four basic projections (0 degree, 45 degrees, 90 degrees, 135 degree) are the default values. 

\a ConvexProjections specifies the number of projections and #ConvexPointsRetrieved returns the number of points 
on the perimeter. For example the number or projections is 4 returns 12 points on the convex perimeter shape.
Parameters
[in,out]ConvexProjectionsNumber of convex projections.
Returns
Number of convex projections.
Supported platforms:
Win32
Related Topics:
#BlobConvexPerimeter Property
#BlobConvexPointIndex Property, #BlobConvexPointX Property and #BlobConvexPointY Property to get the coordinates of the convex shape
#ConvexPointsRetrieved Property

◆ Entire

boolean Entire
getset

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 instead to search Blobs.

Parameters
[in,out]EntireDefines either the entire image or area of interest which will used for the search.
Returns
Defines if the entire image will be used to search Blobs or not.
Supported platforms:
Win32

◆ ExtractBlobCenterAndMoments

boolean ExtractBlobCenterAndMoments
getset

For reasons of speed, it is possible to set different extraction modes so that unnecessary parameters are not calculated.

Parameters
[in,out]ExtractBlobCenterAndMomentsTRUE causes that the centre and moment of inertia of the found blobs are calculated.
Returns
Indicates if the centre and moment of inertia of the found blobs will be calculated or not.
Supported platforms:
Win32
Related Topics:
#ExtractBlobPerimeter Property
#ExtractBlobConvexPerimeter
#ExtractBlobPixelData

Moments
#BlobCenterX Property
#BlobCenterY Property
#BlobMinMomentAxisAngle Property

Coordinates of the axis can be retrieved using #BlobMinMomentAxisX0
#BlobMaxMoment Property and #BlobMinMoment Property
#BlobMomentRatio Property

◆ ExtractBlobConvexPerimeter

boolean ExtractBlobConvexPerimeter
getset

For reasons of speed, it is possible to set different extraction modes so that unnecessary parameters are not calculated.

Parameters
[in,out]ExtractBlobConvexPerimeterTRUE causes that the convex perimeter is calculated.
Returns
Indicates if the convex perimeter will be calculated or not.
Supported platforms:
Win32
Related Topics:
#ExtractBlobPerimeter Property
#ExtractBlobCenterAndMoments Property
#ExtractBlobPixelData Property

#BlobPerimeter and #BlobConvexPerimeter Property
#ConvexProjections Property
#BlobConvexPerimeter Property

◆ ExtractBlobPerimeter

boolean ExtractBlobPerimeter
getset

For reasons of speed, it is possible to set different extraction modes so that unnecessary parameters are not calculated.

Parameters
[in,out]ExtractBlobPerimeterTRUE causes that the perimeter is calculated.
Returns
Indicates if the perimeter will be calculated or not.
Supported platforms:
Win32
Related Topics:
#ExtractBlobPixelData Property
#ExtractBlobConvexPerimeter Property
#ExtractBlobCenterAndMoments Property

#BlobPerimeter and #BlobConvexPerimeter Property #BlobPerimeter Property

◆ ExtractBlobPixelData

boolean ExtractBlobPixelData
getset

For reasons of speed, it is possible to set different extraction modes so that unnecessary parameters are not calculated.

Parameters
[in,out]ExtractBlobPixelDataTRUE causes that the streaks belonging to a blob are stored separately and can be used further with the #ResultImage.
Returns
Indicates if the streaks are stored separately or not.
Supported platforms:
Win32
Related Topics:
#ExtractBlobPerimeter Property
#ExtractBlobConvexPerimeter Property
#ExtractBlobCenterAndMoments Property

◆ Image

__int3264 Image
getset

Defines the image object that is assigned to the Common Vision Blob Control.

Attention
If you specify an invalid image the #CVCError event will be fired.
Parameters
[in,out]ImageHandle to the image object.
Returns
Image object handle.
Supported platforms:
Win32

◆ MemoryUsageFactor

double MemoryUsageFactor
getset

This property sets the memory size of internal tables.

 The number for the \a MemoryUsageFactor takes the actual memory size and multiplies 
 it with the factor. Default value is \c 1. 
Parameters
[in,out]MemoryUsageFactorNumber to duplicate the memory.
Returns
Number to duplicate the memory.
Supported platforms:
Win32

◆ PlaneIndex

long PlaneIndex
getset

Used to define the colour plane to be used if the image assigned to the control consists of more than one plane.

Attention
Valid values are 0 to ImageDimension (cvBlob.Image). If you specify an invalid value the #CVCError event will be fired.
Parameters
[in,out]PlaneIndexDesired plane index.
Returns
Plane index.
Supported platforms:
Win32

◆ SortCenterX

long SortCenterX
getset

If #SORT_BY_DISTANCE is selected via the #SortMode property, this value defines the x-coordinate for which the distance is calculated.

Parameters
[in,out]SortCenterXX-coordinate for which the distance is calculated.
Returns
X-coordinate for which the distance is calculated.
Supported platforms:
Win32
Related Topics:
#SortResults Method
#SortMode Property
#SortCenterY Property

◆ SortCenterY

long SortCenterY
getset

If #SORT_BY_DISTANCE is selected via the #SortMode property, this value defines the y-coordinate for which the distance is calculated.

Parameters
[in,out]SortCenterYY-coordinate for which the distance is calculated.
Returns
Y-coordinate for which the distance is calculated.
Supported platforms:
Win32
Related Topics:
#SortResults Method
#SortMode Property
#SortCenterX Property

◆ SortMode

BlobSortMode SortMode
getset

Following extraction, the objects can be sorted by various criteria.

Attention
The objects could be sorted in ascending and descending order by setting the value of #SortRising.
Parameters
[in,out]SortModeSort mode. For possible values refer to #BlobSortMode.
Returns
Sort mode.
Supported platforms:
Win32
Related Topics:
#SortResults Method
#SortRising Property
#SortCenterX Property
#SortCenterY Property

◆ SortRising

boolean SortRising
getset

Following extraction, the objects can be sorted in ascending or descending order.

Parameters
[in,out]SortRisingTRUE indicates that the objects are sorted in ascending order,
FALSE specifies that the objects are sorted in descending order.
Returns
Specifies the sort order which is either in ascending or descending order.
Supported platforms:
Win32
Related Topics:
#SortResults Method

◆ ThresholdLower

long ThresholdLower
getset

Minimum grey value belonging to the object.

The two threshold values #ThresholdUpper and \a ThresholdLower define the grey value 
range that is used for binarizing. 
Parameters
[in,out]ThresholdLowerMinimum grey value used for thresholding. Default = 128.
Returns
Minimum grey value for thresholding.
Supported platforms:
Win32
Related Topics:
#CVCError Event
#Execute Method
#ExecuteBinarization Method

◆ ThresholdUpper

long ThresholdUpper
getset

Maximum grey value belonging to the object.

The two threshold values \a ThresholdUpper and #ThresholdLower define the grey value 
range that is used for binarizing. 
Parameters
[in,out]ThresholdUpperMaximum grey value used for thresholding. Default = 128.
Returns
Maximum grey value for thresholding.
Supported platforms:
Win32
Related Topics:
#CVCError event
#Execute method
#ExecuteBinarization Method

◆ X0

double X0
getset

Returns the x-coordinate of upper left point of the the area in which the control tries to find blobs.

Attention
If the #Entire property is set to TRUE these values will be ignored and the complete image will be used instead to detect blobs.
Parameters
[in,out]X0X-coordinate of upper left point of the rectangular area of interest.
Returns
X-coordinate of upper left point of the rectangular area.
Supported platforms:
Win32
Related Topics:
X0, #X1, #Y0, and #Y1
#Entire Property

◆ X1

double X1
getset

Returns the x-coordinate of lower right point of the the area in which the control tries to find blobs.

Attention
If the #Entire property is set to TRUE these values will be ignored and the complete image will be used instead to detect blobs.
Parameters
[in,out]X1X-coordinate lower right point of the rectangular area of interest.
Returns
X-coordinate of lower right point of the rectangular area.
Supported platforms:
Win32
Related Topics:
#X0, X1, #Y0, and #Y1
#Entire Property

◆ Y0

double Y0
getset

Returns the y-coordinate of upper left point of the the area in which the control tries to find blobs.

Attention
If the #Entire property is set to TRUE these values will be ignored and the complete image will be used instead to detect blobs.
Parameters
[in,out]Y0Y-coordinate of upper left point of the rectangular area of interest.
Returns
Y-coordinate of upper left point of the rectangular area.
Supported platforms:
Win32
Related Topics:
#X0, #X1, Y0, and #Y1
#Entire Property

◆ Y1

double Y1
getset

Returns the y-coordinate of lower right point of the the area in which the control tries to find blobs.

Attention
If the #Entire property is set to TRUE these values will be ignored and the complete image will be used instead to detect blobs.
Parameters
[in,out]Y1Y-coordinate lower right point of the rectangular area of interest.
Returns
Y-coordinate of lower right point of the rectangular area.
Supported platforms:
Win32
Related Topics:
#X0, #X1, #Y0, and Y1
#Entire Property