1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
|
/****************************************************************************
* 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,QPainter* p = NULL);
/*!
@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*/
|
