/usr/include/osgEarthSymbology/ResourceLibrary 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 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 155 156 157 158 159 | /* -*-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.
*
* 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() { }
/**
* Initialize the catalog by loading its contents into memory
*/
bool initialize( const osgDB::Options* options );
/**
* 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;
optional<URI>& uri() { return _uri; }
const optional<URI>& uri() const { return _uri; }
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;
};
typedef std::map< std::string, osg::ref_ptr<ResourceLibrary> > ResourceLibraryMap;
} } // namespace osgEarth::Symbology
#endif // OSGEARTHSYMBOLOGY_RESOURCE_LIBRARY_H
|