Added keyboard mouse binding usage to the osg::ApplicationUsage and

osgGA::GUIEventHandler and its subclasses.

src/osgGA/AnimationPathManipulator.cpp

@@ -83,6 +83,11 @@ bool AnimationPathManipulator::handle(const osgGA::GUIEventAdapter& ea,osgGA::GU
     return retval;
 }
 
+void AnimationPathManipulator::getUsage(osg::ApplicationUsage& usage) const
+{
+    usage.addKeyboardMouseBinding("AnimationPath: Space","Reset the viewing position to start of animation");
+}
+
 void AnimationPathManipulator::handleFrame( double time )
 {
     osg::AnimationPath::ControlPoint cp;

src/osgGA/DriveManipulator.cpp

@@ -164,7 +164,6 @@ void DriveManipulator::home(const GUIEventAdapter& ea,GUIActionAdapter& us)
     computeLocalDataFromCamera();
 }
 
-
 void DriveManipulator::init(const GUIEventAdapter& ea,GUIActionAdapter& us)
 {
     flushMouseEventStack();
@@ -360,6 +359,15 @@ bool DriveManipulator::handle(const GUIEventAdapter& ea,GUIActionAdapter& us)
     }
 }
 
+void DriveManipulator::getUsage(osg::ApplicationUsage& usage) const
+{
+    usage.addKeyboardMouseBinding("Drive: Space","Reset the viewing position to home");
+    usage.addKeyboardMouseBinding("Drive: +","When in stereo, increase the fusion distance");
+    usage.addKeyboardMouseBinding("Drive: -","When in stereo, reduse the fusion distance");
+    usage.addKeyboardMouseBinding("Drive: q","Use mouse y for controlling speed");
+    usage.addKeyboardMouseBinding("Drive: a","Use mouse middle,right mouse buttons for speed");
+}
+
 
 void DriveManipulator::flushMouseEventStack()
 {

src/osgGA/FlightManipulator.cpp

@@ -175,6 +175,14 @@ bool FlightManipulator::handle(const GUIEventAdapter& ea,GUIActionAdapter& us)
     }
 }
 
+void FlightManipulator::getUsage(osg::ApplicationUsage& usage) const
+{
+    usage.addKeyboardMouseBinding("Flight: Space","Reset the viewing position to home");
+    usage.addKeyboardMouseBinding("Flight: +","When in stereo, increase the fusion distance");
+    usage.addKeyboardMouseBinding("Flight: -","When in stereo, reduse the fusion distance");
+    usage.addKeyboardMouseBinding("Flight: q","Automatically yaw when banked (default)");
+    usage.addKeyboardMouseBinding("Flight: a","No yaw when banked");
+}
 
 void FlightManipulator::flushMouseEventStack()
 {

src/osgGA/GUIEventHandler.cpp

@@ -2,6 +2,16 @@
 
 using namespace osgGA;
 
+void CompositeGUIEventHandler::getUsage(osg::ApplicationUsage& usage) const
+{
+    for (ChildList::const_iterator itr=_children.begin();
+        itr!=_children.end();
+        ++itr)
+    {
+        (*itr)->getUsage(usage);
+    }
+}
+
 bool CompositeGUIEventHandler::handle(const GUIEventAdapter& ea,GUIActionAdapter& aa)
 {
     bool result=false;

src/osgGA/KeySwitchCameraManipulator.cpp

@@ -18,7 +18,7 @@ void KeySwitchCameraManipulator::addCameraManipulator(int key, std::string name,
 void KeySwitchCameraManipulator::addNumberedCameraManipulator(CameraManipulator *cm)
 {
     if(!cm) return;
-    addCameraManipulator('1'+_manips.size(),"camera",cm);
+    addCameraManipulator('1'+_manips.size(),cm->className(),cm);
 }
 
 void KeySwitchCameraManipulator::selectCameraManipulator(unsigned int num)
@@ -61,3 +61,18 @@ bool KeySwitchCameraManipulator::handle(const GUIEventAdapter& ea,GUIActionAdapt
 
     return _current->handle(ea,aa);
 }
+
+void KeySwitchCameraManipulator::getUsage(osg::ApplicationUsage& usage) const
+{
+    for(KeyManipMap::const_iterator itr=_manips.begin();
+        itr!=_manips.end();
+        ++itr)
+    {
+        string key; key += (char)(itr->first);
+        string explanation(std::string("Select '")+itr->second.first+std::string("' camera manipulator"));
+        if (_current==itr->second.second) explanation += " (default)";
+
+        usage.addKeyboardMouseBinding(key,explanation);
+        itr->second.second->getUsage(usage);
+    }
+}

src/osgGA/StateSetManipulator.cpp

@@ -67,6 +67,13 @@ bool StateSetManipulator::handle(const GUIEventAdapter& ea,GUIActionAdapter& aa)
     return false;
 }
 
+void StateSetManipulator::getUsage(osg::ApplicationUsage& usage) const
+{
+    usage.addKeyboardMouseBinding("b","Toggle backface culling");
+    usage.addKeyboardMouseBinding("l","Toggle lighting");
+    usage.addKeyboardMouseBinding("t","Toggle texturing");
+}
+
 void StateSetManipulator::accept(GUIEventHandlerVisitor& gehv)
 {
     gehv.visit(*this);

src/osgGA/TrackballManipulator.cpp

@@ -69,6 +69,14 @@ void TrackballManipulator::init(const GUIEventAdapter& ,GUIActionAdapter& )
     computeLocalDataFromCamera();
 }
 
+
+void TrackballManipulator::getUsage(osg::ApplicationUsage& usage) const
+{
+    usage.addKeyboardMouseBinding("Trackball: Space","Reset the viewing position to home");
+    usage.addKeyboardMouseBinding("Trackball: +","When in stereo, increase the fusion distance");
+    usage.addKeyboardMouseBinding("Trackball: -","When in stereo, reduse the fusion distance");
+}
+
 bool TrackballManipulator::handle(const GUIEventAdapter& ea,GUIActionAdapter& us)
 {
     if(!_camera.get()) return false;