ResourceCache 3.71 KB
/* -*-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_CACHE_H
#define OSGEARTHSYMBOLOGY_RESOURCE_CACHE_H 1

#include <osgEarthSymbology/Common>
#include <osgEarthSymbology/Skins>
#include <osgEarthSymbology/MarkerResource>
#include <osgEarthSymbology/InstanceResource>
#include <osgEarthSymbology/ResourceLibrary>
#include <osgEarth/Containers>
#include <osgEarth/ThreadingUtils>

namespace osgEarth { namespace Symbology
{
    using namespace osgEarth;

    /**
     * Caches the runtime objects created by resources, so we can avoid creating them
     * each time they are referenced.
     *
     * This object is thread-safe.
     */
    class OSGEARTHSYMBOLOGY_EXPORT ResourceCache : public osg::Referenced
    {
    public:
        /** 
         * Constructs a new resource cache.
         */
        ResourceCache( 
            const osgDB::Options* dbOptions );

        /**
         * Fetches the StateSet implementation corresponding to a Skin.
         * @param skin   Skin resource for which to get or create a state set.
         * @param output Result goes here.
         */
        bool getOrCreateStateSet( SkinResource* skin, osg::ref_ptr<osg::StateSet>& output );

        /**
         * Get the statistics collected from the skin cache.
         */
        const CacheStats getSkinStats() const { return _skinCache.getStats(); }

        /**
         * Gets a node corresponding to an instance resource.
         * @param skin   Instance resource for which to get or create a Node.
         * @param output Result goes here.
         */
        bool getOrCreateInstanceNode( InstanceResource* instance, osg::ref_ptr<osg::Node>& output );
        bool cloneOrCreateInstanceNode( InstanceResource* instance, osg::ref_ptr<osg::Node>& output );

        /**
         * Fetches the StateSet implemention for an entire ResourceLibrary.  This will contain a Texture2DArray with all of the skins merged into it.
         * @param library    The library 
         * @param output     Result goes here. 
         */
        bool getOrCreateStateSet( ResourceLibrary* library,  osg::ref_ptr<osg::StateSet>& output );

    protected:
        virtual ~ResourceCache() { }

        osg::ref_ptr<const osgDB::Options> _dbOptions;

        //typedef LRUCache<std::string, osg::observer_ptr<osg::StateSet> > SkinCache;
        typedef LRUCache<std::string, osg::ref_ptr<osg::StateSet> > SkinCache;
        SkinCache        _skinCache;
        Threading::Mutex _skinMutex;

        //typedef LRUCache<std::string, osg::observer_ptr<osg::Node> > InstanceCache;
        typedef LRUCache<std::string, osg::ref_ptr<osg::Node> > InstanceCache;
        InstanceCache    _instanceCache;
        Threading::Mutex _instanceMutex;

        typedef LRUCache<std::string, osg::ref_ptr<osg::StateSet> > ResourceLibraryCache;
        ResourceLibraryCache  _resourceLibraryCache;
        Threading::Mutex      _resourceLibraryMutex;
    };

} } // namespace osgEarth::Symbology

#endif // OSGEARTHSYMBOLOGY_RESOURCE_CACHE_H