TerrainTile

Go to the documentation of this file.

/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield
 *
 * This library is open source and may be redistributed and/or modified under
 * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
 * (at your option) any later version.  The full license is in LICENSE file
 * included with this distribution, and on the openscenegraph.org website.
 *
 * This library 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
 * OpenSceneGraph Public License for more details.
*/
 
#ifndef OSGTERRAIN_TERRAINTILE
#define OSGTERRAIN_TERRAINTILE 1
 
#include <osg/Group>
#include <osg/CoordinateSystemNode>
 
#include <osgDB/ReaderWriter>
 
#include <osgTerrain/TerrainTechnique>
#include <osgTerrain/Layer>
#include <osgTerrain/Locator>
 
namespace osgTerrain {
 
class Terrain;
 
class OSGTERRAIN_EXPORT TileID
{
    public:
 
        TileID();
 
        TileID(int in_level, int in_x, int in_y);
 
        bool operator == (const TileID& rhs) const
        {
            return (level==rhs.level) && (x==rhs.x) && (y==rhs.y);
        }
 
        bool operator != (const TileID& rhs) const
        {
            return (level!=rhs.level) || (x!=rhs.x) || (y!=rhs.y);
        }
 
        bool operator < (const TileID& rhs) const
        {
            if (level<rhs.level) return true;
            if (level>rhs.level) return false;
            if (x<rhs.x) return true;
            if (x>rhs.x) return false;
            return y<rhs.y;
        }
 
        bool valid() const { return level>=0; }
 
        int level;
        int x;
        int y;
};
 

class OSGTERRAIN_EXPORT TerrainTile : public osg::Group
{
    public:
 
        TerrainTile();

        TerrainTile(const TerrainTile&,const osg::CopyOp& copyop=osg::CopyOp::SHALLOW_COPY);
 
        META_Node(osgTerrain, TerrainTile);
 
        virtual void traverse(osg::NodeVisitor& nv);

        void init(int dirtyMask, bool assumeMultiThreaded);

        void setTerrain(Terrain* ts);

        Terrain* getTerrain() { return _terrain; }

        const Terrain* getTerrain() const { return _terrain; }
 

        void setTileID(const TileID& tileID);

        const TileID& getTileID() const { return _tileID; }
 

        void setTerrainTechnique(TerrainTechnique* terrainTechnique);
 
        template<class T> void setTerrainTechnique(const osg::ref_ptr<T>& terrainTechnique) { setTerrainTechnique(terrainTechnique.get()); }

        TerrainTechnique* getTerrainTechnique() { return _terrainTechnique.get(); }

        const TerrainTechnique* getTerrainTechnique() const { return _terrainTechnique.get(); }
 

        void setLocator(Locator* locator) { _locator = locator; }
 
        template<class T> void setLocator(const osg::ref_ptr<T>& locator) { setLocator(locator.get()); }

        Locator* getLocator() { return _locator.get(); }

        const Locator* getLocator() const { return _locator.get(); }

        void setElevationLayer(Layer* layer);
 
        template<class T> void setElevationLayer(const osg::ref_ptr<T>& layer) { setElevationLayer(layer.get()); }

        Layer* getElevationLayer() { return _elevationLayer.get(); }

        const Layer* getElevationLayer() const { return _elevationLayer.get(); }
 

        void setColorLayer(unsigned int i, Layer* layer);
 
        template<class T> void setColorLayer(unsigned int i, const osg::ref_ptr<T>& layer) { setColorLayer(i, layer.get()); }

        Layer* getColorLayer(unsigned int i) { return i<_colorLayers.size() ? _colorLayers[i].get() : 0; }

        const Layer* getColorLayer(unsigned int i) const { return i<_colorLayers.size() ? _colorLayers[i].get() : 0; }

        unsigned int getNumColorLayers() const { return _colorLayers.size(); }
 

        void setRequiresNormals(bool flag) { _requiresNormals = flag; }

        bool getRequiresNormals() const { return _requiresNormals; }
 

        void setTreatBoundariesToValidDataAsDefaultValue(bool flag) { _treatBoundariesToValidDataAsDefaultValue = flag; }

        bool getTreatBoundariesToValidDataAsDefaultValue() const { return _treatBoundariesToValidDataAsDefaultValue; }
 
 
        enum BlendingPolicy
        {
            INHERIT, 
            DO_NOT_SET_BLENDING,
            ENABLE_BLENDING,
            ENABLE_BLENDING_WHEN_ALPHA_PRESENT 
        };

        void setBlendingPolicy(BlendingPolicy policy) { _blendingPolicy = policy; }

