de/df3/qdeclarativegeomap__p_8h_source.html

// Copyright (C) 2015 The Qt Company Ltd.

// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only


#ifndef QDECLARATIVEGEOMAP_H

#define QDECLARATIVEGEOMAP_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 <QtLocation/private/qlocationglobal_p.h>

#include <QtLocation/private/qdeclarativegeomapitemview_p.h>

#include <QtLocation/private/qdeclarativegeomapitemgroup_p.h>

#include <QtLocation/qgeoserviceprovider.h>

#include <QtLocation/private/qgeocameradata_p.h>

#include <QtLocation/private/qgeocameracapabilities_p.h>

#include <QtQuick/QQuickItem>

#include <QtCore/QList>

#include <QtCore/QPointer>

#include <QtGui/QColor>

#include <QtPositioning/qgeorectangle.h>

#include <QtLocation/private/qgeomap_p.h>


Q_MOC_INCLUDE(<QtLocation/private/qdeclarativegeoserviceprovider_p.h>)


QT_BEGIN_NAMESPACE


class QQuickWindow;

class QDeclarativeGeoServiceProvider;

class QGeoMapType;

class QDeclarativeGeoMapCopyrightNotice;


class Q_LOCATION_PRIVATE_EXPORT QDeclarativeGeoMap : public QQuickItem

{

    Q_OBJECT

    QML_NAMED_ELEMENT(Map)

    QML_ADDED_IN_VERSION(5, 0)

    Q_ENUMS(QGeoServiceProvider::Error)

    Q_PROPERTY(QDeclarativeGeoServiceProvider *plugin READ plugin WRITE setPlugin NOTIFY pluginChanged)

    Q_PROPERTY(qreal minimumZoomLevel READ minimumZoomLevel WRITE setMinimumZoomLevel NOTIFY minimumZoomLevelChanged)

    Q_PROPERTY(qreal maximumZoomLevel READ maximumZoomLevel WRITE setMaximumZoomLevel NOTIFY maximumZoomLevelChanged)

    Q_PROPERTY(qreal zoomLevel READ zoomLevel WRITE setZoomLevel NOTIFY zoomLevelChanged)


    Q_PROPERTY(qreal tilt READ tilt WRITE setTilt NOTIFY tiltChanged)

    Q_PROPERTY(qreal minimumTilt READ minimumTilt WRITE setMinimumTilt NOTIFY minimumTiltChanged)

    Q_PROPERTY(qreal maximumTilt READ maximumTilt WRITE setMaximumTilt NOTIFY maximumTiltChanged)


    Q_PROPERTY(qreal bearing READ bearing WRITE setBearing NOTIFY bearingChanged)


    Q_PROPERTY(qreal fieldOfView READ fieldOfView WRITE setFieldOfView NOTIFY fieldOfViewChanged)

    Q_PROPERTY(qreal minimumFieldOfView READ minimumFieldOfView WRITE setMinimumFieldOfView NOTIFY minimumFieldOfViewChanged)

    Q_PROPERTY(qreal maximumFieldOfView READ maximumFieldOfView WRITE setMaximumFieldOfView NOTIFY minimumFieldOfViewChanged)


    Q_PROPERTY(QGeoMapType activeMapType READ activeMapType WRITE setActiveMapType NOTIFY activeMapTypeChanged)

    Q_PROPERTY(QList<QGeoMapType> supportedMapTypes READ supportedMapTypes NOTIFY supportedMapTypesChanged)

    Q_PROPERTY(QGeoCoordinate center READ center WRITE setCenter NOTIFY centerChanged)

    Q_PROPERTY(QList<QObject *> mapItems READ mapItems NOTIFY mapItemsChanged)

    Q_PROPERTY(QGeoServiceProvider::Error error READ error NOTIFY errorChanged)

    Q_PROPERTY(QString errorString READ errorString NOTIFY errorChanged)

    Q_PROPERTY(QGeoShape visibleRegion READ visibleRegion WRITE setVisibleRegion NOTIFY visibleRegionChanged)

