RenderWindowInteractor Class Reference

Gives a RenderWindow the ability to interact with the mouse. More...

#include <renderwindowinteractor.h>

Inheritance diagram for RenderWindowInteractor:

[legend]Collaboration diagram for RenderWindowInteractor:

[legend]List of all members.

Signals
void	ActorRotated (float xf, float yf)
	This signal is emitted, whenever we have rotated an actor.
void	ActorRolled (float angle)
	This signal is emitted, whenever we have rolled an actor Rolling is rotating in the viewplane of the camera.
void	Released (int x, int y)
Public Member Functions
	RenderWindowInteractor (QWidget *parent=0, const char *name=0)
	Constructs a new RenderWindowInteractor with the default settings.
	RenderWindowInteractor (QGLFormat glf, QWidget *parent=0, const char *name=0)
	Constructs a new RenderWindowInteractor with the default settings.
	~RenderWindowInteractor ()
	Destructor of RenderWindowInteractor.
void	SetLeftButtonFunction (const char *function)
	Sets the function, which will be used, when the left mouse button is pressed.
void	SetMiddleButtonFunction (const char *function)
	Sets the function, which will be used, when the middle mouse button is pressed.
void	SetRightButtonFunction (const char *function)
	Sets the function, which will be used, when the right mouse button is pressed.
void	SetShiftLeftButtonFunction (const char *function)
	Sets the function, which will be used, when the left button and the shift key are pressed.
void	SetInteractionActor (vtkActor *actor)
	Sets the actor, which will be used in actor interactions.
void	SetActorRotation (float x, float y, float z)
	Sets the point, in actor coordinate system, around which we rotate the current actor.
void	SetPlane (float *ebene)
	Sets the plane for the actor interaction ActorPlaneMove() and ActorPlaneRoll().
void	SetInteractionTime (int time)
	Set the time in milliseconds between two interactions.
void	SetSensitivity (float t)
	Sets the sensitivity of all interactions.
int	GetInteractionTime (void)
	Get the time in milliseconds between two interactions.
vtkActor *	GetInteractionActor (void)
	Returns the actor, which is used in actor interactions.
float	GetSensitivity ()
	Returns the current sensitivity of all interactions.
const char *	GetClassName ()
	Returns the class name.
Protected Slots
void	ActorRotate ()
	Rotates an actor around a specific point.
void	ActorTranslate ()
	Translates the actor on the viewplane.
void	ActorZoom ()
	Zooms the actor on the normal of the viewplane.
void	ActorRoll ()
	Turns an actor on the viewplane of the camera.
void	ActorPlaneRoll ()
	Rolls the actor.
void	ActorPlaneMove ()
	Moves the actor.
void	CameraRotate ()
	Rotates the camera around the point, which was set with SetCameraRotation().
void	CameraTranslate ()
	Translates the camera along the viewplane.
void	CameraZoom ()
	Zooms the camera along the normal of the viewplane.
void	CameraRoll ()
	Rotates the camera on the viewplane.
void	DoNothing ()
	Does nothing.
Protected Member Functions
void	mousePressEvent (QMouseEvent *event)
	catches the mouse press to react appropriate
void	mouseReleaseEvent (QMouseEvent *event)
	Overriden to catch mouseReleaseEvents and to stop the internal timer.
void	mouseMoveEvent (QMouseEvent *event)
	catches all movements of the mouse
Private Member Functions
void	DisplayToWorld (float x, float y, float z, float *worldPoint)
	Computes the display point defined with x, y and z to world coordinates.
void	WorldToDisplay (float x, float y, float z, float *displayPoint)
	Computes the world point defined with x, y and z to display coordinates.
void	InitRenderWindowInteractor ()
	Initialize the RenderWindowInteractor.
Private Attributes
vtkCellPicker *	cellpicker
vtkCamera *	currentCamera
vtkActor *	interactionActor
vtkActor *	collisionActor
vtkLight *	currentLight
float	viewUp [3]
float	vpNormal [3]
float	rotateY [3]
float	renCenter [3]
float	viewFocus [3]
float	camPos [3]
float	deltaElevation
float	deltaAzimuth
float	normale [3]
float	ebenekonstante
QTimer *	stepTimer
bool	mouseEventActive
bool	firstCall
float	trackballFactor
float	cameraRotation [3]
int	interactionTime
int	currentMousePos [2]
int	lastMousePos [2]
char	leftButtonFunction [200]
char	middleButtonFunction [200]
char	rightButtonFunction [200]
char	shiftLeftButtonFunction [200]

---

Detailed Description

Gives a RenderWindow the ability to interact with the mouse.

This class implements the interaction to the RenderWindow. There is the possibility to set the according function dynamically during run time for each mouse button. There are 2 interaction possibilites: interaction with an actor and interaction with the camera.

The following interaction functions for interacting with the camera are possible:

• CameraRotate : Rotates the camera about the focal point
• CameraTranslate : Translates the camera parallel to the viewplane
• CameraZoom : Translates the camera on the viewplane normal
• CameraRoll : Rotates the camera about the viewplane normal

The following interaction functions for interacting with an actor are possible:

• ActorRotate : Rotates the actor about a specific point
• ActorTranslate : Translates the actor on the viewplane
• ActorZoom : Moves the actor on the viewplane normal
• ActorRoll : Rotates the actor around the viewplane normal
• ActorPlaneRoll : Rotates the actor about a specific plane
• ActorPlaneMove : Moves the actor on a specific plane

