provide event-driven interface to the rendering window (defines trackball mode)
vtkInteractorStyle is a base class implementing the majority of motion control routines and defines an event driven interface to support vtkRenderWindowInteractor. vtkRenderWindowInteractor implements platform dependent key/mouse routing and timer control, which forwards events in a neutral form to vtkInteractorStyle.
vtkInteractorStyle implements the "joystick" style of interaction. That is, holding down the mouse keys generates a stream of events that cause continuous actions (e.g., rotate, translate, pan, zoom). (The class vtkInteractorStyleTrackballimplements a grab and move style.) The event bindings for this class include the following:
vtkInteractorStyleSwitch Class
class to swap between interactory styles
The class vtkInteractorStyleSwitch allows handles interactively switching between four interactor styles – joystick actor, joystick camera, trackball actor, and trackball camera. Type 'j' or 't' to select joystick or trackball, and type 'c' or 'a' to select camera or actor. The default interactor style is joystick camera.
interactive manipulation of the camera
vtkInteractorStyleTrackballCamera allows the user to interactively manipulate (rotate, pan, etc.) the camera, the viewpoint of the scene. In trackball interaction, the magnitude of the mouse motion is proportional to the camera motion associated with a particular mouse binding. For example, small left-button motions cause small changes in the rotation of the camera around its focal point. For a 3-button mouse, the left button is for rotation, the right button for zooming, the middle button for panning, and ctrl + left button for spinning. (With fewer mouse buttons, ctrl + shift + left button is for zooming, and shift + left button is for panning.)
vtkInteractorStyleTrackballActor Class
manipulate objects in the scene independent of each other
vtkInteractorStyleTrackballActor allows the user to interact with (rotate, pan, etc.) objects in the scene indendent of each other. In trackball interaction, the magnitude of the mouse motion is proportional to the actor motion associated with a particular mouse binding. For example, small left-button motions cause small changes in the rotation of the actor around its center point.
The mouse bindings are as follows. For a 3-button mouse, the left button is for rotation, the right button for zooming, the middle button for panning, and ctrl + left button for spinning. (With fewer mouse buttons, ctrl + shift + left button is for zooming, and shift + left button is for panning.)
vtkInteractorStyleImage Class
interactive manipulation of the camera specialized for images
vtkInteractorStyleImage allows the user to interactively manipulate (rotate, pan, zoom etc.) the camera. vtkInteractorStyleImage is specially designed to work with images that are being rendered with vtkImageActor. Several events are overloaded from its superclass vtkInteractorStyle, hence the mouse bindings are different. (The bindings keep the camera's view plane normal perpendicular to the x-y plane.) In summary the mouse events for 2D image interaction are as follows:
If SetInteractionModeToImageSlicing() is called, then some of the mouse events are changed as follows:
If SetInteractionModeToImage3D() is called, then some of the mouse events are changed as follows:
In all modes, the following key bindings are in effect:
Note that the renderer's actors are not moved; instead the camera is moved.