This class implements a visual Qt Quick Item that does map rendering according to the current map settings. More...

#include <qgsquickmapcanvasmap.h>

Inheritance diagram for QgsQuickMapCanvasMap:

Public Slots
void	pan (QPointF oldPos, QPointF newPos)
	Set map setting's extent (pan the map) based on the difference of positions. More...

void	refresh ()
	Refresh the map canvas. More...

void	stopRendering ()
	Stop map rendering. More...

void	zoom (QPointF center, qreal scale)
	Set map setting's extent (zoom the map) on the center by given scale. More...

Signals
void	freezeChanged ()
	When freeze property is set to true, the map canvas does not refresh. More...

void	incrementalRenderingChanged ()
	When the incrementalRendering property is set to true, the automatic refresh of map canvas during rendering is allowed. More...

void	isRenderingChanged ()
	The isRendering property is set to true while a rendering job is pending for this map canvas map. More...

void	mapCanvasRefreshed ()
	Signal is emitted when a canvas is refreshed. More...

void	mapUpdateIntervalChanged ()
	Interval in milliseconds after which the map canvas will be updated while a rendering job is ongoing. More...

void	renderStarting ()
	Signal is emitted when a rendering is starting. More...

Public Member Functions
	QgsQuickMapCanvasMap (QQuickItem *parent=nullptr)
	Create map canvas map. More...

	~QgsQuickMapCanvasMap ()=default

bool	freeze () const
	When freeze property is set to true, the map canvas does not refresh. More...

bool	incrementalRendering () const
	When the incrementalRendering property is set to true, the automatic refresh of map canvas during rendering is allowed. More...

bool	isRendering () const
	The isRendering property is set to true while a rendering job is pending for this map canvas map. More...

QgsQuickMapSettings *	mapSettings () const
	The mapSettings property contains configuration for rendering of the map. More...

int	mapUpdateInterval () const
	Interval in milliseconds after which the map canvas will be updated while a rendering job is ongoing. More...

void	setFreeze (bool freeze)
	When freeze property is set to true, the map canvas does not refresh. More...

void	setIncrementalRendering (bool incrementalRendering)
	When the incrementalRendering property is set to true, the automatic refresh of map canvas during rendering is allowed. More...

void	setMapUpdateInterval (int mapUpdateInterval)
	Interval in milliseconds after which the map canvas will be updated while a rendering job is ongoing. More...

QSGNode *	updatePaintNode (QSGNode oldNode, QQuickItem::UpdatePaintNodeData ) override

Protected Member Functions
void	geometryChanged (const QRectF &newGeometry, const QRectF &oldGeometry) override

Properties
bool	freeze
	When freeze property is set to true, the map canvas does not refresh. More...

bool	incrementalRendering
	When the incrementalRendering property is set to true, the automatic refresh of map canvas during rendering is allowed. More...

bool	isRendering
	The isRendering property is set to true while a rendering job is pending for this map canvas map. More...

QgsQuickMapSettings	mapSettings
	The mapSettings property contains configuration for rendering of the map. More...

int	mapUpdateInterval
	Interval in milliseconds after which the map canvas will be updated while a rendering job is ongoing. More...

Detailed Description

This class implements a visual Qt Quick Item that does map rendering according to the current map settings.

Client code is expected to use MapCanvas item rather than using this class directly.

QgsQuickMapCanvasMap instance internally creates QgsQuickMapSettings in constructor. The QgsProject should be attached to the QgsQuickMapSettings. The map settings for other QgsQuick components should be initialized from QgsQuickMapCanvasMap's mapSettings

Note: QML Type: MapCanvasMap

See also: QgsQuickMapCanvas

Since: QGIS 3.2

Definition at line 52 of file qgsquickmapcanvasmap.h.

Constructor & Destructor Documentation

QgsQuickMapCanvasMap::QgsQuickMapCanvasMap ( QQuickItem * parent = nullptr )

Create map canvas map.

Definition at line 32 of file qgsquickmapcanvasmap.cpp.

QgsQuickMapCanvasMap::~QgsQuickMapCanvasMap ( )

default

Member Function Documentation

bool QgsQuickMapCanvasMap::freeze ( ) const

When freeze property is set to true, the map canvas does not refresh.

The value temporary changes during the rendering process.

void QgsQuickMapCanvasMap::freezeChanged ( )

signal

When freeze property is set to true, the map canvas does not refresh.

The value temporary changes during the rendering process.

void QgsQuickMapCanvasMap::geometryChanged	(	const QRectF &	newGeometry,
		const QRectF &	oldGeometry
	)

overrideprotected

Definition at line 303 of file qgsquickmapcanvasmap.cpp.

bool QgsQuickMapCanvasMap::incrementalRendering ( ) const

When the incrementalRendering property is set to true, the automatic refresh of map canvas during rendering is allowed.

void QgsQuickMapCanvasMap::incrementalRenderingChanged ( )

signal

When the incrementalRendering property is set to true, the automatic refresh of map canvas during rendering is allowed.

