Intoduce new osgWidget::PdfReader and osgWidget::VncClient front ends to osgWidget,

with new pdf plugin and updated vnc plugin that now support these front ends.

Updated osgpdf and osgvnc examples to new these new interfaces.

include/osg/Image

@@ -324,11 +324,11 @@ class OSG_EXPORT Image : public Object
         virtual void update(NodeVisitor* nv) {}
         
 
-        /** method for sending pointer events to images that are acting as front ends to interactive surfaces such as a vnc or browser window.*/
-        virtual void sendPointerEvent(int x, int y, int buttonMask) {}
+        /** method for sending pointer events to images that are acting as front ends to interactive surfaces such as a vnc or browser window.  Return true if handled. */
+        virtual bool sendPointerEvent(int x, int y, int buttonMask) { return false; }
 
-        /** method for sending key events to images that are acting as front ends to interactive surfaces such as a vnc or browser window.*/
-        virtual void sendKeyEvent(int key, bool keyDown) {}
+        /** method for sending key events to images that are acting as front ends to interactive surfaces such as a vnc or browser window.  Return true if handled.*/
+        virtual bool sendKeyEvent(int key, bool keyDown) { return false; }
 
         /** method for passing frame information to the custom Image classes, to be called only when objects associated with imagery are not culled.*/
         virtual void setFrameLastRendered(const osg::FrameStamp* frameStamp) {}

include/osgViewer/ViewerEventHandlers

@@ -373,7 +373,7 @@ public:
         _image(image) {}
 
     META_Object(osgViewer, InteractiveImageHandler);
-
+ 
     virtual bool handle(const osgGA::GUIEventAdapter& ea,osgGA::GUIActionAdapter& aa, osg::Object*, osg::NodeVisitor* nv);
 
     virtual bool cull(osg::NodeVisitor* nv, osg::Drawable* drawable, osg::RenderInfo* renderInfo) const;
@@ -389,6 +389,10 @@ protected:
     bool mousePosition(osgViewer::View* view, osg::NodeVisitor* nv, const osgGA::GUIEventAdapter& ea, int& x, int &y) const;
 
     osg::observer_ptr<osg::Image>  _image;
+    bool    _handleKeyboardEvents;
+    bool    _handledOnKeyboardEvents;
+    bool    _handleMouseEvents;
+    bool    _handledOnMouseEvents;
     
 };
 

include/osgWidget/PdfReader

@@ -0,0 +1,116 @@
+/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2008 Robert Osfield 
+ *
+ * This library is open source and may be redistributed and/or modified under  
+ * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or 
+ * (at your option) any later version.  The full license is in LICENSE file
+ * included with this distribution, and on the openscenegraph.org website.
+ * 
+ * This library 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 
+ * OpenSceneGraph Public License for more details.
+*/
+
+#ifndef OSGWIDGET_PDFREADER
+#define OSGWIDGET_PDFREADER
+
+#include <osg/Image>
+#include <osg/Geode>
+
+#include <osgWidget/Export>
+
+namespace osgWidget {
+
+
+/** Hints structure that can be passed to PdfReader and VncClient classes to help guide them on what geometry to build.*/
+struct GeometryHints
+{
+    enum AspectRatioPolicy
+    {
+        RESIZE_HEIGHT_TO_MAINTAINCE_ASPECT_RATIO,
+        RESIZE_WIDTH_TO_MAINTAINCE_ASPECT_RATIO,
+        IGNORE_DOCUMENT_ASPECT_RATIO,
+    };
+
+    GeometryHints():
+        position(0.0f,0.0f,0.0f),
+        widthVec(1.0f,0.0f,0.0f),
+        heightVec(0.0f,1.0f,0.0f),
+        aspectRatioPolicy(RESIZE_HEIGHT_TO_MAINTAINCE_ASPECT_RATIO) {}
+
+    GeometryHints(const osg::Vec3& pos,
+                  const osg::Vec3& wVec,
+                  const osg::Vec3& hVec, 
+                  AspectRatioPolicy asp=RESIZE_HEIGHT_TO_MAINTAINCE_ASPECT_RATIO):
+        position(pos),
+        widthVec(wVec),
+        heightVec(hVec),
+        aspectRatioPolicy(asp) {}
+
+    osg::Vec3 position;
+    osg::Vec3 widthVec;
+    osg::Vec3 heightVec;
+    AspectRatioPolicy aspectRatioPolicy;
+
+};
+
+/** Pure virtual base class for interfacing with implementation of PDF reader.*/
+class PdfImage : public osg::Image
+{
+    public:
+    
+        PdfImage():_pageNum(0) {}
+    
+        int getPageNum() const { return _pageNum; }
+    
+	virtual int getNumOfPages() = 0;
+        
+        virtual bool page(int pageNum) = 0;
+
+        bool previous()
+        {
+            return page(_pageNum-1);
+        }
+        
+        bool next()
+        { 
+             return page(_pageNum+1);
+        }
+        
+
+    protected:
+    
+        virtual ~PdfImage() {}
+        
+        int _pageNum;
+    
+};
+
+
+/** Convinience class that provides a interactive quad that can be placed directly in the scene.*/
+class OSGWIDGET_EXPORT PdfReader : public osg::Geode
+{
+    public:
+    
+        PdfReader() {}
+
+        PdfReader(const std::string& filename, GeometryHints hints = GeometryHints());
+        
+        bool assign(PdfImage* pdfImage, GeometryHints hints = GeometryHints());
+
+        bool open(const std::string& filename, GeometryHints hints = GeometryHints());
+
+        bool page(int pageNum);
+
+        bool previous();
+        
+        bool next();
+
+    protected:
+    
+        osg::ref_ptr<PdfImage> _pdfImage;
+};
+
+}
+
+#endif

include/osgWidget/VncClient

@@ -0,0 +1,63 @@
+/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2008 Robert Osfield 
+ *
+ * This library is open source and may be redistributed and/or modified under  
+ * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or 
+ * (at your option) any later version.  The full license is in LICENSE file
+ * included with this distribution, and on the openscenegraph.org website.
+ * 
+ * This library 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 
+ * OpenSceneGraph Public License for more details.
+*/
+
+#ifndef OSGWIDGET_VNCCLIENT
+#define OSGWIDGET_VNCCLIENT
+
+#include <osgDB/ReaderWriter>
+
+#include <osgWidget/PdfReader>
+
+namespace osgWidget {
+
+/** Pure virtual base class for VncImage that is sublcassed by vnc plugin to provide the actual implementation.*/
+class VncImage : public osg::Image
+{
+    public:
+    
+        VncImage() {}
+    
+        virtual bool connect(const std::string& hostname) = 0;
+
+        virtual void close() = 0;
+
+    protected:
+    
+        virtual ~VncImage() {}
+    
+};
+
+
+/** Convinience Vnc Client class that provides a interactive quad that can be placed directly in the scene.*/
+class OSGWIDGET_EXPORT VncClient : public osg::Geode
+{
+    public:
+    
+        VncClient() {}
+
+        VncClient(const std::string& hostname, GeometryHints hints = GeometryHints());
+        
+        bool assign(VncImage* vncImage, GeometryHints hints = GeometryHints());
+        
+        bool connect(const std::string& hostname, GeometryHints hints = GeometryHints());
+
+        void close();
+
+    protected:
+    
+        osg::ref_ptr<VncImage> _vncImage;
+};
+
+}
+
+#endif