/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: http://www.qt.io/licensing/ ** ** This file is part of the QtLocation module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL3$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see http://www.qt.io/terms-conditions. For further ** information use the contact form at http://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPLv3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or later as published by the Free ** Software Foundation and appearing in the file LICENSE.GPL included in ** the packaging of this file. Please review the following information to ** ensure the GNU General Public License version 2.0 requirements will be ** met: http://www.gnu.org/licenses/gpl-2.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QGEOPROJECTION_H #define QGEOPROJECTION_H // // W A R N I N G // ------------- // // This file is not part of the Qt API. It exists purely as an // implementation detail. This header file may change from version to // version without notice, or even be removed. // // We mean it. // #include #include #include #include QT_BEGIN_NAMESPACE class Q_LOCATION_PRIVATE_EXPORT QGeoProjection { public: enum ProjectionGroup { ProjectionOther, ProjectionCylindrical, ProjectionPseudocylindrical, ProjectionAzimuthal, ProjectionPseudoazimuthal, ProjectionConic, ProjectionPseudoconic //Polyhedral //Retroazimuthal }; enum Datum { DatumUnknown, DatumWGS84, DatumSphere }; enum ProjectionType { ProjectionUnknown, ProjectionGeneralPerspective, ProjectionWebMercator }; QGeoProjection(); virtual ~QGeoProjection(); virtual void setVisibleArea(const QRectF &visibleArea) = 0; virtual void setViewportSize(const QSize &size) = 0; virtual void setCameraData(const QGeoCameraData &cameraData, bool force = true) = 0; virtual QGeoCameraData cameraData() const = 0; // returns the minimum zoom at the current viewport size virtual double minimumZoom() const = 0; virtual double maximumCenterLatitudeAtZoom(const QGeoCameraData &cameraData) const = 0; virtual double minimumCenterLatitudeAtZoom(const QGeoCameraData &cameraData) const = 0; virtual QGeoCoordinate itemPositionToCoordinate(const QDoubleVector2D &pos, bool clipToViewport = true) const = 0; virtual QDoubleVector2D coordinateToItemPosition(const QGeoCoordinate &coordinate, bool clipToViewport = true) const = 0; virtual ProjectionGroup projectionGroup() const = 0; virtual Datum datum() const = 0; virtual ProjectionType projectionType() const = 0; // Returns the new map center after anchoring coordinate to anchorPoint on the screen virtual QGeoCoordinate anchorCoordinateToPoint(const QGeoCoordinate &coordinate, const QPointF &anchorPoint) const; virtual QGeoShape visibleRegion() const; virtual bool setBearing(qreal bearing, const QGeoCoordinate &coordinate); }; class Q_LOCATION_PRIVATE_EXPORT QGeoProjectionWebMercator : public QGeoProjection { public: QGeoProjectionWebMercator(); ~QGeoProjectionWebMercator(); // From QGeoProjection double minimumZoom() const override; double maximumCenterLatitudeAtZoom(const QGeoCameraData &cameraData) const override; double minimumCenterLatitudeAtZoom(const QGeoCameraData &cameraData) const override; void setVisibleArea(const QRectF &visibleArea) override; void setViewportSize(const QSize &size) override; void setCameraData(const QGeoCameraData &cameraData, bool force = true) override; QGeoCameraData cameraData() const override; QGeoCoordinate itemPositionToCoordinate(const QDoubleVector2D &pos, bool clipToViewport = true) const override; QDoubleVector2D coordinateToItemPosition(const QGeoCoordinate &coordinate, bool clipToViewport = true) const override; QGeoProjection::ProjectionGroup projectionGroup() const override; QGeoProjection::Datum datum() const override; QGeoProjection::ProjectionType projectionType() const override; QGeoCoordinate anchorCoordinateToPoint(const QGeoCoordinate &coordinate, const QPointF &anchorPoint) const override; bool setBearing(qreal bearing, const QGeoCoordinate &coordinate) override; QGeoShape visibleRegion() const override; // Specific to QGeoProjectionWebMercator double mapWidth() const; // The size of the underlying map, at the current zoom level. double mapHeight() const; QDoubleVector2D geoToMapProjection(const QGeoCoordinate &coordinate) const; QGeoCoordinate mapProjectionToGeo(const QDoubleVector2D &projection) const; QDoubleVector2D wrapMapProjection(const QDoubleVector2D &projection) const; QDoubleVector2D unwrapMapProjection(const QDoubleVector2D &wrappedProjection) const; QDoubleVector2D wrappedMapProjectionToItemPosition(const QDoubleVector2D &wrappedProjection) const; QDoubleVector2D itemPositionToWrappedMapProjection(const QDoubleVector2D &itemPosition) const; QDoubleVector2D geoToWrappedMapProjection(const QGeoCoordinate &coordinate) const; QGeoCoordinate wrappedMapProjectionToGeo(const QDoubleVector2D &wrappedProjection) const; QMatrix4x4 quickItemTransformation(const QGeoCoordinate &coordinate, const QPointF &anchorPoint, qreal zoomLevel) const; bool isProjectable(const QDoubleVector2D &wrappedProjection) const; QList visibleGeometry() const; QList visibleGeometryExpanded() const; QList projectableGeometry() const; inline QDoubleVector2D viewportToWrappedMapProjection(const QDoubleVector2D &itemPosition) const; inline QDoubleVector2D viewportToWrappedMapProjection(const QDoubleVector2D &itemPosition, double &s) const; QPair fitViewportToGeoRectangle(const QGeoRectangle &rectangle, const QMargins &margins) const; private: void setupCamera(); void updateVisibleRegion(); public: struct Line2D { Line2D(); Line2D(const QDoubleVector2D &linePoint, const QDoubleVector2D &lineDirection); bool isValid() const; QDoubleVector2D m_point; QDoubleVector2D m_direction; }; struct Plane { Plane(); Plane(const QDoubleVector3D &planePoint, const QDoubleVector3D &planeNormal); QDoubleVector3D lineIntersection(const QDoubleVector3D &linePoint, const QDoubleVector3D &lineDirection) const; inline QDoubleVector3D lineIntersection(const QDoubleVector3D &linePoint, const QDoubleVector3D &lineDirection, double &s) const; Line2D planeXYIntersection() const; bool isValid() const; QDoubleVector3D m_point; QDoubleVector3D m_normal; }; #ifdef QT_LOCATION_DEBUG public: #else protected: #endif QGeoCameraData m_cameraData; double m_mapEdgeSize; double m_minimumZoom; // mercator to camera transform for coordinates (not tiles!) double m_cameraCenterXMercator; double m_cameraCenterYMercator; // cameraToScreen transform double m_viewportWidth; // in pixels double m_viewportHeight; // in pixels double m_1_viewportWidth; double m_1_viewportHeight; QDoubleMatrix4x4 m_transformation; QDoubleMatrix4x4 m_quickItemTransformation; QDoubleVector3D m_eye; QDoubleVector3D m_up; QDoubleVector3D m_center; QDoubleVector3D m_view; QDoubleVector3D m_viewNormalized; QDoubleVector3D m_side; QDoubleVector3D m_centerNearPlane; double m_sideLengthPixels; // map edge size at integer zoom level double m_aperture; double m_nearPlane; double m_farPlane; double m_halfWidth; double m_halfHeight; double m_minimumUnprojectableY; double m_verticalEstateToSkip; // For the clipping region QDoubleVector3D m_centerMercator; QDoubleVector3D m_eyeMercator; QDoubleVector3D m_viewMercator; QDoubleVector3D m_upMercator; QDoubleVector3D m_sideMercator; QDoubleVector3D m_centerNearPlaneMercator; double m_nearPlaneMercator; Line2D m_nearPlaneMapIntersection; QList m_visibleRegion; QList m_visibleRegionExpanded; QList m_projectableRegion; bool m_visibleRegionDirty; QRectF m_visibleArea; Q_DISABLE_COPY(QGeoProjectionWebMercator) }; QT_END_NAMESPACE #endif // QGEOPROJECTION_H