Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qgeoprojection_p.h
Go to the documentation of this file.
1// Copyright (C) 2016 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3
4#ifndef QGEOPROJECTION_H
5#define QGEOPROJECTION_H
6
7//
8// W A R N I N G
9// -------------
10//
11// This file is not part of the Qt API. It exists purely as an
12// implementation detail. This header file may change from version to
13// version without notice, or even be removed.
14//
15// We mean it.
16//
17
18#include <QMatrix4x4>
19#include <QTransform>
20
21#include <QtLocation/private/qlocationglobal_p.h>
22#include <QtLocation/private/qgeocameradata_p.h>
23#include <QtPositioning/private/qdoublematrix4x4_p.h>
24
25QT_BEGIN_NAMESPACE
26
27class QGeoShape;
28class QGeoRectangle;
29
30class Q_LOCATION_EXPORT QGeoProjection
31{
32public:
33 enum ProjectionGroup {
34 ProjectionOther,
35 ProjectionCylindrical,
36 ProjectionPseudocylindrical,
37 ProjectionAzimuthal,
38 ProjectionPseudoazimuthal,
39 ProjectionConic,
40 ProjectionPseudoconic
41 //Polyhedral
42 //Retroazimuthal
43 };
44
45 enum Datum {
46 DatumUnknown,
47 DatumWGS84,
48 DatumSphere
49 };
50
51 enum ProjectionType {
52 ProjectionUnknown,
53 ProjectionGeneralPerspective,
54 ProjectionWebMercator
55 };
56
57 QGeoProjection();
58 virtual ~QGeoProjection();
59
60 virtual void setVisibleArea(const QRectF &visibleArea) = 0;
61 virtual void setViewportSize(const QSize &size) = 0;
62 virtual void setCameraData(const QGeoCameraData &cameraData, bool force = true) = 0;
63 virtual QGeoCameraData cameraData() const = 0;
64
65 // returns the minimum zoom at the current viewport size
66 virtual double minimumZoom() const = 0;
67 virtual double maximumCenterLatitudeAtZoom(const QGeoCameraData &cameraData) const = 0;
68 virtual double minimumCenterLatitudeAtZoom(const QGeoCameraData &cameraData) const = 0;
69
70 virtual QGeoCoordinate itemPositionToCoordinate(const QDoubleVector2D &pos, bool clipToViewport = true) const = 0;
71 virtual QDoubleVector2D coordinateToItemPosition(const QGeoCoordinate &coordinate, bool clipToViewport = true) const = 0;
72
73 virtual ProjectionGroup projectionGroup() const = 0;
74 virtual Datum datum() const = 0;
75 virtual ProjectionType projectionType() const = 0;
76
77 // Returns the new map center after anchoring coordinate to anchorPoint on the screen
78 virtual QGeoCoordinate anchorCoordinateToPoint(const QGeoCoordinate &coordinate, const QPointF &anchorPoint) const;
79
80 virtual QGeoShape visibleRegion() const;
81 virtual bool setBearing(qreal bearing, const QGeoCoordinate &coordinate);
82 virtual QMatrix4x4 projectionTransformation() const = 0; // This brings a mercator coord into the correct viewport coordinate.
83 virtual QMatrix4x4 projectionTransformation_centered() const = 0; // Same as projectionTransformation, but the center of the camera is around 0,0.
84 // Requires subsequent shifting of the geometry to fit such camera.
85 virtual const QMatrix4x4 &qsgTransform() const = 0;
86 virtual QDoubleVector3D centerMercator() const = 0;
87
88 void setItemToWindowTransform(const QTransform &itemToWindowTransform);
89 virtual QTransform itemToWindowTransform() const;
90
91 QTransform m_itemToWindowTransform;
92 mutable bool m_qsgTransformDirty = true;
93};
94
95class Q_LOCATION_EXPORT QGeoProjectionWebMercator : public QGeoProjection
96{
97public:
98 QGeoProjectionWebMercator();
99 ~QGeoProjectionWebMercator();
100
101 // From QGeoProjection
102 double minimumZoom() const override;
103 QMatrix4x4 projectionTransformation() const override;
104 QMatrix4x4 projectionTransformation_centered() const override;
105 const QMatrix4x4 &qsgTransform() const override;
106 QDoubleVector3D centerMercator() const override;
107
108 double maximumCenterLatitudeAtZoom(const QGeoCameraData &cameraData) const override;
109 double minimumCenterLatitudeAtZoom(const QGeoCameraData &cameraData) const override;
110
111 void setVisibleArea(const QRectF &visibleArea) override;
112 void setViewportSize(const QSize &size) override;
113 void setCameraData(const QGeoCameraData &cameraData, bool force = true) override;
114 QGeoCameraData cameraData() const override;
115
116 QGeoCoordinate itemPositionToCoordinate(const QDoubleVector2D &pos, bool clipToViewport = true) const override;
117 QDoubleVector2D coordinateToItemPosition(const QGeoCoordinate &coordinate, bool clipToViewport = true) const override;
118
119 QGeoProjection::ProjectionGroup projectionGroup() const override;
120 QGeoProjection::Datum datum() const override;
121 QGeoProjection::ProjectionType projectionType() const override;
122
123 QGeoCoordinate anchorCoordinateToPoint(const QGeoCoordinate &coordinate, const QPointF &anchorPoint) const override;
124 bool setBearing(qreal bearing, const QGeoCoordinate &coordinate) override;
125
126 QGeoShape visibleRegion() const override;
127
128 // Specific to QGeoProjectionWebMercator
129 double mapWidth() const; // The size of the underlying map, at the current zoom level.
130 double mapHeight() const;
131
132 QDoubleVector2D geoToMapProjection(const QGeoCoordinate &coordinate) const;
133 QGeoCoordinate mapProjectionToGeo(const QDoubleVector2D &projection) const;
134
135 int projectionWrapFactor(const QDoubleVector2D &projection) const;
136 QDoubleVector2D wrapMapProjection(const QDoubleVector2D &projection) const;
137 QDoubleVector2D unwrapMapProjection(const QDoubleVector2D &wrappedProjection) const;
138
139 QDoubleVector2D wrappedMapProjectionToItemPosition(const QDoubleVector2D &wrappedProjection) const;
140 QDoubleVector2D itemPositionToWrappedMapProjection(const QDoubleVector2D &itemPosition) const;
141
142 QDoubleVector2D geoToWrappedMapProjection(const QGeoCoordinate &coordinate) const;
143 QGeoCoordinate wrappedMapProjectionToGeo(const QDoubleVector2D &wrappedProjection) const;
144 QMatrix4x4 quickItemTransformation(const QGeoCoordinate &coordinate, const QPointF &anchorPoint, qreal zoomLevel) const;
145
146 bool isProjectable(const QDoubleVector2D &wrappedProjection) const;
147 QList<QDoubleVector2D> visibleGeometry() const;
148 QList<QDoubleVector2D> visibleGeometryExpanded() const;
149 QList<QDoubleVector2D> projectableGeometry() const;
150
151 inline QDoubleVector2D viewportToWrappedMapProjection(const QDoubleVector2D &itemPosition) const;
152 inline QDoubleVector2D viewportToWrappedMapProjection(const QDoubleVector2D &itemPosition, double &s) const;
153
154 QPair<QGeoCoordinate, qreal> fitViewportToGeoRectangle(const QGeoRectangle &rectangle,
155 const QMargins &margins) const;
156
157private:
158 void setupCamera();
159 void updateVisibleRegion();
160
161public:
162 struct Line2D
163 {
164 Line2D();
165 Line2D(const QDoubleVector2D &linePoint, const QDoubleVector2D &lineDirection);
166
167 bool isValid() const;
168
169 QDoubleVector2D m_point;
170 QDoubleVector2D m_direction;
171 };
172
173 struct Plane
174 {
175 Plane();
176 Plane(const QDoubleVector3D &planePoint, const QDoubleVector3D &planeNormal);
177
178 QDoubleVector3D lineIntersection(const QDoubleVector3D &linePoint, const QDoubleVector3D &lineDirection) const;
179 inline QDoubleVector3D lineIntersection(const QDoubleVector3D &linePoint, const QDoubleVector3D &lineDirection, double &s) const;
180 Line2D planeXYIntersection() const;
181 bool isValid() const;
182
183 QDoubleVector3D m_point;
184 QDoubleVector3D m_normal;
185 };
186
187#ifdef QT_LOCATION_DEBUG
188public:
189#else
190protected:
191#endif
192 QGeoCameraData m_cameraData;
193 double m_mapEdgeSize;
194 double m_minimumZoom;
195 // mercator to camera transform for coordinates (not tiles!)
196 double m_cameraCenterXMercator;
197 double m_cameraCenterYMercator;
198
199 // cameraToScreen transform
200 double m_viewportWidth; // in pixels
201 double m_viewportHeight; // in pixels
202 double m_1_viewportWidth;
203 double m_1_viewportHeight;
204
205 QDoubleMatrix4x4 m_cameraMatrix;
206 QDoubleMatrix4x4 m_cameraMatrix0;
207 QDoubleMatrix4x4 m_transformation;
208 QDoubleMatrix4x4 m_transformation0;
209 QDoubleMatrix4x4 m_quickItemTransformation;
210 QDoubleVector3D m_eye;
211 QDoubleVector3D m_up;
212 QDoubleVector3D m_center;
213 QDoubleVector3D m_view;
214 QDoubleVector3D m_viewNormalized;
215 QDoubleVector3D m_side;
216 QDoubleVector3D m_centerNearPlane;
217 double m_sideLengthPixels; // map edge size at integer zoom level
218 double m_aperture;
219 double m_nearPlane;
220 double m_farPlane;
221 double m_halfWidth;
222 double m_halfHeight;
223 double m_minimumUnprojectableY;
224 double m_verticalEstateToSkip;
225
226 // For the clipping region
227 QDoubleVector3D m_centerMercator;
228 QDoubleVector3D m_eyeMercator;
229 QDoubleVector3D m_eyeMercator0;
230 QDoubleVector3D m_viewMercator;
231 QDoubleVector3D m_upMercator;
232 QDoubleVector3D m_sideMercator;
233 QDoubleVector3D m_centerNearPlaneMercator;
234 double m_nearPlaneMercator;
235 Line2D m_nearPlaneMapIntersection;
236
237 QList<QDoubleVector2D> m_visibleRegion;
238 QList<QDoubleVector2D> m_visibleRegionExpanded;
239 QList<QDoubleVector2D> m_projectableRegion;
240 bool m_visibleRegionDirty;
241
242 mutable QMatrix4x4 m_qsgTransform;
243 QRectF m_visibleArea;
244
245 Q_DISABLE_COPY(QGeoProjectionWebMercator)
246};
247
248QT_END_NAMESPACE
249
250#endif // QGEOPROJECTION_H
centerOffset
static QPointF centerOffset(const QSizeF &screenSize, const QRectF &visibleArea)
Definition qgeoprojection.cpp:36
marginsOffset
static QPointF marginsOffset(const QSizeF &screenSize, const QRectF &visibleArea)
Definition qgeoprojection.cpp:51
toMatrix4x4
static QMatrix4x4 toMatrix4x4(const QDoubleMatrix4x4 &m)
Definition qgeoprojection.cpp:28