M3dmapDraw3d

See also

User Guide:

Organization of the MIL modules

Reference:

M3ddispInquire M3dgraAlloc M3dgraArc M3dmapAlloc M3dmapCalibrate M3dmapControl MbufInquire

Availability

Not available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

Function map

Examples

c3ddisplaymanager.cpp

Function Map

- OperationDraw3dContext3dmapId

Table:

For specifying the 3D draw context

- SrcReconContext3dmapId

- SrcIndex

- DstList3dgraId

- DstParentLabel

Table:

For specifying the parent label

- LaserPlaneTextureImageBufId

- ControlFlag

Return value

Compilation information

Synopsis

Draw 3D annotations based on a laser line profiling 3D reconstruction context.

Syntax

MIL_INT64 M3dmapDraw3d(

MIL_ID OperationDraw3dContext3dmapId,	//in
MIL_ID SrcReconContext3dmapId,	//in
MIL_INT64 SrcIndex,	//in
MIL_ID DstList3dgraId,	//in
MIL_INT64 DstParentLabel,	//in
MIL_ID LaserPlaneTextureImageBufId,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function draws 3D annotations (for example, the camera's coordinate system) based on a laser line profiling 3D reconstruction context, in a 3D graphics list. Set the draw operations and options for the draw using M3dmapControl(). Example operations include drawing the laser plane and the frustum of the camera's view.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.

Parameters

This function is not supported on the selected boards.

Parameters

OperationDraw3dContext3dmapId

Specifies the identifier of the 3D draw context that specifies the annotations to draw and how to draw them. This parameter must be set to one of the following values:

For specifying the 3D draw context
Value	Description
M_DEFAULT	Specifies that the default 3D draw context of the current MIL application is used.
MIL 3D draw context identifier	Specifies a valid 3D draw context identifier, which you have allocated using M3dmapAlloc() with M_DRAW_3D_CONTEXT.

SrcReconContext3dmapId

Specifies the identifier of the laser line profiling 3D reconstruction context, previously allocated using M3dmapAlloc() with M_LASER and M_CALIBRATED_CAMERA_LINEAR_MOTION. The 3D reconstruction setup must have been successfully calibrated using M3dmapCalibrate().

SrcIndex

Reserved for future expansion and must be set to M_DEFAULT.

DstList3dgraId

Specifies the identifier of the 3D graphics list in which to draw. You can specify a 3D graphics list that you have previously allocated using M3dgraAlloc(), or you can specify the identifier of the 3D display's internal graphics list (inquired using M3ddispInquire() with M_3D_GRAPHIC_LIST_ID).

DstParentLabel

Specifies the label of the 3D graphic in the 3D graphics list to be used as the annotation's parent.

For specifying the parent label
Value	Description
M_DEFAULT	Same as M_ROOT_NODE.
M_ROOT_NODE	Specifies the top-most node of the 3D graphics list.
Value >= 0	Specifies the label of the 3D graphic in the 3D graphics list. Label 0 is the 3D graphics list's root node. (summarize) Specifies the label of the 3D graphic in the 3D graphics list. (more details...)

LaserPlaneTextureImageBufId

Specifies the identifier of the image buffer containing the texture image, which you can apply to the drawn laser plane to enhance its visibility. This is typically the image buffer containing the grabbed image of the laser line.

Set this parameter to M_NULL if not used.

ControlFlag

Reserved for future expansion and must be set to M_DEFAULT.

Return value

Returns the parent label of the graphics added to the graphics list.

Compilation information

Header	Include mil.h.
Library	Use mil.lib; mil3dmap.lib.
DLL	Requires mil.dll; mil3dmap.dll.