/usr/include/osgEarth/StateSetCache is in libosgearth-dev 2.5.0+dfsg-2+b2.
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 2008-2013 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.
*
* This program 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
* GNU Lesser General Public License for more details.
*
* 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_STATE_SET_CACHE_H
#define OSGEARTH_STATE_SET_CACHE_H 1
#include <osgEarth/Common>
#include <osgEarth/ThreadingUtils>
#include <osg/StateSet>
#include <set>
namespace osgEarth
{
    /**
     * Cache for optimizing state set sharing.
     */
    class OSGEARTH_EXPORT StateSetCache : public osg::Referenced
    {
    public:
        /**
         * Constructs a new cache.
         */
        StateSetCache();
        /**
         * Check whether a StateSet is eligible for sharing.
         */
        bool eligible( osg::StateSet* stateSet ) const;
        /**
         * Check whether a StateAttribute is eligible for sharing.
         */
        bool eligible( osg::StateAttribute* attr ) const;
        /**
         * Traverse the node and consolidate equivalent state sets, updating
         * the cache along the way.
         */
        void optimize( osg::Node* node );
        /**
         * Looks in the cache for a stateset matching the input. If found,
         * returns the cached one in output. If not found, stores the input 
         * in the cache and returns the same one in output.
         *
         * Must use ref_ptrs for thread safely
         */
        bool share( 
            osg::ref_ptr<osg::StateSet>& input, 
            osg::ref_ptr<osg::StateSet>& output,
            bool                         checkEligible =true );
        /**
         * Looks in the attribute cache for an attribute matching the input.
         * If found, returns the cached one in output. If not found, stores
         * the input in the cache and returns the same one in output.
         *
         * Must use ref_ptrs for thread safely
         */
        bool share(
            osg::ref_ptr<osg::StateAttribute>& input,
            osg::ref_ptr<osg::StateAttribute>& output,
            bool                               checkEligible =true );
        /**
         * Number of statesets in the cache.
         */
        unsigned size() const { return _stateSetCache.size(); }
        /**
         * Clears out the cache.
         */
        void clear();
    protected: 
        virtual ~StateSetCache();
        struct CompareStateSets {
            bool operator()(
                const osg::ref_ptr<osg::StateSet>& lhs,
                const osg::ref_ptr<osg::StateSet>& rhs) const {
                    return lhs->compare(*(rhs.get()), true) < 0;
            }
        };
        typedef std::set< osg::ref_ptr<osg::StateSet>, CompareStateSets> StateSetSet;
        StateSetSet _stateSetCache;
        struct CompareStateAttributes {
            bool operator()(
                const osg::ref_ptr<osg::StateAttribute>& lhs,
                const osg::ref_ptr<osg::StateAttribute>& rhs) const {
                    return lhs->compare(*rhs.get()) < 0;
            }
        };
        typedef std::set< osg::ref_ptr<osg::StateAttribute>, CompareStateAttributes> StateAttributeSet;
        StateAttributeSet _stateAttributeCache;
        mutable Threading::Mutex _mutex;
        void prune();
        void pruneIfNecessary();
        unsigned _pruneCount;
    };
}
#endif // OSGEARTH_STATE_SET_CACHE_H
 |