    Q_PROPERTY(bool copyrightsVisible READ copyrightsVisible WRITE setCopyrightsVisible NOTIFY copyrightsVisibleChanged)

    Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged)

    Q_PROPERTY(bool mapReady READ mapReady NOTIFY mapReadyChanged)

    Q_PROPERTY(QRectF visibleArea READ visibleArea WRITE setVisibleArea NOTIFY visibleAreaChanged  REVISION(5, 12))

    Q_INTERFACES(QQmlParserStatus)


public:


    explicit QDeclarativeGeoMap(QQuickItem *parent = nullptr);

    ~QDeclarativeGeoMap();


    void setPlugin(QDeclarativeGeoServiceProvider *plugin);

    QDeclarativeGeoServiceProvider *plugin() const;


    void setActiveMapType(const QGeoMapType &mapType);

    QGeoMapType activeMapType() const;


    void setMinimumZoomLevel(qreal minimumZoomLevel, bool userSet = true);

    qreal minimumZoomLevel() const;


    void setMaximumZoomLevel(qreal maximumZoomLevel, bool userSet = true);

    qreal maximumZoomLevel() const;


    void setZoomLevel(qreal zoomLevel);

    qreal zoomLevel() const;


    void setBearing(qreal bearing);

    qreal bearing() const;


    void setTilt(qreal tilt);

    qreal tilt() const;

    void setMinimumTilt(qreal minimumTilt, bool userSet = true);

    qreal minimumTilt() const;

    void setMaximumTilt(qreal maximumTilt, bool userSet = true);

    qreal maximumTilt() const;


    void setFieldOfView(qreal fieldOfView);

    qreal fieldOfView() const;

    void setMinimumFieldOfView(qreal minimumFieldOfView, bool userSet = true);

    qreal minimumFieldOfView() const;

    void setMaximumFieldOfView(qreal maximumFieldOfView, bool userSet = true);

    qreal maximumFieldOfView() const;


    void setCenter(const QGeoCoordinate &center);

    QGeoCoordinate center() const;


    void setVisibleRegion(const QGeoShape &shape);

    QGeoShape visibleRegion() const;


    void setCopyrightsVisible(bool visible);

    bool copyrightsVisible() const;


    void setColor(const QColor &color);

    QColor color() const;


    QRectF visibleArea() const;

    void setVisibleArea(const QRectF &visibleArea);


    bool mapReady() const;


    QList<QGeoMapType> supportedMapTypes();


    Q_INVOKABLE void setBearing(qreal bearing, const QGeoCoordinate &coordinate);

    Q_INVOKABLE void alignCoordinateToPoint(const QGeoCoordinate &coordinate, const QPointF &point);


    Q_INVOKABLE void removeMapItem(QDeclarativeGeoMapItemBase *item);

    Q_INVOKABLE void addMapItem(QDeclarativeGeoMapItemBase *item);


    Q_INVOKABLE void addMapItemGroup(QDeclarativeGeoMapItemGroup *itemGroup);

    Q_INVOKABLE void removeMapItemGroup(QDeclarativeGeoMapItemGroup *itemGroup);


    Q_INVOKABLE void removeMapItemView(QDeclarativeGeoMapItemView *itemView);

    Q_INVOKABLE void addMapItemView(QDeclarativeGeoMapItemView *itemView);


    Q_INVOKABLE void clearMapItems();

    QList<QObject *> mapItems();


    Q_INVOKABLE QGeoCoordinate toCoordinate(const QPointF &position, bool clipToViewPort = true) const;

    Q_INVOKABLE QPointF fromCoordinate(const QGeoCoordinate &coordinate, bool clipToViewPort = true) const;


//    QQuickGeoMapGestureArea *gesture();


    Q_INVOKABLE void fitViewportToMapItems(const QVariantList &items = {});

    Q_INVOKABLE void fitViewportToVisibleMapItems();

    Q_INVOKABLE void pan(int dx, int dy);

    Q_INVOKABLE void prefetchData(); // optional hint for prefetch

    Q_INVOKABLE void clearData();

    Q_REVISION(13) Q_INVOKABLE void fitViewportToGeoShape(const QGeoShape &shape, QVariant margins);

    void fitViewportToGeoShape(const QGeoShape &shape, const QMargins &borders = QMargins(10, 10, 10, 10));


    QString errorString() const;

    QGeoServiceProvider::Error error() const;

    QGeoMap* map() const;


    // From QQuickItem

    void itemChange(ItemChange, const ItemChangeData &) override;


