Cog3DRangeImageVolumeCalculatorResult Volume Property Cognex VisionPro
The calculated volume between the 3D surface defined by the range image pixels and the specified base plane, measured in the SelectedSpaceName3D coordinates (e.g. mm3) of the range image

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

public double Volume { get; }

Property Value

Type: Double
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