/****************************************************************************
* MeshLab o o *
* A versatile mesh processing toolbox o o *
* _ O _ *
* Copyright(C) 2008 \/)\/ *
* Visual Computing Lab /\/| *
* ISTI - Italian National Research Council | *
* \ *
* All rights reserved. *
* *
* 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 *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
* This program is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
* GNU General Public License (http://www.gnu.org/licenses/gpl.txt) *
* for more details. *
* *
****************************************************************************/
/****************************************************************************
History
$Log: not supported by cvs2svn $
Revision 1.7 2008/03/14 16:54:34 benedetti
Added doxygen documentation
Revision 1.6 2008/03/02 16:44:18 benedetti
moved ActiveCoordinateFrame to its own files
Revision 1.5 2008/02/22 20:04:02 benedetti
many user interface improvements, cleaned up a little
Revision 1.4 2008/02/17 20:52:53 benedetti
some generalization made
Revision 1.3 2008/02/16 14:12:30 benedetti
first version
****************************************************************************/
#ifndef COORDINATEFRAME_H
#define COORDINATEFRAME_H
#include <vcg/math/similarity.h>
#include <vcg/space/color4.h>
#include <QGLWidget>
namespace vcg {
/*!
@brief The CoordinateFrame class.
This class can draw the standard icon for a 3D coordinate frame.
*/
class CoordinateFrame
{
public:
// functions:
/*!
@brief The constructor.
Initialize the CoordinateFrame data.
@param size the distance from the origin to the endpoint of the arrows.
*/
CoordinateFrame(float size);
/*!
@brief The destructor.
The destructor.
*/
virtual ~CoordinateFrame() {}
/*!
@brief Render the coordinate frame.
@param glw the GL widget.
*/
virtual void Render(QGLWidget* glw,QPainter* p = NULL);
// data
/// The color used for the ticks, the ticks values and the head of the arrows.
Color4b basecolor;
/// The color of the X axis and label.
Color4b xcolor;
/// The color of the Y axis and label.
Color4b ycolor;
/// The color of the Z axis and label.
Color4b zcolor;
/// The distance from the origin to the endpoint of the arrows.
float size;
/// The width of the lines.
float linewidth;
/// The font used for the labels and the ticks values.
QFont font;
/// The flag that enables axes rendering.
bool drawaxis;
/// The flag that enables lablels rendering.
bool drawlabels;
/// The flag that enables ticks values rendering.
bool drawvalues;
// useful functions:
static void drawTickedLine(const Point3d &, const Point3d &, float, float,float);
static float calcSlope(const Point3d &, const Point3d &, float, int , double *, double *, GLint *);
static float niceRound(float);
};
/*!
@brief The MovableCoordinateFrame class.
This class extends the coordinate frame with the ability of being programmatically rototranslated.
*/
class MovableCoordinateFrame: public CoordinateFrame
{
public:
/*!
@brief The constructor.
Initialize the MovableCoordinateFrame data.
@param size the distance from the origin to the endpoint of the arrows.
*/
MovableCoordinateFrame(float);
/*!
@brief The destructor.
The destructor.
*/
virtual ~MovableCoordinateFrame(){}
/*!
@brief Render the movable coordinate frame in its position.
@param glw the GL widget.
*/
virtual void Render(QGLWidget* glw);
/*!
@brief Reset the position and/or the rotation of the coordinate frame.
@param reset_position set to true to reset the position.
@param reset_alignment set to true to reset the rotation.
*/
virtual void Reset(bool reset_position,bool reset_alignment);
/*!
@brief Set the position of the coordinate frame.
@param new_position the new position of the coordinate frame.
*/
virtual void SetPosition(const Point3f new_position);
/*!
@brief Set the rotation of the coordinate frame.
@param new_rotation the new rotation of the coordinate frame.
*/
virtual void SetRotation(const Quaternionf rotation);
/*!
@brief Get the position of the coordinate frame.
@return the position of the coordinate frame.
*/
virtual Point3f GetPosition();
/*!
@brief Get the rotation of the coordinate frame.
@return the rotation of the coordinate frame.
*/
virtual Quaternionf GetRotation();
/*!
@brief Computes the transformation matrix relative to the current rototranslation.
@param m is set to the transformation matrix.
*/
virtual void GetTransform(Matrix44f &m);
/*!
@brief Rotates the coordinate frame wrt itself.
@param angle the angle of the rotation, in degrees.
@param axis the axis of the rotation.
*/
virtual void Rot(float angle,const Point3f axis);
/*!
@brief Align the coordinate frame to one or two directions.
If the primary direction of alignment is null this function does nothing, otherwise two rotations are performed: the first rotation aligns the axis named axis_1 to the primary direction of alignment, the second rotation never moves axis_1 away from the primary direction.
If the secondary direction of alignment is not null and is not parallel to the primary direction the axis named axis_2 is rotated as much as possible to be aligned to secondary direction.
If the secondary direction of alignment is null the axis named axis_2 is rotated as much as possible to be realigned to its old direction, if this is impossible the remaining axis is used.
@param primary the primary direction of alignment.
@param secondary the secondary direction of alignment.
@param axis_1 the name of the axis to align to the primary direction, must be a char choosen from 'X', 'Y' and 'Z'
@param axis_2 the name of the axis to align to the secondary direction, must be different from axis_1 and must be a char choosen from 'X', 'Y', 'Z' and ' '; if the char is ' ' the axis is choosen automatically.
*/
virtual void AlignWith(const Point3f primary, const Point3f secondary, const char axis_1, const char axis_2);
protected:
// data:
Point3f position;
Quaternionf rotation;
// functions:
virtual void Move(const Similarityf);
void RotateToAlign(const Point3f, const Point3f);
};
}//namespace
#endif /*COORDINATEFRAME_H*/