OpenSceneGraph/include/osgWidget/Browser

/* -*-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_BROWSER
#define OSGWIDGET_BROWSER

#include <osgWidget/PdfReader>

namespace osgWidget {


class BrowserImage;

class OSGWIDGET_EXPORT BrowserManager : public osg::Object
{
    public:
    
        static osg::ref_ptr<BrowserManager>& instance();
        
        virtual void init(const std::string& application);

        void setApplication(const std::string& application) { _application = application; }
        const std::string& getApplication() const { return _application; }

        virtual BrowserImage* createBrowserImage(const std::string& url, int width, int height);
        
    protected:

        BrowserManager();
        BrowserManager(const BrowserManager& rhs, const osg::CopyOp& copyop=osg::CopyOp::SHALLOW_COPY):
            osg::Object(rhs,copyop) {}
            
        virtual ~BrowserManager();
        
        META_Object(osgWidget,BrowserManager)

        std::string _application;
};


/** Pure virtual base class for that provides the browser inteface for integration with 3rd party implementations.
  * Implementation of BrowserImage are provide via the gecko plugin.*/
class BrowserImage : public osg::Image
{
    public:
    
        BrowserImage() {}
    
        virtual void navigateTo(const std::string& url) = 0;

    protected:
    
        virtual ~BrowserImage() {}
    
};


/** Convinience class that provides a interactive quad that can be placed directly in the scene.*/
class OSGWIDGET_EXPORT Browser : public osg::Geode
{
    public:
    
        Browser() {}

        Browser(const std::string& url, const GeometryHints& hints = GeometryHints());
        
        bool assign(BrowserImage* browserImage, const GeometryHints& hints = GeometryHints());

        bool open(const std::string& url, const GeometryHints& hints = GeometryHints());

        void navigateTo(const std::string& url);

    protected:
    
        osg::ref_ptr<BrowserImage> _browserImage;
};

}

#endif