CogBlobMeasureConstants EnumerationCognex VisionPro
Enumeration of the various measurements that can be performed on a specified blob. Measurements can be obtained by calling the Measure property of a blob result. Measurements can also be used to specify blob filtering & sorting criteria.

Namespace: Cognex.VisionPro.Blob
Assembly: Cognex.VisionPro.Blob (in Cognex.VisionPro.Blob.dll) Version: 65.1.0.0
Syntax

public enum CogBlobMeasureConstants
Members

  Member nameValueDescription
Label0 The connectivity label. For grey scale connectivity, the label will be 1 for blobs and 0 for holes. For labeled connectivity, this is the blob's label.
Area1 The area of the blob specified in units of the input image's selected space at run-time. If you have specified a hard threshold, then this measure is equal to the number of pixels in the blob. If you have specified a soft threshold, then the area is the sum of the weights (from 0.0 to 1.0) of the pixels in the blob.
BoundaryPixelLength2

The length of the pixel aligned boundary of this blob specified in image pixel units. This measure is computed by taking measuring the length of a boundary drawn along the outside edge of each pixel that makes up the blob. This measure is not available when using whole-image connectivity.

Perimeter3 The perimeter of the blob specified in units of the input image's selected space at run-time. This measure is a corrected version of the BoundaryPixelLength that adjusts for the tendency of BoundaryPixelLength to overstate the true blob perimeter. Not available for whole-image connectivity.
NumUnfilteredChildren4 The number of children of this blob before any filter criteria are applied.
CenterMassX5 The x-coordinate of the center of mass of the blob specified in units of the input image's selected space at run-time.
CenterMassY6 The y-coordinate of the center of mass of the blob specified in units of the input image's selected space at run-time.
InertiaX7 The second moment of inertia of the blob about an axis drawn through the blob's center of mass and parallel to the Y-axis of selected space of the input image.
InertiaY8 The second moment of inertia of the blob about an axis drawn through the blob's center of mass and parallel to the X-axis of selected space of the input image.
InertiaMin9 The blob's second moment of inertia about the principal axis of the blob.
InertiaMax10 The blob's second moment of inertia about the second principal axis of the blob.
Elongation11InertiaMax to InertiaMin.
Angle12

The angle of the principal axis of the blob specified in units of the input image's selected space at run-time. The angle is measured from the X-axis of the selected space to the principal axis of the blob and is in the range -π/2 radians to +π/2 radians. This value is not very meaningful if the elongation measure is very close to one.

Acircularity13 The acircularity of this blob as defined by the formula: Perimeter^2 / (4 x PI x Area). This measure is not available when using whole-image connectivity.
AcircularityRms14 The acircularity of this blob as defined by the normalized RMS deviation of the boundary point radius values from r0, where r0is the square root of the blob's area divided by pi. This measure is not available when using whole-image connectivity.
BoundingBoxPixelAlignedNoExcludeCenterX15

The x-coordinate of the center point of the smallest rectangle that completely encloses the blob and is aligned with the pixels of the image. No exclude extrema settings are used for this calculation.

BoundingBoxPixelAlignedNoExcludeCenterY16 The y-coordinate of the center point of the smallest rectangle that completely encloses the blob and is aligned with the pixels of the image. No exclude extrema settings are used for this calculation.
BoundingBoxPixelAlignedNoExcludeMinX17 The minimum x-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the pixels of the image. No exclude extrema settings are used for this calculation.
BoundingBoxPixelAlignedNoExcludeMaxX18 The maximum x-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the pixels of the image. No exclude extrema settings are used for this calculation.
BoundingBoxPixelAlignedNoExcludeMinY19 The minimum y-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the pixels of the image. No exclude extrema settings are used for this calculation.
BoundingBoxPixelAlignedNoExcludeMaxY20 The maximum y-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the pixels of the image. No exclude extrema settings are used for this calculation.
BoundingBoxPixelAlignedNoExcludeWidth21 The width of the smallest rectangle that completely encloses the blob and is aligned with the pixels of the image. No exclude extrema settings are used for this calculation.
BoundingBoxPixelAlignedNoExcludeHeight22 The height of the smallest rectangle that completely encloses the blob and is aligned with the pixels of the image. No exclude extrema settings are used for this calculation.
BoundingBoxPixelAlignedNoExcludeAspect23 The ratio of height to width of the smallest rectangle that completely encloses the blob and is aligned with the pixels of the image. No exclude extrema settings are used for this calculation.
MedianExtremaAngleX24 The x-coordinate of the point through which two orthogonal lines each divide the blob's area in half. The orthogonal lines are aligned with the angle specified by ExtremaAngle. The value of x is specified in units of the input image's selected space.
MedianExtremaAngleY25 The y-coordinate of the point through which two orthogonal lines each divide the blob's area in half. The orthogonal lines are aligned with the angle specified by ExtremaAngle. The value of y is specified in units of the input image's selected space.
BoundingBoxExtremaAngleCenterX26

