\inmodule QtLocation More...

#include <qgeocameracapabilities_p.h>

Collaboration diagram for QGeoCameraCapabilities:

Public Member Functions
	QGeoCameraCapabilities ()
	\qmlvaluetype cameraCapabilities \inqmlmodule QtLocation

	QGeoCameraCapabilities (const QGeoCameraCapabilities &other) noexcept
	Constructs a camera capabilities object from the contents of other.

	QGeoCameraCapabilities (QGeoCameraCapabilities &&other) noexcept=default

	~QGeoCameraCapabilities ()
	Destroys this camera capabilities object.

QGeoCameraCapabilities &	operator= (const QGeoCameraCapabilities &other) noexcept
	Assigns the contents of other to this camera capabilities object and returns a reference to this camera capabilities object.

void	swap (QGeoCameraCapabilities &other) noexcept

void	setTileSize (int tileSize)

int	tileSize () const

void	setMinimumZoomLevel (double minimumZoomLevel)

double	minimumZoomLevel () const

double	minimumZoomLevelAt256 () const

void	setMaximumZoomLevel (double maximumZoomLevel)

double	maximumZoomLevel () const

double	maximumZoomLevelAt256 () const

void	setSupportsBearing (bool supportsBearing)
	Sets whether the associated plugin can render a map when the camera has an arbitrary bearing to supportsBearing.

bool	supportsBearing () const
	Returns whether the associated plugin can render a map when the camera has an arbitrary bearing.

void	setSupportsRolling (bool supportsRolling)
	Sets whether the associated plugin can render a map when the camera is rolled to supportsRolling.

bool	supportsRolling () const
	Returns whether the associated plugin can render a map when the camera is rolled.

void	setSupportsTilting (bool supportsTilting)
	Sets whether the associated plugin can render a map when the camera is tilted to supportsTilting.

bool	supportsTilting () const
	Returns whether the associated plugin can render a map when the camera is tilted.

void	setMinimumTilt (double minimumTilt)

double	minimumTilt () const

void	setMaximumTilt (double maximumTilt)

double	maximumTilt () const

void	setMinimumFieldOfView (double minimumFieldOfView)

double	minimumFieldOfView () const

void	setMaximumFieldOfView (double maximumFieldOfView)

double	maximumFieldOfView () const

void	setOverzoomEnabled (bool overzoomEnabled)
	Sets whether overzooming is supported by the associated plugin.

bool	overzoomEnabled () const
	Returns whether overzooming is supported by the associated plugin.

bool	isValid () const
	Returns whether this instance of the class is considered "valid".

Properties
qreal	minimumZoomLevel
	\qmlproperty qreal cameraCapabilities::minimumZoomLevel

qreal	maximumZoomLevel
	\qmlproperty qreal cameraCapabilities::maximumZoomLevel

qreal	minimumTilt
	\qmlproperty qreal cameraCapabilities::minimumTilt

qreal	maximumTilt
	\qmlproperty qreal cameraCapabilities::maximumTilt

qreal	minimumFieldOfView
	\qmlproperty qreal cameraCapabilities::minimumFieldOfView

qreal	maximumFieldOfView
	\qmlproperty qreal cameraCapabilities::maximumFieldOfView

Friends
bool	operator== (const QGeoCameraCapabilities &lhs, const QGeoCameraCapabilities &rhs) noexcept

bool	operator!= (const QGeoCameraCapabilities &lhs, const QGeoCameraCapabilities &rhs) noexcept

Detailed Description

\inmodule QtLocation

Since: 5.6

The QGeoCameraCapabilities class describes the limitations on camera settings imposed by a mapping plugin.

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 \l QGeoMap such that the camera information stays within these limits.

Definition at line 28 of file qgeocameracapabilities_p.h.

Constructor & Destructor Documentation

◆ QGeoCameraCapabilities() [1/3]

QGeoCameraCapabilities::QGeoCameraCapabilities ( )

\qmlvaluetype cameraCapabilities \inqmlmodule QtLocation

Since: QtLocation 5.10

The cameraCapabilities type holds information about the camera capabilities for a specific map type.

This includes the map minimum and maximum zoom level, minimum and maximum tilt angle and minimum and maximum field of view.

Constructs a camera capabilities object.

Definition at line 88 of file qgeocameracapabilities.cpp.

◆ QGeoCameraCapabilities() [2/3]

QGeoCameraCapabilities::QGeoCameraCapabilities ( const QGeoCameraCapabilities & other )

defaultnoexcept

Constructs a camera capabilities object from the contents of other.

◆ QGeoCameraCapabilities() [3/3]

QGeoCameraCapabilities::QGeoCameraCapabilities ( QGeoCameraCapabilities && other )

defaultnoexcept

◆ ~QGeoCameraCapabilities()

