OGRE  1.8
Object-Oriented Graphics Rendering Engine
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
OgreSceneNode.h
Go to the documentation of this file.
1 /*
2 -----------------------------------------------------------------------------
3 This source file is part of OGRE
4  (Object-oriented Graphics Rendering Engine)
5 For the latest info, see http://www.ogre3d.org/
6 
7 Copyright (c) 2000-2013 Torus Knot Software Ltd
8 
9 Permission is hereby granted, free of charge, to any person obtaining a copy
10 of this software and associated documentation files (the "Software"), to deal
11 in the Software without restriction, including without limitation the rights
12 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13 copies of the Software, and to permit persons to whom the Software is
14 furnished to do so, subject to the following conditions:
15 
16 The above copyright notice and this permission notice shall be included in
17 all copies or substantial portions of the Software.
18 
19 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
25 THE SOFTWARE.
26 -----------------------------------------------------------------------------
27 */
28 #ifndef _SceneNode_H__
29 #define _SceneNode_H__
30 
31 #include "OgrePrerequisites.h"
32 
33 #include "OgreNode.h"
34 #include "OgreIteratorWrappers.h"
35 #include "OgreAxisAlignedBox.h"
36 #include "OgreHeaderPrefix.h"
37 
38 namespace Ogre {
39 
40  // forward decl
41  struct VisibleObjectsBoundsInfo;
42 
58  class _OgreExport SceneNode : public Node
59  {
60  public:
61  typedef HashMap<String, MovableObject*> ObjectMap;
64 
65  protected:
67 
73 
76 
79 
81  void updateFromParentImpl(void) const;
82 
84  Node* createChildImpl(void);
85 
87  Node* createChildImpl(const String& name);
88 
90  void setParent(Node* parent);
91 
95  virtual void setInSceneGraph(bool inGraph);
96 
98  bool mYawFixed;
101 
110  public:
115  SceneNode(SceneManager* creator);
120  SceneNode(SceneManager* creator, const String& name);
121  ~SceneNode();
122 
128  virtual void attachObject(MovableObject* obj);
129 
132  virtual unsigned short numAttachedObjects(void) const;
133 
138  virtual MovableObject* getAttachedObject(unsigned short index);
139 
143  virtual MovableObject* getAttachedObject(const String& name);
144 
150  virtual MovableObject* detachObject(unsigned short index);
152  virtual void detachObject(MovableObject* obj);
153 
155  virtual MovableObject* detachObject(const String& name);
156 
159  virtual void detachAllObjects(void);
160 
164  virtual bool isInSceneGraph(void) const { return mIsInSceneGraph; }
165 
170  virtual void _notifyRootNode(void) { mIsInSceneGraph = true; }
171 
172 
185  virtual void _update(bool updateChildren, bool parentHasChanged);
186 
189  virtual void _updateBounds(void);
190 
209  virtual void _findVisibleObjects(Camera* cam, RenderQueue* queue,
210  VisibleObjectsBoundsInfo* visibleBounds,
211  bool includeChildren = true, bool displayNodes = false, bool onlyShadowCasters = false);
212 
218  virtual const AxisAlignedBox& _getWorldAABB(void) const;
219 
230  virtual ObjectIterator getAttachedObjectIterator(void);
241  virtual ConstObjectIterator getAttachedObjectIterator(void) const;
242 
248  SceneManager* getCreator(void) const { return mCreator; }
249 
260  virtual void removeAndDestroyChild(const String& name);
261 
272  virtual void removeAndDestroyChild(unsigned short index);
273 
280  virtual void removeAndDestroyAllChildren(void);
281 
286  virtual void showBoundingBox(bool bShow);
287 
293  virtual void hideBoundingBox(bool bHide);
294 
297  virtual void _addBoundingBoxToQueue(RenderQueue* queue);
298 
306  virtual bool getShowBoundingBox() const;
307 
314  virtual SceneNode* createChildSceneNode(
315  const Vector3& translate = Vector3::ZERO,
316  const Quaternion& rotate = Quaternion::IDENTITY );
317 
327  virtual SceneNode* createChildSceneNode(const String& name, const Vector3& translate = Vector3::ZERO, const Quaternion& rotate = Quaternion::IDENTITY);
328 
345  virtual void findLights(LightList& destList, Real radius, uint32 lightMask = 0xFFFFFFFF) const;
346 
361  virtual void setFixedYawAxis( bool useFixed, const Vector3& fixedAxis = Vector3::UNIT_Y );
362 
365  virtual void yaw(const Radian& angle, TransformSpace relativeTo = TS_LOCAL);
376  virtual void setDirection(Real x, Real y, Real z,
377  TransformSpace relativeTo = TS_LOCAL,
378  const Vector3& localDirectionVector = Vector3::NEGATIVE_UNIT_Z);
379 
390  virtual void setDirection(const Vector3& vec, TransformSpace relativeTo = TS_LOCAL,
391  const Vector3& localDirectionVector = Vector3::NEGATIVE_UNIT_Z);
398  virtual void lookAt( const Vector3& targetPoint, TransformSpace relativeTo,
399  const Vector3& localDirectionVector = Vector3::NEGATIVE_UNIT_Z);
418  virtual void setAutoTracking(bool enabled, SceneNode* const target = 0,
419  const Vector3& localDirectionVector = Vector3::NEGATIVE_UNIT_Z,
420  const Vector3& offset = Vector3::ZERO);
422  virtual SceneNode* getAutoTrackTarget(void) { return mAutoTrackTarget; }
424  virtual const Vector3& getAutoTrackOffset(void) { return mAutoTrackOffset; }
426  virtual const Vector3& getAutoTrackLocalDirection(void) { return mAutoTrackLocalDirection; }
428  void _autoTrack(void);
430  SceneNode* getParentSceneNode(void) const;
439  virtual void setVisible(bool visible, bool cascade = true);
447  virtual void flipVisibility(bool cascade = true);
448 
458  virtual void setDebugDisplayEnabled(bool enabled, bool cascade = true);
459 
461  virtual DebugRenderable* getDebugRenderable();
462 
463 
464 
465 
466  };
471 }// namespace
472 
473 #include "OgreHeaderSuffix.h"
474 
475 #endif
A viewpoint from which the scene will be rendered.
Definition: OgreCamera.h:86
virtual const Vector3 & getAutoTrackOffset(void)
Get the auto tracking offset for this node, if the node is auto tracking.
float Real
Software floating point type.
unsigned int uint32
Definition: OgrePlatform.h:270
WireBoundingBox * mWireBoundingBox
Pointer to a Wire Bounding Box for this Node.
Definition: OgreSceneNode.h:69
#define _OgreExport
Definition: OgrePlatform.h:233
ObjectMap mObjectsByName
Definition: OgreSceneNode.h:66
MapIterator< ObjectMap > ObjectIterator
Definition: OgreSceneNode.h:62
Manages the organisation and rendering of a 'scene' i.e.
virtual bool isInSceneGraph(void) const
Determines whether this node is in the scene graph, i.e.
static const Vector3 ZERO
Definition: OgreVector3.h:796
A 3D box aligned with the x/y/z axes.
Vector3 mAutoTrackLocalDirection
Local 'normal' direction vector.
Abstract class defining a movable object in a scene.
Class representing a node in the scene graph.
Definition: OgreSceneNode.h:58
Implementation of a Quaternion, i.e.
Concrete IteratorWrapper for nonconst access to the underlying key-value container.
static const Quaternion IDENTITY
static const Vector3 NEGATIVE_UNIT_Z
Definition: OgreVector3.h:802
bool mShowBoundingBox
Flag that determines if the bounding box of the node should be displayed.
Definition: OgreSceneNode.h:71
virtual const Vector3 & getAutoTrackLocalDirection(void)
Get the auto tracking local direction for this node, if it is auto tracking.
Standard 3-dimensional vector.
Definition: OgreVector3.h:51
Allows the rendering of a wireframe bounding box.
HashMap< String, MovableObject * > ObjectMap
Definition: OgreSceneNode.h:61
SceneNode * mAutoTrackTarget
Auto tracking target.
virtual void _notifyRootNode(void)
Notifies this SceneNode that it is the root scene node.
AxisAlignedBox mWorldAABB
World-Axis aligned bounding box, updated only through _update.
Definition: OgreSceneNode.h:78
ConstMapIterator< ObjectMap > ConstObjectIterator
Definition: OgreSceneNode.h:63
Vector3 mAutoTrackOffset
Tracking offset for fine tuning.
bool mIsInSceneGraph
Is this node a current part of the scene graph?
Wrapper class which indicates a given angle value is in Radians.
Definition: OgreMath.h:46
virtual SceneNode * getAutoTrackTarget(void)
Get the auto tracking target for this node, if any.
Class to manage the scene object rendering queue.
Concrete IteratorWrapper for const access to the underlying key-value container.
static const Vector3 UNIT_Y
Definition: OgreVector3.h:798
_StringBase String
bool mYawFixed
Whether to yaw around a fixed axis.
Definition: OgreSceneNode.h:98
SceneManager * mCreator
SceneManager which created this node.
Definition: OgreSceneNode.h:75
Vector3 mYawFixedAxis
Fixed axis to yaw around.
Structure collecting together information about the visible objects that have been discovered in a sc...
Class representing a general-purpose node an articulated scene graph.
Definition: OgreNode.h:63
SceneManager * getCreator(void) const
Gets the creator of this scene node.