        BlendingPolicy getBlendingPolicy() const { return _blendingPolicy; }
 
 
        enum DirtyMask
        {
            NOT_DIRTY = 0,
            IMAGERY_DIRTY = 1<<0,
            ELEVATION_DIRTY = 1<<1,
            LEFT_EDGE_DIRTY = 1<<2,
            RIGHT_EDGE_DIRTY = 1<<3,
            TOP_EDGE_DIRTY = 1<<4,
            TOP_LEFT_CORNER_DIRTY = 1<<5,
            TOP_RIGHT_CORNER_DIRTY = 1<<6,
            BOTTOM_EDGE_DIRTY = 1<<7,
            BOTTOM_LEFT_CORNER_DIRTY = 1<<8,
            BOTTOM_RIGHT_CORNER_DIRTY = 1<<9,
            EDGES_DIRTY = LEFT_EDGE_DIRTY | RIGHT_EDGE_DIRTY | TOP_EDGE_DIRTY | BOTTOM_EDGE_DIRTY |
                          TOP_LEFT_CORNER_DIRTY | TOP_RIGHT_CORNER_DIRTY | BOTTOM_LEFT_CORNER_DIRTY | BOTTOM_RIGHT_CORNER_DIRTY,
            ALL_DIRTY = IMAGERY_DIRTY | ELEVATION_DIRTY | EDGES_DIRTY
        };

        void setDirty(bool dirty) { setDirtyMask(dirty ? ALL_DIRTY : NOT_DIRTY); }

        int getDirty() const { return _dirtyMask!=NOT_DIRTY; }
 

        void setDirtyMask(int dirtyMask);

        int getDirtyMask() const { return _dirtyMask; }
 

        virtual osg::BoundingSphere computeBound() const;

        struct TileLoadedCallback : public osg::Referenced
        {
            virtual bool deferExternalLayerLoading() const = 0;
            virtual void loaded(osgTerrain::TerrainTile* tile, const osgDB::ReaderWriter::Options* options) const = 0;
        };
 
        static void setTileLoadedCallback(TileLoadedCallback* lc);
        static osg::ref_ptr<TileLoadedCallback>& getTileLoadedCallback();

        virtual void releaseGLObjects(osg::State* = 0) const;
 
 
    protected:
 
        virtual ~TerrainTile();
 
        typedef std::vector< osg::ref_ptr<Layer> > Layers;
 
        friend class Terrain;
 
        Terrain*                            _terrain;
 
        int                                 _dirtyMask;
        bool                                _hasBeenTraversal;
 
        TileID                              _tileID;
 
        osg::ref_ptr<TerrainTechnique>      _terrainTechnique;
        osg::ref_ptr<Locator>               _locator;
 
        osg::ref_ptr<Layer>                 _elevationLayer;
 
        Layers                              _colorLayers;
 
        bool                                _requiresNormals;
        bool                                _treatBoundariesToValidDataAsDefaultValue;
        BlendingPolicy                      _blendingPolicy;
};

class OSGTERRAIN_EXPORT WhiteListTileLoadedCallback : public TerrainTile::TileLoadedCallback
{
    public:
 
        WhiteListTileLoadedCallback();
 
        void allow(const std::string& setname) { _setWhiteList.insert(setname); }
 
        void setMinimumNumOfLayers(unsigned int numLayers) { _minumumNumberOfLayers = numLayers; }
        unsigned int getMinimumNumOfLayers() const { return _minumumNumberOfLayers; }
 
        void setReplaceSwitchLayer(bool replaceSwitchLayer) { _replaceSwitchLayer = replaceSwitchLayer; }
        bool getReplaceSwitchLayer() const { return _replaceSwitchLayer; }
 
        void setAllowAll(bool allowAll) { _allowAll = allowAll; }
        bool getAllowAll() const { return _allowAll; }
 
        bool layerAcceptable(const std::string& setname) const;
        bool readImageLayer(osgTerrain::ImageLayer* imageLayer, const osgDB::ReaderWriter::Options* options) const;
 
        virtual bool deferExternalLayerLoading() const;
 
        virtual void loaded(osgTerrain::TerrainTile* tile, const osgDB::ReaderWriter::Options* options) const;
 
    protected:
 
        virtual ~WhiteListTileLoadedCallback();
 
        typedef std::set<std::string> SetWhiteList;
        SetWhiteList    _setWhiteList;
        unsigned int    _minumumNumberOfLayers;
        bool            _replaceSwitchLayer;
        bool            _allowAll;
 
};
 
}
 
#endif