Q_SIGNALS:

    void pluginChanged(QDeclarativeGeoServiceProvider *plugin);

    void zoomLevelChanged(qreal zoomLevel);

    void centerChanged(const QGeoCoordinate &coordinate);

    void activeMapTypeChanged();

    void supportedMapTypesChanged();

    void minimumZoomLevelChanged(qreal minimumZoomLevel);

    void maximumZoomLevelChanged(qreal maximumZoomLevel);

    void mapItemsChanged();

    void errorChanged();

    void copyrightLinkActivated(const QString &link);

    void copyrightsVisibleChanged(bool visible);

    void colorChanged(const QColor &color);

    void bearingChanged(qreal bearing);

    void tiltChanged(qreal tilt);

    void fieldOfViewChanged(qreal fieldOfView);

    void minimumTiltChanged(qreal minimumTilt);

    void maximumTiltChanged(qreal maximumTilt);

    void minimumFieldOfViewChanged(qreal minimumFieldOfView);

    void maximumFieldOfViewChanged(qreal maximumFieldOfView);

    void copyrightsImageChanged(const QImage &copyrightsImage);

    void copyrightsChanged(const QString &copyrightsHtml);

    void mapReadyChanged(bool ready);

    void visibleAreaChanged();

    Q_REVISION(14) void visibleRegionChanged();


protected:

    void componentComplete() override;

    QSGNode *updatePaintNode(QSGNode *, UpdatePaintNodeData *) override;

    void geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry) override;


    void setError(QGeoServiceProvider::Error error, const QString &errorString);

    void initialize();

    void setZoomLevel(qreal zoomLevel, bool overzoom);

    bool addMapChild(QObject *child);

    bool removeMapChild(QObject *child);

    bool isGroupNested(QDeclarativeGeoMapItemGroup *group) const;


    bool addMapItem_real(QDeclarativeGeoMapItemBase *item);

    bool removeMapItem_real(QDeclarativeGeoMapItemBase *item);

    bool addMapItemGroup_real(QDeclarativeGeoMapItemGroup *itemGroup);

    bool removeMapItemGroup_real(QDeclarativeGeoMapItemGroup *itemGroup);

    bool addMapItemView_real(QDeclarativeGeoMapItemView *itemView);

    bool removeMapItemView_real(QDeclarativeGeoMapItemView *itemView);

    void updateItemToWindowTransform();

    void onSGNodeChanged();


private Q_SLOTS:

    void mappingManagerInitialized();

    void pluginReady();

    void onSupportedMapTypesChanged();

    void onCameraCapabilitiesChanged(const QGeoCameraCapabilities &oldCameraCapabilities);

    void onAttachedCopyrightNoticeVisibilityChanged();

    void onCameraDataChanged(const QGeoCameraData &cameraData);


private:

    void setupMapView(QDeclarativeGeoMapItemView *view);

    void populateMap();

    void fitViewportToMapItemsRefine(const QList<QPointer<QDeclarativeGeoMapItemBase> > &mapItems, bool refine, bool onlyVisible);

    void attachCopyrightNotice(bool initialVisibility);

    void detachCopyrightNotice(bool currentVisibility);

    QMargins mapMargins() const;


