/home/cube/sources/osgearth/src/osgEarthDrivers/wms/Capabilities

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 OSGEARTH_WMS_CAPABILITIES_H
#define OSGEARTH_WMS_CAPABILITIES_H

#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
{
    class Style : public osg::Referenced
    {
    public:
        Style();
        Style(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 Layer : public osg::Referenced
    {
    public:
        Layer();

        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<Style> StyleList;

        StyleList& getStyles() {return _styles;}

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

        SRSList& getSpatialReferences() {return _spatialReferences;}

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

        LayerList& getLayers() {return _layers;}

        Layer* getParentLayer() {return _parentLayer;}

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

        Layer* 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;
        Layer* _parentLayer;
    };

    class 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;}

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

        std::string suggestExtension();

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

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

    /*
    * Reads Capabilities from a URL or file
    */
    class 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){}
    };
}

#endif //OSGEARTH_CAPABILITIES_H