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

\inmoduleQtLocation \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.

\since5.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.

\since5.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.

\since5.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.

\since5.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.