qgstiles.h

Go to the documentation of this file.

/***************************************************************************
  qgstiles.h
  --------------------------------------
  Date                 : March 2020
  Copyright            : (C) 2020 by Martin Dobias
  Email                : wonder dot sk at gmail dot 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 QGSTILES_H
#define QGSTILES_H
 
#include "qgis_core.h"
#include "qgis_sip.h"
 
#include "qgis.h"
#include "qgsrectangle.h"
#include "qgscoordinatereferencesystem.h"
#include "qgsreadwritecontext.h"
 
class QgsRenderContext;
 
class CORE_EXPORT QgsTileXYZ
{
  public:
    QgsTileXYZ( int tc = -1, int tr = -1, int tz = -1 )
      : mColumn( tc ), mRow( tr ), mZoomLevel( tz )
    {
    }
 
    int column() const { return mColumn; }
    int row() const { return mRow; }
    int zoomLevel() const { return mZoomLevel; }
 
    QString toString() const { return QStringLiteral( "X=%1 Y=%2 Z=%3" ).arg( mColumn ).arg( mRow ).arg( mZoomLevel ); }
 
  private:
    int mColumn;
    int mRow;
    int mZoomLevel;
};
 
 
class CORE_EXPORT QgsTileRange
{
  public:
    QgsTileRange( int c1 = -1, int c2 = -1, int r1 = -1, int r2 = -1 )
      : mStartColumn( c1 ), mEndColumn( c2 ), mStartRow( r1 ), mEndRow( r2 ) {}
 
    bool isValid() const { return mStartColumn >= 0 && mEndColumn >= 0 && mStartRow >= 0 && mEndRow >= 0; }
 
    int startColumn() const { return mStartColumn; }
    int endColumn() const { return mEndColumn; }
    int startRow() const { return mStartRow; }
    int endRow() const { return mEndRow; }
 
  private:
    int mStartColumn;
    int mEndColumn;
    int mStartRow;
    int mEndRow;
};
 
 
class CORE_EXPORT QgsTileMatrix
{
  public:
 
    static QgsTileMatrix fromWebMercator( int zoomLevel );
 
    static QgsTileMatrix fromCustomDef( int zoomLevel, const QgsCoordinateReferenceSystem &crs,
                                        const QgsPointXY &z0TopLeftPoint, double z0Dimension,
                                        int z0MatrixWidth = 1, int z0MatrixHeight = 1 );
 
    static QgsTileMatrix fromTileMatrix( int zoomLevel, const QgsTileMatrix &tileMatrix );
 
    QgsCoordinateReferenceSystem crs() const { return mCrs; }
 
    void setCrs( const QgsCoordinateReferenceSystem &crs ) { mCrs = crs;}
 
    int zoomLevel() const { return mZoomLevel; }
 
    void setZoomLevel( int level ) { mZoomLevel = level; }
 
    int matrixWidth() const { return mMatrixWidth; }
 
    int matrixHeight() const { return mMatrixHeight; }
 
    QgsRectangle extent() const { return mExtent; }
 
    double scale() const { return mScaleDenom; }
 
    void setScale( double scale ) { mScaleDenom = scale; }
 
    QgsRectangle tileExtent( QgsTileXYZ id ) const;
 
    QgsPointXY tileCenter( QgsTileXYZ id ) const;
 
    QgsTileRange tileRangeFromExtent( const QgsRectangle &mExtent ) const;
 
    QPointF mapToTileCoordinates( const QgsPointXY &mapPoint ) const;
 
    bool isRootTileMatrix() const { return mZoomLevel == 0; }
 
  private:
    QgsCoordinateReferenceSystem mCrs;
    int mZoomLevel = -1;
    int mMatrixWidth;
    int mMatrixHeight;
    QgsRectangle mExtent;
    double mScaleDenom;
    double mTileXSpan;
    double mTileYSpan;
 
    friend class QgsTileMatrixSet;
};
 
 
class CORE_EXPORT QgsTileMatrixSet
{
 
  public:
 
    virtual ~QgsTileMatrixSet() = default;
 
    bool isEmpty() const;
 
    void addGoogleCrs84QuadTiles( int minimumZoom = 0, int maximumZoom = 14 );
 
    QgsTileMatrix tileMatrix( int zoom ) const;
 
    QgsTileMatrix rootMatrix() const;
 
    void setRootMatrix( const QgsTileMatrix &matrix );
 
    void addMatrix( const QgsTileMatrix &matrix );
 
    int minimumZoom() const;
 
    int maximumZoom() const;
 
    void dropMatricesOutsideZoomRange( int minimumZoom, int maximumZoom );
 
    QgsCoordinateReferenceSystem crs() const;
 
    double scaleToZoom( double scale ) const;
 
    int scaleToZoomLevel( double scale ) const;
 
    double scaleForRenderContext( const QgsRenderContext &context ) const;
 
    double calculateTileScaleForMap( double actualMapScale,
                                     const QgsCoordinateReferenceSystem &mapCrs,
                                     const QgsRectangle &mapExtent,
                                     const QSize mapSize,
                                     const double mapDpi
                                   ) const;
 
    virtual bool readXml( const QDomElement &element, QgsReadWriteContext &context );
 
    virtual QDomElement writeXml( QDomDocument &document, const QgsReadWriteContext &context ) const;
 
    Qgis::ScaleToTileZoomLevelMethod scaleToTileZoomMethod() const { return mScaleToTileZoomMethod; }
 
    void setScaleToTileZoomMethod( Qgis::ScaleToTileZoomLevelMethod method ) { mScaleToTileZoomMethod = method; }
 
  private:
 
    // Usually corresponds to zoom level 0, even if that zoom level is NOT present in the actual tile matrices for this set
    QgsTileMatrix mRootMatrix;
    QMap< int, QgsTileMatrix > mTileMatrices;
    Qgis::ScaleToTileZoomLevelMethod mScaleToTileZoomMethod = Qgis::ScaleToTileZoomLevelMethod::MapBox;
};
 
#endif // QGSTILES_H