M3dgraNode

This function adds a node to the specified 3D graphics list. Unlike other elements of a 3D graphics list, nodes have no graphical representation. You can use a node to group 3D graphics by specifying the node's label as their parent label. This allows you to apply settings to all of the node's children graphics using the node's label in a call to M3dgraControl() with M_RECURSIVE.

You must specify the label of the 3D graphic, in the 3D graphics list, to use as the parent of the node. When the node is added to the 3D graphics list's tree structure, it is added as a child under the specified parent. If the 3D graphics list is empty, the node's parent must be the root node.

The node has its own coordinate system that represents the node's position and orientation with respect to its parent's coordinate system. You can set the node's position and orientation using the Matrix3dgeoId parameter.

To modify or inquire 3D graphics list settings, use M3dgraControl() or M3dgraInquire(), respectively.

Unlike most other functions that modify a MIL object, you can call this function concurrently from multiple threads on the same MIL 3D graphics list (List3dgraId) without using an M_MUTEX object, as long as all the other parameters of the concurrent calls do not also share data.