Situare - A location system for Facebook
Copyright (C) 2010 Ixonos Plc. Authors:
+ Sami Rämö - sami.ramo@ixonos.com
Jussi Laitinen - jussi.laitinen@ixonos.com
Situare is free software; you can redistribute it and/or
#include <QtCore>
+#include "common.h"
+#include "mapfetcher.h"
+#include "mapscene.h"
+#include "maptile.h"
/**
-* @brief MapEngine controls Map.
+* @brief Map engine
*
-* @class MapEngine mapengine.h "map/mapengine.h"
+* Logic for controlling map functionality. Does also include static methods for
+* converting coordinates.
+* @author Sami Rämö - sami.ramo (at) ixonos.com
*/
class MapEngine : public QObject
{
Q_OBJECT
-
public:
/**
- * @brief Constructor for the MapEngine.
+ * @brief Constructor
*
- * @fn MapEngine
- * @param parent QObject
+ * @param parent Parent
*/
MapEngine(QObject *parent = 0);
/**
- * @brief Transforms coordinates to tile x,y values.
+ * @brief MapEngine initializer
+ *
+ * Set initial location and zoom level for the engine. locationChanged and
+ * zoomLevelChanged signals are emitted, so init should be called after
+ * those signals are connected to MapView.
+ */
+ void init();
+
+ /**
+ * @brief Convert tile x & y numbers to MapScene coordinates
+ *
+ * @param zoomLevel Zoom level
+ * @param tileNumber x & y numbers of the tile
+ * @return QPoint MapScene coordinate
+ */
+
+ static QPoint convertTileNumberToSceneCoordinate(int zoomLevel, QPoint tileNumber)
+ {
+ int pow = 1 << (MAX_MAP_ZOOM_LEVEL - zoomLevel);
+ int x = tileNumber.x() * TILE_SIZE_X * pow;
+ int y = tileNumber.y() * TILE_SIZE_Y * pow;
+
+ return QPoint(x, y);
+ }
+
+ static QPoint convertSceneCoordinateToTileNumber(int zoomLevel, QPointF sceneCoordinate)
+ {
+ int pow = 1 << (MAX_MAP_ZOOM_LEVEL - zoomLevel);
+ int x = static_cast<int>(sceneCoordinate.x() / (TILE_SIZE_X*pow));
+ int y = static_cast<int>(sceneCoordinate.y() / (TILE_SIZE_Y*pow));
+
+ return QPoint(x, y);
+ }
+
+ /**
+ * @brief Getter for scene
+ *
+ * @return QGraphicsScene
+ */
+ QGraphicsScene* scene();
+
+ /**
+ * @brief Helper for setting view location based on latitude and longitude
+ * coordinates
+ *
+ * @param latLonCoordinate Latitude & longitude coordinates for location
+ */
+ void setViewLocation(QPointF latLonCoordinate);
+
+ /**
+ * @brief Converts latitude, longitude and zoom to tile x, y values.
*
- * @fn latLonToTile
- * @param latitude latitude value
- * @param longitude longitude value
- * @param zoom zoom level
- * @return QPoint tile x,y
+ * @param latLonCoordinate latitude and longitude values
+ * @return QPoint tile x,y value
*/
- QPoint latLonToTile(qreal latitude, qreal longitude, int zoom);
+ static QPointF convertLatLonToSceneCoordinate(QPointF latLonCoordinate)
+ {
+ /// @todo CREATE TEST CASE & CHECK CALCULATION
+ qDebug() << __PRETTY_FUNCTION__;
+
+ qreal longitude = latLonCoordinate.x();
+ qreal latitude = latLonCoordinate.y();
+
+ if ((longitude > MAX_LONGITUDE) || (longitude < MIN_LONGITUDE))
+ return QPoint(UNDEFINED, UNDEFINED);
+ if ((latitude > MAX_LATITUDE) || (latitude < MIN_LATITUDE))
+ return QPoint(UNDEFINED, UNDEFINED);
+
+ qreal z = static_cast<qreal>(1 << MAX_MAP_ZOOM_LEVEL);
+
+ qreal x = static_cast<qreal>((longitude + 180.0) / 360.0);
+ qreal y = static_cast<qreal>((1.0 - log(tan(latitude * M_PI / 180.0) + 1.0
+ / cos(latitude * M_PI / 180.0)) / M_PI) / 2.0);
+ return QPointF(x*z*TILE_SIZE_X, y*z*TILE_SIZE_Y);
+ }
+
+public slots:
/**
- * @brief Transforms tile x value to longitude.
+ * @brief Slot for setting current view location
*
- * @fn tileXToLongitude
- * @param x tile x value
- * @param zoom zoom value
- * @return qreal longitude
+ * Emits locationChanged signal.
+ * @param sceneCoordinate Scene coordinates for new position
*/
- qreal tileXToLongitude(int x, int zoom);
+ void setLocation(QPointF sceneCoordinate);
+
+ void viewResized(const QSize &size);
+private:
/**
- * @brief Transforms tile y value to latitude.
+ * @brief Build URL for donwloading single map tile from OpenStreetMap tile server
*
- * @fn tileYToLatitude
- * @param y tile y value
- * @param zoom zoom value
- * @return qreal latitude
+ * @param zoomLevel Zoom level
+ * @param tileNumbers Tile x & y numbers
+ * @return URL for the required tile
*/
- qreal tileYToLatitude(int y, int zoom);
+ QUrl buildURL(int zoomLevel, QPoint tileNumbers);
+
+ /**
+ * @brief Parses given URL to zoom, x and y values. Parsed values are
+ * placed in variables given as parameters.
+ *
+ * @param url url to parse
+ * @param [out] zoom zoom variable
+ * @param [out] x x variable
+ * @param [out] y y variable
+ */
+ void parseURL(const QUrl &url, int &zoom, int &x, int &y);
+
+ /**
+ * @brief Set zValues for all tiles in the scene
+ *
+ * Drawing order of MapTiles, which has the zoom level higher than the current
+ * zoom level, is reversed and those MapTiles are mapped between lower level MapTiles.
+ * Example: If maximum zoom level is 18 and current view zoomlevel is 15, then
+ * the drawing order from top to bottom is 15, 16, 14, 17, 13, 18, 12, 11, 10, ...
+ */
+ void setZValues();
+
+ int tileMaxValue(int zoomLevel);
+
+ /**
+ * @brief Calculates grid of tile coordinates from current scene coordinate.
+ *
+ * Grid size is calculated from view size and scene's current center coordinate.
+ *
+ * @param sceneCoordinate scene's current center coordinate
+ * @return QRect grid of tile coordinates
+ */
+ QRect calculateGrid(QPointF sceneCoordinate);
+
+ /**
+ * @brief Calculate new tiles to fetch.
+ *
+ * @param sceneCoordinate scene's center coordinate
+ */
+ void calculateNewTiles(QPointF sceneCoordinate);
+
+ /**
+ * @brief Removes tiles which are out of view bounds.
+ */
+ void removeOldTiles();
+
+ /**
+ * @brief Checks if center tile has changed.
+ *
+ * @param sceneCoordinate scene's center coordinate
+ * @return bool true if center tile changed, false otherwise
+ */
+ bool centerTileChanged(QPointF sceneCoordinate);
+
+private slots:
+ /**
+ * @brief Slot for received map tile images
+ *
+ * Does add MapTile objects to MapScene. Zoom level and location is parsed from URL.
+ * @param url URL of the received image
+ * @param pixmap Received pixmap
+ */
+ void mapImageReceived(const QUrl &url, const QPixmap &pixmap);
+
+ /**
+ * @brief Slot for zooming in
+ *
+ */
+ void zoomIn();
+
+ /**
+ * @brief Slot for zooming out
+ *
+ */
+ void zoomOut();
+
+signals:
+ /**
+ * @brief Signal for view location change
+ *
+ * @param sceneCoordinate New scene coordinates
+ */
+ void locationChanged(QPointF sceneCoordinate);
+
+ /**
+ * @brief Signal for zoom level change
+ *
+ * @param newZoomLevel New zoom level
+ */
+ void zoomLevelChanged(int newZoomLevel);
+
+ void fetchImage(const QUrl &url);
+
+ void centerToSceneCoordinates(QPointF sceneCoordinate);
+
+private:
+
+ MapScene *m_mapScene; ///< Scene for map tiles
+ MapFetcher *m_mapFetcher; ///< Fetcher for map tiles
+ int m_zoomLevel; ///< Current zoom level
+ QHash<QString, MapTile *> mapTilesInScene; ///< List of map tiles in map scene
+ QSize m_viewSize;
+ QPointF m_sceneCoordinate;
+ QQueue<QString> mapTilesInView;
+ QPoint m_centerTile;
+ QRect viewGrid;
};
#endif // MAPENGINE_H