M3dgraAdd

This function takes a 3D-displayable point cloud container or fully corrected depth map image buffer with the M_DISP attribute and adds it to the specified 3D graphics list, allowing you to, for example, view the point cloud or depth map on a 3D display. Unlike M3ddispSelect(), this function allows you to position the point cloud or depth map relative to a parent graphic.

You must specify the label of the 3D graphic, in the 3D graphics list, to use as the parent of the 3D-displayable point cloud container or fully corrected depth map image buffer. When the 3D-displayable point cloud container or fully corrected depth map image buffer 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 specified parent must be the root node.

Unlike other 3D graphics functions that create static 3D graphics, the 3D graphic created by M3dgraAdd() is linked to the 3D-displayable point cloud container or fully corrected depth map image buffer and updates dynamically.

The 3D graphic created by M3dgraAdd() has its own coordinate system that represents the position and orientation of the 3D graphic with respect to its parent's coordinate system. Initially, the position and orientation of 3D graphic's coordinate system is the identity matrix. This means that the 3D graphic's position and orientation is the same as the position and orientation of its parent's coordinate system.

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.