OpenGLContext.move.examinemanager

Interaction mode for examining objects

Classes

class ExamineManager( EventManager ):

Interaction EventManager for "Examine" mode

This interaction manager implements an examine mode similar to that found in VRML97 browsers. Pointing to an object and dragging up/down left/right causes the viewpoint to orbit around the object as if the object were held in the hand and being rotated.

The manager uses the trackball thereby the dragwatcher to provide screen-relative scaling of the input. In other words, distances are measured as fractions of the distance to the edge of the screen.

__init__( self , context , platform , center , event )

Initialise the ExamineManager

context: Context instance
platform: ViewPlatform instance
center: object-space coordinates about which to revolve
event: event which began the examine interaction.

cancel( self , event )

Cancel the examine mode, return to original position and orientation

OnBind( self )

Bind the events needing binding to run the examine mode Customisation point for those needing custom controls

OnBuildTrackball( self , platform , center , event , width , height )

Build the trackball object Customisation point for those wanting to use a different trackball implementation.

OnUnBind( self )

UnBind the events for the examine mode Customisation point for those needing custom controls

ProcessEvent( self , event )

Respond to events from the system Customisation point for those needing custom controls

release( self , event )

Trigger cleanup of the examine mode

update( self , event )

Update the examine trackball with new mouse event

This updates the internal position, then triggers a redraw of the context.