src/core/raster/qgsrasterlayer.h

Go to the documentation of this file.

/***************************************************************************
                        qgsrasterlayer.h  -  description
                              -------------------
 begin                : Fri Jun 28 2002
 copyright            : (C) 2004 by T.Sutton, Gary E.Sherman, Steve Halasz
 email                : tim@linfiniti.com
***************************************************************************/
/*
 * Peter J. Ersts - contributed to the refactoring and maintenance of this class
 * B. Morley - added functions to convert this class to a data provider interface
 * Frank Warmerdam - contributed bug fixes and migrated class to use all GDAL_C_API calls
 */
/***************************************************************************
 *                                                                         *
 *   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 QGSRASTERLAYER_H
#define QGSRASTERLAYER_H

#include <QColor>
#include <QDateTime>
#include <QList>
#include <QMap>
#include <QPair>
#include <QVector>

#include "qgis.h"
#include "qgsbrightnesscontrastfilter.h"
#include "qgscolorrampshader.h"
#include "qgscontrastenhancement.h"
#include "qgshuesaturationfilter.h"
#include "qgsmaplayer.h"
#include "qgspoint.h"
#include "qgsraster.h"
#include "qgsrasterdataprovider.h"
#include "qgsrasterinterface.h"
#include "qgsrasterpipe.h"
#include "qgsrasterresamplefilter.h"
#include "qgsrastershaderfunction.h"
#include "qgsrastershader.h"
#include "qgsrastertransparency.h"
#include "qgsrasterviewport.h"

class QgsMapToPixel;
class QgsRasterRenderer;
class QgsRectangle;
class QImage;
class QLibrary;
class QPixmap;
class QSlider;

class CORE_EXPORT QgsRasterLayer : public QgsMapLayer
{
    Q_OBJECT
  public:
    static const double CUMULATIVE_CUT_LOWER;

    static const double CUMULATIVE_CUT_UPPER;

    static const double SAMPLE_SIZE;

    QgsRasterLayer();

    QgsRasterLayer( const QString & path,
                    const QString &  baseName = QString::null,
                    bool loadDefaultStyleFlag = true );

    QgsRasterLayer( const QString & uri,
                    const QString & baseName,
                    const QString & providerKey,
                    bool loadDefaultStyleFlag = true );

    ~QgsRasterLayer();

    enum ColorShadingAlgorithm
    {
      UndefinedShader,
      PseudoColorShader,
      FreakOutShader,
      ColorRampShader,
      UserDefinedShader
    };

    enum DrawingStyle
    {
      UndefinedDrawingStyle,
      SingleBandGray,                 // a single band image drawn as a range of gray colors
      SingleBandPseudoColor,          // a single band image drawn using a pseudocolor algorithm
      PalettedColor,                  // a "Palette" image drawn using color table
      PalettedSingleBandGray,         // a "Palette" layer drawn in gray scale
      PalettedSingleBandPseudoColor,  // a "Palette" layerdrawn using a pseudocolor algorithm
      PalettedMultiBandColor,         // currently not supported
      MultiBandSingleBandGray,        // a layer containing 2 or more bands, but a single band drawn as a range of gray colors
      MultiBandSingleBandPseudoColor, // a layer containing 2 or more bands, but a single band drawn using a pseudocolor algorithm
      MultiBandColor,                 // a layer containing 2 or more bands, mapped to RGB color space. In the case of a multiband with only two bands, one band will be mapped to more than one color.
      SingleBandColorDataStyle        // ARGB values rendered directly
    };

    enum LayerType
    {
      GrayOrUndefined,
      Palette,
      Multiband,
      ColorLayer
    };

    static void buildSupportedRasterFileFilter( QString & fileFilters );

    static bool isValidRasterFileName( const QString & theFileNameQString, QString &retError );
    static bool isValidRasterFileName( const QString & theFileNameQString );

    static QDateTime lastModified( const QString &  name );

    void setDataProvider( const QString & provider );

    LayerType rasterType() { return mRasterType; }

    //DrawingStyle drawingStyle() { return mDrawingStyle; }

    //void setDrawingStyle( const DrawingStyle &  theDrawingStyle ) { mDrawingStyle = theDrawingStyle; setRendererForDrawingStyle( theDrawingStyle ); }

    void setRenderer( QgsRasterRenderer* theRenderer );
    QgsRasterRenderer* renderer() const { return mPipe.renderer(); }

    QgsRasterResampleFilter * resampleFilter() const { return mPipe.resampleFilter(); }

    QgsBrightnessContrastFilter * brightnessFilter() const { return mPipe.brightnessFilter(); }
    QgsHueSaturationFilter * hueSaturationFilter() const { return mPipe.hueSaturationFilter(); }

    QgsRasterPipe * pipe() { return &mPipe; }

    int width() const;

    int height() const;

    int bandCount() const;

    const  QString bandName( int theBandNoInt );

    QgsRasterDataProvider* dataProvider();

    const QgsRasterDataProvider* dataProvider() const;

    virtual void reload();

    bool draw( QgsRenderContext& rendererContext );

    void draw( QPainter * theQPainter,
               QgsRasterViewPort * myRasterViewPort,
               const QgsMapToPixel* theQgsMapToPixel = 0 );

    QString lastError();

    QString lastErrorTitle();

    QList< QPair< QString, QColor > > legendSymbologyItems() const;

    QString metadata();

    QPixmap paletteAsPixmap( int theBandNumber = 1 );

    QString providerType() const;

    double rasterUnitsPerPixelX();
    double rasterUnitsPerPixelY();

    void setContrastEnhancement( QgsContrastEnhancement::ContrastEnhancementAlgorithm theAlgorithm,
                                 QgsRaster::ContrastEnhancementLimits theLimits = QgsRaster::ContrastEnhancementMinMax,
                                 QgsRectangle theExtent = QgsRectangle(),
                                 int theSampleSize = SAMPLE_SIZE,
                                 bool theGenerateLookupTableFlag = true );

    void setDefaultContrastEnhancement();

    void setDrawingStyle( const QString & theDrawingStyleQString );

    void showProgress( int theValue );

    virtual QStringList subLayers() const;

    QPixmap previewAsPixmap( QSize size, QColor bgColor = Qt::white );

    void triggerRepaint();

    virtual void setLayerOrder( const QStringList &layers );

    virtual void setSubLayerVisibility( QString name, bool vis );

    virtual QDateTime timestamp() const { return mDataProvider->timestamp() ; }

  public slots:
    void showStatusMessage( const QString & theMessage );

    void updateProgress( int, int );

    void onProgress( int, double, QString );

  signals:
    void progressUpdate( int theValue );

    void dataChanged();

  protected:
    bool readSymbology( const QDomNode& node, QString& errorMessage );

    bool readXml( const QDomNode& layer_node );

    bool writeSymbology( QDomNode&, QDomDocument& doc, QString& errorMessage ) const;

    bool writeXml( QDomNode & layer_node, QDomDocument & doc );

  private:
    void init();

    void closeDataProvider();

    bool update();

    void setRendererForDrawingStyle( const DrawingStyle &  theDrawingStyle );

    const QString QSTRING_NOT_SET;
    const QString TRSTRING_NOT_SET;

    QgsRasterDataProvider* mDataProvider;

    //DrawingStyle mDrawingStyle;

    QString mError;

    QString mErrorCaption;

    QDateTime mLastModified;

    QgsRasterViewPort mLastViewPort;

    QString mProviderKey;

    LayerType mRasterType;

    QgsRasterPipe mPipe;
};

#endif