Additionally, you can set the speed of an interaction with SetInteractionTime(), you can define the rotation point of actors with SetActorRotation() and you can set the sensitivity of the interaction with SetSensitivity().

Version:

Revision

1.3

Author:

Jan Stifter

Date:

Date

2000/09/14 14:56:10

Based on:

A lot of code is based on the original vtkQGL package, written by Jan Ehrhardt ehrhardt@medinf.mu-luebeck.de.

History:

      $Log: renderwindowinteractor.cpp,v $
      Revision 1.3  2000/09/14 14:56:10  jstifter
      Changes proposed from Kent Vander Velden <graphix@iastate.edu>
      CameraRotate, CameraTranslate, CameraZoom problems fixed (mostly due to
      incorrect clipping)

      Revision 1.2  2000/09/14 13:25:43  jstifter
      Added Support for *parent, *name in the constructors

      Revision 1.1.1.1  2000/08/15 09:36:39  jstifter
      first cvs import

Definition at line 17 of file renderwindowinteractor.h.

---

Constructor & Destructor Documentation

RenderWindowInteractor::RenderWindowInteractor (  QWidget *  parent = 0, const char *  name = 0 )

Constructs a new RenderWindowInteractor with the default settings. The default functions are: LeftButtonFunction : CameraRotate() MiddleButtonFunction : CameraTranslate() RightButtonFunction : CameraZoom() ShiftLeftButtonFunction : CameraRoll() The time between two interactions is set to 50 milliseconds, the sensitvity is set to 10. Parameters: parent  directly passed to constructor of RenderWindow name  directly passed to constructor of RenderWindow Definition at line 79 of file renderwindowinteractor.cpp. References InitRenderWindowInteractor(). : RenderWindow( parent, name ) { this->InitRenderWindowInteractor(); }

Here is the call graph for this function:

RenderWindowInteractor::RenderWindowInteractor (  QGLFormat  glf, QWidget *  parent = 0, const char *  name = 0 )

Constructs a new RenderWindowInteractor with the default settings. The default functions are: LeftButtonFunction : CameraRotate() MiddleButtonFunction : CameraTranslate() RightButtonFunction : CameraZoom() ShiftLeftButtonFunction : CameraRoll() The time between two interactions is set to 50 milliseconds, the sensitvity is set to 10. Parameters: glf  the desired QGLFormat parent  directly passed to constructor of RenderWindow name  directly passed to constructor of RenderWindow Definition at line 100 of file renderwindowinteractor.cpp. References InitRenderWindowInteractor(). : RenderWindow( glf, parent, name ) { this->InitRenderWindowInteractor(); }

Here is the call graph for this function:

RenderWindowInteractor::~RenderWindowInteractor (   )

Destructor of RenderWindowInteractor. Definition at line 111 of file renderwindowinteractor.cpp. References stepTimer. { delete this->stepTimer; }

---

Member Function Documentation

void RenderWindowInteractor::ActorPlaneMove (   )  [protected, slot]

