qgsmaplayer.h

Go to the documentation of this file.

/***************************************************************************
                          qgsmaplayer.h  -  description
                             -------------------
    begin                : Fri Jun 28 2002
    copyright            : (C) 2002 by Gary E.Sherman
    email                : sherman at mrcc.com
***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef QGSMAPLAYER_H
#define QGSMAPLAYER_H

#include <QDateTime>
#include <QObject>
#include <QUndoStack>
#include <QVariant>
#include <QImage>
#include <QDomNode>
#include <QPainter>

#include "qgis.h"
#include "qgserror.h"
#include "qgsrectangle.h"
#include "qgsmaprenderer.h"
#include "qgsobjectcustomproperties.h"

class QgsRenderContext;
class QgsCoordinateReferenceSystem;
class QgsMapLayerLegend;
class QgsMapLayerRenderer;

class QDomDocument;
class QKeyEvent;
class QPainter;

class CORE_EXPORT QgsMapLayer : public QObject
{
    Q_OBJECT

  public:
    enum LayerType
    {
      VectorLayer,
      RasterLayer,
      PluginLayer
    };

    QgsMapLayer( QgsMapLayer::LayerType type = VectorLayer, QString lyrname = QString::null, QString source = QString::null );

    virtual ~QgsMapLayer();

    QgsMapLayer::LayerType type() const;

    QString id() const;

    void setLayerName( const QString & name );

    const QString & name() const;

    const QString & originalName() const { return mLayerOrigName; }

    void setTitle( const QString& title ) { mTitle = title; }
    const QString& title() const { return mTitle; }

    void setAbstract( const QString& abstract ) { mAbstract = abstract; }
    const QString& abstract() const { return mAbstract; }

    void setKeywordList( const QString& keywords ) { mKeywordList = keywords; }
    const QString& keywordList() const { return mKeywordList; }

    /* Layer dataUrl information */
    void setDataUrl( const QString& dataUrl ) { mDataUrl = dataUrl; }
    const QString& dataUrl() const { return mDataUrl; }
    void setDataUrlFormat( const QString& dataUrlFormat ) { mDataUrlFormat = dataUrlFormat; }
    const QString& dataUrlFormat() const { return mDataUrlFormat; }

    /* Layer attribution information */
    void setAttribution( const QString& attrib ) { mAttribution = attrib; }
    const QString& attribution() const { return mAttribution; }
    void setAttributionUrl( const QString& attribUrl ) { mAttributionUrl = attribUrl; }
    const QString& attributionUrl() const { return mAttributionUrl; }

    /* Layer metadataUrl information */
    void setMetadataUrl( const QString& metaUrl ) { mMetadataUrl = metaUrl; }
    const QString& metadataUrl() const { return mMetadataUrl; }
    void setMetadataUrlType( const QString& metaUrlType ) { mMetadataUrlType = metaUrlType; }
    const QString& metadataUrlType() const { return mMetadataUrlType; }
    void setMetadataUrlFormat( const QString& metaUrlFormat ) { mMetadataUrlFormat = metaUrlFormat; }
    const QString& metadataUrlFormat() const { return mMetadataUrlFormat; }

    /* Set the blending mode used for rendering a layer */
    void setBlendMode( const QPainter::CompositionMode &blendMode );
    /* Returns the current blending mode for a layer */
    QPainter::CompositionMode blendMode() const;

    virtual void reload() {}

    virtual QgsMapLayerRenderer* createMapRenderer( QgsRenderContext& rendererContext ) { Q_UNUSED( rendererContext ); return 0; }

    virtual bool draw( QgsRenderContext& rendererContext );

    virtual void drawLabels( QgsRenderContext& rendererContext );

    virtual QgsRectangle extent();

    bool isValid();

    QString publicSource() const;

    const QString &source() const;

    virtual QStringList subLayers() const;

    virtual void setLayerOrder( const QStringList &layers );

    virtual void setSubLayerVisibility( QString name, bool vis );

    virtual bool isEditable() const;

    bool readLayerXML( const QDomElement& layerElement );


    bool writeLayerXML( QDomElement& layerElement, QDomDocument& document, QString relativeBasePath = QString::null );

    static QDomDocument asLayerDefinition( QList<QgsMapLayer*> layers, QString relativeBasePath = QString::null );

    static QList<QgsMapLayer*> fromLayerDefinition( QDomDocument& document );
    static QList<QgsMapLayer*> fromLayerDefinitionFile( const QString qlrfile );

    void setCustomProperty( const QString& key, const QVariant& value );
    QVariant customProperty( const QString& value, const QVariant& defaultValue = QVariant() ) const;
    void removeCustomProperty( const QString& key );


    Q_DECL_DEPRECATED virtual QString lastErrorTitle();

    Q_DECL_DEPRECATED virtual QString lastError();

    virtual QgsError error() const { return mError; }

    const QgsCoordinateReferenceSystem& crs() const;

    void setCrs( const QgsCoordinateReferenceSystem& srs, bool emitSignal = true );

    static QString capitaliseLayerName( const QString& name );

    virtual QString styleURI();

    virtual QString loadDefaultStyle( bool & theResultFlag );

    virtual QString loadNamedStyle( const QString &theURI, bool &theResultFlag );

    virtual bool loadNamedStyleFromDb( const QString &db, const QString &theURI, QString &qml );

    //TODO edit infos
    virtual void exportNamedStyle( QDomDocument &doc, QString &errorMsg );


    virtual void exportSldStyle( QDomDocument &doc, QString &errorMsg );

    virtual QString saveDefaultStyle( bool & theResultFlag );

    virtual QString saveNamedStyle( const QString &theURI, bool &theResultFlag );

    virtual QString saveSldStyle( const QString &theURI, bool &theResultFlag );
    virtual QString loadSldStyle( const QString &theURI, bool &theResultFlag );

    virtual bool readSld( const QDomNode &node, QString &errorMessage )
    { Q_UNUSED( node ); errorMessage = QString( "Layer type %1 not supported" ).arg( type() ); return false; }


    virtual bool readSymbology( const QDomNode& node, QString& errorMessage ) = 0;

    virtual bool writeSymbology( QDomNode &node, QDomDocument& doc, QString& errorMessage ) const = 0;

    QUndoStack *undoStack();

    /* Layer legendUrl information */
    void setLegendUrl( const QString& legendUrl ) { mLegendUrl = legendUrl; }
    const QString& legendUrl() const { return mLegendUrl; }
    void setLegendUrlFormat( const QString& legendUrlFormat ) { mLegendUrlFormat = legendUrlFormat; }
    const QString& legendUrlFormat() const { return mLegendUrlFormat; }

    Q_DECL_DEPRECATED QImage *cacheImage() { return 0; }
    Q_DECL_DEPRECATED void setCacheImage( QImage * );
    Q_DECL_DEPRECATED virtual void onCacheImageDelete() {}

    void setLegend( QgsMapLayerLegend* legend );
    QgsMapLayerLegend* legend() const;

  public slots:

    virtual void invalidTransformInput();

    void setMinimumScale( float theMinScale );
    float minimumScale() const;

    void setMaximumScale( float theMaxScale );
    float maximumScale() const;

    void toggleScaleBasedVisibility( bool theVisibilityFlag );
    bool hasScaleBasedVisibility() const;

    Q_DECL_DEPRECATED void clearCacheImage();

    void triggerRepaint();

    virtual QString metadata();

    virtual QDateTime timestamp() const { return QDateTime() ; }

  signals:

    void drawingProgress( int theProgress, int theTotalSteps );

    void statusChanged( QString theStatus );

    void layerNameChanged();

    void layerCrsChanged();

    void repaintRequested();

    void screenUpdateRequested();

    void recalculateExtents();

    void dataChanged();

    void blendModeChanged( const QPainter::CompositionMode &blendMode );

    void rendererChanged();

    void legendChanged();

  protected:
    virtual void setExtent( const QgsRectangle &rect );

    void setValid( bool valid );

    virtual bool readXml( const QDomNode& layer_node );

    virtual bool writeXml( QDomNode & layer_node, QDomDocument & document );


    void readCustomProperties( const QDomNode& layerNode, const QString& keyStartsWith = "" );

    void writeCustomProperties( QDomNode & layerNode, QDomDocument & doc ) const;

    void connectNotify( const char * signal );

    void appendError( const QgsErrorMessage & theMessage ) { mError.append( theMessage );}
    void setError( const QgsError & theError ) { mError = theError;}

    QgsRectangle mExtent;

    bool mValid;

    QString mDataSource;

    QString mLayerName;

    QString mLayerOrigName;

    QString mTitle;

    QString mAbstract;
    QString mKeywordList;

    QString mDataUrl;
    QString mDataUrlFormat;

    QString mAttribution;
    QString mAttributionUrl;

    QString mMetadataUrl;
    QString mMetadataUrlType;
    QString mMetadataUrlFormat;

    QString mLegendUrl;
    QString mLegendUrlFormat;

    QgsError mError;

  private:
    QgsCoordinateReferenceSystem* mCRS;

    QgsMapLayer( QgsMapLayer const & );

    QgsMapLayer & operator=( QgsMapLayer const & );

    QString mID;

    QgsMapLayer::LayerType mLayerType;

    QPainter::CompositionMode mBlendMode;

    QString mTag;

    float mMinScale;
    float mMaxScale;
    bool mScaleBasedVisibility;

    QUndoStack mUndoStack;

    QgsObjectCustomProperties mCustomProperties;

    QgsMapLayerLegend* mLegend;
};

#endif