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
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
|
/*
* 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 for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software Foundation,
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
* The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
* All rights reserved.
*/
/** \file SG_Spatial.h
* \ingroup bgesg
*/
#ifndef __SG_SPATIAL_H__
#define __SG_SPATIAL_H__
#include <MT_Vector3.h>
#include <MT_Point3.h>
#include <MT_Matrix3x3.h> // or Quaternion later ?
#include "SG_IObject.h"
#include "SG_BBox.h"
#include "SG_ParentRelation.h"
class SG_Node;
class SG_ParentRelation;
/**
* SG_Spatial contains spatial information (local & world position, rotation
* and scaling) for a Scene graph node.
* It also contains a link to the node's parent.
*/
class SG_Spatial : public SG_IObject
{
protected:
MT_Point3 m_localPosition;
MT_Matrix3x3 m_localRotation;
MT_Vector3 m_localScaling;
MT_Point3 m_worldPosition;
MT_Matrix3x3 m_worldRotation;
MT_Vector3 m_worldScaling;
SG_ParentRelation *m_parent_relation;
SG_BBox m_bbox;
MT_Scalar m_radius;
bool m_modified;
bool m_ogldirty; // true if the openGL matrix for this object must be recomputed
public:
inline void ClearModified()
{
m_modified = false;
m_ogldirty = true;
}
inline void SetModified()
{
m_modified = true;
ActivateScheduleUpdateCallback();
}
inline void ClearDirty()
{
m_ogldirty = false;
}
/**
* Define the relationship this node has with it's parent
* node. You should pass an unshared instance of an SG_ParentRelation
* allocated on the heap to this method. Ownership of this
* instance is assumed by this class.
* You may call this function several times in the lifetime
* of a node to change the relationship dynamically.
* You must call this method before the first call to UpdateSpatialData().
* An assertion will be fired at run-time in debug if this is not
* the case.
* The relation is activated only if no controllers of this object
* updated the coordinates of the child.
*/
void
SetParentRelation(
SG_ParentRelation *relation
);
SG_ParentRelation * GetParentRelation()
{
return m_parent_relation;
}
/**
* Apply a translation relative to the current position.
* if local then the translation is assumed to be in the
* local coordinates of this object. If not then the translation
* is assumed to be in global coordinates. In this case
* you must provide a pointer to the parent of this object if it
* exists otherwise if there is no parent set it to NULL
*/
void
RelativeTranslate(
const MT_Vector3& trans,
const SG_Spatial *parent,
bool local
);
void SetLocalPosition(const MT_Point3& trans)
{
m_localPosition = trans;
SetModified();
}
void SetWorldPosition(const MT_Point3& trans)
{
m_worldPosition = trans;
}
void
RelativeRotate(
const MT_Matrix3x3& rot,
bool local
);
void SetLocalOrientation(const MT_Matrix3x3& rot)
{
m_localRotation = rot;
SetModified();
}
// rot is arrange like openGL matrix
void SetLocalOrientation(const float* rot)
{
m_localRotation.setValue(rot);
SetModified();
}
void SetWorldOrientation(const MT_Matrix3x3& rot)
{
m_worldRotation = rot;
}
void RelativeScale(const MT_Vector3& scale)
{
m_localScaling = m_localScaling * scale;
SetModified();
}
void SetLocalScale(const MT_Vector3& scale)
{
m_localScaling = scale;
SetModified();
}
void SetWorldScale(const MT_Vector3& scale)
{
m_worldScaling = scale;
}
const MT_Point3& GetLocalPosition() const
{
return m_localPosition;
}
const MT_Matrix3x3& GetLocalOrientation() const
{
return m_localRotation;
}
const MT_Vector3& GetLocalScale() const
{
return m_localScaling;
}
const MT_Point3& GetWorldPosition() const
{
return m_worldPosition;
}
const MT_Matrix3x3& GetWorldOrientation() const
{
return m_worldRotation;
}
const MT_Vector3& GetWorldScaling() const
{
return m_worldScaling;
}
void SetWorldFromLocalTransform()
{
m_worldPosition= m_localPosition;
m_worldScaling= m_localScaling;
m_worldRotation= m_localRotation;
}
MT_Transform GetWorldTransform() const;
bool ComputeWorldTransforms(const SG_Spatial *parent, bool& parentUpdated)
{
return m_parent_relation->UpdateChildCoordinates(this,parent,parentUpdated);
}
/**
* Bounding box functions.
*/
SG_BBox& BBox()
{
return m_bbox;
}
void SetBBox(SG_BBox& bbox)
{
m_bbox = bbox;
}
bool inside(const MT_Point3 &point) const;
void getBBox(MT_Point3 *box) const;
void getAABBox(MT_Point3 *box) const;
MT_Scalar Radius() const { return m_radius; }
void SetRadius(MT_Scalar radius) { m_radius = radius; }
bool IsModified() { return m_modified; }
bool IsDirty() { return m_ogldirty; }
protected:
friend class SG_Controller;
friend class KX_BoneParentRelation;
friend class KX_VertexParentRelation;
friend class KX_SlowParentRelation;
friend class KX_NormalParentRelation;
/**
* Protected constructor this class is not
* designed for direct instantiation
*/
SG_Spatial(
void* clientobj,
void* clientinfo,
SG_Callbacks& callbacks
);
SG_Spatial(
const SG_Spatial& other
);
virtual ~SG_Spatial();
/**
* Update the world coordinates of this spatial node. This also informs
* any controllers to update this object.
*/
bool
UpdateSpatialData(
const SG_Spatial *parent,
double time,
bool& parentUpdated
);
#ifdef WITH_CXX_GUARDEDALLOC
MEM_CXX_CLASS_ALLOC_FUNCS("GE:SG_Spatial")
#endif
};
#endif /* __SG_SPATIAL_H__ */
|