private:

    QQuickWindow *m_window = nullptr;

    QDeclarativeGeoServiceProvider *m_plugin = nullptr;

    QGeoMappingManager *m_mappingManager = nullptr;

    QGeoMapType m_activeMapType;

    QList<QGeoMapType> m_supportedMapTypes;

    QList<QDeclarativeGeoMapItemView *> m_mapViews;

    QPointer<QGeoMap> m_map;

    QPointer<QDeclarativeGeoMapCopyrightNotice> m_copyrights;

    QList<QPointer<QDeclarativeGeoMapItemBase> > m_mapItems;

    QList<QPointer<QDeclarativeGeoMapItemGroup> > m_mapItemGroups;

    QString m_errorString;

    QGeoServiceProvider::Error m_error = QGeoServiceProvider::NoError;

    QGeoRectangle m_visibleRegion;

    QColor m_color = QColor::fromRgbF(0.9f, 0.9f, 0.9f);

    QGeoCameraData m_cameraData;

    bool m_componentCompleted = false;

    bool m_pendingFitViewport = false;

    bool m_copyrightsVisible = true;

    double m_maximumViewportLatitude = 0.0;

    double m_minimumViewportLatitude = 0.0;

    bool m_initialized = false;

    bool m_sgNodeHasChanged = false;

    QGeoCameraCapabilities m_cameraCapabilities;

    qreal m_minimumZoomLevel = Q_QNAN;

    qreal m_maximumZoomLevel = Q_QNAN;

    qreal m_userMinimumZoomLevel = 0;

    qreal m_userMaximumZoomLevel = Q_INFINITY;


    qreal m_minimumTilt = Q_QNAN;

    qreal m_maximumTilt = Q_QNAN;

    qreal m_userMinimumTilt = 0;

    qreal m_userMaximumTilt = Q_INFINITY;


    qreal m_minimumFieldOfView = Q_QNAN;

    qreal m_maximumFieldOfView = Q_QNAN;

    qreal m_userMinimumFieldOfView = 0;

    qreal m_userMaximumFieldOfView = Q_INFINITY;


    int m_copyNoticesVisible = 0;

    qreal m_maxChildZ = 0;

    QRectF m_visibleArea;


    friend class QDeclarativeGeoMapItem;

    friend class QDeclarativeGeoMapItemView;

    friend class QDeclarativeGeoMapCopyrightNotice;

    Q_DISABLE_COPY(QDeclarativeGeoMap)

};


QT_END_NAMESPACE


QML_DECLARE_TYPE(QDeclarativeGeoMap)


#endif

QColor
The QColor class provides colors based on RGB, HSV or CMYK values.
Definition qcolor.h:31

QDeclarativeGeoMapCopyrightNotice
Definition qdeclarativegeomapcopyrightsnotice_p.h:34

QDeclarativeGeoMapItemBase
Definition qdeclarativegeomapitembase_p.h:47

QDeclarativeGeoMapItemGroup
Definition qdeclarativegeomapitemgroup_p.h:26

QDeclarativeGeoMapItemView
Definition qdeclarativegeomapitemview_p.h:44

QDeclarativeGeoMap
Definition qdeclarativegeomap_p.h:41

QDeclarativeGeoMap::mapItems
QList< QObject * > mapItems()

QDeclarativeGeoMap::supportedMapTypes
QList< QGeoMapType > supportedMapTypes()

QDeclarativeGeoServiceProvider
Definition qdeclarativegeoserviceprovider_p.h:44

QGeoCameraCapabilities
\inmodule QtLocation
Definition qgeocameracapabilities_p.h:29

QGeoCameraData
Definition qgeocameradata_p.h:29

QGeoCoordinate
\inmodule QtPositioning
Definition qgeocoordinate.h:22

QGeoMapType
Definition qgeomaptype_p.h:32

QGeoMap
Definition qgeomap_p.h:39

QGeoMappingManager
\inmodule QtLocation
Definition qgeomappingmanager_p.h:35

QGeoRectangle
\inmodule QtPositioning
Definition qgeorectangle.h:14

QGeoServiceProvider
\inmodule QtLocation
Definition qgeoserviceprovider.h:27

QGeoServiceProvider::Error
Error
Describes an error related to the loading and setup of a service provider plugin.
Definition qgeoserviceprovider.h:31

QGeoShape
\inmodule QtPositioning
Definition qgeoshape.h:17

QImage
\inmodule QtGui
Definition qimage.h:37

QList< QPair< QString, QString > >

QMargins
\inmodule QtCore
Definition qmargins.h:23

QObject
\inmodule QtCore
Definition qobject.h:90

QPointF
\inmodule QtCore\reentrant
Definition qpoint.h:214

QPointer
\inmodule QtCore
Definition qpointer.h:18

QQmlParserStatus
The QQmlParserStatus class provides updates on the QML parser state.
Definition qqmlparserstatus.h:14

QQuickItem
The QQuickItem class provides the most basic of all visual items in \l {Qt Quick}.
Definition qquickitem.h:64

