/usr/include/osgEarth/SceneGraphCallback is in libosgearth-dev 2.9.0+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 | /* -*-c++-*- */
/* osgEarth - Dynamic map generation toolkit for OpenSceneGraph
* Copyright 2016 Pelican Mapping
* http://osgearth.org
*
* osgEarth is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
* IN THE SOFTWARE.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>
*/
#ifndef OSGEARTH_SCENE_GRAPH_CALLBACK_H
#define OSGEARTH_SCENE_GRAPH_CALLBACK_H 1
#include <osgEarth/Common>
#include <osgEarth/ThreadingUtils>
#include <osg/Node>
#include <osg/PagedLOD>
#include <osg/observer_ptr>
namespace osgEarth
{
/**
* Callback for getting notifications of scene graph events.
* Not all methods may be invoked in all situations. It's up to
* the implementation to call then when it wants.
*/
class SceneGraphCallback : public osg::Referenced
{
public:
// Called before a node is added to the live scene graph,
// possibly from a background pager thread
virtual void onPreMergeNode(osg::Node*) { }
// Called after a node is added to the live scene graph
// in the main/update thread
virtual void onPostMergeNode(osg::Node*) { }
// Called after a node is remoevd from the live scene graph
// in the main/update thread
virtual void onRemoveNode(osg::Node*) { }
};
typedef std::vector<osg::ref_ptr<SceneGraphCallback> > SceneGraphCallbackVector;
/**
* Cotnainer for scene graph callbacks. Typically an object that
* supports scene graph callbacks will host an instance of this
* object and use it register and fire callbacks at the appropriate times.
*/
class OSGEARTH_EXPORT SceneGraphCallbacks : public osg::Referenced
{
public:
//! Add a new callback
virtual void add(SceneGraphCallback* cb);
//! Remove an existing callback
virtual void remove(SceneGraphCallback* cb);
//! Invoke all pre-merge callbacks on the provided node
virtual void firePreMergeNode(osg::Node* node);
//! Invoke all post-merge callbacks on the provided node
virtual void firePostMergeNode(osg::Node* node);
//! Invoke all remove callbacks on the provided node
virtual void fireRemoveNode(osg::Node* node);
private:
SceneGraphCallbackVector _callbacks;
Threading::Mutex _mutex;
};
/**
* Extends the osg::PagedLOD class to invoke SceneGraphCallbacks
* when nodes are added or removed from the live scene graph.
* (Note, this object does not invoke the preMergeNode method.)
*/
class OSGEARTH_EXPORT PagedLODWithSceneGraphCallbacks : public osg::PagedLOD
{
public:
PagedLODWithSceneGraphCallbacks(SceneGraphCallbacks* host);
/**
* Gets the SceneGraphCallbacks.
*/
SceneGraphCallbacks* getSceneGraphCallbacks() const;
/**
* Sets the SceneGraphCallbacks
*/
void setSceneGraphCallbacks(SceneGraphCallbacks* host);
public: // osg::Group
virtual bool addChild(osg::Node* child);
virtual bool insertChild(unsigned index, osg::Node* child);
virtual bool replaceChild(osg::Node* origChild, osg::Node* newChild);
virtual void childRemoved(unsigned pos, unsigned num);
private:
osg::observer_ptr<SceneGraphCallbacks> _host;
};
}
#endif // OSGEARTH_SCENE_GRAPH_CALLBACK_H
|