The x-coordinate of the center point of the smallest rectangle that completely encloses the blob and is aligned with the angle specified by the ExtremaAngle property.

BoundingBoxExtremaAngleCenterY27 The y-coordinate of the center point of the smallest rectangle that completely encloses the blob and is aligned with the angle specified by the ExtremaAngle property.
BoundingBoxExtremaAngleMinX28 The minimum x-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with ExtremaAngle property.
BoundingBoxExtremaAngleMaxX29

The maximum x-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the angle specified by the ExtremaAngle property.

This measure is specified in a coordinate space which is a rotated and translated version of the input image's selected space. The origin of the new space is the blob's center of mass and is rotated by the angle specified by ExtremaAngle.

BoundingBoxExtremaAngleMinY30

The minimum y-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the angle specified by the ExtremaAngle property.

This measure is specified in a coordinate space which is a rotated and translated version of the input image's selected space. The origin of the new space is the blob's center of mass and is rotated by the angle specified by ExtremaAngle.

BoundingBoxExtremaAngleMaxY31

The maximum y-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the angle specified by the ExtremaAngle property.

This measure is specified in a coordinate space which is a rotated and translated version of the input image's selected space. The origin of the new space is the blob's center of mass and is rotated by the angle specified by ExtremaAngle.

BoundingBoxExtremaAngleWidth32 The width of the smallest rectangle that completely encloses the blob and is aligned with the angle specified by the ExtremaAngle property.
BoundingBoxExtremaAngleHeight33 The height of the smallest rectangle that completely encloses the blob and is aligned with the angle specified by the ExtremaAngle property.
BoundingBoxExtremaAngleAspect34 The ratio of height to width of the smallest rectangle that completely encloses the blob and is aligned with the angle specified by the ExtremaAngle property.
BoundingBoxPrincipalAxisMinX35

The minimum x-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the blob's principal axis.

This measure is specified in a coordinate space which is a rotated and translated version of the input image's selected space. The origin of the new space is the blob's center of mass and is rotated by rotated by the angle of the blob's principal axis.

BoundingBoxPrincipalAxisMaxX36

The maximum x-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the blob's principal axis.

This measure is specified in a coordinate space which is a rotated and translated version of the input image's selected space. The origin of the new space is the blob's center of mass and is rotated by the angle of the blob's principal axis.

BoundingBoxPrincipalAxisMinY37

The minimum y-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the blob's principal axis.

This measure is specified in a coordinate space which is a rotated and translated version of the input image's selected space. The origin of the new space is the blob's center of mass and is rotated by the angle of the blob's principal axis.

BoundingBoxPrincipalAxisMaxY38

The maximum y-coordinate enclosed by the smallest rectangle that completely encloses the blob and is aligned with the blob's principal axis.

This measure is specified in a coordinate space which is a rotated and translated version of the input image's selected space. The origin of the new space is the blob's center of mass and is rotated by the angle of the blob's principal axis.

BoundingBoxPrincipalAxisWidth39 The width of the smallest rectangle that completely encloses the blob and is aligned with the blob's principal axis.
BoundingBoxPrincipalAxisHeight40 The height of the smallest rectangle that completely encloses the blob and is aligned with the blob's principal axis.
BoundingBoxPrincipalAxisAspect41 The ratio of height to width of the smallest rectangle that completely encloses the blob and is aligned with the blob's principal axis.
NotClipped42 This measure will be 1.0 if the blob was not clipped during processing. It will be zero if the blob touches the edge of the region of interest, or the edge of the run-time image, or any Don't Care pixel in the InputImageMask.
See Also