OpenSceneGraph/doc/doc++/osgGA/FlightManipulator.html
Robert Osfield ed10594139 Updated docs
2004-08-06 06:53:36 +00:00

336 lines
16 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>class OSGGA_EXPORT osgGA::FlightManipulator</TITLE>
<META NAME="GENERATOR" CONTENT="DOC++ 3.4.6">
</HEAD>
<BODY BGCOLOR="#ffffff">
<H2>class OSGGA_EXPORT <A HREF="#DOC.DOCU">osgGA::FlightManipulator</A></H2></H2><BLOCKQUOTE> FlightManipulator is a MatrixManipulator which provides flight simulator-like updating of the camera position & orientation.</BLOCKQUOTE>
<HR>
<H2>Inheritance:</H2>
<APPLET CODE="ClassGraph.class" WIDTH=600 HEIGHT=125>
<param name=classes value="Mosg::Object,M,CGUIEventHandler,MGUIEventHandler.html,CMatrixManipulator,MMatrixManipulator.html,CFlightManipulator,MFlightManipulator.html">
<param name=before value="M,M,M,M">
<param name=after value="Md_SPSP,Md_SP,Md_,M">
<param name=indent value="0,1,2,3">
<param name=arrowdir value="down">
</APPLET>
<HR>
<DL>
<P><DL>
<DT><H3>Public Classes</H3><DD><DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>enum <B><A HREF="#DOC.2.3.14">YawControlMode</A></B>
</DL></P>
<P><DL>
<DT><H3>Public Methods</H3><DD><DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif> <B><A HREF="#DOC.2.3.1">FlightManipulator</A></B>()
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual const char* <B><A HREF="#DOC.2.3.2">className</A></B>() const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual void <B><A HREF="#DOC.2.3.3">setByMatrix</A></B>(const osg::Matrixd&amp; matrix)
<DD><I>set the position of the matrix manipulator using a 4x4 Matrix</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual void <B><A HREF="#DOC.2.3.4">setByInverseMatrix</A></B>(const osg::Matrixd&amp; matrix)
<DD><I>set the position of the matrix manipulator using a 4x4 Matrix</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual osg::Matrixd <B><A HREF="#DOC.2.3.5">getMatrix</A></B>() const
<DD><I>get the position of the manipulator as 4x4 Matrix</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual osg::Matrixd <B><A HREF="#DOC.2.3.6">getInverseMatrix</A></B>() const
<DD><I>get the position of the manipulator as a inverse matrix of the manipulator, typically used as a model view matrix</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual void <B><A HREF="#DOC.2.3.7">setNode</A></B>(osg::Node*)
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual const osg::Node* <B><A HREF="#DOC.2.3.8">getNode</A></B>() const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual osg::Node* <B><A HREF="#DOC.2.3.9">getNode</A></B>()
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual void <B><A HREF="#DOC.2.3.10">home</A></B>(const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&amp; ea, <!1><A HREF="GUIActionAdapter.html">GUIActionAdapter</A>&amp; us)
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual void <B><A HREF="#DOC.2.3.11">init</A></B>(const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&amp; ea, <!1><A HREF="GUIActionAdapter.html">GUIActionAdapter</A>&amp; us)
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual bool <B><A HREF="#DOC.2.3.12">handle</A></B>(const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&amp; ea, <!1><A HREF="GUIActionAdapter.html">GUIActionAdapter</A>&amp; us)
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual void <B><A HREF="#DOC.2.3.13">getUsage</A></B>(osg::ApplicationUsage&amp; usage) const
<DD><I>Get the keyboard and mouse usage of this manipulator</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>void <B><A HREF="#DOC.2.3.15">setYawControlMode</A></B>(<!1><A HREF="FlightManipulator.html#DOC.2.3.14">YawControlMode</A> ycm)
<DD><I>Configure the Yaw control for the flight model.</I>
</DL></P>
<P><DL>
<DT><H3>Protected Fields</H3><DD><DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>osg::ref_ptr&lt;const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&gt; <B><A HREF="#DOC.2.3.21">_ga_t1</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>osg::ref_ptr&lt;const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&gt; <B><A HREF="#DOC.2.3.22">_ga_t0</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>osg::ref_ptr&lt;osg::Node&gt; <B><A HREF="#DOC.2.3.23">_node</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>double <B><A HREF="#DOC.2.3.24">_modelScale</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>double <B><A HREF="#DOC.2.3.25">_acceleration</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>double <B><A HREF="#DOC.2.3.26">_velocity</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif><!1><A HREF="FlightManipulator.html#DOC.2.3.14">YawControlMode</A> <B><A HREF="#DOC.2.3.27">_yawMode</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>osg::Vec3d <B><A HREF="#DOC.2.3.28">_eye</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>osg::Quat <B><A HREF="#DOC.2.3.29">_rotation</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>double <B><A HREF="#DOC.2.3.30">_distance</A></B>
</DL></P>
<P><DL>
<DT><H3>Protected Methods</H3><DD><DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual <B><A HREF="#DOC.2.3.16">~FlightManipulator</A></B>()
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>void <B><A HREF="#DOC.2.3.17">flushMouseEventStack</A></B>()
<DD><I>Reset the internal GUIEvent stack</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>void <B><A HREF="#DOC.2.3.18">addMouseEvent</A></B>(const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&amp; ea)
<DD><I>Add the current mouse GUIEvent to internal stack</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>void <B><A HREF="#DOC.2.3.19">computePosition</A></B>(const osg::Vec3&amp; eye, const osg::Vec3&amp; lv, const osg::Vec3&amp; up)
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>bool <B><A HREF="#DOC.2.3.20">calcMovement</A></B>()
<DD><I>For the give mouse movement calculate the movement of the camera.</I>
</DL></P>
</DL>
<HR><H3>Inherited from <A HREF="MatrixManipulator.html">MatrixManipulator</A>:</H3>
<DL>
<P><DL>
<DT><H3>Public Classes</H3><DD><DT>
class <B><A HREF="CoordinateFrameCallback.html">CoordinateFrameCallback</A></B>: public osg::Referenced
<DD><I>callback class to use to allow matrix manipulators to querry the application for the local coordinate frame</I>
</DL></P>
<P><DL>
<DT><H3>Public Methods</H3><DD><DT>
<IMG ALT="o" SRC=icon2.gif>virtual void <B>setMinimumDistance</B>(float minimumDistance)
<DT>
<IMG ALT="o" SRC=icon2.gif>float <B>getMinimumDistance</B>() const
<DT>
<IMG ALT="o" SRC=icon2.gif>virtual void <B>setCoordinateFrameCallback</B>(<!1><A HREF="CoordinateFrameCallback.html">CoordinateFrameCallback</A>* cb)
<DT>
<IMG ALT="o" SRC=icon2.gif><!1><A HREF="CoordinateFrameCallback.html">CoordinateFrameCallback</A>* <B>getCoordinateFrameCallback</B>()
<DT>
<IMG ALT="o" SRC=icon2.gif>const <!1><A HREF="CoordinateFrameCallback.html">CoordinateFrameCallback</A>* <B>getCoordinateFrameCallback</B>() const
<DT>
<IMG ALT="o" SRC=icon2.gif>osg::CoordinateFrame <B>getCoordinateFrame</B>(const osg::Vec3d&amp; position) const
<DT>
<IMG ALT="o" SRC=icon2.gif>osg::Vec3d <B>getSideVector</B>(const osg::CoordinateFrame&amp; cf) const
<DT>
<IMG ALT="o" SRC=icon2.gif>osg::Vec3d <B>getFrontVector</B>(const osg::CoordinateFrame&amp; cf) const
<DT>
<IMG ALT="o" SRC=icon2.gif>osg::Vec3d <B>getUpVector</B>(const osg::CoordinateFrame&amp; cf) const
<DT>
<IMG ALT="o" SRC=icon2.gif>virtual osgUtil::SceneView::FusionDistanceMode <B>getFusionDistanceMode</B>() const
<DT>
<IMG ALT="o" SRC=icon2.gif>virtual float <B>getFusionDistanceValue</B>() const
<DT>
<IMG ALT="o" SRC=icon2.gif>virtual void <B>setHomePosition</B>(const osg::Vec3d&amp; eye, const osg::Vec3d&amp; center, const osg::Vec3d&amp; up)
<DT>
<IMG ALT="o" SRC=icon2.gif>virtual void <B>getHomePosition</B>(osg::Vec3d&amp; eye, osg::Vec3d&amp; center, osg::Vec3d&amp; up)
<DT>
<IMG ALT="o" SRC=icon2.gif>virtual void <B>setAutoComputeHomePosition</B>(bool flag)
<DT>
<IMG ALT="o" SRC=icon2.gif>bool <B>getAutoComputeHomePosition</B>() const
<DT>
<IMG ALT="o" SRC=icon2.gif>virtual void <B>computeHomePosition</B>()
<DT>
<IMG ALT="o" SRC=icon2.gif>virtual void <B>accept</B>(<!1><A HREF="GUIEventHandlerVisitor.html">GUIEventHandlerVisitor</A>&amp; v)
</DL></P>
<P><DL>
<DT><H3>Protected Fields</H3><DD><DT>
<IMG ALT="o" SRC=icon2.gif>double <B>_minimumDistance</B>
<DT>
<IMG ALT="o" SRC=icon2.gif>bool <B>_autoComputeHomePosition</B>
<DT>
<IMG ALT="o" SRC=icon2.gif>osg::Vec3d <B>_homeEye</B>
<DT>
<IMG ALT="o" SRC=icon2.gif>osg::Vec3d <B>_homeCenter</B>
<DT>
<IMG ALT="o" SRC=icon2.gif>osg::Vec3d <B>_homeUp</B>
<DT>
<IMG ALT="o" SRC=icon2.gif>osg::ref_ptr&lt;<!1><A HREF="CoordinateFrameCallback.html">CoordinateFrameCallback</A>&gt; <B>_coordinateFrameCallback</B>
</DL></P>
</DL>
<HR><H3>Inherited from <A HREF="GUIEventHandler.html">GUIEventHandler</A>:</H3>
<DL>
<P><DL>
<DT><H3>Public Methods</H3><DD><DT>
<IMG ALT="o" SRC=icon2.gif>META_Object <B>(osgGA, GUIEventHandler) const </B>() const
<DT>
<IMG ALT="o" SRC=icon2.gif>virtual <!1><A HREF="CompositeGUIEventHandler.html">CompositeGUIEventHandler</A>* <B>getComposite</B>()
</DL></P>
</DL>
<A NAME="DOC.DOCU"></A>
<HR>
<H2>Documentation</H2>
<BLOCKQUOTE>
FlightManipulator is a MatrixManipulator which provides flight simulator-like
updating of the camera position & orientation. By default, the left mouse
button accelerates, the right mouse button decelerates, and the middle mouse
button (or left and right simultaneously) stops dead.</BLOCKQUOTE>
<DL>
<A NAME="FlightManipulator"></A>
<A NAME="DOC.2.3.1"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> FlightManipulator()</B></TT>
<DL><DT><DD></DL><P>
<A NAME="className"></A>
<A NAME="DOC.2.3.2"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual const char* className() const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="setByMatrix"></A>
<A NAME="DOC.2.3.3"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual void setByMatrix(const osg::Matrixd&amp; matrix)</B></TT>
<DD>set the position of the matrix manipulator using a 4x4 Matrix
<DL><DT><DD></DL><P>
<A NAME="setByInverseMatrix"></A>
<A NAME="DOC.2.3.4"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual void setByInverseMatrix(const osg::Matrixd&amp; matrix)</B></TT>
<DD>set the position of the matrix manipulator using a 4x4 Matrix
<DL><DT><DD></DL><P>
<A NAME="getMatrix"></A>
<A NAME="DOC.2.3.5"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual osg::Matrixd getMatrix() const </B></TT>
<DD>get the position of the manipulator as 4x4 Matrix
<DL><DT><DD></DL><P>
<A NAME="getInverseMatrix"></A>
<A NAME="DOC.2.3.6"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual osg::Matrixd getInverseMatrix() const </B></TT>
<DD>get the position of the manipulator as a inverse matrix of the manipulator, typically used as a model view matrix
<DL><DT><DD></DL><P>
<A NAME="setNode"></A>
<A NAME="DOC.2.3.7"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual void setNode(osg::Node*)</B></TT>
<DL><DT><DD></DL><P>
<A NAME="getNode"></A>
<A NAME="DOC.2.3.8"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual const osg::Node* getNode() const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="getNode"></A>
<A NAME="DOC.2.3.9"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual osg::Node* getNode()</B></TT>
<DL><DT><DD></DL><P>
<A NAME="home"></A>
<A NAME="DOC.2.3.10"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual void home(const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&amp; ea, <!1><A HREF="GUIActionAdapter.html">GUIActionAdapter</A>&amp; us)</B></TT>
<DL><DT><DD></DL><P>
<A NAME="init"></A>
<A NAME="DOC.2.3.11"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual void init(const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&amp; ea, <!1><A HREF="GUIActionAdapter.html">GUIActionAdapter</A>&amp; us)</B></TT>
<DL><DT><DD></DL><P>
<A NAME="handle"></A>
<A NAME="DOC.2.3.12"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual bool handle(const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&amp; ea, <!1><A HREF="GUIActionAdapter.html">GUIActionAdapter</A>&amp; us)</B></TT>
<DL><DT><DD></DL><P>
<A NAME="getUsage"></A>
<A NAME="DOC.2.3.13"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual void getUsage(osg::ApplicationUsage&amp; usage) const </B></TT>
<DD>Get the keyboard and mouse usage of this manipulator
<DL><DT><DD></DL><P>
<A NAME="YawControlMode"></A>
<A NAME="DOC.2.3.14"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>enum YawControlMode</B></TT>
<DL><DT><DD></DL><P><DL>
<A NAME="YAW_AUTOMATICALLY_WHEN_BANKED"></A>
<A NAME="DOC.2.3.14.1"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> YAW_AUTOMATICALLY_WHEN_BANKED</B></TT>
<DL><DT><DD></DL><P>
<A NAME="NO_AUTOMATIC_YAW"></A>
<A NAME="DOC.2.3.14.2"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> NO_AUTOMATIC_YAW</B></TT>
<DL><DT><DD></DL><P></DL>
<A NAME="setYawControlMode"></A>
<A NAME="DOC.2.3.15"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>void setYawControlMode(<!1><A HREF="FlightManipulator.html#DOC.2.3.14">YawControlMode</A> ycm)</B></TT>
<DD>Configure the Yaw control for the flight model.
<DL><DT><DD></DL><P>
<A NAME="~FlightManipulator"></A>
<A NAME="DOC.2.3.16"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual ~FlightManipulator()</B></TT>
<DL><DT><DD></DL><P>
<A NAME="flushMouseEventStack"></A>
<A NAME="DOC.2.3.17"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>void flushMouseEventStack()</B></TT>
<DD>Reset the internal GUIEvent stack
<DL><DT><DD></DL><P>
<A NAME="addMouseEvent"></A>
<A NAME="DOC.2.3.18"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>void addMouseEvent(const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&amp; ea)</B></TT>
<DD>Add the current mouse GUIEvent to internal stack
<DL><DT><DD></DL><P>
<A NAME="computePosition"></A>
<A NAME="DOC.2.3.19"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>void computePosition(const osg::Vec3&amp; eye, const osg::Vec3&amp; lv, const osg::Vec3&amp; up)</B></TT>
<DL><DT><DD></DL><P>
<A NAME="calcMovement"></A>
<A NAME="DOC.2.3.20"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>bool calcMovement()</B></TT>
<DD>For the give mouse movement calculate the movement of the camera.
Return true is camera has moved and a redraw is required.
<DL><DT><DD></DL><P>
<A NAME="_ga_t1"></A>
<A NAME="DOC.2.3.21"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>osg::ref_ptr&lt;const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&gt; _ga_t1</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_ga_t0"></A>
<A NAME="DOC.2.3.22"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>osg::ref_ptr&lt;const <!1><A HREF="GUIEventAdapter.html">GUIEventAdapter</A>&gt; _ga_t0</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_node"></A>
<A NAME="DOC.2.3.23"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>osg::ref_ptr&lt;osg::Node&gt; _node</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_modelScale"></A>
<A NAME="DOC.2.3.24"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>double _modelScale</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_acceleration"></A>
<A NAME="DOC.2.3.25"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>double _acceleration</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_velocity"></A>
<A NAME="DOC.2.3.26"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>double _velocity</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_yawMode"></A>
<A NAME="DOC.2.3.27"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B><!1><A HREF="FlightManipulator.html#DOC.2.3.14">YawControlMode</A> _yawMode</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_eye"></A>
<A NAME="DOC.2.3.28"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>osg::Vec3d _eye</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_rotation"></A>
<A NAME="DOC.2.3.29"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>osg::Quat _rotation</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_distance"></A>
<A NAME="DOC.2.3.30"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>double _distance</B></TT>
<DL><DT><DD></DL><P></DL>
<HR><DL><DT><B>This class has no child classes.</B></DL>
<DL><DT><DD></DL><P><P><I><A HREF="index.html">Alphabetic index</A></I> <I><A HREF="HIER.html">HTML hierarchy of classes</A> or <A HREF="HIERjava.html">Java</A></I></P><HR>
<BR>
This page was generated with the help of <A HREF="http://www.linuxsupportline.com/~doc++">DOC++</A>.
</BODY>
</HTML>