QGeoCameraCapabilities::~QGeoCameraCapabilities ( )

default

Destroys this camera capabilities object.

Member Function Documentation

◆ isValid()

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).

Definition at line 137 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::valid_.

◆ maximumFieldOfView()

double QGeoCameraCapabilities::maximumFieldOfView ( ) const

Definition at line 354 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::maximumFieldOfView_.

◆ maximumTilt()

double QGeoCameraCapabilities::maximumTilt ( ) const

Definition at line 304 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::maxTilt_.

◆ maximumZoomLevel()

double QGeoCameraCapabilities::maximumZoomLevel ( ) const

Definition at line 192 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::maxZoom_.

◆ maximumZoomLevelAt256()

double QGeoCameraCapabilities::maximumZoomLevelAt256 ( ) const

Definition at line 197 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::maxZoom_, QGeoCameraCapabilitiesPrivate::tileSize_, and zoomLevelTo256().

Here is the call graph for this function:

◆ minimumFieldOfView()

double QGeoCameraCapabilities::minimumFieldOfView ( ) const

Definition at line 329 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::minimumFieldOfView_.

◆ minimumTilt()

double QGeoCameraCapabilities::minimumTilt ( ) const

Definition at line 280 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::minTilt_.

◆ minimumZoomLevel()

double QGeoCameraCapabilities::minimumZoomLevel ( ) const

Definition at line 161 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::minZoom_.

◆ minimumZoomLevelAt256()

double QGeoCameraCapabilities::minimumZoomLevelAt256 ( ) const

Definition at line 166 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::minZoom_, QGeoCameraCapabilitiesPrivate::tileSize_, and zoomLevelTo256().

Here is the call graph for this function:

◆ operator=()

QGeoCameraCapabilities & QGeoCameraCapabilities::operator= ( const QGeoCameraCapabilities & other )

noexcept

Assigns the contents of other to this camera capabilities object and returns a reference to this camera capabilities object.

Definition at line 105 of file qgeocameracapabilities.cpp.

References d, and other().

Here is the call graph for this function:

◆ overzoomEnabled()

bool QGeoCameraCapabilities::overzoomEnabled ( ) const

Returns whether overzooming is supported by the associated plugin.

Since: 5.9

Definition at line 383 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::overzoomEnabled_.

Referenced by setOverzoomEnabled(), and QDeclarativeGeoMap::setZoomLevel().

Here is the caller graph for this function:

◆ setMaximumFieldOfView()

void QGeoCameraCapabilities::setMaximumFieldOfView ( double maximumFieldOfView )

Definition at line 348 of file qgeocameracapabilities.cpp.

References maximumFieldOfView, QGeoCameraCapabilitiesPrivate::maximumFieldOfView_, qBound(), and QGeoCameraCapabilitiesPrivate::valid_.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), and QGeoTiledMappingManagerEngineNokia::QGeoTiledMappingManagerEngineNokia().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setMaximumTilt()

void QGeoCameraCapabilities::setMaximumTilt ( double maximumTilt )

Definition at line 298 of file qgeocameracapabilities.cpp.

References maximumTilt, QGeoCameraCapabilitiesPrivate::maxTilt_, and QGeoCameraCapabilitiesPrivate::valid_.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), and QGeoTiledMappingManagerEngineNokia::QGeoTiledMappingManagerEngineNokia().

Here is the caller graph for this function:

◆ setMaximumZoomLevel()

void QGeoCameraCapabilities::setMaximumZoomLevel ( double maximumZoomLevel )

Definition at line 186 of file qgeocameracapabilities.cpp.

References maximumZoomLevel, QGeoCameraCapabilitiesPrivate::maxZoom_, and QGeoCameraCapabilitiesPrivate::valid_.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), QGeoTiledMappingManagerEngineNokia::QGeoTiledMappingManagerEngineNokia(), and QGeoTileProviderOsm::updateCameraCapabilities().

Here is the caller graph for this function:

◆ setMinimumFieldOfView()

void QGeoCameraCapabilities::setMinimumFieldOfView ( double minimumFieldOfView )

Definition at line 323 of file qgeocameracapabilities.cpp.

References minimumFieldOfView, QGeoCameraCapabilitiesPrivate::minimumFieldOfView_, qBound(), and QGeoCameraCapabilitiesPrivate::valid_.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), and QGeoTiledMappingManagerEngineNokia::QGeoTiledMappingManagerEngineNokia().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setMinimumTilt()

void QGeoCameraCapabilities::setMinimumTilt ( double minimumTilt )

Definition at line 274 of file qgeocameracapabilities.cpp.

References minimumTilt, QGeoCameraCapabilitiesPrivate::minTilt_, and QGeoCameraCapabilitiesPrivate::valid_.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), and QGeoTiledMappingManagerEngineNokia::QGeoTiledMappingManagerEngineNokia().

