Cog3DRangeImageVolumeCalculatorResult PixelCountsDiagImage Property Cognex VisionPro
Diagnostic which identifies which pixels in the range image fall into each of 4 different categories.

See Cog3DRangeImagePixelCountsTypeConstants for the definition of the different categories.

Each pixel in the pixel counts diag image is a bit-wise or of Cog3DRangeImagePixelCountsTypeConstants.

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

public CogImage8Grey PixelCountsDiagImage { get; }

Property Value

Type: CogImage8Grey
Remarks

A range image pixel is "used" to calculate the volume if:

  • it is inside the 2D input [P:Cognex::VisionPro3D::Cog3DRangeImageVolumeCalculatorTool::Region] of the tool.
  • it is marked as "care" in the optional [P:Cognex::VisionPro3D::Cog3DRangeImageVolumeCalculator::InputImageMask] provided as part of the [P:Cognex::VisionPro3D::Cog3DRangeImageVolumeCalculatorTool::RunParams].
  • it is marked as a "visible pixel" in the visible pixel mask of the [P:Cognex::VisionPro3D::Cog3DRangeImageVolumeCalculatorTool::InputImage]. The visible pixel mask can be accessed by calling GetMaskData  on the range image.
  • its height (relative to the base plane) is greater than or equal to the [P:Cognex::VisionPro3D::Cog3DRangeImageVolumeCalculator::MinimumHeightThreshold].

Pixels that meet these conditions contribute to the volume computation and are marked as "used" in the PixelCountsDiagImage.

Note that the height of an individual range image pixel is defined as the signed distance from the center of the range image pixel to the nearest point on the base plane (measured in selected space 3D units).

Note, however, that the volume is calculated by summing the contribution of the range image pixels within the [P:Cognex::VisionPro3D::Cog3DRangeImageVolumeCalculatorTool::Region] projected along the pixel coordinate z axis until they intersect the base plane.

See Also