/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 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 OSGVIEWER_GRAPHICWINDOW #define OSGVIEWER_GRAPHICWINDOW 1 #include #include #include #include #include extern "C" { typedef void (* CGraphicsWindowFunction) (void); } namespace osgViewer { class View; /** Base class for providing Windowing API agnostic access to creating and managing graphics window and events. * Note, the GraphicsWindow is subclassed from osg::GraphicsContext, and to provide an implemention you'll need to implement its * range of pure virtual functions, you'll find these all have naming convention methodNameImplemention(..). * GraphicsWindow adds the event queue on top of the GraphicsContext, thereby adding a mechanism for adapting Windowing events * as well as basics graphics context work, you should wire up custom GraphicsWindowImplementation to push their events through * into the EventQueue. */ class OSGVIEWER_EXPORT GraphicsWindow : public osg::GraphicsContext, public osgGA::GUIActionAdapter { public: GraphicsWindow() { _eventQueue = new osgGA::EventQueue; _eventQueue->setGraphicsContext(this); } virtual bool isSameKindAs(const Object* object) const { return dynamic_cast(object)!=0; } virtual const char* libraryName() const { return "osgViewer"; } virtual const char* className() const { return "GraphicsWindow"; } void setEventQueue(osgGA::EventQueue* eventQueue) { _eventQueue = eventQueue; } osgGA::EventQueue* getEventQueue() { return _eventQueue.get(); } const osgGA::EventQueue* getEventQueue() const { return _eventQueue.get(); } virtual void checkEvents() {} /** Set the window's position and size.*/ void setWindowRectangle(int x, int y, int width, int height) { if (setWindowRectangleImplementation(x ,y ,width, height) && _traits.valid()) { resized(x,y,width,height); } } /** implementation of setWindowRectangle, should be implemented by derived classes */ virtual bool setWindowRectangleImplementation(int /*x*/, int /*y*/, int /*width*/, int /*height*/) { osg::notify(osg::NOTICE)<<"GraphicsWindow::setWindowRectangleImplementation(..) not implemented."<x; y = _traits->y; width = _traits->width; height = _traits->height; } } /** Set Window decoration.*/ void setWindowDecoration(bool flag) { if (setWindowDecorationImplementation(flag) && _traits.valid()) { _traits->windowDecoration = flag; } } /** implementation of setWindowDecoration, should be implemented by derived classes */ virtual bool setWindowDecorationImplementation(bool /*flag*/) { osg::notify(osg::NOTICE)<<"GraphicsWindow::setWindowDecorationImplementation(..) not implemented."<windowDecoration : false; } /** Get focus.*/ virtual void grabFocus() { osg::notify(osg::NOTICE)<<"GraphicsWindow::grabFocus(..) not implemented."<windowName : ""; } /** Switch on/off the cursor.*/ virtual void useCursor(bool cursorOn) { setCursor(cursorOn ? InheritCursor : NoCursor); } /** Set mouse cursor to a specific shape.*/ virtual void setCursor(MouseCursor /*mouseCursor*/) { osg::notify(osg::NOTICE)<<"GraphicsWindow::setCursor(..) not implemented."<vsync : true; } /** Set swap group. */ virtual void setSwapGroup(bool on, GLuint group, GLuint barrier) { osg::notify(osg::NOTICE) << "GraphicsWindow::setSwapGroup(" << on << " " << group << " " << barrier << ") not implemented." << std::endl; } void getSwapGroup(bool& on, GLuint& group, GLuint& barrier) const { on = _traits->swapGroupEnabled; group = _traits->swapGroup; barrier = _traits->swapBarrier; } public: /** Return whether a valid and usable GraphicsContext has been created.*/ virtual bool valid() const { osg::notify(osg::NOTICE)<<"GraphicsWindow::valid() not implemented."< Views; /** Returns the list of views (osgViewer::View) attached to this GraphicsWindow. * Internally, the method walks through all the cameras and collects all the views attached to the cameras.*/ void getViews(Views& views); // Override from GUIActionAdapter virtual void requestRedraw(); // Override from GUIActionAdapter virtual void requestContinuousUpdate(bool /*needed*/=true) {} // Override from GUIActionAdapter virtual void requestWarpPointer(float /*x*/,float /*y*/) {} protected: osg::ref_ptr _eventQueue; }; class GraphicsWindowEmbedded : public GraphicsWindow { public: GraphicsWindowEmbedded(osg::GraphicsContext::Traits* traits=0) { _traits = traits; init(); } GraphicsWindowEmbedded(int x, int y, int width, int height) { _traits = new GraphicsContext::Traits; _traits->x = x; _traits->y = y; _traits->width = width; _traits->height = height; init(); } virtual bool isSameKindAs(const Object* object) const { return dynamic_cast(object)!=0; } virtual const char* libraryName() const { return "osgViewer"; } virtual const char* className() const { return "GraphicsWindowEmbedded"; } void init() { if (valid()) { setState( new osg::State ); getState()->setGraphicsContext(this); if (_traits.valid() && _traits->sharedContext.valid()) { getState()->setContextID( _traits->sharedContext->getState()->getContextID() ); incrementContextIDUsageCount( getState()->getContextID() ); } else { getState()->setContextID( osg::GraphicsContext::createNewContextID() ); } } } // dummy implementations, assume that graphics context is *always* current and valid. virtual bool valid() const { return true; } virtual bool realizeImplementation() { return true; } virtual bool isRealizedImplementation() const { return true; } virtual void closeImplementation() {} virtual bool makeCurrentImplementation() { return true; } virtual bool releaseContextImplementation() { return true; } virtual void swapBuffersImplementation() {} virtual void grabFocus() {} virtual void grabFocusIfPointerInWindow() {} virtual void raiseWindow() {} }; struct GraphicsWindowFunctionProxy { GraphicsWindowFunctionProxy(CGraphicsWindowFunction function) { (function)(); } }; #define USE_GRAPICSWINDOW_IMPLEMENTATION(ext) \ extern "C" void graphicswindow_##ext(void); \ static osgViewer::GraphicsWindowFunctionProxy graphicswindowproxy_##ext(graphicswindow_##ext); #if defined(_WIN32) #define USE_GRAPHICSWINDOW() USE_GRAPICSWINDOW_IMPLEMENTATION(Win32) #elif defined(__APPLE__) #define USE_GRAPHICSWINDOW() USE_GRAPICSWINDOW_IMPLEMENTATION(Carbon) #else #define USE_GRAPHICSWINDOW() USE_GRAPICSWINDOW_IMPLEMENTATION(X11) #endif } #endif