mapcontrol.h

/*
*
* This file is part of QMapControl,
* an open-source cross-platform map widget
*
* Copyright (C) 2007 - 2008 Kai Winter
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with QMapControl. If not, see <http://www.gnu.org/licenses/>.
*
* Contact e-mail: kaiwinter@gmx.de
* Program URL   : http://qmapcontrol.sourceforge.net/
*
*/

#ifndef MAPCONTROL_H
#define MAPCONTROL_H

#include "qmapcontrol_global.h"
#include "layermanager.h"
#include "layer.h"
#include "mapadapter.h"
#include "geometry.h"
#include "imagemanager.h"

#include <QWidget>

namespace qmapcontrol
{
    class LayerManager;
    class MapAdapter;
    class Layer;


    class QMAPCONTROL_EXPORT MapControl : public QWidget
    {
        Q_OBJECT

    public:
        enum MouseMode
        {
            Panning, 
            Dragging, 
            None 
        };


        MapControl (QWidget * parent = 0, Qt::WindowFlags windowFlags = 0);


        MapControl ( QSize size, MouseMode mousemode = Panning, bool showScale = false, bool showCrosshairs = true, QWidget * parent = 0, Qt::WindowFlags windowFlags = 0);

        ~MapControl();


        void addLayer ( Layer* layer );


        void removeLayer ( Layer* layer );


        Layer* layer ( const QString& layername ) const;


        QList<QString> layers() const;


        int numberOfLayers() const;


        QPointF currentCoordinate() const;


        int currentZoom() const;

        void updateView() const;


        void enableMouseWheelEvents( bool enabled = true );


        bool mouseWheelEventsEnabled();
        

        void setView ( const QPointF& coordinate ) const;


        void setView ( const QList<QPointF> coordinates ) const;


        void setViewAndZoomIn ( const QList<QPointF> coordinates ) const;


        void setView ( const Point* point ) const;


        void followGeometry ( const Geometry* geometry ) const;

        //TODO:
        // void followGeometry(const QList<Geometry*>) const;


        void stopFollowing ( const Geometry* geometry ) const;


        void moveTo     ( QPointF coordinate );


        void setMouseMode ( MouseMode mousemode );


        MapControl::MouseMode mouseMode();

        //int rotation;


        void enablePersistentCache ( int tileExpiry = -1, const QDir& path= QDir::homePath() + "/QMapControl.cache" );


        void setProxy(QString host, int port, const QString username = QString(), const QString password = QString());


        void showScale ( bool visible );

        void showCrosshairs ( bool visible );


        void setUseBoundingBox( bool usebounds );


        bool isBoundingBoxEnabled();


        void setBoundingBox( QRectF &rect );


        QRectF getBoundingBox();


        QRectF getViewport();


        bool isGeometryVisible( Geometry * geometry);


        int loadingQueueSize();

    private:
        LayerManager* layermanager;
        QPoint screen_middle; // middle of the widget (half size)

        QPoint pre_click_px; // used for scrolling (MouseMode Panning)
        QPoint current_mouse_pos; // used for scrolling and dragging (MouseMode Panning/Dragging)

        QSize size; // size of the widget

        bool mouse_wheel_events;
        bool mousepressed;
        MouseMode mymousemode;
        bool scaleVisible;
        bool crosshairsVisible;

        bool m_loadingFlag;

        QMutex moveMutex; // used for method moveTo()
        QPointF target; // used for method moveTo()
        int steps; // used for method moveTo()

        QPointF clickToWorldCoordinate ( QPoint click );

        Q_DISABLE_COPY( MapControl )

    protected:
        void paintEvent ( QPaintEvent* evnt );
        void mousePressEvent ( QMouseEvent* evnt );
        void mouseReleaseEvent ( QMouseEvent* evnt );
        void mouseMoveEvent ( QMouseEvent* evnt );
        void wheelEvent( QWheelEvent* evnt );

    signals:
        // void mouseEvent(const QMouseEvent* evnt);


        void mouseEventCoordinate ( const QMouseEvent* evnt, const QPointF coordinate );


        void boxDragged ( const QRectF );


        void geometryClicked ( Geometry* geometry, QPoint coord_px );


        void viewChanged ( const QPointF &coordinate, int zoom ) const;

    public slots:
        void zoomIn();

        void zoomOut();


        void setZoom ( int zoomlevel );

        void scrollLeft ( int pixel=10 );

        void scrollRight ( int pixel=10 );

        void scrollUp ( int pixel=10 );

        void scrollDown ( int pixel=10 );

        void scroll ( const QPoint scroll );


        void updateRequest ( QRect rect );


        void updateRequestNew();


        void resize(const QSize newSize);

    private slots:
        void tick();
        void loadingFinished();
        void positionChanged ( Geometry* geom );

    };
}
#endif