/usr/include/osgEarth/SharedSARepo is in libosgearth-dev 2.7.0+dfsg-2+b3.
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 116 117 118 119 120 121 122 123  | /* -*-c++-*- */
/* osgEarth - Dynamic map generation toolkit for OpenSceneGraph
* Copyright 2015 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_SHARED_SA_REPO_H
#define OSGEARTH_SHARED_SA_REPO_H 1
#include <osgEarth/Common>
#include <osgEarth/ThreadingUtils>
#include <osg/observer_ptr>
#include <list>
namespace osgEarth
{
    /**
     * A thread-safe object sharing container for osg::StateAttribute instances
     * (or anything else implementing the compare() method). The VirtualProgram
     * uses this to share identical Program objects.
     *
     * Note. This object holds observers, so there is no need to deal with
     * releaseGLObjects et al. since it can never be the final owner.
     */
    template<typename T>
    struct SharedSARepo
    {
    private:
        typedef std::list< osg::observer_ptr<T> > SAUniqueSet;
        SAUniqueSet      _set;
        Threading::Mutex _mx;
        bool             _enabled;
    public:
        SharedSARepo() : _enabled(true) { }
        ~SharedSARepo() 
        {
            clear();
        }
        void setEnabled(bool value)
        {
            _enabled = value;
            if ( !_enabled )
            {
                clear();
            }
        }
        bool isEnabled() const
        {
            return _enabled;
        }
        bool share(osg::ref_ptr<T>& out)
        {
            if ( !_enabled )
                return false;
            _mx.lock();
            bool found = false;
            for (typename SAUniqueSet::iterator i = _set.begin(); !found && i != _set.end(); )
            {
                osg::ref_ptr<T> temp;
                if ( i->lock(temp) )
                {
                    if ( temp->compare( *out.get() ) == 0 )
                    {
                        out = temp.get();
                        //OE_DEBUG << LC << "Shared a program; repo size = " << _set.size() << std::endl;
                        found = true;
                    }
                    else
                    {
                        ++i;
                    }
                }
                else 
                {
                    // found an orphaned observer; prune it
                    typename SAUniqueSet::iterator j = i++;
                    _set.erase( j );
                    //OE_DEBUG << LC << "Pruned a program; repo size = " << _set.size() << std::endl;
                }
            }
            if ( !found )
            {
                _set.push_back(out.get());
                //OE_DEBUG << LC << "Added a program; repo size = " << _set.size() << std::endl;
            }
            _mx.unlock();
            return found;
        }
        void clear()
        {
            _mx.lock();
            _set.clear();
            _mx.unlock();
        }
    };
}
#endif // OSGEARTH_SHARED_SA_REPO_H
 |