openscenegraph
NodeTrackerManipulator
Go to the documentation of this file.
1/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield
2 *
3 * This library is open source and may be redistributed and/or modified under
4 * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
5 * (at your option) any later version. The full license is in LICENSE file
6 * included with this distribution, and on the openscenegraph.org website.
7 *
8 * This library is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * OpenSceneGraph Public License for more details.
12*/
13
14#ifndef OSGGA_NODE_TRACKER_MANIPULATOR
15#define OSGGA_NODE_TRACKER_MANIPULATOR 1
16
17#include <osgGA/OrbitManipulator>
18#include <osg/ObserverNodePath>
19
20
21namespace osgGA {
22
23
24class OSGGA_EXPORT NodeTrackerManipulator : public OrbitManipulator
25{
26 typedef OrbitManipulator inherited;
27
28 public:
29
30 NodeTrackerManipulator( int flags = DEFAULT_SETTINGS );
31
32 NodeTrackerManipulator( const NodeTrackerManipulator& om,
33 const osg::CopyOp& copyOp = osg::CopyOp::SHALLOW_COPY );
34
35 META_Object( osgGA, NodeTrackerManipulator );
36
37 void setTrackNodePath(const osg::NodePath& nodePath);
38 void setTrackNodePath(const osg::ObserverNodePath& nodePath) { _trackNodePath = nodePath; }
39 osg::ObserverNodePath& getTrackNodePath() { return _trackNodePath; }
40
41 void setTrackNode(osg::Node* node);
42 osg::Node* getTrackNode() { osg::NodePath nodePath; return _trackNodePath.getNodePath(nodePath) && !nodePath.empty() ? nodePath.back() : 0; }
43 const osg::Node* getTrackNode() const { osg::NodePath nodePath; return _trackNodePath.getNodePath(nodePath) && !nodePath.empty() ? nodePath.back() : 0; }
44
45 enum TrackerMode
46 {
47 /** Track the center of the node's bounding sphere, but not rotations of the node.
48 * For databases which have a CoordinateSystemNode, the orientation is kept relative the coordinate frame if the center of the node.
49 */
50 NODE_CENTER,
51 /** Track the center of the node's bounding sphere, and the azimuth rotation (about the z axis of the current coordinate frame).
52 * For databases which have a CoordinateSystemNode, the orientation is kept relative the coordinate frame if the center of the node.
53 */
54 NODE_CENTER_AND_AZIM,
55 /** Tack the center of the node's bounding sphere, and the all rotations of the node.
56 */
57 NODE_CENTER_AND_ROTATION
58 };
59
60 void setTrackerMode(TrackerMode mode);
61 TrackerMode getTrackerMode() const { return _trackerMode; }
62
63
64 enum RotationMode
65 {
66 /** Use a trackball style manipulation of the view direction w.r.t the tracked orientation.
67 */
68 TRACKBALL,
69 /** Allow the elevation and azimuth angles to be adjust w.r.t the tracked orientation.
70 */
71 ELEVATION_AZIM
72 };
73
74 void setRotationMode(RotationMode mode);
75 RotationMode getRotationMode() const;
76
77
78 virtual void setByMatrix(const osg::Matrixd& matrix);
79 virtual osg::Matrixd getMatrix() const;
80 virtual osg::Matrixd getInverseMatrix() const;
81
82 virtual void setNode(osg::Node*);
83
84 virtual void computeHomePosition();
85
86 protected:
87
88 virtual bool performMovementLeftMouseButton(const double eventTimeDelta, const double dx, const double dy);
89 virtual bool performMovementMiddleMouseButton(const double eventTimeDelta, const double dx, const double dy);
90 virtual bool performMovementRightMouseButton(const double eventTimeDelta, const double dx, const double dy);
91
92 void computeNodeWorldToLocal(osg::Matrixd& worldToLocal) const;
93 void computeNodeLocalToWorld(osg::Matrixd& localToWorld) const;
94
95 void computeNodeCenterAndRotation(osg::Vec3d& center, osg::Quat& rotation) const;
96
97 void computePosition(const osg::Vec3d& eye,const osg::Vec3d& lv,const osg::Vec3d& up);
98
99
100 osg::ObserverNodePath _trackNodePath;
101 TrackerMode _trackerMode;
102
103};
104
105}
106
107#endif /* OSGGA_NODE_TRACKER_MANIPULATOR */