dd996a3289
forcing users to use osgDB::readRef*File() methods. The later is preferable as it closes a potential threading bug when using paging databases in conjunction
with the osgDB::Registry Object Cache. This threading bug occurs when one thread gets an object from the Cache via an osgDB::read*File() call where only
a pointer to the object is passed back, so taking a reference to the object is delayed till it gets reassigned to a ref_ptr<>, but at the same time another
thread calls a flush of the Object Cache deleting this object as it's referenceCount is now zero. Using osgDB::readREf*File() makes sure the a ref_ptr<> is
passed back and the referenceCount never goes to zero.
To ensure the OSG builds when OSG_PROVIDE_READFILE is to OFF the many cases of osgDB::read*File() usage had to be replaced with a ref_ptr<> osgDB::readRef*File()
usage. The avoid this change causing lots of other client code to be rewritten to handle the use of ref_ptr<> in place of C pointer I introduced a serious of
templte methods in various class to adapt ref_ptr<> to the underly C pointer to be passed to old OSG API's, example of this is found in include/osg/Group:
bool addChild(Node* child); // old method which can only be used with a Node*
tempalte<class T> bool addChild(const osg::ref_ptr<T>& child) { return addChild(child.get()); } // adapter template method
These changes together cover 149 modified files, so it's a large submission. This extent of changes are warrent to make use of the Object Cache
and multi-threaded loaded more robust.
git-svn-id: http://svn.openscenegraph.org/osg/OpenSceneGraph/trunk@15164 16af8721-9629-0410-8352-f15c8da7e697
133 lines
4.5 KiB
C++
133 lines
4.5 KiB
C++
/* -*-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_Viewer
|
|
#define OSGVIEWER_Viewer 1
|
|
|
|
#include <osg/ArgumentParser>
|
|
#include <osgGA/EventVisitor>
|
|
#include <osgUtil/UpdateVisitor>
|
|
#include <osgViewer/GraphicsWindow>
|
|
#include <osgViewer/View>
|
|
|
|
|
|
namespace osgViewer {
|
|
|
|
/** Viewer holds a single view on to a single scene.*/
|
|
class OSGVIEWER_EXPORT Viewer : public ViewerBase, public osgViewer::View
|
|
{
|
|
public:
|
|
|
|
Viewer();
|
|
|
|
Viewer(osg::ArgumentParser& arguments);
|
|
|
|
Viewer(const osgViewer::Viewer& viewer, const osg::CopyOp& copyop=osg::CopyOp::SHALLOW_COPY);
|
|
|
|
virtual ~Viewer();
|
|
|
|
META_Object(osgViewer,Viewer);
|
|
|
|
/** Take all the settings, Camera and Slaves from the passed in view(er), leaving it empty. */
|
|
virtual void take(osg::View& rhs);
|
|
|
|
|
|
/** Set the Stats object used to collect various frame related timing and scene graph stats.*/
|
|
virtual void setViewerStats(osg::Stats* stats) { setStats(stats); }
|
|
|
|
/** Get the Viewers Stats object.*/
|
|
virtual osg::Stats* getViewerStats() { return getStats(); }
|
|
|
|
/** Get the Viewers Stats object.*/
|
|
virtual const osg::Stats* getViewerStats() const { return getStats(); }
|
|
|
|
|
|
/** read the viewer configuration from a configuration file.*/
|
|
virtual bool readConfiguration(const std::string& filename);
|
|
|
|
/** Get whether at least of one of this viewers windows are realized.*/
|
|
virtual bool isRealized() const;
|
|
|
|
/** set up windows and associated threads.*/
|
|
virtual void realize();
|
|
|
|
virtual void setStartTick(osg::Timer_t tick);
|
|
void setReferenceTime(double time=0.0);
|
|
|
|
using osgViewer::View::setSceneData;
|
|
|
|
/** Set the sene graph data that viewer with view.*/
|
|
virtual void setSceneData(osg::Node* node);
|
|
|
|
|
|
/** Convenience method for setting up the viewer so it can be used embedded in an external managed window.
|
|
* Returns the GraphicsWindowEmbedded that can be used by applications to pass in events to the viewer. */
|
|
virtual GraphicsWindowEmbedded* setUpViewerAsEmbeddedInWindow(int x, int y, int width, int height);
|
|
|
|
|
|
virtual double elapsedTime();
|
|
|
|
virtual osg::FrameStamp* getViewerFrameStamp() { return getFrameStamp(); }
|
|
|
|
/** Execute a main frame loop.
|
|
* Equivalent to while (!viewer.done()) viewer.frame();
|
|
* Also calls realize() if the viewer is not already realized,
|
|
* and installs trackball manipulator if one is not already assigned.
|
|
*/
|
|
virtual int run();
|
|
|
|
/** check to see if the new frame is required, called by run(..) when FrameScheme is set to ON_DEMAND.*/
|
|
virtual bool checkNeedToDoFrame();
|
|
|
|
/** check to see if events have been received, return true if events are now available.*/
|
|
virtual bool checkEvents();
|
|
|
|
virtual void advance(double simulationTime=USE_REFERENCE_TIME);
|
|
|
|
virtual void eventTraversal();
|
|
|
|
virtual void updateTraversal();
|
|
|
|
virtual void getCameras(Cameras& cameras, bool onlyActive=true);
|
|
|
|
virtual void getContexts(Contexts& contexts, bool onlyValid=true);
|
|
|
|
virtual void getAllThreads(Threads& threads, bool onlyActive=true);
|
|
|
|
virtual void getOperationThreads(OperationThreads& threads, bool onlyActive=true);
|
|
|
|
virtual void getScenes(Scenes& scenes, bool onlyValid=true);
|
|
|
|
virtual void getViews(Views& views, bool onlyValid=true);
|
|
|
|
/** Get the keyboard and mouse usage of this viewer.*/
|
|
virtual void getUsage(osg::ApplicationUsage& usage) const;
|
|
|
|
|
|
protected:
|
|
|
|
void constructorInit();
|
|
|
|
virtual void viewerInit() { init(); }
|
|
|
|
void generateSlavePointerData(osg::Camera* camera, osgGA::GUIEventAdapter& event);
|
|
void generatePointerData(osgGA::GUIEventAdapter& event);
|
|
void reprojectPointerData(osgGA::GUIEventAdapter& source_event, osgGA::GUIEventAdapter& dest_event);
|
|
|
|
};
|
|
|
|
|
|
}
|
|
|
|
#endif
|