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 "qgsrectangle.h"
#include "qgscoordinatereferencesystem.h"
 
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( const int &zoomLevel, const QgsTileMatrix &tileMatrix );
 
    QgsCoordinateReferenceSystem crs() const { return mCrs; }
 
    int zoomLevel() const { return mZoomLevel; }
 
    int matrixWidth() const { return mMatrixWidth; }
 
    int matrixHeight() const { return mMatrixHeight; }
 
    QgsRectangle extent() const { return mExtent; }
 
    double scale() const { return mScaleDenom; }
 
    QgsRectangle tileExtent( QgsTileXYZ id ) const;
 
    QgsPointXY tileCenter( QgsTileXYZ id ) const;
 
    QgsTileRange tileRangeFromExtent( const QgsRectangle &mExtent );
 
    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;
};
 
#endif // QGSTILES_H