QQuickItem::ItemChange
ItemChange
Used in conjunction with QQuickItem::itemChange() to notify the item about certain types of changes.
Definition qquickitem.h:143

QQuickWindow
\qmltype Window \instantiates QQuickWindow \inqmlmodule QtQuick
Definition qquickwindow.h:41

QRectF
\inmodule QtCore\reentrant
Definition qrect.h:483

QSGNode
\group qtquick-scenegraph-nodes \title Qt Quick Scene Graph Node classes
Definition qsgnode.h:37

QString
\macro QT_RESTRICTED_CAST_FROM_ASCII
Definition qstring.h:127

QVariant
\inmodule QtCore
Definition qvariant.h:64

map
QMap< QString, QString > map
[6]
Definition doc_src_containers.cpp:94

colorChanged
void colorChanged()

QT_BEGIN_NAMESPACE
Combined button and popup list for selecting options.
Definition qstandardpaths_haiku.cpp:21

QT_END_NAMESPACE
Definition qsharedpointer.cpp:1545

color
Definition qssgutils_p.h:103

initialize
static bool initialize()
Definition qctf.cpp:67

error
DBusConnection const char DBusError * error
Definition qdbus_symbols_p.h:157

Q_INFINITY
#define Q_INFINITY
Definition qnumeric.h:77

Q_QNAN
#define Q_QNAN
Definition qnumeric.h:81

f
GLfloat GLfloat f
Definition qopengles2ext.h:795

group
GLboolean GLuint group
Definition qopengles2ext.h:855

QML_DECLARE_TYPE
#define QML_DECLARE_TYPE(TYPE)
Definition qqml.h:19

Error
@ Error
Definition qqmlbuiltinfunctions.cpp:1746

QML_NAMED_ELEMENT
#define QML_NAMED_ELEMENT(NAME)
Definition qqmlintegration.h:52

QML_ADDED_IN_VERSION
#define QML_ADDED_IN_VERSION(MAJOR, MINOR)
Definition qqmlintegration.h:86

setError
static void setError(QJsonObject *response, const QString &msg)
Definition qqmlnativedebugservice.cpp:62

position
static qreal position(const QQuickItem *item, QQuickAnchors::Anchor anchorLine)
Definition qquickanchors.cpp:66

NoError
@ NoError
Definition main.cpp:34

Q_PROPERTY
#define Q_PROPERTY(...)
Definition qtmetamacros.h:56

Q_OBJECT
#define Q_OBJECT
Definition qtmetamacros.h:117

Q_REVISION
#define Q_REVISION(...)
Definition qtmetamacros.h:59

Q_INVOKABLE
#define Q_INVOKABLE
Definition qtmetamacros.h:76

Q_INTERFACES
#define Q_INTERFACES(x)
Definition qtmetamacros.h:55

Q_SLOTS
#define Q_SLOTS
Definition qtmetamacros.h:44

Q_MOC_INCLUDE
#define Q_MOC_INCLUDE(...)
Definition qtmetamacros.h:79

Q_ENUMS
#define Q_ENUMS(x)
Definition qtmetamacros.h:63

Q_SIGNALS
#define Q_SIGNALS
Definition qtmetamacros.h:45

qreal
double qreal
Definition qtypes.h:92

false
return false
Definition src_corelib_thread_qatomic.cpp:23

item
QGraphicsItem * item
Definition src_gui_graphicsview_qgraphicsitem.cpp:107

setColor
myFilter setColor(QColor(128, 0, 0))

items
QList< QTreeWidgetItem * > items
Definition src_gui_itemviews_qtreewidget.cpp:7

child
QLayoutItem * child
[0]
Definition src_gui_kernel_qlayout.cpp:25

view
QQuickView * view
[0]
Definition src_plugins_platforms_qnx_qqnxwindow.cpp:5

QQuickItem::UpdatePaintNodeData
Definition qquickitem.h:367

parent
IUIAutomationTreeWalker __RPC__deref_out_opt IUIAutomationElement ** parent
Definition uiaclientinterfaces_p.h:209

QQuickItem::ItemChangeData
\inmodule QtQuick
Definition qquickitem.h:158

private
#define private
Definition vsp2hardwarelayerintegration.cpp:7