/*
- Situare - A location system for Facebook
- Copyright (C) 2010 Ixonos Plc. Authors:
-
- Henri Lampela - henri.lampela@ixonos.com
- Kaj Wallin - kaj.wallin@ixonos.com
- Sami Rämö - sami.ramo@ixonos.com
-
- Situare is free software; you can redistribute it and/or
- modify it under the terms of the GNU General Public License
- version 2 as published by the Free Software Foundation.
-
- Situare is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with Situare; if not, write to the Free Software
- Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
- USA.
+ Situare - A location system for Facebook
+ Copyright (C) 2010 Ixonos Plc. Authors:
+
+ Henri Lampela - henri.lampela@ixonos.com
+ Kaj Wallin - kaj.wallin@ixonos.com
+ Sami Rämö - sami.ramo@ixonos.com
+ Katri Kaikkonen - katri.kaikkonen@ixonos.com
+
+ Situare is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License
+ version 2 as published by the Free Software Foundation.
+
+ Situare is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with Situare; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
+ USA.
*/
#ifndef MAINWINDOW_H
#include <QUrl>
#include "network/networkcookiejar.h"
-#include "panelsidebar.h"
class QGraphicsScene;
class QLabel;
-class QWebView;
+class QMessageBox;
class QNetworkReply;
+class QToolButton;
+class QWebView;
class FacebookAuthentication;
+class FullScreenButton;
class FriendListPanel;
+class IndicatorButton;
+class GeoCoordinate;
+class MapScale;
class MapScene;
class MapView;
+class TabbedPanel;
+class SettingsDialog;
+class SceneCoordinate;
class SituareService;
class User;
class UserInfoPanel;
class ZoomButtonPanel;
-class SettingsDialog;
-class QToolButton;
/**
* @brief Main Window Class
public:
/**
- * @brief Constructor
- *
- * @param parent Parent
- */
+ * @brief Constructor
+ *
+ * @param parent Parent
+ */
MainWindow(QWidget *parent = 0);
/**
- * @brief Destructor
- *
- */
+ * @brief Destructor
+ *
+ */
~MainWindow();
/*******************************************************************************
******************************************************************************/
private:
/**
- * @brief HW increase and decrease key presses are grabbed and used for zooming the map.
- */
+ * @brief HW increase and decrease key presses are grabbed and used for zooming the map.
+ */
void keyPressEvent(QKeyEvent* event);
/*******************************************************************************
******************************************************************************/
public:
/**
- * @brief Builds information box with message.
- *
- * @param message Information message
- * @param modal Modal = true, non-modal false
- */
- void buildInformationBox(const QString &message, bool modal=false);
-
- /**
- * @brief Clears cookie jar
- *
- */
+ * @brief Clears cookie jar
+ *
+ */
void clearCookieJar();
/**
- * @brief
- *
- * @param logged
- */
+ * @brief
+ *
+ * @param logged
+ */
void loggedIn(bool logged);
/**
- * @brief Enable / disable auto centering button.
- *
- * @param enabled true if shoud be enabled, false otherwise
- */
- void setAutoCenteringButtonEnabled(bool enabled);
+ * @brief Gets the login state (logged in/logged out)
+ *
+ * @return bool Login state
+ */
+ bool loginState();
/**
- * @brief Enable / disable GPS button.
- *
- * Does set visibilities for manual location cursor and auto centering menu button.
- *
- * @param enabled true if enabled, false otherwise
- */
+ * @brief Reads automatic location update settings.
+ */
+ void readAutomaticLocationUpdateSettings();
+
+ /**
+ * @brief Enable / disable GPS button.
+ *
+ * Does set visibilities for manual location cursor and auto centering menu button.
+ *
+ * @param enabled true if enabled, false otherwise
+ */
void setGPSButtonEnabled(bool enabled);
/**
- * @brief Set scene for MapView
- *
- * @param scene Scene to be set
- */
+ * @brief Enable / disable direction indicator button.
+ *
+ * @param enabled true if shoud be enabled, false otherwise
+ */
+ void setIndicatorButtonEnabled(bool enabled);
+
+ /**
+ * @brief Set scene for MapView
+ *
+ * @param scene Scene to be set
+ */
void setMapViewScene(QGraphicsScene *scene);
/**
- * @brief Gets the username from member variable for saving purposes
- *
- * @return QString Username
- */
+ * Shows dialog with enable automatic location update question.
+ *
+ * @param text text to show in dialog
+ */
+ void showEnableAutomaticUpdateLocationDialog(const QString &text);
+
+ /**
+ * @brief Gets the username from member variable for saving purposes
+ *
+ * @return QString Username
+ */
const QString username();
public slots:
/**
- * @brief Slot to intercept signal when login has failed (loginFailure signal)
- *
- */
+ * @brief Build direction indicator button and connect slots
+ */
+ void buildIndicatorButton();
+
+ /**
+ * @brief Builds information box with message.
+ *
+ * @param message Information message
+ * @param modal Modal = true, non-modal false
+ */
+ void buildInformationBox(const QString &message, bool modal=false);
+
+ /**
+ * @brief Slot for failed login
+ */
void loginFailed();
/**
- * @brief Slot to intercept signal when login with cookies is requested
- *
- */
+ * @brief Slot to intercept signal when login with cookies is requested
+ */
void loginUsingCookies();
/**
- * @brief Public slot, which open settings dialog
- */
+ * @brief Public slot, which open settings dialog
+ */
void openSettingsDialog();
/**
- * @brief Sets username to member variable for login dialog
- *
- * @param username Username to be set
- */
+ * @brief Set own location crosshair visibility
+ *
+ * @param visible
+ */
+ void setOwnLocationCrosshairVisibility(bool visible);
+
+ /**
+ * @brief Sets username to member variable for login dialog
+ *
+ * @param username Username to be set
+ */
void setUsername(const QString &username);
/**
- * @brief Public slot to intercept signal when old cerdentials are invalid or credentials
- * doesn't exist yet
- *
- */
+ * @brief Method to show panels
+ */
+ void showPanels();
+
+ /**
+ * @brief Public slot to intercept signal when old cerdentials are invalid or credentials
+ * doesn't exist yet
+ *
+ */
void startLoginProcess();
/**
- * @brief Toggle progress indicator.
- *
- * @param state true if progress indicator should be shown, false otherwise
- */
+ * @brief Toggle progress indicator.
+ *
+ * @param state true if progress indicator should be shown, false otherwise
+ */
void toggleProgressIndicator(bool state);
/**
- * @brief Shows / hides Situare related UI items
- *
- * @param show
- */
- void updateItemVisibility(bool show);
+ * @brief Shows / hides Situare related UI items
+ *
+ */
+ void updateItemVisibility();
private:
/**
- * @brief Build fullscreen toggle button and connect slots
- */
+ * @brief Build fullscreen toggle button and connect slots
+ */
void buildFullScreenButton();
/**
- * @brief Build friend list panel and connect slots
- */
+ * @brief Build friend list panel and connect slots
+ */
void buildFriendListPanel();
/**
- * @brief Build manual location setting cross hair and connect slots
- */
+ * @brief Build manual location setting cross hair and connect slots
+ */
void buildManualLocationCrosshair();
/**
- * @brief Build map and connect slots
- */
+ * @brief Build map and connect slots
+ */
void buildMap();
/**
- * @brief Build OSM license and connect slots
- */
+ * @brief Build map scale and connect slots
+ */
+ void buildMapScale();
+
+ /**
+ * @brief Build OSM license and connect slots
+ */
void buildOsmLicense();
/**
- * @brief Build user info panel and connect slots
- */
+ * @brief Build user info panel and connect slots
+ */
void buildUserInfoPanel();
/**
- * @brief Build webview and connect slots
- *
- */
+ * @brief Build webview and connect slots
+ */
void buildWebView();
/**
- * @brief Build zoom button panel and connect slots
- */
+ * @brief Build zoom button panel and connect slots
+ */
void buildZoomButtonPanel();
/**
- * @brief Private method to create the Menu items
- */
+ * @brief Private method to create the Menu items
+ */
void createMenus();
/**
- * @brief Grab or release HW increase and decrease buttons.
- *
- * @param grab Use true for grabbing and false for releasing the keys
- */
+ * @brief Grab or release HW increase and decrease buttons.
+ *
+ * @param grab Use true for grabbing and false for releasing the keys
+ */
void grabZoomKeys(bool grab);
/**
- * @brief Queues dialog/information box
- *
- * @param dialog Dialog to be added into queue
- */
+ * @brief Queues dialog/information box
+ *
+ * @param dialog Dialog to be added into queue
+ */
void queueDialog(QDialog *dialog);
/**
- * @brief Set own location crosshair visibility
- *
- * @param visible
- */
- void setOwnLocationCrosshairVisibility(bool visible);
-
- void showErrorNote();
+ * @brief Shows queued error information box
+ *
+ */
+ void showErrorInformationBox();
/**
- * @brief Shows queued information box
- *
- * @fn showInformationBox
- */
+ * @brief Shows queued information box
+ *
+ * @fn showInformationBox
+ */
void showInformationBox();
private slots:
/**
- * @brief Slot to intercept signal when dialog/information note is processed
- *
- * @param status Status of the dialog
- */
+ * @brief Slot for automatic update dialog finished.
+ *
+ * @result result code
+ */
+ void automaticUpdateDialogFinished(int result);
+
+ /**
+ * @brief Slot to intercept signal when dialog/information note is processed
+ *
+ * @param status Status of the dialog
+ */
void dialogFinished(int status);
/**
- * @brief Slot for drawing the fullscreen toggle button
- *
- * @param size Size of the screen
- */
+ * @brief Slot for drawing the fullscreen toggle button
+ *
+ * @param size Size of the screen
+ */
void drawFullScreenButton(const QSize &size);
/**
- * @brief Slot for drawing the Open Street Map license text
- *
- * @param size Size of the screen
- */
+ * @brief Slot for drawing the map distance scale
+ *
+ * @param size Size of the screen
+ */
+ void drawMapScale(const QSize &size);
+
+ /**
+ * @brief Slot for drawing the Open Street Map license text
+ *
+ * @param size Size of the screen
+ */
void drawOsmLicense(const QSize &size);
/**
- * @brief Slot for drawing the own location crosshair
- *
- * @param width Width of the viewport
- * @param height Height of the viewport
- */
- void drawOwnLocationCrosshair(int width, int height);
+ * @brief Slot for drawing the own location crosshair
+ *
+ * @param size Size of the screen
+ */
+ void drawOwnLocationCrosshair(const QSize &size);
/**
- * @brief Slot for gps timeout.
- *
- * Called when request timeout occurs.
- */
+ * @brief Slot to intercept signal when error dialog/information note is processed
+ *
+ * @param status Status of the dialog
+ */
+ void errorDialogFinished(int status);
+
+ /**
+ * @brief Slot for gps timeout.
+ *
+ * Called when request timeout occurs.
+ */
void gpsTimeout();
/**
- * @brief Slot to load cookies from settings
- *
- */
+ * @brief Slot to load cookies from settings
+ */
void loadCookies();
/**
- * @brief Slot to intercept signal when webview has finished loading webpage
- *
- * @param done Status of the loading
- */
+ * @brief Slot to intercept signal when webview has finished loading webpage
+ *
+ * @param done Status of the loading
+ */
void loadDone(bool done);
/**
- * @brief Slot to save cookies to settings
- *
- */
+ * @brief Slot to save cookies to settings
+ */
void saveCookies();
/**
- * @brief Set correnct view port size to datamembers
- *
- * @param width Width of the viewport
- * @param height Height of the viewport
- */
- void setViewPortSize(const int width, const int height);
+ * @brief Slot for settings dialog accepted.
+ */
+ void settingsDialogAccepted();
/**
- * @brief Toggle between fullscreen and normal window mode
- */
+ * @brief Set correnct view port size to datamembers
+ *
+ * @param size Size of the screen
+ */
+ void setViewPortSize(const QSize &size);
+
+ /**
+ * @brief Start location search (open search dialog)
+ */
+ void startLocationSearch();
+
+ /**
+ * @brief Toggle between fullscreen and normal window mode
+ */
void toggleFullScreen();
+ /**
+ * @brief Slot to intercept signal from webview's networkaccessmanager
+ *
+ * @param reply Network reply (contains errors)
+ */
void webViewRequestFinished(QNetworkReply* reply);
- void errorNoteFinished();
-
/*******************************************************************************
* SIGNALS
******************************************************************************/
signals:
/**
- * @brief Automatic centering setting changed by user
- *
- * @param enabled True if automatic centering is enabled, otherwise false
- */
+ * @brief Automatic centering setting changed by user
+ *
+ * @param enabled True if automatic centering is enabled, otherwise false
+ */
void autoCenteringTriggered(bool enabled);
/**
- * @brief Signal that indicates when user has cancelled login process
- *
- */
+ * @brief Signal that indicates when user has cancelled login process
+ *
+ */
void cancelLoginProcess();
/**
- * @brief View should be centered to new location
- *
- * @param sceneCoordinate Scene coordinates of the new center point
- */
- void centerToSceneCoordinates(QPoint sceneCoordinate);
+ * @brief View should be centered to new location
+ *
+ * @param coordinate Scene coordinates of the new center point
+ */
+ void centerToSceneCoordinates(const SceneCoordinate &coordinate);
/**
- * @brief Signal for enabling automatic location update.
- *
- * @param enabled true if enabled, false otherwise
- * @param updateIntervalMsecs update interval in milliseconds
- */
- void enableAutomaticLocationUpdate(bool enabled, int updateIntervalMsecs);
+ * @brief Signal for enabling automatic location update.
+ *
+ * @param enabled true if enabled, false otherwise
+ * @param updateIntervalMsecs update interval in milliseconds
+ */
+ void enableAutomaticLocationUpdate(bool enabled, int updateIntervalMsecs = 0);
/**
- * @brief Signal for requesting username from settings
- *
- */
+ * @brief Signals error
+ *
+ * @param context error context
+ * @param error error code
+ */
+ void error(const int context, const int error);
+
+ /**
+ * @brief Signal for requesting username from settings
+ *
+ */
void fetchUsernameFromSettings();
/**
- * @brief Signal for finding user.
- *
- * @param coordinates user geo coordinates
- */
- void findUser(const QPointF &coordinates);
+ * @brief Signal for finding user.
+ *
+ * @param coordinates user geo coordinates
+ */
+ void findUser(const GeoCoordinate &coordinates);
/**
- * @brief GPS setting changed
- *
- * @param enabled True if GPS is enabled, otherwise false
- */
+ * @brief Signals when friend's profile image is ready
+ *
+ * @param user Friend
+ */
+ void friendImageReady(User *user);
+
+ /**
+ * @brief GPS setting changed
+ *
+ * @param enabled True if GPS is enabled, otherwise false
+ */
void gpsTriggered(bool enabled);
/**
- * @brief Signal for finding friend.
- *
- * @param coordinates friend's geo coordinates
- */
- void findFriend(const QPointF &coordinates);
+ * @brief Signal for finding friend.
+ *
+ * @param coordinates friend's geo coordinates
+ */
+ void findFriend(const GeoCoordinate &coordinates);
/**
- * @brief Signal for friend location ready.
- *
- * @param friendsList
- */
+ * @brief Signal for friend location ready.
+ *
+ * @param friendsList
+ */
void friendsLocationsReady(QList<User *> &friendsList);
/**
- * @brief Signal is emitted when location item is clicked.
- *
- * @param userIDs list of friends user IDs in the group
- */
+ * @brief Signal is emitted when location item is clicked.
+ *
+ * @param userIDs list of friends user IDs in the group
+ */
void locationItemClicked(const QList<QString> &userIDs);
/**
- * @brief Signals when Login/Logout action is pressed
- *
- */
+ * @brief Signals when Login/Logout action is pressed
+ *
+ */
void loginActionPressed();
/**
- * @brief MapView has been resized
- *
- * @param size view size
- */
+ * @brief MapView has been resized
+ *
+ * @param size view size
+ */
void mapViewResized(const QSize &size);
/**
- * @brief Forwarding signal from MapView to MapEngine
- *
- * @param sceneCoordinate
- */
- void mapViewScrolled(QPoint sceneCoordinate);
+ * @brief Forwarding signal from MapView to MapEngine
+ *
+ * @param coordinate
+ */
+ void mapViewScrolled(const SceneCoordinate &coordinate);
/**
- * @brief Forwarding signal from MapEngine to MapView
- */
+ * @brief Forwarding signal from MapEngine to MapView
+ */
void maxZoomLevelReached();
/**
- * @brief Forwarding signal from MapEngine to MapView
- */
+ * @brief Forwarding signal from MapEngine to MapView
+ */
void minZoomLevelReached();
/**
- * @brief Signal for refreshing user data.
- *
- */
+ * @brief Forwarding signal from MapEngine to MapScale
+ */
+ void newMapResolution(qreal scale);
+
+ /**
+ * @brief Signal for refreshing user data.
+ *
+ */
void refreshUserData();
/**
- * @brief Signal for requesting reverseGeo from SituareEngine
- *
- */
+ * @brief Signal for requesting reverseGeo from SituareEngine
+ *
+ */
void requestReverseGeo();
/**
- * @brief Signals, when address data is ready
- *
- * @param address Street address
- */
+ * @brief Signals, when address data is ready
+ *
+ * @param address Street address
+ */
void reverseGeoReady(const QString &address);
/**
- * @brief Signal to save username to settings
- *
- * @param username Username
- */
+ * @brief Signal to save username to settings
+ *
+ * @param username Username
+ */
void saveUsername(const QString &username);
/**
- * @brief Signal for requestLocationUpdate from SituareEngine
- *
- * @param status Status message
- * @param publish Publish on Facebook
- */
+ * @brief Signal for location search
+ *
+ * @param location QString location
+ */
+ void searchForLocation(QString location);
+
+ /**
+ * @brief Signal for requestLocationUpdate from SituareEngine
+ *
+ * @param status Status message
+ * @param publish Publish on Facebook
+ */
void statusUpdate(const QString &status, const bool &publish);
/**
- * @brief Signals when webview's urlChanged signal is emitted
- *
- * @param url New url
- */
+ * @brief Signals when webview's urlChanged signal is emitted
+ *
+ * @param url New url
+ */
void updateCredentials(const QUrl &url);
/**
- * @brief MapView has finished zooming
+ * @brief Signals when updateLocationDialog's data must be cleared
+ *
+ */
+ void clearUpdateLocationDialogData();
+
+ /**
+ * @brief Dragging mode triggered.
*/
+ void draggingModeTriggered();
+
+ /**
+ * @brief MapView has finished zooming
+ */
void viewZoomFinished();
/**
- * @brief Signal for use location ready.
- *
- * @param user User object
- */
+ * @brief Signal for use location ready.
+ *
+ * @param user User object
+ */
void userLocationReady(User *user);
/**
- * @brief Map zoom in request
- */
+ * @brief Map zoom in request
+ */
void zoomIn();
/**
- * @brief Forwarding signal from MapEngine to MapView
- */
+ * @brief Forwarding signal from MapEngine to MapView
+ */
void zoomLevelChanged(int zoomLevel);
/**
- * @brief Map zoom out request
- */
+ * @brief Map zoom out request
+ */
void zoomOut();
/*******************************************************************************
* DATA MEMBERS
******************************************************************************/
private:
- bool m_drawOwnLocationCrosshair; ///< Flag for making ownLocationCrosshair visible or not
+ bool m_errorShown; ///< Indicates if error dialog/note is shown
bool m_loggedIn; ///< Indicates login state
bool m_refresh; ///< Indicates when webpage is refreshed
- int m_viewPortHeight; ///< Height of view port
- int m_viewPortWidth; ///< Width of view port
+ int m_progressIndicatorCount; ///< Indicates the number of progress indicator calls
- QAction *m_autoCenteringAct; ///< Action to auto center map using gps position
QAction *m_gpsToggleAct; ///< Action to trigger gps toggle
QAction *m_loginAct; ///< Action to Login/Logout
QAction *m_toSettingsAct; ///< Action to trigger switch to settings dialog
+ QAction *m_searchLocationAct; /// @todo this is temporary, remove when not needed!
QLabel *m_osmLicense; ///< Label for Open Street Map license
QLabel *m_ownLocationCrosshair; ///< Label that show ownLocationCrosshair
+ QList<QDialog *> m_error_queue; ///< QList type error dialog queue
+ QList<QDialog *> m_queue; ///< QList type dialog queue
+
QMenu *m_viewMenu; ///< Object that hold the view menu items
+ QMessageBox *m_automaticUpdateLocationDialog; ///< Automatic update location dialog
+
+ QSize m_viewPortSize; ///< Size of the viewport
+
QString m_email; ///< Placeholder for email
QString m_password; ///< Placeholder for password
- QToolButton *m_fullScreenButton; ///< Instance of the fullscreen toggle button
-
QWebView *m_webView; ///< Shows facebook login page
FriendListPanel *m_friendsListPanel; ///< Instance of friends list panel
+ FullScreenButton *m_fullScreenButton; ///< Instance of the fullscreen toggle button
+ IndicatorButton *m_indicatorButton; ///< Instance of direction indicator button
+ MapScale *m_mapScale; ///< Instance of the map scale
MapView *m_mapView; ///< Instance of the map view
NetworkCookieJar *m_cookieJar; ///< Placeholder for QNetworkCookies
- PanelSideBar *m_userPanelSidebar; ///< User panel side bar
- PanelSideBar *m_friendsListPanelSidebar;///< Friends panel side bar
- UserInfoPanel *m_userPanel; ///< Instance of the user information panel
+ TabbedPanel *m_tabbedPanel; ///< Widget for tabbed panels
+ UserInfoPanel *m_userInfoPanel; ///< Instance of the user information panel
ZoomButtonPanel *m_zoomButtonPanel; ///< Instance of zoom button panel
-
- SettingsDialog *m_settingsDialog; ///< Settings dialog
-
- QList<QDialog *> m_queue;
- QList<QDialog *> m_modal_queue;
};
#endif // MAINWINDOW_H