This file is indexed.

/usr/include/osgEarthSymbology/ResourceLibrary is in libosgearth-dev 2.5.0+dfsg-8build1.

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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
/* -*-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 OSGEARTHSYMBOLOGY_RESOURCE_LIBRARY_H
#define OSGEARTHSYMBOLOGY_RESOURCE_LIBRARY_H 1

#include <osgEarthSymbology/Common>
#include <osgEarthSymbology/Skins>
#include <osgEarthSymbology/MarkerResource>
#include <osgEarthSymbology/InstanceResource>
#include <osgEarth/ThreadingUtils>
#include <osgEarth/Random>
#include <map>

namespace osgEarth { namespace Symbology
{
    template<typename T> struct ResourceMap : public std::map<std::string, osg::ref_ptr<T> > { };

    /** 
     * ResourceLibrary manages a collection of external resources that a
     * build system can use the construct geometries.
     *
     * TODO: This class PROBABLY NEEDS the ability to share a mutex with
     * whatever session is using it... like in osgGIS...
     */
    class OSGEARTHSYMBOLOGY_EXPORT ResourceLibrary : public osg::Referenced
    {
    public:
        /**
         * Creates a new resource library with a source URI. The library
         * will populate upon first use..
         */
        ResourceLibrary( 
            const std::string& name, 
            const URI&         uri);

        /**
         * Creates a new resource library from a config.
         */
        ResourceLibrary( const Config& conf );


        /** dtor */
        virtual ~ResourceLibrary() { }

        /**
         * Gets the name of the lib.
         */
        const std::string& getName() const { return _name; }

        /**
         * Adds a resoure to the library.
         */
        void addResource( Resource* resource );

        /**
         * Removes a resource from the library.
         */
        void removeResource( Resource* resource );


    public: // Skin resource functions

        /**
         * Finds and returns a Skin resource by name.
         */
        SkinResource* getSkin( const std::string& name, const osgDB::Options* dbOptions =0L ) const;

        /**
         * Returns a list of all Skin resources.
         */
        void getSkins( SkinResourceVector& output, const osgDB::Options* dbOptions =0L ) const;

        /**
         * Returns a list of all Skin resources that match the criteria specified
         * in the symbol.
         */
        void getSkins( const SkinSymbol* symbol, SkinResourceVector& output, const osgDB::Options* dbOptions =0L ) const;

        /**
         * Returns a skin that matches the criteria specified in the symbol. The method
         * will randomly select a suitable skin if there are more than one match. If the
         * symbol contains a random seed, it will use that to seed the selection in order
         * to provide consistency.
         */
        SkinResource* getSkin( const SkinSymbol* symbol, Random& prng, const osgDB::Options* dbOptions =0L ) const;


    public: // Marker resource functions (deprecated)

        /**
         * Finds and returns a marker reosurce by name.
         */
        MarkerResource* getMarker( const std::string& name, const osgDB::Options* dbOptions =0L ) const;

        /**
         * Returns a list of all marker resources in this library.
         */
        void getMarkers( MarkerResourceVector& output, const osgDB::Options* dbOptions =0L ) const;


    public: // Instance functions

        /**
         * Finds an instance-resource by name.
         */
        InstanceResource* getInstance( const std::string& name, const osgDB::Options* dbOptions =0L ) const;


    public: // serialization functions

        void mergeConfig( const Config& conf );
        Config getConfig() const;

    protected:
        typedef std::map< const Symbol*, Random > RandomMap;

        optional<URI>                      _uri;
        std::string                        _name;
        bool                               _initialized;
        mutable Threading::ReadWriteMutex  _mutex;

        ResourceMap<SkinResource>          _skins;
        ResourceMap<MarkerResource>        _markers;
        ResourceMap<InstanceResource>      _instances;

        bool matches( const SkinSymbol* symbol, SkinResource* skin ) const;

        void initialize( const osgDB::Options* options );
    };


    typedef std::map< std::string, osg::ref_ptr<ResourceLibrary> > ResourceLibraryMap;


} } // namespace osgEarth::Symbology

#endif // OSGEARTHSYMBOLOGY_RESOURCE_LIBRARY_H