/home/cube/sources/osgearth/src/osgEarthUtil/WMS

Go to the documentation of this file.

/* -*-c++-*- */
/* osgEarth - Dynamic map generation toolkit for OpenSceneGraph
* Copyright 2008-2010 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 OSGEARTHUTIL_WMS_H
#define OSGEARTHUTIL_WMS_H 1

#include <osgEarthUtil/Common>
#include <osg/Referenced>
#include <osg/ref_ptr>
#include <osgEarth/Common>

#include <osgDB/ReaderWriter>
#include <osg/Version>
#if OSG_MIN_VERSION_REQUIRED(2,9,5)
#include <osgDB/Options>
#endif


#include <string>
#include <vector>

namespace osgEarth { namespace Util
{
    class OSGEARTHUTIL_EXPORT WMSStyle : public osg::Referenced
    {
    public:
        WMSStyle();
        WMSStyle(const std::string& name, const std::string &title);

        const std::string& getName() {return _name;}

        void setName(const std::string &name) {_name = name;}

        const std::string& getTitle() {return _title;}

        void setTitle(const std::string &title) {_title = title;}
        
    protected:
        std::string _name;
        std::string _title;
    };

    class OSGEARTHUTIL_EXPORT WMSLayer : public osg::Referenced
    {
    public:
        WMSLayer();

        const std::string& getName() {return _name;}

        void setName(const std::string &name) {_name = name;}

        const std::string& getTitle() {return _title;}

        void setTitle(const std::string &title) {_title = title;}

        const std::string& getAbstract() {return _abstract;}

        void setAbstract(const std::string &abstract) {_abstract = abstract;}

        void getLatLonExtents(double &minLon, double &minLat, double &maxLon, double &maxLat);

        void setLatLonExtents(double minLon, double minLat, double maxLon, double maxLat);

        void getExtents(double &minX, double &minY, double &maxX, double &maxY);

        void setExtents(double minX, double minY, double maxX, double maxY);


        typedef std::vector<WMSStyle> StyleList;

        StyleList& getStyles() {return _styles;}

        typedef std::vector<std::string> SRSList;

        SRSList& getSpatialReferences() {return _spatialReferences;}

        typedef std::vector< osg::ref_ptr<WMSLayer> > LayerList;

        LayerList& getLayers() {return _layers;}

        WMSLayer* getParentLayer() {return _parentLayer;}

        void setParentLayer( WMSLayer* layer ) {_parentLayer = layer;}

        WMSLayer* getLayerByName(const std::string &name);
    protected:
        std::string _name;
        std::string _title;
        std::string _abstract;
        double _minLon, _minLat, _maxLon, _maxLat;
        double _minX, _minY, _maxX, _maxY;
        StyleList _styles;
        SRSList _spatialReferences;

        LayerList _layers;
        WMSLayer* _parentLayer;
    };

    class OSGEARTHUTIL_EXPORT WMSCapabilities : public osg::Referenced
    {
    public:
        WMSCapabilities();

        const std::string& getVersion() {return _version;}

        void setVersion(const std::string& version) {_version = version;}

        typedef std::vector<std::string> FormatList;

        FormatList& getFormats() {return _formats;}

        WMSLayer::LayerList& getLayers() {return _layers;}

        std::string suggestExtension();

        WMSLayer* getLayerByName(const std::string &name);

    protected:
        FormatList _formats;
        WMSLayer::LayerList _layers;
        std::string _version;
    };

    /*
    * Reads Capabilities from a URL or file
    */
    class OSGEARTHUTIL_EXPORT WMSCapabilitiesReader
    {
    public:
        static WMSCapabilities* read( const std::string &location, const osgDB::ReaderWriter::Options *options );
        static WMSCapabilities* read( std::istream &in );
    private:
        WMSCapabilitiesReader(){}
        WMSCapabilitiesReader(const WMSCapabilitiesReader &cr){}
    };

} } // namespace osgEarth::Util

#endif //OSGEARTHUTIL_WMS_H