/* gammaray-geo-positioning.qdoc This file is part of GammaRay, the Qt application inspection and manipulation tool. SPDX-FileCopyrightText: 2018 Klarälvdalens Datakonsult AB, a KDAB Group company Author: Volker Krause SPDX-License-Identifier: GPL-2.0-or-later Contact KDAB at for commercial licensing options. */ /*! \nextpage {Font Browser} \previouspage {Meta Type Browser} \page gammaray-geo-positioning.html \title Geo Positioning \section1 Overview The geo positioning view allows you to observe the QGeoPositionInfo data supplied by a QGeoPositionInfoSource to your application, in textual form as well as on a map view. It is also possible to override that positioning information manually or via a pre-recorded NMEA file, enabling you to easily test location-aware application. \image gammaray-geo-positioning.png By default the input widgets at the top of the view show the current positioning information provided by QtPositioning. The map view at the bottom highlights the current position with a blue marker, and the movement history with a blue line. You can center the map on the current position using the corresponding menu action or the keyboard shortcut \uicontrol F3. \section2 Manual Override You can switch the geo positioning view into override mode using the checkbox at the top left. This will enabling editing on all input widget on the top, and show a second position marker and movement track on the map, in red. For the application the positing information are replaced with what you enter here now, independent of what the QtPositioning backend reports. Besides changing individual values of QGeoPositionInfo in the widgets at the top, you can also set a position on the map view directly: \list \li Left-click will change latitude and longitude. \li Ctrl + mouse wheel will change the direction. \endlist Note that the override mode is only available when the target application has been started with GammaRay, not when attaching to it at runtime. Observing the data is possible in both cases. \section2 NMEA Replay Besides manual override it is also possible to replay a recorded NMEA track from a satellite positioning source. For using this switch the to manual override mode and select \uicontrol Positioning > \uicontrol{Load NMEA file...} from the menu. */