manolas
/
vcglib
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Added Doxygen documentation.

This commit is contained in:
Paolo Cignoni 2007-07-14 12:43:44 +00:00
parent 787cfbe93f
commit b2e7a9e03b
2 changed files with 1096 additions and 239 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

530
wrap/gui/trackball.h
View File

@ -2,14 +2,13 @@
* VCGLib o o * * VCGLib o o *
* Visual and Computer Graphics Library o o * * Visual and Computer Graphics Library o o *
* _ O _ * * _ O _ *
* Copyright(C) 2004 * Copyright(C) 2004 \/)\/ *
\/)\/ *
* Visual Computing Lab /\/| * * Visual Computing Lab /\/| *
* ISTI - Italian National Research Council | * * ISTI - Italian National Research Council | *
* \ * * \ *
* All rights reserved. * * All rights reserved. *
* * * *
* This program is free software; you can redistribute it and/or modify * * This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by * * it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or * * the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. * * (at your option) any later version. *
@ -25,6 +24,9 @@
History History
$Log: not supported by cvs2svn $ $Log: not supported by cvs2svn $
Revision 1.15 2007/06/13 17:15:08 benedetti
Added one-level undo system and sticky trackmodes.
Revision 1.14 2007/05/15 15:00:47 benedetti Revision 1.14 2007/05/15 15:00:47 benedetti
Moved the drawing code to trackmodes, some other minor changes Moved the drawing code to trackmodes, some other minor changes
@ -72,52 +74,6 @@ Adding copyright.
****************************************************************************/ ****************************************************************************/
/****************************************************************************
Short usage note:
The trackball is a manipulator of an object
Center specify the center of rotation and scaling of the trackball and usually
is set by the program and do not interactively change
Radius specify the radius of the interactive ball shaped icon to specify rotation.
It is in absolute unit but it should be in screen related units like the previoous
one it is not changed during interaction.
When you specify a traslation with the trackball the trackball center remain UNCHANGED,
in other words it means that the object move out of the trackball icon.
Similarly when you apply a scaling the size of the iconshaped ball do not change.
Typical use:
glMatrixMode(GL_PROJECTION);
glLoadIdentity();
gluPerspective(60, float(width())/float(height()), 1, 100);
glMatrixMode(GL_MODELVIEW);
glLoadIdentity();
gluLookAt(0,0,3, 0,0,0, 0,1,0);
trackball.center=Point3f(0, 0, 0);
trackball.radius= 1;
trackball.GetView();
trackball.Apply();
float d=1.0f/mesh.bbox.Diag();
glScale(d);
glTranslate(-mesh.bbox.Center());
mesh->Render();
Note on the typical use:
Perspective and gllookat are choosed to frame the origin centered 1-radius
trackball.
The final scale and translate are just to fit a generic mesh to the 1sized
origin centered where the trackball stays box.
The trackball works also on Orthographic projections
BUT that are not centered around origin (just move it back along the Z)
****************************************************************************/
#ifndef TRACKBALL_H #ifndef TRACKBALL_H
#define TRACKBALL_H #define TRACKBALL_H
@ -130,96 +86,316 @@ BUT that are not centered around origin (just move it back along the Z)
#include <map> #include <map>
namespace vcg { namespace vcg {
/* A trackball stores a transformation called 'track' that effectively rotate the object. /*!
the rotation center, and size are kept in center and radius. @brief The base class for Trackball.
This class is useful for using a Trackball instance in a scene graph,
as a sort of interactive transform.
*/
class Transform {
public:
/*!
@brief The constructor.
Initialize:
- track to the identity transform.
- center to origin 0,0,0.
- radius to unit size.
*/ */
Transform();
/// A trackball stores a transformation called 'track' that effectively rototranslate the object.
Similarityf track;
/// track position in model space.
Point3f center;
/// size of the widget in model space.
float radius;
};
class Transform { /*!
public: @brief Computes the linear interpolation between 2 transforms.
Transform();
Similarityf track;
/// track position in model space. default is 0,0,0
Point3f center;
/// size of the widget in model space.
float radius;
};
Transform interpolate(const Transform &a, const Transform &b, float t); @param a The first transform.
@param b The second transform.
@param t The interpolation value (0: just a, 0.5: middle from a to b, 1: just b).
@return The linear interpolation.
*/
Transform interpolate(const Transform &a, const Transform &b, float t);
class TrackMode; class TrackMode;
class Trackball: public Transform {
public: /*!
@brief The manipulator manager system.
<em>Short usage note:</em>
- Center specify the center of rotation and scaling of the trackball and usually is set by the program and do not interactively change
- Radius specify the radius of the interactive ball shaped icon to specify rotation. It is in absolute unit.
- Like the previous one it is not changed during interaction.
When you specify a translation with the trackball the trackball center remain \b unchanged, in other words it means that the object move out of the trackball icon. Similarly when you apply a scaling the size of the manipulator icon do not change.
Typical use:
<pre>
glMatrixMode(GL_PROJECTION);
glLoadIdentity();
gluPerspective(60, float(width())/float(height()), 1, 100);
glMatrixMode(GL_MODELVIEW);
glLoadIdentity();
gluLookAt(0,0,3, 0,0,0, 0,1,0)
trackball.center=Point3f(0, 0, 0);
trackball.radius= 1;
trackball.GetView();
trackball.Apply(true); //false if you want an invisible trackball
float d=1.0f/mesh.bbox.Diag();
glScale(d);
glTranslate(-mesh.bbox.Center());
mesh->Render();
</pre>
Note on the typical use:
- Perspective and glulookat are choosed to frame the origin centered 1-radius trackball.
- The final scale and translate are just to fit a generic mesh to the 1sized origin centered where the trackball stays box.
- The trackball works also on Orthographic projections \b but that are not centered around origin (just move it back along the Z)
*/
class Trackball: public Transform {
public:
// the drawing code has been moved to the trackmodes // the drawing code has been moved to the trackmodes
// class DrawingHint { // class DrawingHint {
// DrawingHint DH; // DrawingHint DH;
/// The componibile states of the manipulator system.
enum Button { BUTTON_NONE = 0x0000, enum Button { BUTTON_NONE = 0x0000, ///< No mouse button pressed.
BUTTON_LEFT = 0x0001, BUTTON_LEFT = 0x0001, ///< Left mouse button pressed.
BUTTON_MIDDLE = 0x0002, BUTTON_MIDDLE = 0x0002, ///< Middle mouse button pressed.
BUTTON_RIGHT = 0x0004, BUTTON_RIGHT = 0x0004, ///< Right mouse button pressed.
WHEEL = 0x0008, WHEEL = 0x0008, ///< Mouse wheel activated.
KEY_SHIFT = 0x0010, KEY_SHIFT = 0x0010, ///< Shift key pressed.
KEY_CTRL = 0x0020, KEY_CTRL = 0x0020, ///< Ctrl key pressed.
KEY_ALT = 0x0040, KEY_ALT = 0x0040, ///< Alt key pressed.
HANDLE = 0x0080 }; HANDLE = 0x0080 ///< Application-defined state activated.
};
Trackball(); /*!
~Trackball(); @brief The constructor.
void SetIdentity();
void SetPosition(const Point3f &c, int millisec = 0);
void SetScale(const float s) {radius=s;};
void SetTransform(const Transform &transform, int millisec = 0);
void Translate(Point3f tr);
void Scale(const float f);
Initialize the internal state with default values
and call setDefaultMapping().
*/
Trackball();
/*!
@brief The destructor.
//operating @warning The destructor <b>does not</b> deallocate the memory allocated by setDefaultMapping(), because the application can change the modes map. This can lead to small memory leaks, so please explicitally delete any manipulator in the modes map if you are going to repeatly allocate and deallocate Trackball instances.
void GetView(); */
void Apply(bool Draw); ~Trackball();
void Apply (); /*!
void DrawPostApply(); @brief Reset the trackball.
void ApplyInverse();
// DrawIcon() has been moved to trackutils.h
//void DrawIcon();
void Reset();
// DrawCircle (), DrawPlane(), DrawPlaneHandle() has been moved to trackutils.h Equivalent to Reset().
// the drawing code has been moved to the trackmodes */
// void DrawCircle (); void SetIdentity();
// void DrawPlane(); /*!
// void DrawPlaneHandle(); @brief Set the position of the trackball.
//interface @param c The new position of the trackball.
void MouseDown(/*Button*/ int button); @param millisec Currently not in use.
void MouseDown(int x, int y, /*Button*/ int button); */
void MouseMove(int x, int y); void SetPosition(const Point3f &c, int millisec = 0);
void MouseUp(int x, int y, /*Button */ int button); /*!
void MouseWheel(float notch); // it assumes that a notch of 1.0 is a single step of the wheel @brief Currently not in use.
void MouseWheel (float notch, /*Button */ int button);
void ButtonUp(Button button);
void ButtonDown(Button button);
void Undo();
//default sensitivity 1 @param s Currently not in use.
void SetSensitivity(float s); */
void SetScale(const float s) {radius=s;};
/*!
@brief Currently not in use.
//spinning interface @param transform Currently not in use.
void SetSpinnable(bool on); @param millisec Currently not in use.
bool IsSpinnable(); */
void SetSpinning(Quaternionf &spin); void SetTransform(const Transform &transform, int millisec = 0);
void StopSpinning(); /*!
bool IsSpinning(); @brief Apply a translation on the current transformation.
//interfaccia navigation: @param tr The translation vector.
void Back(); */
void Forward(); void Translate(Point3f tr);
void Home(); /*!
void Store(); @brief Apply a scaling on the current transformation.
void HistorySize(int lenght);
@param f The scale factor.
*/
void Scale(const float f);
//operating
/*!
@brief Initialize the camera instance.
*/
void GetView();
/*!
@brief Apply the current transformation on the OpenGL modelview matrix.
@param Draw true if has to call DrawPostApply() after the application.
*/
void Apply(bool Draw);
/*!
@brief Old application of the transformation.
@warning This function does \b not call DrawPostApply() after the application.
*/
void Apply ();
/*!
@brief Draw the current manipulator.
Call the draw function of the current manipulator.
If no manipulator is selected call the draw function of the manipulator associated to inactive_mode.
@warning This function assumes that the OpenGL modelview matrix has been initialized with Apply ().
*/
void DrawPostApply();
/*!
@brief Apply the \b inverse of current transformation on the OpenGL modelview matrix.
*/
void ApplyInverse();
// DrawIcon() has been moved to trackutils.h
//void DrawIcon();
/*!
@brief Reset the transformation and every mapped manipulator.
*/
void Reset();
// DrawCircle (), DrawPlane(), DrawPlaneHandle() has been moved to trackutils.h
// the drawing code has been moved to the trackmodes
// void DrawCircle ();
// void DrawPlane();
// void DrawPlaneHandle();
//interface
/*!
@brief Interface function relative to mouse down event in QT/SDL.
@param button The new state.
*/
void MouseDown(/*Button*/ int button);
/*!
@brief Interface function relative to mouse down event in QT/SDL.
@param x The horizontal coordinate of the mouse pointer.
@param y The vertical coordinate of the mouse pointer.
@param button The new state.
*/
void MouseDown(int x, int y, /*Button*/ int button);
/*!
@brief Interface function relative to mouse down event in QT/SDL.
@param x The horizontal coordinate of the mouse pointer.
@param y The vertical coordinate of the mouse pointer.
*/
void MouseMove(int x, int y);
/*!
@brief Interface function relative to mouse down event in QT/SDL.
@param x The horizontal coordinate of the mouse pointer.
@param y The vertical coordinate of the mouse pointer.
@param button The new state.
*/
void MouseUp(int x, int y, /*Button */ int button);
/*!
@brief Old interface function relative to mouse down event in QT/SDL.
@param notch The mouse wheel notch (1: one forward step, -1: one backward step).
*/
void MouseWheel(float notch);
/*!
@brief Interface function relative to mouse down event in QT/SDL.
@param notch The mouse wheel notch (1: one forward step, -1: one backward step).
@param button The new state.
*/
void MouseWheel (float notch, /*Button */ int button);
/*!
@brief Interface function relative to key down event in QT/SDL.
@param button the new state.
*/
void ButtonUp(Button button);
/*!
@brief Interface function relative to key up event in QT/SDL.
@param button the new state.
*/
void ButtonDown(Button button);
/*!
@brief Undo function for manipulator system.
A call of this function restores the state before last user action.
This function calls %Undo() on every mapped manipulator.
*/
void Undo();
//default sensitivity 1
/*!
@brief Currently not in use.
@param s Currently not in use.
*/
void SetSensitivity(float s);
//spinning interface
/*!
@brief Currently not in use.
@param on Currently not in use.
*/
void SetSpinnable(bool on);
/*!
@brief Currently not in use.
@return A meaningless boolean value.
*/
bool IsSpinnable();
/*!
@brief Currently not in use.
@param spin Currently not in use.
*/
void SetSpinning(Quaternionf &spin);
/*!
@brief Currently not in use.
*/
void StopSpinning();
/*!
@brief Currently not in use.
@return A meaningless boolean value.
*/
bool IsSpinning();
//interfaccia navigation:
/*!
@brief Currently not in use.
*/
void Back();
/*!
@brief Currently not in use.
*/
void Forward();
/*!
@brief Currently not in use.
*/
void Home();
/*!
@brief Currently not in use.
*/
void Store();
/*!
@brief Currently not in use.
*/
void HistorySize(int lenght);
/* //internals // commented out no more used this stuff! /* //internals // commented out no more used this stuff!
enum Action { NONE = 0, enum Action { NONE = 0,
@ -236,48 +412,86 @@ namespace vcg {
TRACK_SCALE = 13 TRACK_SCALE = 13
}; };
*/ */
// loads/stores current status from/to ascii stings // loads/stores current status from/to ascii stings
void ToAscii(char * st); /*!
bool SetFromAscii(char * st); @brief Currently not in use.
//protected:
View<float> camera;
void SetCurrentAction(); @param st Currently not in use.
*/
int current_button; void ToAscii(char * st);
TrackMode *current_mode; /*!
@brief Currently not in use.
// inactive_mode is used to draw the inactive trackball @param st Currently not in use.
// can be assigned, for example, to draw an area or a path @return A meaningless boolean value.
// even when the user is not interacting with it */
TrackMode *inactive_mode; bool SetFromAscii(char * st);
// reset modes to default mapping.
void setDefaultMapping ();
std::map<int, TrackMode *> modes; //protected:
/// The reference for point projection and unprojection from screen space to modelspace.
View<float> camera;
/*!
@brief Prepare Trackball and every mapped TrackMode for an user action.
Similarityf last_track; This function is called automatically when an user action begins.
*/
// undo_track and last_track have different meanings.. void SetCurrentAction();
Similarityf undo_track; /// Current state composition.
int current_button;
Similarityf last_view; /// The selected manipulator.
Point3f last_point; TrackMode *current_mode;
std::vector<Point3f> Hits;
bool dragging;
int button_mask;
Quaternionf spin; /// The inactive manipulator. It is drawed when Trackball is inactive.
bool spinnable; TrackMode *inactive_mode;
bool spinning;
std::list<Transform> history;
int history_size;
friend class TrackMode; /*!
}; @brief Reset modes to default mapping.
Set the default modes mapping.
The default mapping is:
- \b LEFT : SphereMode.
- \b LEFT+CTRL or \b MIDDLE : PanMode.
- \b LEFT+SHIFT or \b WHEEL : ScaleMode.
- \b LEFT+ALT : ZMode.
@warning The memory allocated by this function <b>is not</b> automatically deallocated. see ~Trackball().
*/
void setDefaultMapping ();
/// The manipulator mapping. Needs to be explicitally managed for custom mappings.
std::map<int, TrackMode *> modes;
// undo_track and last_track have different meanings..
/// Transformation before current user action.
Similarityf last_track;
/// track after an Undo() call.
Similarityf undo_track;
/// Currently not in use.
Similarityf last_view;
/// Mouse cursor coordinates before current action.
Point3f last_point;
/// Currently not in use.
std::vector<Point3f> Hits;
/// Currently not in use.
bool dragging;
/// Currently not in use.
int button_mask;
/// Currently not in use.
Quaternionf spin;
/// Currently not in use.
bool spinnable;
/// Currently not in use.
bool spinning;
/// Currently not in use.
std::list<Transform> history;
/// Currently not in use.
int history_size;
/// Manipulators needs full access to this class.
friend class TrackMode;
};
}//namespace }//namespace

805
wrap/gui/trackmode.h
View File

File diff suppressed because it is too large Load Diff