3D Transform

 

Watch a Video Presentation

 

This tool enables you to have a more precise control on the transformation matrix used to position the 3D Camera. The transformations applied with the mouse in the associated windows are immediately reflected here. Any modification to the matrix done with this tool will immediately affect the geometries in the associated windows.

 

 

From the Graphic Interface

 

 

 

Mode Track Ball

The left mouse button activates the trackball rotations. The mouse controls a point on the surface of a sphere anchored in the center of the 3D window. Moving the mouse drags the point and thus rotates the sphere around its center. The right mouse button activates the translations. The mouse motion drags the objects vertically and horizontally in the plane of the 3D window. The middle mouse button (or both the left and right) activates the scaling. The horizontal mouse motion controls the objects’ scaling.

 

 

Mode Classic

The left mouse button activates the rotations. The vertical mouse motion will rotate the objects around the windows’ horizontal axis. The horizontal mouse motion will rotate the objects around the window’s vertical axis. The right mouse button activates the translations. The mouse motion drags the objects vertically and horizontally in the plane of the 3D window. The middle mouse button (or both the left and right) activates the scaling. The horizontal mouse motion controls the objects’ scaling.

 

 

Mode Patient

In this interface mode, only the horizontal mouse motion is used, and all transformations are done in the patient axis system. Thus, a “z” rotation is a rotation around the patient’s head to foot axis. Each of the mouse buttons controls the rotation of the objects around one of the patient’s axis. The left button activates the “x” axis rotation, the middle button the “y” axis rotation and the right button the “z” axis. Each combination of 2 buttons controls the translation of the objects along one of the patient’s axis. The middle and right buttons activate the “x” translation, the left and right buttons the “y” translation and the left and middle buttons the “z” translation. Pressing all 3 mouse buttons at once activates the scaling.

 

 

Rotation

The X/Y/Z sliders control the surfaces’ rotation around their axis. The rotations are applied in the following order: X  then Y then Z.

 

Translation

The X/Y/Z sliders control the surfaces’ translation along their axis.

 

Scaling

The X slider is used to control the surfaces’ scaling factor.

 

X/Y/Z Sliders

Control the rotation/translation or scaling applied to the transformation matrix.

 

Restore

Reinitialize all transformation matrices and center all currently visible surfaces in the 3D window. (A surface is visible if its shading is either line, flat or smooth.)

 

Center

Center the visible surfaces in the 3D window.

 

 

From the Display Area

 

The mouse is used to manipulate the 3D objects as described earlier.

 

 

From the Keyboard

 

There is no keyboard interface specific to this tool.

 

 

From the Command Line

 

System Variables defined in this library:

 

 

$TRANSFORM_INTERFACE

(U16)

Type of 3D mouse interface. (0=Track, 1=Classic, 2=Patient)

 

Commands recognized in this library:

 

Transform: Mode (track|classic|patient)

Assign a value to the $TRANSFORM_INTERFACE variable. (See Transform in The 3D Tools)

 

Transform: t_window Camera x y z

Place the observer at the position x, y, z for all the windows matching the template "t_window".

 

Transform: t_window Center x y z

Center all the windows matching the template "t_window" around the point x, y, z.

 

Transform: t_window FOV angle

Change the camera Field Of View "angle" to all the windows matching the template "t_window". Accepted values for "angle" range from 0.0 to 179.0 degrees. A value of 0 will yield an orthogonal projection. The default Camera has a FOV of 27 degrees.

 

Transform: t_window Matrix a11 a12 a13 a14 a21 ... a44

Directly set the matrix elements. The 16 parameters of this command will be inserted in the 4x4 transformation matrix.of all the windows matching the template "t_window".

 

Transform: t_window Pivot angle x y z

Rotate "angle" degrees around the direction specified by x, y, z all the windows matching the template "t_window".

 

Transform: t_window Restore

Restore the transformation matrix all the windows matching the template "t_window".

 

Transform: t_window Rotate x y z

Rotate all the windows matching the template "t_window".

 

Transform: t_window Scale value

Scale all the windows matching the template "t_window".

 

Transform: t_window Translate x y z

Translate all the windows matching the template "t_window".

 

Templates:

 

t_window is a template for the window. It match either the widow ID ("1" to "4") or "cur" for the currently selected window.