vtkInteractorStyleUnicam Class Reference

#include <vtkInteractorStyleUnicam.h>

Inheritance diagram for vtkInteractorStyleUnicam:

[legend]

Collaboration diagram for vtkInteractorStyleUnicam:

[legend]

List of all members.

Detailed Description

provides Unicam navigation style

UniCam is a camera interactor. Here, just the primary features of the UniCam technique are implemented. UniCam requires just one mouse button and supports context sensitive dollying, panning, and rotation. (In this implementation, it uses the right mouse button, leaving the middle and left available for other functions.) For more information, see the paper at:

ftp://ftp.cs.brown.edu/pub/papers/graphics/research/unicam.pdf

The following is a brief description of the UniCam Camera Controls. You can perform 3 operations on the camera: rotate, pan, and dolly the camera. All operations are reached through the right mouse button & mouse movements.

IMPORTANT: UniCam assumes there is an axis that makes sense as a "up" vector for the world. By default, this axis is defined to be the vector <0,0,1>. You can set it explicitly for the data you are viewing with the 'SetWorldUpVector(..)' method in C++, or similarly in Tcl/Tk (or other interpreted languages).

1. ROTATE:

Position the cursor over the point you wish to rotate around and press and release the left mouse button. A 'focus dot' appears indicating the point that will be the center of rotation. To rotate, press and hold the left mouse button and drag the mouse.. release the button to complete the rotation.

Rotations can be done without placing a focus dot first by moving the mouse cursor to within 10% of the window border & pressing and holding the left button followed by dragging the mouse. The last focus dot position will be re-used.

2. PAN:

Click and hold the left mouse button, and initially move the mouse left or right. The point under the initial pick will pick correlate w/ the mouse tip-- (i.e., direct manipulation).

3. DOLLY (+ PAN):

Click and hold the left mouse button, and initially move the mouse up or down. Moving the mouse down will dolly towards the picked point, and moving the mouse up will dolly away from it. Dollying occurs relative to the picked point which simplifies the task of dollying towards a region of interest. Left and right mouse movements will pan the camera left and right.

Warning:: (NOTE: This implementation of Unicam assumes a perspective camera. It could be modified relatively easily to also support an orthographic projection.)

Definition at line 107 of file vtkInteractorStyleUnicam.h.


Public Types
typedef vtkInteractorStyle	Superclass
Public Member Functions
virtual const char *	GetClassName ()
virtual int	IsA (const char *type)
void	PrintSelf (ostream &os, vtkIndent indent)
void	SetWorldUpVector (double a[3])
void	SetWorldUpVector (double x, double y, double z)
virtual double *	GetWorldUpVector ()
virtual void	GetWorldUpVector (double data[3])
virtual void	OnTimer ()

virtual void	OnMouseMove ()
virtual void	OnLeftButtonDown ()
virtual void	OnLeftButtonUp ()
virtual void	OnLeftButtonMove ()
Static Public Member Functions
static vtkInteractorStyleUnicam *	New ()
static int	IsTypeOf (const char *type)
static vtkInteractorStyleUnicam *	SafeDownCast (vtkObject *o)
Protected Member Functions
	vtkInteractorStyleUnicam ()
virtual	~vtkInteractorStyleUnicam ()
void	ChooseXY (int X, int Y)
void	RotateXY (int X, int Y)
void	DollyXY (int X, int Y)
void	PanXY (int X, int Y)
void	MyTranslateCamera (double v[3])
void	MyRotateCamera (double cx, double cy, double cz, double ax, double ay, double az, double angle)
void	GetRightVandUpV (double p, vtkCamera cam, double rightV, double upV)
void	NormalizeMouseXY (int X, int Y, double NX, double NY)
double	WindowAspect ()
Protected Attributes
vtkWorldPointPicker *	InteractionPicker
int	ButtonDown
double	DTime
double	Dist
double	StartPix [2]
double	LastPos [2]
double	LastPix [2]
double	DownPt [3]
double	Center [3]
double	WorldUpVector [3]
vtkActor *	FocusSphere
int	IsDot
vtkRenderer *	FocusSphereRenderer
int	state

Member Typedef Documentation

typedef vtkInteractorStyle vtkInteractorStyleUnicam::Superclass

Reimplemented from vtkInteractorStyle.

Definition at line 111 of file vtkInteractorStyleUnicam.h.

Constructor & Destructor Documentation

vtkInteractorStyleUnicam::vtkInteractorStyleUnicam ( ) [protected]

virtual vtkInteractorStyleUnicam::~vtkInteractorStyleUnicam ( ) [protected, virtual]

Member Function Documentation

static vtkInteractorStyleUnicam* vtkInteractorStyleUnicam::New ( ) [static]

This class must be supplied with a vtkRenderWindowInteractor wrapper or parent. This class should not normally be instantiated by application programmers.

Reimplemented from vtkInteractorStyle.

virtual const char* vtkInteractorStyleUnicam::GetClassName ( ) [virtual]

Reimplemented from vtkInteractorStyle.

static int vtkInteractorStyleUnicam::IsTypeOf ( const char * name ) [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkInteractorStyle.

virtual int vtkInteractorStyleUnicam::IsA ( const char * name ) [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkInteractorStyle.

static vtkInteractorStyleUnicam* vtkInteractorStyleUnicam::SafeDownCast ( vtkObject * o ) [static]

Reimplemented from vtkInteractorStyle.

void vtkInteractorStyleUnicam::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)			`[virtual]`

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkInteractorStyle.

void vtkInteractorStyleUnicam::SetWorldUpVector ( double a[3] ) [inline]

Definition at line 114 of file vtkInteractorStyleUnicam.h.