A RangeWithGrey image is a combined image consisting of a range image and a 16-bit greyscale image acquired at the same time using a displacement sensor. The following image shows a RangeWithGrey image of an electronic component.

The following image shows the same RangeWithGrey image visualized in the 3D Viewer.

Enabling High Dynamic Range changes the range of greyscale values that appear in the greyscale part of the acquired RangeWithGrey image.

For information on setting up acquisition with your displacement sensor, see the Getting Started topic. For detailed information on range image acquisition, see the Acquiring Images from a DS900 Series Sensor and Acquiring Images from a DS1000 Series Sensor topics. For advanced range image acquisition details, including coordinate spaces related to range images, see the Range Image Coordinate Spaces and Associated Parameters topic. For hardware-related information (such as mounting and physical product features) and further product details, see the DS900 Quick Reference Guide, DS1000 Quick Reference Guide, and the DS1000 Technical Reference Manual.

Use the Cog3DRangeGreySplitterScript CogToolBlock to split a RangeWithGrey image into separate 3D range and 16-bit greyscale images. VisionPro contains a sample application that demonstrates its use.

Find the Cog3DRangeGreySplitterScript CogToolBlock under 3D Tools in the QuickBuild tool palette. A new Cog3DRangeGreySplitterScript CogToolBlock appears as shown:

In addition to generating a CogImage16Range and CogImage16Grey, the tool block creates a CogVisionDataContainer for use with vision tools such as the CogVisionDataStitch tool or the Cog3DVisionDataRerender tool.

If the input image is not a range image or if the input image is null, the output terminals will be set to null, the tool's result will be set to "Error", and the tool's error message will be set to "Input image is null, or input image type is not supported".

If the width of the input image is odd, the output terminals will be set to null, the tool's result will be set to "Error", and the tool's error message will be set to "The width of the image is odd indicating that the image is not a combined image."

The Cog3DRangeGreySplitterScript CogToolBlock does not support an API. Programmatic users can examine the script within the tool block to recreate the functionality. The tool block uses the CogCopyRegion class to produce the range image and the grey image as follows:

• Two regions are created: one for the left half of the image (range region) and one for the right half of the image (grey region).
• The 16-bit greyscale image is extracted from the input range image.
• The Execute method on the CogCopyRegion operator is called once using the input range image and the range region to produce the output range image.
• The Execute method on the CogCopyRegion operator is called a second time using the 16-bit grey image and the grey region to produce the output grey image.
• A CogVisionDataContainer object is created, and both the range and the grey images are added to the container object.