M3dgeoDraw3d

See also

Reference:

M3dgeoAlloc M3dgeoInquire M3dgraAlloc M3dgraArc

Availability

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

3dcadregistration.cpp
3dmodelheightdefect.cpp
m3dgra.cpp
m3dgra.cs
m3dgra.vb
pointcloudprojection.cpp
simple3dstitching.cpp
sphereinspection.cpp

Function Map

- OperationDraw3dContext3dgeoId

- SrcGeometry3dgeoId

Table:

For specifying the geometry object identifier

- DstList3dgraId

- DstParentLabel

Table:

For specifying the parent label

- ControlFlag

Return value

Compilation information

Synopsis

Draw the geometry, defined in the specified 3D geometry object, into a 3D graphics list.

Syntax

MIL_INT64 M3dgeoDraw3d(

MIL_ID OperationDraw3dContext3dgeoId,	//in
MIL_ID SrcGeometry3dgeoId,	//in
MIL_ID DstList3dgraId,	//in
MIL_INT64 DstParentLabel,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function draws a geometry, defined in the specified 3D geometry object, into the destination 3D graphics list.

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

OperationDraw3dContext3dgeoId

Reserved for future expansion and must be set to M_DEFAULT.

SrcGeometry3dgeoId

Specifies the identifier of the 3D geometry object to draw into the 3D graphics list. The 3D geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY, and must have been successfully defined. Supported 3D geometries include box, cylinder, line, plane, and sphere.

For geometries with infinite size, such as infinite lines, planes, and cylinders, the 3D graphics list's clipping box is used to determine the position and size of the 3D graphic. The size and position are only set when calling M3dgeoDraw3d(); they do not update if the 3D graphics list's clipping box is changed afterward.

For specifying the geometry object identifier
Value	Description
M_XY_PLANE	Specifies the XY (Z=0) plane.
MIL 3D geometry object identifier	Specifies the identifier of a 3D geometry object. The 3D geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY. (summarize) Specifies the identifier of a 3D geometry object. (more details...)

DstList3dgraId

Specifies the identifier of the 3D graphics list in which to draw. The 3D graphics list must have been previously allocated using M3dgraAlloc().

DstParentLabel

Specifies the label of the 3D graphic in the 3D graphics list to be used as the geometry'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...)

ControlFlag

Reserved for future expansion and must be set to M_DEFAULT.

Return value

Returns the label of the 3D graphic added to the 3D graphics list.

Compilation information

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