IS3D::DefaultMouseNav Class Reference

#include <DefaultMouseNav.H>

Inherits IS3D::AnimObj.

List of all members.

Public Member Functions
	DefaultMouseNav ()
virtual	~DefaultMouseNav ()
void	startEnter (EventRef e)
void	initialClick (EventRef e)
void	checkMovementForPanOrDolly (EventRef e)
void	panMove (EventRef e)
void	dollyMove (EventRef e)
void	rotOn (EventRef e)
void	rotMove (EventRef e)
void	spinDecision (EventRef e)
void	spinningEnter (EventRef e)
void	spinOff (EventRef e)
void	scaleUp (EventRef e)
void	scaleDown (EventRef e)
void	animate ()
Protected Attributes
FsaRef	_fsa
Vector2	_ptrOffset
Vector2	_lastPos
Vector2	_initialClickPos
double	_initialClickTime
bool	_hitGeometry
Vector3	_hitPoint
DrawObjRef	_hitPointIcon
Vector3	_lastIntersectionPt
Sphere	_boundingSphere
double	_lastRotTime
double	_rotAngularVel
Vector3	_rotAxis

---

Detailed Description

This mouse navigation is derived from "Unicam" by Zeleznik et al.

Relevant ConfigVal's:

"DefaultMouseNav_btn" specifies the button event used, set this to something different to use an alternative to the left mouse button.

"DefaultMouseNav_ptr" specifies the 2D event corresponding to mouse movement.

"DefaultMouseNav_ptrOffset" is an offset in IS3D screen coords, if you have a 3D icon attached to the mouse, then the Z calculation for the mouse click will hit that 3D icon rather than the underlying geometry that you usually want it to. This offsets the mouse click location in screen coords so you won't hit the geometry.

Interaction Description:

• Start state: wait for mouse down then transition to PanDollyRotDecision
  • on mouse down, store an intersection point if the click intersected some geometry

• PanDollyRotDecision state:
  • if change in mouseX > threshold goto Pan
  • if change in mouseY > threshold goto Dolly
  • if mouse up, then go to RotWaitForSecondClick
  • if wait for mouse up time limit is reached then goto PanDollyDecision

• PanDollyDecision state:
  • if change in mouseX > threshold goto Pan
  • if change in mouseY > threshold goto Dolly

• Pan state:
  • if geometry was clicked then act like we grabbed the geometry at that point and are dragging it in a plane parallel to the filmplane
  • otherwise, grab the point under the mouse on the filmplane

• Dolly state:
  • vertical mouse movement only controls dollying.
  • if geometry was clicked then dollying is scaled such that moving the mouse to the bottom of the screen would pull that geometry right up to the filmplane no matter how far away it was when it started.
  • otherwise, a constant dolly factor is used to turn vertical mouse movement into translation in and out of the screen.

• Rot state:
  • if we clicked on some geometry do a trackball rotate around the selected 3D point
  • otherwise rotate around the origin of RoomSpace
  • when we exit the state, check our angular velocity - if the mouse is still rotating the model around (angular vel > threshold) then goto Spinning

• Spinning state:
  • continue to rotate the model with the same angular velocity and direction until the mouse is clicked once to stop it.

---

Constructor & Destructor Documentation

IS3D::DefaultMouseNav::DefaultMouseNav

(

)

virtual IS3D::DefaultMouseNav::~DefaultMouseNav

(

)

[virtual]

---

Member Function Documentation

void IS3D::DefaultMouseNav::startEnter

(

EventRef

e

)

void IS3D::DefaultMouseNav::initialClick

(

EventRef

e

)

void IS3D::DefaultMouseNav::checkMovementForPanOrDolly

(

EventRef

e

)

void IS3D::DefaultMouseNav::panMove

(

EventRef

e

)

void IS3D::DefaultMouseNav::dollyMove

(

EventRef

e

)

void IS3D::DefaultMouseNav::rotOn

(

EventRef

e

)

void IS3D::DefaultMouseNav::rotMove

(

EventRef

e

)

void IS3D::DefaultMouseNav::spinDecision

(

EventRef

e

)

void IS3D::DefaultMouseNav::spinningEnter

(

EventRef

e

)

void IS3D::DefaultMouseNav::spinOff

(

EventRef

e

)

void IS3D::DefaultMouseNav::scaleUp

(

EventRef

e

)

void IS3D::DefaultMouseNav::scaleDown

(

EventRef

e

)

void IS3D::DefaultMouseNav::animate

(

)

[virtual]

Implements IS3D::AnimObj.

---

Member Data Documentation

FsaRef IS3D::DefaultMouseNav::_fsa [protected]

Vector2 IS3D::DefaultMouseNav::_ptrOffset [protected]

Vector2 IS3D::DefaultMouseNav::_lastPos [protected]

Vector2 IS3D::DefaultMouseNav::_initialClickPos [protected]

double IS3D::DefaultMouseNav::_initialClickTime [protected]

bool IS3D::DefaultMouseNav::_hitGeometry [protected]

Vector3 IS3D::DefaultMouseNav::_hitPoint [protected]

DrawObjRef IS3D::DefaultMouseNav::_hitPointIcon [protected]

Vector3 IS3D::DefaultMouseNav::_lastIntersectionPt [protected]

Sphere IS3D::DefaultMouseNav::_boundingSphere [protected]

double IS3D::DefaultMouseNav::_lastRotTime [protected]

double IS3D::DefaultMouseNav::_rotAngularVel [protected]

Vector3 IS3D::DefaultMouseNav::_rotAxis [protected]

---

The documentation for this class was generated from the following file:

• DefaultMouseNav.H