Here is the caller graph for this function:

◆ setMinimumZoomLevel()

void QGeoCameraCapabilities::setMinimumZoomLevel ( double minimumZoomLevel )

Definition at line 155 of file qgeocameracapabilities.cpp.

References minimumZoomLevel, QGeoCameraCapabilitiesPrivate::minZoom_, and QGeoCameraCapabilitiesPrivate::valid_.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), QGeoMappingManagerEngineItemsOverlay::QGeoMappingManagerEngineItemsOverlay(), QGeoMappingManagerEngineMapboxGL::QGeoMappingManagerEngineMapboxGL(), QGeoTiledMappingManagerEngineMapbox::QGeoTiledMappingManagerEngineMapbox(), QGeoTiledMappingManagerEngineNokia::QGeoTiledMappingManagerEngineNokia(), QGeoTiledMappingManagerEngineOsm::QGeoTiledMappingManagerEngineOsm(), and QGeoTileProviderOsm::updateCameraCapabilities().

Here is the caller graph for this function:

◆ 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

Definition at line 372 of file qgeocameracapabilities.cpp.

References overzoomEnabled(), QGeoCameraCapabilitiesPrivate::overzoomEnabled_, and QGeoCameraCapabilitiesPrivate::valid_.

Referenced by QGeoTiledMappingManagerEngineNokia::QGeoTiledMappingManagerEngineNokia().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSupportsBearing()

void QGeoCameraCapabilities::setSupportsBearing ( bool supportsBearing )

Sets whether the associated plugin can render a map when the camera has an arbitrary bearing to supportsBearing.

Definition at line 208 of file qgeocameracapabilities.cpp.

References supportsBearing(), QGeoCameraCapabilitiesPrivate::supportsBearing_, and QGeoCameraCapabilitiesPrivate::valid_.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), and QGeoTiledMappingManagerEngineNokia::QGeoTiledMappingManagerEngineNokia().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSupportsRolling()

void QGeoCameraCapabilities::setSupportsRolling ( bool supportsRolling )

Sets whether the associated plugin can render a map when the camera is rolled to supportsRolling.

Definition at line 227 of file qgeocameracapabilities.cpp.

References supportsRolling(), QGeoCameraCapabilitiesPrivate::supportsRolling_, and QGeoCameraCapabilitiesPrivate::valid_.

Here is the call graph for this function:

◆ setSupportsTilting()

void QGeoCameraCapabilities::setSupportsTilting ( bool supportsTilting )

Sets whether the associated plugin can render a map when the camera is tilted to supportsTilting.

Definition at line 246 of file qgeocameracapabilities.cpp.

References supportsTilting(), QGeoCameraCapabilitiesPrivate::supportsTilting_, and QGeoCameraCapabilitiesPrivate::valid_.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), and QGeoTiledMappingManagerEngineNokia::QGeoTiledMappingManagerEngineNokia().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTileSize()

void QGeoCameraCapabilities::setTileSize ( int tileSize )

Definition at line 119 of file qgeocameracapabilities.cpp.

References tileSize(), and QGeoCameraCapabilitiesPrivate::tileSize_.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ supportsBearing()

bool QGeoCameraCapabilities::supportsBearing ( ) const

Returns whether the associated plugin can render a map when the camera has an arbitrary bearing.

Definition at line 218 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::supportsBearing_.

Referenced by QDeclarativeGeoMap::initialize(), and setSupportsBearing().

Here is the caller graph for this function:

◆ supportsRolling()

bool QGeoCameraCapabilities::supportsRolling ( ) const

Returns whether the associated plugin can render a map when the camera is rolled.

Definition at line 237 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::supportsRolling_.

Referenced by setSupportsRolling().

Here is the caller graph for this function:

◆ supportsTilting()

bool QGeoCameraCapabilities::supportsTilting ( ) const

Returns whether the associated plugin can render a map when the camera is tilted.

Definition at line 256 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::supportsTilting_.

Referenced by QDeclarativeGeoMap::initialize(), and setSupportsTilting().

Here is the caller graph for this function:

◆ swap()

void QGeoCameraCapabilities::swap ( QGeoCameraCapabilities & other )

inlinenoexcept

Definition at line 48 of file qgeocameracapabilities_p.h.

References d, other(), and swap().

Referenced by swap().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ tileSize()

int QGeoCameraCapabilities::tileSize ( ) const

Definition at line 126 of file qgeocameracapabilities.cpp.

References QGeoCameraCapabilitiesPrivate::tileSize_.

Referenced by QGeoTiledMapPrivate::QGeoTiledMapPrivate(), QGeoTiledMapPrivate::changeActiveMapType(), QGeoTiledMapPrivate::onCameraCapabilitiesChanged(), and setTileSize().

Here is the caller graph for this function:

