QGeoCameraCapabilities Class
The QGeoCameraCapabilities class describes the limitations on camera settings imposed by a mapping plugin. More...
Header: | #include <QGeoCameraCapabilities> |
Properties
|
|
Public Functions
QGeoCameraCapabilities() | |
QGeoCameraCapabilities(const QGeoCameraCapabilities &other) | |
~QGeoCameraCapabilities() | |
bool | isValid() const |
double | maximumFieldOfView() const |
double | maximumTilt() const |
double | maximumZoomLevelAt256() const |
double | minimumFieldOfView() const |
double | minimumTilt() const |
double | minimumZoomLevelAt256() const |
bool | overzoomEnabled() const |
void | setOverzoomEnabled(bool overzoomEnabled) |
void | setSupportsBearing(bool supportsBearing) |
void | setSupportsRolling(bool supportsRolling) |
void | setSupportsTilting(bool supportsTilting) |
bool | supportsBearing() const |
bool | supportsRolling() const |
bool | supportsTilting() const |
QGeoCameraCapabilities & | operator=(const QGeoCameraCapabilities &other) |
Detailed Description
\inmodule
QtLocation \ingroup
QtLocation-impl \since
5.6 \internal
Different mapping plugins will support different ranges of zoom levels, and not all mapping plugins will be able to support, bearing, tilting and rolling of the camera.
This class describes what the plugin supports, and is used to restrict changes to the camera information associated with a QGeoMap such that the camera information stays within these limits.
Property Documentation
[read-only]
maximumFieldOfView : const qreal
This property holds the maximum field of view supported by the associated plugin.
The value is in degrees and is clamped against a [1, 179] range.
\since
5.9
Access functions:
double | maximumFieldOfView() const |
[read-only]
maximumTilt : const qreal
This property holds the maximum tilt supported by the associated plugin.
The value is in degrees where 0 is equivalent to 90 degrees between the line of view and earth's surface, that is, looking straight down to earth.
Access functions:
double | maximumTilt() const |
[read-only]
maximumZoomLevel : const qreal
This property holds the maximum zoom level supported by the associated plugin.
Larger values of the zoom level correspond to more detailed views of the map.
Access functions:
double | maximumZoomLevelAt256() const |
[read-only]
minimumFieldOfView : const qreal
This property holds the minimum field of view supported by the associated plugin.
The value is in degrees and is clamped against a [1, 179] range.
\since
5.9
Access functions:
double | minimumFieldOfView() const |
[read-only]
minimumTilt : const qreal
This property holds the minimum tilt supported by the associated plugin.
The value is in degrees where 0 is equivalent to 90 degrees between the line of view and earth's surface, that is, looking straight down to earth.
Access functions:
double | minimumTilt() const |
[read-only]
minimumZoomLevel : const qreal
This property holds the minimum zoom level supported by the associated plugin.
Larger values of the zoom level correspond to more detailed views of the map.
Access functions:
double | minimumZoomLevelAt256() const |
Member Function Documentation
QGeoCameraCapabilities::QGeoCameraCapabilities()
Constructs a camera capabilities object.
[noexcept]
QGeoCameraCapabilities::QGeoCameraCapabilities(const QGeoCameraCapabilities &other)
Constructs a camera capabilities object from the contents of other.
[noexcept]
QGeoCameraCapabilities::~QGeoCameraCapabilities()
Destroys this camera capabilities object.
bool QGeoCameraCapabilities::isValid() const
Returns whether this instance of the class is considered "valid". To be valid, the instance must have had at least one capability set (to either true or false) using a set method, or copied from another instance (such as by the assignment operator).
bool QGeoCameraCapabilities::overzoomEnabled() const
Returns whether overzooming is supported by the associated plugin.
\since
5.9
See also setOverzoomEnabled().
void QGeoCameraCapabilities::setOverzoomEnabled(bool overzoomEnabled)
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
See also overzoomEnabled().
void QGeoCameraCapabilities::setSupportsBearing(bool supportsBearing)
Sets whether the associated plugin can render a map when the camera has an arbitrary bearing to supportsBearing.
See also supportsBearing().
void QGeoCameraCapabilities::setSupportsRolling(bool supportsRolling)
Sets whether the associated plugin can render a map when the camera is rolled to supportsRolling.
See also supportsRolling().
void QGeoCameraCapabilities::setSupportsTilting(bool supportsTilting)
Sets whether the associated plugin can render a map when the camera is tilted to supportsTilting.
See also supportsTilting().
bool QGeoCameraCapabilities::supportsBearing() const
Returns whether the associated plugin can render a map when the camera has an arbitrary bearing.
See also setSupportsBearing().
bool QGeoCameraCapabilities::supportsRolling() const
Returns whether the associated plugin can render a map when the camera is rolled.
See also setSupportsRolling().
bool QGeoCameraCapabilities::supportsTilting() const
Returns whether the associated plugin can render a map when the camera is tilted.
See also setSupportsTilting().
[noexcept]
QGeoCameraCapabilities &QGeoCameraCapabilities::operator=(const QGeoCameraCapabilities &other)
Assigns the contents of other to this camera capabilities object and returns a reference to this camera capabilities object.