Programming with Medical 3D Control

The Medical3DControl is a simple to use control with built in mouse action tools that can easily integrate into the LEADTOOLS Medical Viewer to transform the viewer into a feature rich, advanced 3D viewer with support for various layouts, tools and functionalities that are comparable to high-end radiology work stations. The Medical 3D control was designed for rapid development and ease of use. This control internally holds all the 3D Objects and is capable of handling all actions internally. The control is also responsible for rendering the 3D objects. The Medical3DControl class is derived from MedicalViewerBaseCell and thus provides the same MedicalViewer features including adding overlay tags, using rulers, etc. through the appropriate methods. In addition, it also adds the following ActionTypes and related events for 3D object manipulations:

• WindowLevel - Interactive tools for brightness, transparency, and contrast adjustment. Also controls the transparency.
• Scale3DObject - Used to scale the 3D object using the mouse.
• Translate3DObject - Used for panning the 3D Object using the mouse.
• Alpha - Used for changing the alpha factor of the LUT curve using mouse.
• Rotate3DObject - Used to rotate the 3D Object in object space using the mouse.
• Rotate3DCamera - Used for rotating the 3D object in view space using the mouse.
• Translate3DCamera - Used for panning the 3D object in view space using the mouse.
• ZoomCamera - Used to zoom in and out of the 3D object in view space using the mouse.
• TranslatePlane - Used to change the position of the 3D object in the container using the mouse.
• RotatePlane - Used to rotate the planes using the mouse.

You must call the AddAction method before assigning a specific mouse button by calling SetAction. When calling SetAction, you specify MedicalViewerActionFlags, which tell the control how to handle the action (i.e. to apply the action to selected cells, active cells or all cells in the viewer). An action tool can only be added once and to verify this, use MedicalViewerBaseCell.IsActionAdded. Note, some mouse buttons are not appropriate for some action types (i.e. magnify glass cannot be assigned to the mouse wheel) and the MedicalViewerBaseCell.IsValidForAction method can be called to identify whether the mouse button is right for the specified action type. To get the information about the currently active action call MedicalViewerBaseCell.GetActionButton and to get the information about current action flags call MedicalViewerBaseCell.GetActionFlags. To verify that the Meical3DControl supports the specified action type, call MedicalViewerBaseCell.CanExecuteAction.

To add a 2D stack of images to the control for generating the 3D volume, refer to Rendering 2D Medical Images in a 3D Space. Once the volumetric dataset has been added to the Medical3DObject, add the object to the control by calling Medical3DContainer.Objects.Add. The Medical3DControl can be integrated with the MedicalViewer through the MedicalViewer.Cells collection. You can choose between the various 3D volume rendering types by simply setting the Medical3DContainer.VolumeType property. The Medical3Dcontrol also contains AxialFrame, SagittalFrame and CoronalFrame properties where each holds the representative orthogonal frame in MedicalViewerMPRCell. The Medical Viewer can be used to display each orthogonal plane on a separate window. For more information on creating a 3D object with MPR view, refer to MedicalViewerMPRCell and Programming with MPR Slices.

See Also

Rendering 2D Medical Images in a 3D Space