Merge branch 'map' of https://vcs.maemo.org/git/situare into map
[situare] / src / map / mapview.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
7    Situare is free software; you can redistribute it and/or
8    modify it under the terms of the GNU General Public License
9    version 2 as published by the Free Software Foundation.
10
11    Situare is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with Situare; if not, write to the Free Software
18    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301,
19    USA.
20 */
21
22 #ifndef MAPVIEW_H
23 #define MAPVIEW_H
24
25 #include <QGraphicsView>
26
27 /**
28 * @brief Map view widget
29 *
30 * @author Sami Rämö - sami.ramo (at) ixonos.com
31 */
32 class MapView : public QGraphicsView
33 {
34     Q_OBJECT
35 public:
36     /**
37     * @brief Constructor
38     *
39     * @param parent Parent
40     */
41     MapView(QWidget *parent = 0);
42
43 signals:
44     /**
45     * @brief Signal for view scroll events
46     *
47     * Signal is emitted when view scroll is requested with mouse (or finger).
48     * @param sceneCoordinate Scene coordinates of the new requested center point of the view
49     */
50     void viewScrolled(QPointF sceneCoordinate);
51
52     void viewResized(const QSize &size);
53
54 public slots:
55     /**
56     * @brief Slot for centering view to new location
57     *
58     * @param sceneCoordinate Scene coordinates of the new center point
59     */
60     void centerToSceneCoordinates(QPointF sceneCoordinate);
61
62 protected:
63     void resizeEvent(QResizeEvent *event);
64
65 private slots:
66     /**
67     * @brief Slot for mouse move events
68     *
69     * Does calculate mouse movement delta from last event position and new view center
70     * based on that delta. Saves current event position for next round. Emits viewScrolled
71     * signal and doesn't actually scroll the view.
72     * @param event Mouse event
73     */
74     void mouseMoveEvent(QMouseEvent *event);
75
76     /**
77     * @brief Slot for mouse press events
78     *
79     * Saves inial values for mouse and scene location for dragging view.
80     * @param event Mouse event
81     */
82     void mousePressEvent(QMouseEvent *event);
83
84     /**
85     * @brief Set zoom level of the view
86     *
87     * @param zoomLevel Zoom level
88     */
89     void setZoomLevel(int zoomLevel);
90
91 private:
92     QPointF m_mousePosition; ///< Previous mouse event position
93     QPointF m_scenePosition; ///< New center position
94 };
95
96 #endif // MAPVIEW_H