Skip to main content

M3dgeoDraw3d

BoardSupported
Host SystemYes
V4L2Yes
Clarity UHDYes
Concord PoENo
GenTLYes
GevIQYes
GigE VisionYes
IndioNo
Iris GTXYes
Radient eV-CLYes
Rapixo CLYes
Rapixo CoFYes
Rapixo CXPYes
USB3 VisionYes

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

Syntax

AIL_INT64 M3dgeoDraw3d(
AIL_ID OperationDraw3dContext3dgeoId, //in
AIL_ID SrcGeometry3dgeoId, //in
AIL_ID DstList3dgraId, //out
AIL_INT64 DstParentLabel, //in
AIL_INT64 ControlFlag //in
)

Description

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

Parameters

OperationDraw3dContext3dgeoId (in, AIL_ID)

Reserved for future expansion and must be set to M_DEFAULT.

SrcGeometry3dgeoId (in, AIL_ID)

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, point, and sphere.

For specifying the geometry object identifier

ValueDescription
M_XY_PLANESpecifies the XY (Z=0) plane.
3D geometry object identifierSpecifies the identifier of a 3D geometry object. The 3D geometry object must have been previously allocated using M3dgeoAlloc with M_GEOMETRY.

DstList3dgraId (out, AIL_ID)

Specifies the identifier of the 3D graphics list in which to draw. The 3D graphics list must have been 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 (in, AIL_INT64)

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

ValueDescription
M_DEFAULTSame as M_ROOT_NODE.
M_ROOT_NODESpecifies the top-most node of the 3D graphics list.
Value >= 0Specifies the label of the 3D graphic in the 3D graphics list. Label 0 is the 3D graphics list's root node.

ControlFlag (in, AIL_INT64)

Reserved for future expansion and must be set to M_DEFAULT.

Return Value

Type: AIL_INT64

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

Copyright © 2026 Zebra Technologies.