Friends And Related Symbol Documentation

◆ operator!=

bool operator!=	(	const QGeoCameraCapabilities &	lhs,
		const QGeoCameraCapabilities &	rhs )

friend

Definition at line 55 of file qgeocameracapabilities_p.h.

◆ operator==

bool operator==	(	const QGeoCameraCapabilities &	lhs,
		const QGeoCameraCapabilities &	rhs )

friend

Definition at line 50 of file qgeocameracapabilities_p.h.

Property Documentation

◆ maximumFieldOfView

QGeoCameraCapabilities::maximumFieldOfView

read

\qmlproperty qreal cameraCapabilities::maximumFieldOfView

This read-only property holds the maximum available field of view with this map type.

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

Definition at line 37 of file qgeocameracapabilities_p.h.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), QDeclarativeGeoMap::initialize(), and setMaximumFieldOfView().

◆ maximumTilt

QGeoCameraCapabilities::maximumTilt

read

\qmlproperty qreal cameraCapabilities::maximumTilt

This read-only property holds the maximum available tilt with this map type.

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.

Definition at line 35 of file qgeocameracapabilities_p.h.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), and setMaximumTilt().

◆ maximumZoomLevel

QGeoCameraCapabilities::maximumZoomLevel

read

\qmlproperty qreal cameraCapabilities::maximumZoomLevel

This read-only property holds the maximum available zoom level with this map type.

the maximum zoom level supported by the associated plugin.

Larger values of the zoom level correspond to more detailed views of the map.

Definition at line 33 of file qgeocameracapabilities_p.h.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), QGeoTiledMapPrivate::onCameraCapabilitiesChanged(), and setMaximumZoomLevel().

◆ minimumFieldOfView

QGeoCameraCapabilities::minimumFieldOfView

read

\qmlproperty qreal cameraCapabilities::minimumFieldOfView

This read-only property holds the minimum available field of view with this map type.

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

Definition at line 36 of file qgeocameracapabilities_p.h.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), QDeclarativeGeoMap::initialize(), and setMinimumFieldOfView().

◆ minimumTilt

QGeoCameraCapabilities::minimumTilt

read

\qmlproperty qreal cameraCapabilities::minimumTilt

This read-only property holds the minimum available tilt with this map type.

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.

Definition at line 34 of file qgeocameracapabilities_p.h.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), and setMinimumTilt().

◆ minimumZoomLevel

QGeoCameraCapabilities::minimumZoomLevel

read

\qmlproperty qreal cameraCapabilities::minimumZoomLevel

This read-only property holds the minimum available zoom level with this map type.

the minimum zoom level supported by the associated plugin.

Larger values of the zoom level correspond to more detailed views of the map.

Definition at line 32 of file qgeocameracapabilities_p.h.

Referenced by QDeclarativeGeoMap::QDeclarativeGeoMap(), QGeoTiledMapPrivate::onCameraCapabilitiesChanged(), setMinimumZoomLevel(), and QDeclarativeGeoMap::setZoomLevel().

The documentation for this class was generated from the following files:

qtlocation/src/location/maps/qgeocameracapabilities_p.h (60828037eb143eaefab1780f1f831a3f0e6dcaf2)
qtlocation/src/location/maps/qgeocameracapabilities.cpp (95e2cae51e6c92315fbf33c5d3e8a1826cca8907)

Public Member Functions

Properties

Friends

Detailed Description

Constructor & Destructor Documentation

◆ QGeoCameraCapabilities() [1/3]

◆ QGeoCameraCapabilities() [2/3]

◆ QGeoCameraCapabilities() [3/3]

◆ ~QGeoCameraCapabilities()

Member Function Documentation

◆ isValid()

◆ maximumFieldOfView()

◆ maximumTilt()

◆ maximumZoomLevel()

◆ maximumZoomLevelAt256()

◆ minimumFieldOfView()

◆ minimumTilt()

◆ minimumZoomLevel()

◆ minimumZoomLevelAt256()

◆ operator=()

◆ overzoomEnabled()

◆ setMaximumFieldOfView()

◆ setMaximumTilt()

◆ setMaximumZoomLevel()

◆ setMinimumFieldOfView()

◆ setMinimumTilt()

◆ setMinimumZoomLevel()

◆ setOverzoomEnabled()

◆ setSupportsBearing()

◆ setSupportsRolling()

◆ setSupportsTilting()

◆ setTileSize()

◆ supportsBearing()

◆ supportsRolling()

◆ supportsTilting()

◆ swap()

◆ tileSize()

Friends And Related Symbol Documentation

◆ operator!=

◆ operator==

Property Documentation

◆ maximumFieldOfView

◆ maximumTilt

◆ maximumZoomLevel

◆ minimumFieldOfView

◆ minimumTilt

◆ minimumZoomLevel