Subversion Repositories Projects

Rev

Rev 391 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
305 KeyOz 1
/*
2
*
3
* This file is part of QMapControl,
4
* an open-source cross-platform map widget
5
*
6
* Copyright (C) 2007 - 2008 Kai Winter
7
*
8
* This program is free software: you can redistribute it and/or modify
9
* it under the terms of the GNU Lesser General Public License as published by
10
* the Free Software Foundation, either version 3 of the License, or
11
* (at your option) any later version.
12
*
13
* This program is distributed in the hope that it will be useful,
14
* but WITHOUT ANY WARRANTY; without even the implied warranty of
15
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16
* GNU Lesser General Public License for more details.
17
*
18
* You should have received a copy of the GNU Lesser General Public License
19
* along with QMapControl. If not, see <http://www.gnu.org/licenses/>.
20
*
21
* Contact e-mail: kaiwinter@gmx.de
22
* Program URL   : http://qmapcontrol.sourceforge.net/
23
*
24
*/
25
 
26
#ifndef LINESTRING_H
27
#define LINESTRING_H
28
 
29
#include "curve.h"
30
 
31
namespace qmapcontrol
32
{
33
    //! A collection of Point objects to describe a line
34
    /*!
35
     * A LineString is a Curve with linear interpolation between Points. Each consecutive pair of Points defines a Line segment.
36
     *  @author Kai Winter <kaiwinter@gmx.de>
37
     */
38
    class LineString : public Curve
39
    {
40
        Q_OBJECT
41
 
42
    public:
43
        LineString();
44
        //! constructor
45
        /*!
46
         * The constructor of a LineString takes a list of Points to form a line.
47
         * @param points a list of points
48
         * @param name the name of the LineString
49
         * @param pen a QPen can be used to modify the look of the line.
50
         * @see http://doc.trolltech.com/4.3/qpen.html
51
         */
52
        LineString ( QList<Point*> const points, QString name = QString(), QPen* pen = 0 );
53
        virtual ~LineString();
54
 
55
        //! returns the points of the LineString
56
        /*!
57
         * @return  a list with the points of the LineString
58
         */
59
        QList<Point*>   points();
60
 
61
        //! adds a point at the end of the LineString
62
        /*!
63
         * @param point the point which should be added to the LineString
64
         */
65
        void addPoint ( Point* point );
66
 
67
        //! sets the given list as points of the LineString
68
        /*!
69
         * @param points the points which should be set for the LineString
70
         */
71
        void setPoints ( QList<Point*> points );
72
 
73
        //! returns the number of Points the LineString consists of
74
        /*!
75
         * @return the number of the LineString´s Points
76
         */
77
        int numberOfPoints() const;
78
 
79
        // virtual Geometry     Clone();
80
        virtual QRectF boundingBox();
81
        // virtual Point EndPoint();
82
        // virtual Point StartPoint();
83
        // virtual Point Value();
84
 
85
        //! returns true if the LineString has Childs
86
        /*!
87
         * This is equal to: numberOfPoints() > 0
88
         * @return true it the LineString has Childs (=Points)
89
         * @see clickedPoints()
90
         */
91
        virtual bool hasPoints() const;
92
 
93
        //! returns true if the LineString has clicked Points
94
        /*!
95
         * @return true if childs of a LineString were clicked
96
         * @see clickedPoints()
97
         */
98
        virtual bool hasClickedPoints() const;
99
 
100
        //! returns the clicked Points
101
        /*!
102
         * If a LineString was clicked it could be neccessary to figure out which of its points where clicked.
103
         * Do do so the methods hasPoints() and clickedPoints() can be used.
104
         * When a point is added to a LineString the Point becomes its child.
105
         * It is possible (depending on the zoomfactor) to click more than one Point of a LineString, so this method returns a list.
106
         * @return the clicked Points of the LineString
107
         */
108
        virtual QList<Geometry*> clickedPoints();
109
 
110
    protected:
111
        virtual bool Touches ( Geometry* geom, const MapAdapter* mapadapter );
112
        virtual bool Touches ( Point* geom, const MapAdapter* mapadapter );
113
        virtual void draw ( QPainter* painter, const MapAdapter* mapadapter, const QRect &screensize, const QPoint offset );
114
 
115
    private:
116
        QList<Point*>   vertices;
117
        QList<Geometry*>        touchedPoints;
118
    };
119
}
120
#endif