M3dmapDraw

Specifies that the default graphics context of the current MIL application is used.

Note that there is a different default graphics context for each thread.

Generates the depth map representing the specified geometry object. The geometry object must have been successfully defined using M3dmapSetGeometry().

An analytic geometry object's domain is theoretically infinite; therefore, to define the region in space where you are interested in visualizing the geometry object, the destination buffer's size and calibration information is used to establish a bounding box. The destination buffer must have a constant pixel size in X and Y and have a valid Z-scale.

If the geomery object has been defined from another fully corrected depth map buffer, and you want to draw the annotation in the same area of space, you can copy the calibration information from the depth map buffer to the destination buffer using MbufCopy() prior to calling M3dmapDraw().

Note that saturation can occur, depending on the Z-scale and offset of the destination buffer. If, for a given pixel of the destination buffer, the corresponding Z-value of the geometry object falls outside the buffer's range of Z-values, the pixel will be saturated to either 0 or the buffer's maximum value, minus one (the maximum value is reserved to represent missing data).

This drawing operation is only available if M3dmapId is a geometry object.

Draws the laser line that would have produced the most recent results stored in the 3D reconstruction result buffer using M3dmapAddScan().

This drawing operation is only available if M3dmapId is a 3D reconstruction result buffer, allocated using M3dmapAllocResult().

Note that since only 1-band destination buffers are supported, the foreground color of the specified graphic context must be grayscale.

Draws all regions (pixels) of the laser line image that were interpolated due to missing data (gaps) in the calibration laser lines. Although the laser line can appear in these regions and be associated with a valid height, the heights will be less accurate since they are interpolated.

This drawing operation is only available if M3dmapId is a 3D reconstruction context allocated with M_DEPTH_CORRECTION and calibrated using M3dmapCalibrate().

Draws all regions (pixels) of the laser line image where an inversion occured. An inversion occurs when a reference plane associated with a lower height is found above a reference plane associated with a higher height. The laser line can still appear in these regions, however, results taken from these regions will be incorrect.

This drawing operation is only available if M3dmapId is a 3D reconstruction context allocated with M_DEPTH_CORRECTION and calibrated using M3dmapCalibrate().

Draws all regions (pixels) of the laser line image where the laser line cannot appear, because of missing data (gaps) in the calibration laser lines that could not be accounted for by interpolation.

This drawing operation is only available if M3dmapId is a 3D reconstruction context allocated with M_DEPTH_CORRECTION and calibrated using M3dmapCalibrate().

Draws all regions (pixels) of the laser line image where the laser line cannot appear, because they are outside the calibrated region.

This drawing operation is only available if M3dmapId is a 3D reconstruction context allocated with M_DEPTH_CORRECTION and calibrated using M3dmapCalibrate().

Draws all regions (pixels) of the laser line image where the laser line can appear and be associated with a valid height.

This drawing operation is only available if M3dmapId is a 3D reconstruction context allocated with M_DEPTH_CORRECTION and calibrated using M3dmapCalibrate().

Draws all the fitted laser lines used for calibrating the 3D reconstruction setup.

This drawing operation is only available if M3dmapId is a 3D reconstruction context allocated with M_CALIBRATED_CAMERA_LINEAR_MOTION and calibrated using M3dmapCalibrate().

Draws all the extracted laser lines used for calibrating the 3D reconstruction setup.

This drawing operation is only available if M3dmapId is a 3D reconstruction context allocated with M_CALIBRATED_CAMERA_LINEAR_MOTION and calibrated using M3dmapCalibrate().

If drawing in an image buffer, the graphics context cannot have any zoom factors associated with it (MgraControl() with M_DRAW_ZOOM_X or M_DRAW_ZOOM_Y must be set to 1.0).