1 /****************************************************************************
2 **
3 ** Copyright (C) 2015 The Qt Company Ltd.
4 ** Contact: http://www.qt.io/licensing/
5 **
6 ** This file is part of the QtLocation module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL3$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and The Qt Company. For licensing terms
14 ** and conditions see http://www.qt.io/terms-conditions. For further
15 ** information use the contact form at http://www.qt.io/contact-us.
16 **
17 ** GNU Lesser General Public License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Lesser
19 ** General Public License version 3 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPLv3 included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 3 requirements
23 ** will be met: https://www.gnu.org/licenses/lgpl.html.
24 **
25 ** GNU General Public License Usage
26 ** Alternatively, this file may be used under the terms of the GNU
27 ** General Public License version 2.0 or later as published by the Free
28 ** Software Foundation and appearing in the file LICENSE.GPL included in
29 ** the packaging of this file. Please review the following information to
30 ** ensure the GNU General Public License version 2.0 requirements will be
31 ** met: http://www.gnu.org/licenses/gpl-2.0.html.
32 **
33 ** $QT_END_LICENSE$
34 **
35 ****************************************************************************/
36 
37 #ifndef QDECLARATIVECIRCLEMAPITEM_H
38 #define QDECLARATIVECIRCLEMAPITEM_H
39 
40 //
41 //  W A R N I N G
42 //  -------------
43 //
44 // This file is not part of the Qt API.  It exists purely as an
45 // implementation detail.  This header file may change from version to
46 // version without notice, or even be removed.
47 //
48 // We mean it.
49 //
50 
51 #include <QtLocation/private/qlocationglobal_p.h>
52 #include <QtLocation/private/qdeclarativegeomapitembase_p.h>
53 #include <QtLocation/private/qdeclarativepolylinemapitem_p_p.h>
54 #include <QSGGeometryNode>
55 #include <QSGFlatColorMaterial>
56 #include <QtPositioning/QGeoCircle>
57 
58 QT_BEGIN_NAMESPACE
59 
60 class QDeclarativeCircleMapItemPrivate;
61 class Q_LOCATION_PRIVATE_EXPORT QDeclarativeCircleMapItem : public QDeclarativeGeoMapItemBase
62 {
63     Q_OBJECT
64     Q_ENUMS(Backend)
65 
66     Q_PROPERTY(QGeoCoordinate center READ center WRITE setCenter NOTIFY centerChanged)
67     Q_PROPERTY(qreal radius READ radius WRITE setRadius NOTIFY radiusChanged)
68     Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged)
69     Q_PROPERTY(QDeclarativeMapLineProperties *border READ border CONSTANT)
70     Q_PROPERTY(Backend backend READ backend WRITE setBackend NOTIFY backendChanged REVISION 15)
71 
72 public:
73     enum Backend {
74         Software = 0,
75         OpenGL = 1
76     };
77 
78     explicit QDeclarativeCircleMapItem(QQuickItem *parent = nullptr);
79     ~QDeclarativeCircleMapItem() override;
80 
81     virtual void setMap(QDeclarativeGeoMap *quickMap, QGeoMap *map) override;
82     virtual QSGNode *updateMapItemPaintNode(QSGNode *, UpdatePaintNodeData *) override;
83 
84     QGeoCoordinate center();
85     void setCenter(const QGeoCoordinate &center);
86 
87     qreal radius() const;
88     void setRadius(qreal radius);
89 
90     QColor color() const;
91     void setColor(const QColor &color);
92 
93     QDeclarativeMapLineProperties *border();
94 
95     bool contains(const QPointF &point) const override;
96     const QGeoShape &geoShape() const override;
97     void setGeoShape(const QGeoShape &shape) override;
98 
99     Backend backend() const;
100     void setBackend(Backend b);
101 
102 Q_SIGNALS:
103     void centerChanged(const QGeoCoordinate &center);
104     void radiusChanged(qreal radius);
105     void colorChanged(const QColor &color);
106     void backendChanged();
107 
108 protected:
109     void geometryChanged(const QRectF &newGeometry, const QRectF &oldGeometry) override;
110     void updatePolish() override;
111     void possiblySwitchBackend(const QGeoCoordinate &oldCenter, qreal oldRadius, const QGeoCoordinate &newCenter, qreal newRadius);
112 
113 protected Q_SLOTS:
114     void markSourceDirtyAndUpdate();
115     void onLinePropertiesChanged();
116     virtual void afterViewportChanged(const QGeoMapViewportChangeEvent &event) override;
117 
118 private:
119     void updateCirclePath();
120 
121 private:
122     QGeoCircle m_circle;
123     QDeclarativeMapLineProperties m_border;
124     QColor m_color;
125     bool m_dirtyMaterial;
126     bool m_updatingGeometry;
127     Backend m_backend = Software;
128 
129     QScopedPointer<QDeclarativeCircleMapItemPrivate> m_d;
130 
131     friend class QDeclarativeCircleMapItemPrivate;
132     friend class QDeclarativeCircleMapItemPrivateCPU;
133     friend class QDeclarativeCircleMapItemPrivateOpenGL;
134 };
135 
136 //////////////////////////////////////////////////////////////////////
137 
138 QT_END_NAMESPACE
139 
140 QML_DECLARE_TYPE(QDeclarativeCircleMapItem)
141 
142 #endif /* QDECLARATIVECIRCLEMAPITEM_H */
143