From 453fab84c606328811bafd4de9cde5564620fdc6 Mon Sep 17 00:00:00 2001 From: Paolo Angelelli Date: Wed, 12 Apr 2017 16:00:48 +0200 Subject: Clarify overzoomEnabled property of QGeoCameraCapabilities Change-Id: If6f8fd446c562d6ccaf368e1d5afb5eee113fece Reviewed-by: Alex Blasche --- src/location/declarativemaps/qdeclarativegeomap.cpp | 4 +++- src/location/maps/qgeocameracapabilities.cpp | 8 ++++++++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/src/location/declarativemaps/qdeclarativegeomap.cpp b/src/location/declarativemaps/qdeclarativegeomap.cpp index e4bf10a6..1638d1c8 100644 --- a/src/location/declarativemaps/qdeclarativegeomap.cpp +++ b/src/location/declarativemaps/qdeclarativegeomap.cpp @@ -936,7 +936,9 @@ qreal QDeclarativeGeoMap::maximumZoomLevel() const This property holds the zoom level for the map. Larger values for the zoom level provide more detail. Zoom levels - are always non-negative. The default value is 8.0. + are always non-negative. The default value is 8.0. Depending on the plugin in use, + values outside the [minimumZoomLevel, maximumZoomLevel] range, which represent the range for which + tiles are available, may be accepted, or clamped. */ void QDeclarativeGeoMap::setZoomLevel(qreal zoomLevel) { diff --git a/src/location/maps/qgeocameracapabilities.cpp b/src/location/maps/qgeocameracapabilities.cpp index d5a2f11e..bb6ec4d3 100644 --- a/src/location/maps/qgeocameracapabilities.cpp +++ b/src/location/maps/qgeocameracapabilities.cpp @@ -438,6 +438,14 @@ double QGeoCameraCapabilities::maximumFieldOfView() const /*! Sets whether overzooming is supported by the associated plugin. + Overzooming means that zoom levels outside the [minimumZL, maximumZL] range can be set, + and if tiles aren't available for those zoom levels, either tiles from other zoom levels + will be used, or nothing will be shown. + + Set this value to false if the plugin is not capable of that. For example if using + a mapping engine that always clamp the zoomLevel value, which may cause misalignment in case + of stacked map elements. + \since 5.9 */ void QGeoCameraCapabilities::setOverzoomEnabled(bool overzoomEnabled) -- cgit v1.2.3