Moves the actor. Moves the actor, which was set with SetInteractionActor() in the plane, which was set with SetPlane(). Definition at line 805 of file renderwindowinteractor.cpp. References currentMousePos, DisplayToWorld(), ebenekonstante, interactionActor, lastMousePos, normale, and WorldToDisplay(). { float *center; float dispCenter[4]; float newP[4]; float oldP[4]; float p0[3],p1[3],t; float tkonstante = (this->normale[0])*(this->normale[0]) + (this->normale[1])*(this->normale[1]) + (this->normale[2])*(this->normale[2]) ; if( (this->currentMousePos[0] == this->lastMousePos[0]) && (this->currentMousePos[1] == this->lastMousePos[1]) ) { return; } center = this->interactionActor->GetCenter(); this->WorldToDisplay( center[0], center[1], center[2], dispCenter ); this->DisplayToWorld( float(this->currentMousePos[0]), float(this->height() - this->currentMousePos[1]), dispCenter[2], newP ); this->DisplayToWorld( float(this->lastMousePos[0]), float(this->height() - this->lastMousePos[1]), dispCenter[2], oldP); oldP[3] = oldP[0]*(this->normale[0]) + oldP[1]*(this->normale[1]) + oldP[2]*(this->normale[2]) ; t = (this->ebenekonstante - oldP[3])/tkonstante; p0[0] = oldP[0] + t*(this->normale[0]); p0[1] = oldP[1] + t*(this->normale[1]); p0[2] = oldP[2] + t*(this->normale[2]); newP[3] = newP[0]*(this->normale[0]) + newP[1]*(this->normale[1]) + newP[2]*(this->normale[2]); t = (this->ebenekonstante - newP[3])/tkonstante; p1[0] = newP[0] + t*(this->normale[0]); p1[1] = newP[1] + t*(this->normale[1]); p1[2] = newP[2] + t*(this->normale[2]); this->interactionActor->AddPosition( p1[0]-p0[0], p1[1]-p0[1], p1[2]-p0[2] ); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::ActorPlaneRoll (   )  [protected, slot]

Rolls the actor. Rolls the actor, which was set with SetInteractionActor() in the plane, which was set with SetPlane(). Definition at line 872 of file renderwindowinteractor.cpp. References currentMousePos, firstCall, RenderWindow::GetRenderer(), interactionActor, lastMousePos, renCenter, and trackballFactor. { float angle; // do nothing if mouse is still on the same pos if( (this->currentMousePos[0] == this->lastMousePos[0]) && (this->currentMousePos[1] == this->lastMousePos[1]) ) { return; } // first time we do some preprocessing if( firstCall ) { this->renCenter[0] = this->GetRenderer()->GetCenter()[0]; this->renCenter[1] = this->GetRenderer()->GetCenter()[1]; this->renCenter[2] = this->GetRenderer()->GetCenter()[2]; firstCall = false; } int diffX1 = this->currentMousePos[0] - int(this->renCenter[0]); int diffY1 = this->currentMousePos[1] - int(this->renCenter[1]); int diffX2 = this->lastMousePos[0] - int(this->renCenter[0]); int diffY2 = this->lastMousePos[1] - int(this->renCenter[1]); double a1 = atan2( double(diffY1), double(diffX1) ); double a2 = atan2( double(diffY2), double(diffX2) ); angle = (a2 - a1) / (2.0 * 3.1415926535) * 360.0 / 10.0 * this->trackballFactor; this->interactionActor->RotateWXYZ( -angle, this->normale[0], this->normale[1], this->normale[2] ); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::ActorRoll (   )  [protected, slot]

Turns an actor on the viewplane of the camera. The actor can be set with SetInteractionActor() Definition at line 579 of file renderwindowinteractor.cpp. References ActorRolled(), currentCamera, currentMousePos, firstCall, RenderWindow::GetRenderer(), interactionActor, lastMousePos, renCenter, and trackballFactor. { float angle; // do nothing if mouse is still on the same pos if( (this->currentMousePos[0] == this->lastMousePos[0]) && (this->currentMousePos[1] == this->lastMousePos[1]) ) { return; } // first time we do some preprocessing if( firstCall ) { this->currentCamera->GetViewPlaneNormal( this->vpNormal ); this->renCenter[0] = this->GetRenderer()->GetCenter()[0]; this->renCenter[1] = this->GetRenderer()->GetCenter()[1]; this->renCenter[2] = this->GetRenderer()->GetCenter()[2]; firstCall = false; } int diffX1 = this->currentMousePos[0] - int(this->renCenter[0]); int diffY1 = this->currentMousePos[1] - int(this->renCenter[1]); int diffX2 = this->lastMousePos[0] - int(this->renCenter[0]); int diffY2 = this->lastMousePos[1] - int(this->renCenter[1]); double a1 = atan2( double(diffY1), double(diffX1) ); double a2 = atan2( double(diffY2), double(diffX2) ); angle = (a2 - a1) / (2.0 * 3.1415926535) * 360.0 / 10.0 * this->trackballFactor; this->interactionActor->RotateWXYZ( angle, this->vpNormal[0], this->vpNormal[1], this->vpNormal[2] ); emit ActorRolled( angle ); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::ActorRolled (  float  angle  )  [signal]

This signal is emitted, whenever we have rolled an actor Rolling is rotating in the viewplane of the camera. Parameters: angle  the angle in degrees around the viewplane-normal of the current camera. Definition at line 136 of file moc_renderwindowinteractor.cpp. Referenced by ActorRoll(). { if ( signalsBlocked() ) return; QConnectionList *clist = receivers( staticMetaObject()->signalOffset() + 1 ); if ( !clist ) return; QUObject o[2]; static_QUType_ptr.set(o+1,&t0); activate_signal( clist, o ); }

void RenderWindowInteractor::ActorRotate (   )  [protected, slot]

Rotates an actor around a specific point. The rotation point can be set with SetActorRotation(), the actor must be set with SetInteractionActor() Definition at line 444 of file renderwindowinteractor.cpp. References ActorRotated(), currentCamera, currentMousePos, deltaAzimuth, deltaElevation, firstCall, RenderWindow::GetRenderer(), RenderWindow::GetRenderWindow(), interactionActor, lastMousePos, and trackballFactor. { float xf; float yf; // do nothing if mouse is still on the same pos if( (this->currentMousePos[0] == this->lastMousePos[0]) && (this->currentMousePos[1] == this->lastMousePos[1]) ) { return; } // basic idea: the change in x of the mouse is used to rotate around the // view-up vector. the change in y of the mouse is used to rotate around the // cross of the viewplane-normal and the view-up vector, // first time we do some preprocessing if( firstCall ) { int *size = this->GetRenderWindow()->GetSize(); float *vp = this->GetRenderer()->GetViewport(); this->deltaAzimuth = -20.0/((vp[2] - vp[0])*size[0]); this->deltaElevation = -20.0/((vp[3] - vp[1])*size[1]); // get the rotation axis: cross of view-up and the normal in the viewplane this->currentCamera->GetViewUp( this->viewUp ); this->currentCamera->GetViewPlaneNormal( this->vpNormal ); vtkMath::Cross( this->vpNormal, this->viewUp, this->rotateY ); this->firstCall = false; } // how much to rotate xf = (this->currentMousePos[0] - this->lastMousePos[0]) * this->trackballFactor * deltaAzimuth * (-1); yf = (this->currentMousePos[1] - this->lastMousePos[1]) * this->trackballFactor * deltaElevation; this->interactionActor->RotateWXYZ( xf, this->viewUp[0], this->viewUp[1], this->viewUp[2] ); this->interactionActor->RotateWXYZ( yf, this->rotateY[0], this->rotateY[1], this->rotateY[2] ); emit ActorRotated( xf, yf ); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::ActorRotated (  float  xf, float  yf )  [signal]

This signal is emitted, whenever we have rotated an actor. Parameters: xf  the angle in degrees around the view-up vector of the current camera. yf  the angle in degrees around the cross of the viewplane-normal and the view-up vector. Definition at line 122 of file moc_renderwindowinteractor.cpp. Referenced by ActorRotate(). { if ( signalsBlocked() ) return; QConnectionList *clist = receivers( staticMetaObject()->signalOffset() + 0 ); if ( !clist ) return; QUObject o[3]; static_QUType_ptr.set(o+1,&t0); static_QUType_ptr.set(o+2,&t1); activate_signal( clist, o ); }

void RenderWindowInteractor::ActorTranslate (   )  [protected, slot]

Translates the actor on the viewplane. The actor must be set with SetInteractionActor() Definition at line 501 of file renderwindowinteractor.cpp. References currentMousePos, DisplayToWorld(), interactionActor, lastMousePos, and WorldToDisplay(). { float *center; float dispCenter[4]; float newP[4]; float oldP[4]; // do nothing if mouse is still on the same pos if( (this->currentMousePos[0] == this->lastMousePos[0]) && (this->currentMousePos[1] == this->lastMousePos[1]) ) { return; } center = this->interactionActor->GetCenter(); this->WorldToDisplay( center[0], center[1], center[2], dispCenter ); this->DisplayToWorld( float(this->currentMousePos[0]), float(this->height() - this->currentMousePos[1]), dispCenter[2], newP ); this->DisplayToWorld( float(this->lastMousePos[0]), float(this->height() - this->lastMousePos[1]), dispCenter[2], oldP); this->interactionActor->AddPosition( newP[0]-oldP[0], newP[1]-oldP[1], newP[2]-oldP[2] ); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::ActorZoom (   )  [protected, slot]

Zooms the actor on the normal of the viewplane. The actor must be set with SetInteractionActor() Definition at line 543 of file renderwindowinteractor.cpp. References currentCamera, currentMousePos, firstCall, interactionActor, lastMousePos, and trackballFactor. { float yf; // do nothing if mouse is still on the same pos if( (this->currentMousePos[0] == this->lastMousePos[0]) && (this->currentMousePos[1] == this->lastMousePos[1]) ) { return; } // first time we do some preprocessing if( firstCall ) { this->currentCamera->GetViewPlaneNormal( this->vpNormal ); firstCall = false; } yf = float(this->lastMousePos[1] - this->currentMousePos[1]) / float(this->height()) * this->trackballFactor * -10.0; this->interactionActor->AddPosition( this->vpNormal[0] * yf, this->vpNormal[1] * yf, this->vpNormal[2] * yf ); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::CameraRoll (   )  [protected, slot]

Rotates the camera on the viewplane. This function corresponds to a roll-operation like in airplanes Definition at line 757 of file renderwindowinteractor.cpp. References currentCamera, currentLight, currentMousePos, firstCall, RenderWindow::GetRenderer(), lastMousePos, renCenter, and trackballFactor. Referenced by InitRenderWindowInteractor(). { float angle; // do nothing if mouse is still on the same pos if( (this->currentMousePos[0] == this->lastMousePos[0]) && (this->currentMousePos[1] == this->lastMousePos[1]) ) { return; } // first time we do some preprocessing if( firstCall ) { this->renCenter[0] = this->GetRenderer()->GetCenter()[0]; this->renCenter[1] = this->GetRenderer()->GetCenter()[1]; this->renCenter[2] = this->GetRenderer()->GetCenter()[2]; firstCall = false; } // calculate the angle in radians and roll the camera int diffX1 = this->currentMousePos[0] - int(this->renCenter[0]); int diffY1 = this->currentMousePos[1] - int(this->renCenter[1]); int diffX2 = this->lastMousePos[0] - int(this->renCenter[0]); int diffY2 = this->lastMousePos[1] - int(this->renCenter[1]); double a1 = atan2( double(diffY1), double(diffX1) ); double a2 = atan2( double(diffY2), double(diffX2) ); angle = (a2 - a1) / (2.0 * 3.1415926535) * 360.0 / 10.0 * this->trackballFactor; this->currentCamera->Roll( angle ); // light follows the camera this->currentLight->SetPosition( this->currentCamera->GetPosition() ); this->currentLight->SetFocalPoint( this->currentCamera->GetFocalPoint() ); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::CameraRotate (   )  [protected, slot]

Rotates the camera around the point, which was set with SetCameraRotation(). Definition at line 625 of file renderwindowinteractor.cpp. References currentCamera, currentLight, currentMousePos, deltaAzimuth, deltaElevation, firstCall, RenderWindow::GetRenderer(), RenderWindow::GetRenderWindow(), lastMousePos, and trackballFactor. Referenced by InitRenderWindowInteractor(). { float xf; float yf; // do nothing if mouse is still on the same pos if( (this->currentMousePos[0] == this->lastMousePos[0]) && (this->currentMousePos[1] == this->lastMousePos[1]) ) { return; } // first time we do some preprocessing if( firstCall ) { int *size = this->GetRenderWindow()->GetSize(); float *vp = this->GetRenderer()->GetViewport(); this->deltaAzimuth = -20.0/((vp[2] - vp[0])*size[0]); this->deltaElevation = -20.0/((vp[3] - vp[1])*size[1]); firstCall = false; } xf = (this->currentMousePos[0] - this->lastMousePos[0]) * this->deltaAzimuth * this->trackballFactor; yf = (this->lastMousePos[1] - this->currentMousePos[1]) * this->deltaElevation * this->trackballFactor; this->currentCamera->Azimuth( xf ); this->currentCamera->Elevation( yf ); this->currentCamera->OrthogonalizeViewUp(); this->GetRenderer()->ResetCameraClippingRange(); // light follows the camera this->currentLight->SetPosition( this->currentCamera->GetPosition() ); this->currentLight->SetFocalPoint( this->currentCamera->GetFocalPoint() ); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::CameraTranslate (   )  [protected, slot]

Translates the camera along the viewplane. Definition at line 671 of file renderwindowinteractor.cpp. References currentCamera, currentLight, currentMousePos, DisplayToWorld(), lastMousePos, trackballFactor, viewFocus, and WorldToDisplay(). Referenced by InitRenderWindowInteractor(). { float newP[4]; float viewFocus[4]; float viewPoint[3]; double motionVector[3]; // do nothing if mouse is still on the same pos if( (this->currentMousePos[0] == this->lastMousePos[0]) && (this->currentMousePos[1] == this->lastMousePos[1]) ) { return; } this->currentCamera->GetFocalPoint( viewFocus ); this->WorldToDisplay( viewFocus[0], viewFocus[1], viewFocus[2], viewFocus ); double focalDepth = viewFocus[2]; this->DisplayToWorld( float(this->width()/2.0 + (this->currentMousePos[0] - this->lastMousePos[0])), float(this->height()/2.0 - (this->currentMousePos[1] - this->lastMousePos[1])), focalDepth, newP ); this->currentCamera->GetFocalPoint( viewFocus ); this->currentCamera->GetPosition( viewPoint ); motionVector[0] = this->trackballFactor / 10.0 * ( viewFocus[0] - newP[0] ); motionVector[1] = this->trackballFactor / 10.0 * ( viewFocus[1] - newP[1] ); motionVector[2] = this->trackballFactor / 10.0 * ( viewFocus[2] - newP[2] ); this->currentCamera->SetFocalPoint( motionVector[0] + viewFocus[0], motionVector[1] + viewFocus[1], motionVector[2] + viewFocus[2]); this->currentCamera->SetPosition( motionVector[0] + viewPoint[0], motionVector[1] + viewPoint[1], motionVector[2] + viewPoint[2]); // light follows the camera this->currentLight->SetPosition( this->currentCamera->GetPosition() ); this->currentLight->SetFocalPoint( this->currentCamera->GetFocalPoint() ); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::CameraZoom (   )  [protected, slot]

Zooms the camera along the normal of the viewplane. Definition at line 726 of file renderwindowinteractor.cpp. References currentCamera, currentMousePos, RenderWindow::GetRenderer(), lastMousePos, and trackballFactor. Referenced by InitRenderWindowInteractor(). { float yf; // do nothing if mouse is still on the same y position if( this->currentMousePos[1] == this->lastMousePos[1] ) { return; } yf = float(this->currentMousePos[1]-this->lastMousePos[1]) / float(this->height()) * this->trackballFactor; // if yf < 0, we need to be between 0..1 yf = pow( 1.1, yf ); this->currentCamera->Dolly( yf ); this->GetRenderer()->ResetCameraClippingRange(); // update this->updateGL(); // save mouse pos this->lastMousePos[0] = this->currentMousePos[0]; this->lastMousePos[1] = this->currentMousePos[1]; }

void RenderWindowInteractor::DisplayToWorld (  float  x, float  y, float  z, float *  worldPoint )  [private]

Computes the display point defined with x, y and z to world coordinates. Parameters: x  x of the display point y  y of the display point z  z of the display point worldPoint  the resulting world point (size 4 floats). Definition at line 930 of file renderwindowinteractor.cpp. References RenderWindow::GetRenderer(). Referenced by ActorPlaneMove(), ActorTranslate(), and CameraTranslate(). { this->GetRenderer()->SetDisplayPoint( x, y, z ); this->GetRenderer()->DisplayToWorld(); this->GetRenderer()->GetWorldPoint( worldPoint ); // normalize if (worldPoint[3]) { worldPoint[0] = worldPoint[0] / worldPoint[3]; worldPoint[1] = worldPoint[1] / worldPoint[3]; worldPoint[2] = worldPoint[2] / worldPoint[3]; worldPoint[3] = 1.0; } }

Here is the call graph for this function:

void RenderWindowInteractor::DoNothing (   )  [protected, slot]

Does nothing. This is needed, when a Button should have no interaction meaning. Definition at line 918 of file renderwindowinteractor.cpp. Referenced by SetLeftButtonFunction(), SetMiddleButtonFunction(), SetRightButtonFunction(), and SetShiftLeftButtonFunction(). { }

const char * RenderWindowInteractor::GetClassName (   )

Returns the class name. Definition at line 151 of file renderwindowinteractor.cpp. { return( "RenderWindowInteractor" ); }

vtkActor * RenderWindowInteractor::GetInteractionActor (  void   )

Returns the actor, which is used in actor interactions. Definition at line 318 of file renderwindowinteractor.cpp. References interactionActor. { return this->interactionActor; }

int RenderWindowInteractor::GetInteractionTime (  void   )

Get the time in milliseconds between two interactions. Definition at line 433 of file renderwindowinteractor.cpp. References interactionTime. { return this->interactionTime; }

float RenderWindowInteractor::GetSensitivity (   )

Returns the current sensitivity of all interactions. See also: SetSensitivity() Definition at line 185 of file renderwindowinteractor.cpp. References trackballFactor. { return this->trackballFactor; }

void RenderWindowInteractor::InitRenderWindowInteractor (   )  [private]

Initialize the RenderWindowInteractor. This function is called from the two constructors Definition at line 121 of file renderwindowinteractor.cpp. References CameraRoll(), CameraRotate(), CameraTranslate(), CameraZoom(), collisionActor, currentCamera, currentLight, RenderWindow::GetRenderer(), interactionActor, mouseEventActive, SetInteractionTime(), SetLeftButtonFunction(), SetMiddleButtonFunction(), SetRightButtonFunction(), SetSensitivity(), SetShiftLeftButtonFunction(), and stepTimer. Referenced by RenderWindowInteractor(). { this->SetLeftButtonFunction( SLOT(CameraRotate()) ); this->SetMiddleButtonFunction( SLOT(CameraTranslate()) ); this->SetRightButtonFunction( SLOT(CameraZoom()) ); this->SetShiftLeftButtonFunction( SLOT(CameraRoll()) ); this->mouseEventActive = false; this->SetInteractionTime( 50 ); this->SetSensitivity( 10.0 ); this->stepTimer = new QTimer(); CHECK_PTR( this->stepTimer ); this->currentCamera = this->GetRenderer()->GetActiveCamera(); CHECK_PTR( this->currentCamera ); // get the light we are using vtkLightCollection *lightCollection = this->GetRenderer()->GetLights(); lightCollection->InitTraversal(); this->currentLight = lightCollection->GetNextItem(); CHECK_PTR( this->currentLight ); this->interactionActor = NULL; this->collisionActor = NULL; }

Here is the call graph for this function:

void RenderWindowInteractor::mouseMoveEvent (  QMouseEvent *  event  )  [protected]

catches all movements of the mouse Overriden to save the mouse coords, which are needed for the interaction routines. Definition at line 410 of file renderwindowinteractor.cpp. References currentMousePos. { this->currentMousePos[0] = event->x(); this->currentMousePos[1] = event->y(); }

void RenderWindowInteractor::mousePressEvent (  QMouseEvent *  event  )  [protected]

catches the mouse press to react appropriate Overriden to catch mousePressEvents and to start an internal timer, which calls the appropriate interaction routine. Definition at line 346 of file renderwindowinteractor.cpp. References currentMousePos, firstCall, lastMousePos, mouseEventActive, and stepTimer. { if( this->mouseEventActive ) { return; } if( event->button() & LeftButton ) { if( event->state() & ShiftButton ) { // left mouse mouse and shift button this->mouseEventActive = true; QObject::connect( this->stepTimer, SIGNAL(timeout()), this->shiftLeftButtonFunction ); } else { // left mouse button without shift button this->mouseEventActive = true; QObject::connect( this->stepTimer, SIGNAL(timeout()), this->leftButtonFunction ); } } else if( event->button() & MidButton ) { // middle mouse button this->mouseEventActive = true; QObject::connect( this->stepTimer, SIGNAL(timeout()), this->middleButtonFunction ); } else if( event->button() & RightButton ) { // right mouse button this->mouseEventActive = true; QObject::connect( this->stepTimer, SIGNAL(timeout()), this, this->rightButtonFunction ); } if( this->mouseEventActive ) { this->currentMousePos[0] = event->x(); this->currentMousePos[1] = event->y(); this->lastMousePos[0] = event->x(); this->lastMousePos[1] = event->y(); this->firstCall = true; this->stepTimer->start( this->interactionTime ); } }

void RenderWindowInteractor::mouseReleaseEvent (  QMouseEvent *  event  )  [protected]

Overriden to catch mouseReleaseEvents and to stop the internal timer. Definition at line 392 of file renderwindowinteractor.cpp. References mouseEventActive, Released(), and stepTimer. { if( this->mouseEventActive ) { this->stepTimer->stop(); this->mouseEventActive = false; QObject::disconnect( this->stepTimer, 0, this, 0 ); } emit( Released(event->x(), this->height() - event->y()) ); }

void RenderWindowInteractor::Released (  int  x, int  y )  [signal]

This signal is emitted, when the interaction is finished. Parameters: x  the x coordinate of the pointer y  the y coordinate of the pointer Definition at line 149 of file moc_renderwindowinteractor.cpp. Referenced by mouseReleaseEvent(). { if ( signalsBlocked() ) return; QConnectionList *clist = receivers( staticMetaObject()->signalOffset() + 2 ); if ( !clist ) return; QUObject o[3]; static_QUType_int.set(o+1,t0); static_QUType_int.set(o+2,t1); activate_signal( clist, o ); }

void RenderWindowInteractor::SetActorRotation (  float  x, float  y, float  z )

Sets the point, in actor coordinate system, around which we rotate the current actor. Important: Set first the actor with SetInteractionActor() before using this function. Parameters: x  x of the rotation point y  y of the rotation point z  z of the rotation point Definition at line 332 of file renderwindowinteractor.cpp. References interactionActor. { ASSERT( this->interactionActor != NULL ); // set it to the interactionActor this->interactionActor->SetOrigin( x, y, z ); }

void RenderWindowInteractor::SetInteractionActor (  vtkActor *  actor  )

Sets the actor, which will be used in actor interactions. Definition at line 310 of file renderwindowinteractor.cpp. References interactionActor. { this->interactionActor = actor; }

void RenderWindowInteractor::SetInteractionTime (  int  time  )

Set the time in milliseconds between two interactions. If you have huge objects and the interaction is too fast for the rendering, set the value bigger. Note that on some systems, the timer of qt (QTimer) can not be faster than the internal clock, which is around 16 msec (measured on WinNT 4.0). Parameters: time  the time in milliseconds Definition at line 426 of file renderwindowinteractor.cpp. References interactionTime. Referenced by InitRenderWindowInteractor(). { this->interactionTime = time; }

void RenderWindowInteractor::SetLeftButtonFunction (  const char *  function  )

Sets the function, which will be used, when the left mouse button is pressed. The function can be: ActorRotate() ActorTranslate() ActorZoom() ActorRoll() ActorPlaneMove() ActorPlaneRoll() CameraRotate() CameraTranslate() CameraZoom() CameraRoll() DoNothing() Parameters: function  the name of the function, wrapped in a slot, e.g. SLOT(CameraRotate()). If function is NULL, DoNothing() will be used. Definition at line 209 of file renderwindowinteractor.cpp. References DoNothing(). Referenced by InitRenderWindowInteractor(). { if( function == NULL ) { strncpy( this->leftButtonFunction, SLOT(DoNothing()), 100 ); } else { strncpy( this->leftButtonFunction, function, 100 ); } }

void RenderWindowInteractor::SetMiddleButtonFunction (  const char *  function  )

Sets the function, which will be used, when the middle mouse button is pressed. The function can be: ActorRotate() ActorTranslate() ActorZoom() ActorRoll() ActorPlaneMove() ActorPlaneRoll() CameraRotate() CameraTranslate() CameraZoom() CameraRoll() DoNothing() Parameters: function  the name of the function, wrapped in a slot, e.g. SLOT(CameraRotate()). If function is NULL, DoNothing() will be used. Definition at line 238 of file renderwindowinteractor.cpp. References DoNothing(). Referenced by InitRenderWindowInteractor(). { if( function == NULL ) { strncpy( this->middleButtonFunction, SLOT(DoNothing()), 100 ); } else { strncpy( this->middleButtonFunction, function, 100 ); } }

void RenderWindowInteractor::SetPlane (  float *  ebene  )

Sets the plane for the actor interaction ActorPlaneMove() and ActorPlaneRoll(). Parameters: ebene  pointer to a float array with the four values, which specifiy a plane (ax+by+cz+d=1). Definition at line 161 of file renderwindowinteractor.cpp. References ebenekonstante, and normale. { this->normale[0] = ebene[0]; this->normale[1] = ebene[1]; this->normale[2] = ebene[2]; this->ebenekonstante = ebene[3]; }

void RenderWindowInteractor::SetRightButtonFunction (  const char *  function  )

Sets the function, which will be used, when the right mouse button is pressed. The function can be: ActorRotate() ActorTranslate() ActorZoom() ActorRoll() ActorPlaneMove() ActorPlaneRoll() CameraRotate() CameraTranslate() CameraZoom() CameraRoll() DoNothing() Parameters: function  the name of the function, wrapped in a slot, e.g. SLOT(CameraRotate()). If function is NULL, DoNothing() will be used. Definition at line 267 of file renderwindowinteractor.cpp. References DoNothing(). Referenced by InitRenderWindowInteractor(). { if( function == NULL ) { strncpy( this->rightButtonFunction, SLOT(DoNothing()), 100 ); } else { strncpy( this->rightButtonFunction, function, 100 ); } }

void RenderWindowInteractor::SetSensitivity (  float  t  )

Sets the sensitivity of all interactions. Parameters: t  the sensitivity, default is 10.0 See also: GetSensitivity() Definition at line 176 of file renderwindowinteractor.cpp. References trackballFactor. Referenced by InitRenderWindowInteractor(). { this->trackballFactor = t; }

void RenderWindowInteractor::SetShiftLeftButtonFunction (  const char *  function  )

Sets the function, which will be used, when the left button and the shift key are pressed. The function can be: ActorRotate() ActorTranslate() ActorZoom() ActorRoll() ActorPlaneMove() ActorPlaneRoll() CameraRotate() CameraTranslate() CameraZoom() CameraRoll() DoNothing() Parameters: function  the name of the function, wrapped in a slot, e.g. SLOT(CameraRotate()). If function is NULL, DoNothing() will be used. Definition at line 296 of file renderwindowinteractor.cpp. References DoNothing(). Referenced by InitRenderWindowInteractor(). { if( function == NULL ) { strncpy( this->shiftLeftButtonFunction, SLOT(DoNothing()), 100 ); } else { strncpy( this->shiftLeftButtonFunction, function, 100 ); } }

void RenderWindowInteractor::WorldToDisplay (  float  x, float  y, float  z, float *  displayPoint )  [private]

Computes the world point defined with x, y and z to display coordinates. Parameters: x  x of the world point y  y of the world point z  z of the world point displayPoint  the resulting display point (size 3 floats). Definition at line 954 of file renderwindowinteractor.cpp. References RenderWindow::GetRenderer(). Referenced by ActorPlaneMove(), ActorTranslate(), and CameraTranslate(). { this->GetRenderer()->SetWorldPoint(x, y, z, 1.0 ); this->GetRenderer()->WorldToDisplay(); this->GetRenderer()->GetDisplayPoint( displayPoint ); }

Here is the call graph for this function:

---

Member Data Documentation

float RenderWindowInteractor::cameraRotation[3] [private]

Definition at line 124 of file renderwindowinteractor.h.

float RenderWindowInteractor::camPos[3] [private]

Definition at line 114 of file renderwindowinteractor.h.

vtkCellPicker* RenderWindowInteractor::cellpicker [private]

Definition at line 102 of file renderwindowinteractor.h.

vtkActor* RenderWindowInteractor::collisionActor [private]

Definition at line 106 of file renderwindowinteractor.h. Referenced by InitRenderWindowInteractor().

vtkCamera* RenderWindowInteractor::currentCamera [private]

Definition at line 104 of file renderwindowinteractor.h. Referenced by ActorRoll(), ActorRotate(), ActorZoom(), CameraRoll(), CameraRotate(), CameraTranslate(), CameraZoom(), and InitRenderWindowInteractor().

vtkLight* RenderWindowInteractor::currentLight [private]

Definition at line 107 of file renderwindowinteractor.h. Referenced by CameraRoll(), CameraRotate(), CameraTranslate(), and InitRenderWindowInteractor().

int RenderWindowInteractor::currentMousePos[2] [private]

Definition at line 126 of file renderwindowinteractor.h. Referenced by ActorPlaneMove(), ActorPlaneRoll(), ActorRoll(), ActorRotate(), ActorTranslate(), ActorZoom(), CameraRoll(), CameraRotate(), CameraTranslate(), CameraZoom(), mouseMoveEvent(), and mousePressEvent().

float RenderWindowInteractor::deltaAzimuth [private]

Definition at line 116 of file renderwindowinteractor.h. Referenced by ActorRotate(), and CameraRotate().

float RenderWindowInteractor::deltaElevation [private]

Definition at line 115 of file renderwindowinteractor.h. Referenced by ActorRotate(), and CameraRotate().

float RenderWindowInteractor::ebenekonstante [private]

Definition at line 118 of file renderwindowinteractor.h. Referenced by ActorPlaneMove(), and SetPlane().

bool RenderWindowInteractor::firstCall [private]

Definition at line 122 of file renderwindowinteractor.h. Referenced by ActorPlaneRoll(), ActorRoll(), ActorRotate(), ActorZoom(), CameraRoll(), CameraRotate(), and mousePressEvent().

vtkActor* RenderWindowInteractor::interactionActor [private]

Definition at line 105 of file renderwindowinteractor.h. Referenced by ActorPlaneMove(), ActorPlaneRoll(), ActorRoll(), ActorRotate(), ActorTranslate(), ActorZoom(), GetInteractionActor(), InitRenderWindowInteractor(), SetActorRotation(), and SetInteractionActor().

int RenderWindowInteractor::interactionTime [private]

Definition at line 125 of file renderwindowinteractor.h. Referenced by GetInteractionTime(), and SetInteractionTime().

int RenderWindowInteractor::lastMousePos[2] [private]

Definition at line 127 of file renderwindowinteractor.h. Referenced by ActorPlaneMove(), ActorPlaneRoll(), ActorRoll(), ActorRotate(), ActorTranslate(), ActorZoom(), CameraRoll(), CameraRotate(), CameraTranslate(), CameraZoom(), and mousePressEvent().

char RenderWindowInteractor::leftButtonFunction[200] [private]

Definition at line 129 of file renderwindowinteractor.h.

char RenderWindowInteractor::middleButtonFunction[200] [private]

Definition at line 130 of file renderwindowinteractor.h.

bool RenderWindowInteractor::mouseEventActive [private]

Definition at line 121 of file renderwindowinteractor.h. Referenced by InitRenderWindowInteractor(), mousePressEvent(), and mouseReleaseEvent().

float RenderWindowInteractor::normale[3] [private]

Definition at line 117 of file renderwindowinteractor.h. Referenced by ActorPlaneMove(), and SetPlane().

float RenderWindowInteractor::renCenter[3] [private]

Definition at line 112 of file renderwindowinteractor.h. Referenced by ActorPlaneRoll(), ActorRoll(), and CameraRoll().

char RenderWindowInteractor::rightButtonFunction[200] [private]

Definition at line 131 of file renderwindowinteractor.h.

float RenderWindowInteractor::rotateY[3] [private]

Definition at line 111 of file renderwindowinteractor.h.

char RenderWindowInteractor::shiftLeftButtonFunction[200] [private]

Definition at line 132 of file renderwindowinteractor.h.

QTimer* RenderWindowInteractor::stepTimer [private]

Definition at line 120 of file renderwindowinteractor.h. Referenced by InitRenderWindowInteractor(), mousePressEvent(), mouseReleaseEvent(), and ~RenderWindowInteractor().

float RenderWindowInteractor::trackballFactor [private]

Definition at line 123 of file renderwindowinteractor.h. Referenced by ActorPlaneRoll(), ActorRoll(), ActorRotate(), ActorZoom(), CameraRoll(), CameraRotate(), CameraTranslate(), CameraZoom(), GetSensitivity(), and SetSensitivity().

float RenderWindowInteractor::viewFocus[3] [private]

Definition at line 113 of file renderwindowinteractor.h. Referenced by CameraTranslate().

float RenderWindowInteractor::viewUp[3] [private]

Definition at line 109 of file renderwindowinteractor.h.

float RenderWindowInteractor::vpNormal[3] [private]

Definition at line 110 of file renderwindowinteractor.h.

---

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

• renderwindowinteractor.h
• moc_renderwindowinteractor.cpp
• renderwindowinteractor.cpp

---