bool QgsQuickMapCanvasMap::isRendering ( ) const

The isRendering property is set to true while a rendering job is pending for this map canvas map.

It can be used to show a notification icon about an ongoing rendering job. This is a readonly property.

void QgsQuickMapCanvasMap::isRenderingChanged ( )

signal

The isRendering property is set to true while a rendering job is pending for this map canvas map.

It can be used to show a notification icon about an ongoing rendering job. This is a readonly property.

void QgsQuickMapCanvasMap::mapCanvasRefreshed ( )

signal

Signal is emitted when a canvas is refreshed.

QgsQuickMapSettings* QgsQuickMapCanvasMap::mapSettings ( ) const

The mapSettings property contains configuration for rendering of the map.

It should be used as a primary source of map settings (and project) for all other components in the application.

This is a readonly property.

int QgsQuickMapCanvasMap::mapUpdateInterval ( ) const

Interval in milliseconds after which the map canvas will be updated while a rendering job is ongoing.

This only has an effect if incrementalRendering is activated. Default is 250 [ms].

void QgsQuickMapCanvasMap::mapUpdateIntervalChanged ( )

signal

Interval in milliseconds after which the map canvas will be updated while a rendering job is ongoing.

This only has an effect if incrementalRendering is activated. Default is 250 [ms].

void QgsQuickMapCanvasMap::pan	(	QPointF	oldPos,
		QPointF	newPos
	)

slot

Set map setting's extent (pan the map) based on the difference of positions.

Definition at line 71 of file qgsquickmapcanvasmap.cpp.

void QgsQuickMapCanvasMap::refresh ( )

slot

Refresh the map canvas.

Does nothing when output size of map settings is not set

Definition at line 375 of file qgsquickmapcanvasmap.cpp.

void QgsQuickMapCanvasMap::renderStarting ( )

signal

Signal is emitted when a rendering is starting.

void QgsQuickMapCanvasMap::setFreeze ( bool freeze )

When freeze property is set to true, the map canvas does not refresh.

The value temporary changes during the rendering process.

Definition at line 245 of file qgsquickmapcanvasmap.cpp.

void QgsQuickMapCanvasMap::setIncrementalRendering ( bool incrementalRendering )

When the incrementalRendering property is set to true, the automatic refresh of map canvas during rendering is allowed.

Definition at line 231 of file qgsquickmapcanvasmap.cpp.

void QgsQuickMapCanvasMap::setMapUpdateInterval ( int mapUpdateInterval )

Interval in milliseconds after which the map canvas will be updated while a rendering job is ongoing.

This only has an effect if incrementalRendering is activated. Default is 250 [ms].

Definition at line 216 of file qgsquickmapcanvasmap.cpp.

void QgsQuickMapCanvasMap::stopRendering ( )

slot

Stop map rendering.

Definition at line 342 of file qgsquickmapcanvasmap.cpp.

QSGNode * QgsQuickMapCanvasMap::updatePaintNode	(	QSGNode *	oldNode,
		QQuickItem::UpdatePaintNodeData *
	)

override

Definition at line 263 of file qgsquickmapcanvasmap.cpp.

void QgsQuickMapCanvasMap::zoom	(	QPointF	center,
		qreal	scale
	)

slot

Set map setting's extent (zoom the map) on the center by given scale.

Definition at line 58 of file qgsquickmapcanvasmap.cpp.

Property Documentation

bool QgsQuickMapCanvasMap::freeze

readwrite

When freeze property is set to true, the map canvas does not refresh.

The value temporary changes during the rendering process.

Definition at line 70 of file qgsquickmapcanvasmap.h.

bool QgsQuickMapCanvasMap::incrementalRendering

readwrite

When the incrementalRendering property is set to true, the automatic refresh of map canvas during rendering is allowed.

Definition at line 89 of file qgsquickmapcanvasmap.h.

bool QgsQuickMapCanvasMap::isRendering

read

The isRendering property is set to true while a rendering job is pending for this map canvas map.

It can be used to show a notification icon about an ongoing rendering job. This is a readonly property.

Definition at line 77 of file qgsquickmapcanvasmap.h.

QgsQuickMapSettings * QgsQuickMapCanvasMap::mapSettings

read

The mapSettings property contains configuration for rendering of the map.

It should be used as a primary source of map settings (and project) for all other components in the application.

This is a readonly property.

Definition at line 64 of file qgsquickmapcanvasmap.h.

int QgsQuickMapCanvasMap::mapUpdateInterval

readwrite

Interval in milliseconds after which the map canvas will be updated while a rendering job is ongoing.

This only has an effect if incrementalRendering is activated. Default is 250 [ms].

Definition at line 84 of file qgsquickmapcanvasmap.h.

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

/build/qgis-3.4.15+24xenial/src/quickgui/qgsquickmapcanvasmap.h
/build/qgis-3.4.15+24xenial/src/quickgui/qgsquickmapcanvasmap.cpp

Public Slots

Signals

Public Member Functions

Protected Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Property Documentation