vcs.maemo.org Git - situare/blob - src/map/mapengine.h

   1 /*
   2    Situare - A location system for Facebook
   3    Copyright (C) 2010  Ixonos Plc. Authors:
   4
   5        Sami Rämö - sami.ramo@ixonos.com
   6        Jussi Laitinen - jussi.laitinen@ixonos.com
   7
   8    Situare is free software; you can redistribute it and/or
   9    modify it under the terms of the GNU General Public License
  10    version 2 as published by the Free Software Foundation.
  11
  12    Situare is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with Situare; if not, write to the Free Software
  19    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301,
  20    USA.
  21 */
  22
  23 #ifndef MAPENGINE_H
  24 #define MAPENGINE_H
  25
  26 #include <math.h>
  27
  28 #include <QtCore>
  29
  30 #include "mapfetcher.h"
  31 #include "mapscene.h"
  32 #include "mapview.h"
  33
  34 /**
  35 * @brief Map engine
  36 *
  37 * Logic for controlling map functionality. Does also include static methods for
  38 * converting coordinates.
  39 * @author Sami Rämö - sami.ramo (at) ixonos.com
  40 */
  41 class MapEngine : public QObject
  42 {
  43     Q_OBJECT
  44 public:
  45     /**
  46     * @brief Constructor
  47     *
  48     * Does create and add scene to map view.
  49     * @param mapView View for map
  50     * @param parent Parent
  51     */
  52     MapEngine(MapView *mapView, QWidget *parent = 0);
  53
  54     /**
  55     * @brief Convert tile x & y numbers to MapScene coordinates
  56     *
  57     * @param zoomLevel Zoom level
  58     * @param tileNumber x & y numbers of the tile
  59     * @return QPoint MapScene coordinate
  60     */
  61     /**
  62       * @todo use bit shift instead of pow
  63       */
  64     static QPoint convertTileNumberToSceneCoordinate(int zoomLevel, QPoint tileNumber)
  65     {
  66         int x = tileNumber.x() * TILE_SIZE_X * pow(2, MAX_ZOOM_LEVEL - zoomLevel);
  67         int y = tileNumber.y() * TILE_SIZE_Y * pow(2, MAX_ZOOM_LEVEL - zoomLevel);
  68
  69         return QPoint(x, y);
  70     }
  71
  72     /**
  73     * @brief Set view location
  74     *
  75     * @param latLonCoordinate Latitude & longitude coordinates for location
  76     */
  77     void setViewLocation(QPointF latLonCoordinate);
  78
  79     QPoint latLonToTile(qreal latitude, qreal longitude, int zoom);
  80
  81     /**
  82     * @brief Transforms tile x value to longitude.
  83     *
  84     * @param x tile x value
  85     * @param zoom zoom value
  86     * @return qreal longitude
  87     */
  88     qreal tileXToLongitude(int x, int zoom);
  89
  90     /**
  91     * @brief Transforms tile y value to latitude.
  92     *
  93     * @param y tile y value
  94     * @param zoom zoom value
  95     * @return qreal latitude
  96     */
  97     qreal tileYToLatitude(int y, int zoom);
  98
  99 private slots:
 100     /**
 101     * @brief Slot for received map tile images
 102     *
 103     * Does add MapTile objects to MapScene. Zoom level and location is parsed from URL.
 104     * @param url URL of the received image
 105     * @param pixmap Received pixmap
 106     */
 107     void mapImageReceived(const QUrl &url, const QPixmap &pixmap);
 108
 109 public:
 110     static const int TILE_SIZE_X = 256; ///< Tile image size in x direction
 111     static const int TILE_SIZE_Y = 256; ///< Tile image size in y direction
 112     static const int MIN_ZOOM_LEVEL = 0; ///< Minimum zoom level
 113     static const int MAX_ZOOM_LEVEL = 18; ///< Maximum zoom level
 114
 115 private:
 116     MapView *m_mapView; ///< View for viewing map
 117     MapScene *m_mapScene; ///< Scene for map tiles
 118     MapFetcher *m_mapFetcher; ///< Fetcher for map tiles
 119     int m_zoomLevel; ///< Current zoom level
 120 };
 121
 122 #endif // MAPENGINE_H