The default vector tile renderer implementation. More...

#include <qgsvectortilebasicrenderer.h>

Inheritance diagram for QgsVectorTileBasicRenderer:

Public Member Functions
	QgsVectorTileBasicRenderer ()
	Constructs renderer with no styles. More...

QgsVectorTileBasicRenderer *	clone () const override
	Returns a clone of the renderer. More...

void	readXml (const QDomElement &elem, const QgsReadWriteContext &context) override
	Reads renderer's properties from given XML element. More...

void	renderBackground (QgsRenderContext &context) override
	Renders the background if defined. More...

void	renderSelectedFeatures (const QList< QgsFeature > &selection, QgsRenderContext &context) override
	Renders the specified features in a selected state. More...

void	renderTile (const QgsVectorTileRendererData &tile, QgsRenderContext &context) override
	Renders given vector tile. Must be called between startRender/stopRender. More...

QSet< QString >	requiredLayers (QgsRenderContext &context, int tileZoom) const override
	Returns a list of the layers required for rendering. More...

void	setStyle (int index, const QgsVectorTileBasicRendererStyle &style)
	Updates style definition at the paricular index of the list (the index must be in interval [0,N-1] otherwise this function does nothing) More...

void	setStyles (const QList< QgsVectorTileBasicRendererStyle > &styles)
	Sets list of styles of the renderer. More...

void	startRender (QgsRenderContext &context, int tileZoom, const QgsTileRange &tileRange) override
	Initializes rendering. It should be paired with a stopRender() call. More...

void	stopRender (QgsRenderContext &context) override
	Finishes rendering and cleans up any resources. More...

QgsVectorTileBasicRendererStyle	style (int index) const
	Returns style definition at the particular index. More...

QList< QgsVectorTileBasicRendererStyle >	styles () const
	Returns list of styles of the renderer. More...

QString	type () const override
	Returns unique type name of the renderer implementation. More...

QMap< QString, QSet< QString > >	usedAttributes (const QgsRenderContext &) override
	Returns field names of sub-layers that will be used for rendering. Must be called between startRender/stopRender. More...

bool	willRenderFeature (const QgsFeature &feature, int tileZoom, const QString &layerName, QgsRenderContext &context) override
	Returns `true` if the specified feature will be rendered in the given render context. More...

void	writeXml (QDomElement &elem, const QgsReadWriteContext &context) const override
	Writes renderer's properties to given XML element. More...

Public Member Functions inherited from QgsVectorTileRenderer
virtual	~QgsVectorTileRenderer ()=default

virtual QgsVectorTileRenderer *	clone () const =0
	Returns a clone of the renderer. More...

virtual void	readXml (const QDomElement &elem, const QgsReadWriteContext &context)=0
	Reads renderer's properties from given XML element. More...

virtual void	renderBackground (QgsRenderContext &context)=0
	Renders the background if defined. More...

virtual void	renderSelectedFeatures (const QList< QgsFeature > &selection, QgsRenderContext &context)=0
	Renders the specified features in a selected state. More...

virtual void	renderTile (const QgsVectorTileRendererData &tile, QgsRenderContext &context)=0
	Renders given vector tile. Must be called between startRender/stopRender. More...

virtual QSet< QString >	requiredLayers (QgsRenderContext &context, int tileZoom) const
	Returns a list of the layers required for rendering. More...

virtual void	resolveReferences (const QgsProject &project)
	Resolves references to other objects - second phase of loading - after readXml() More...

virtual void	startRender (QgsRenderContext &context, int tileZoom, const QgsTileRange &tileRange)=0
	Initializes rendering. It should be paired with a stopRender() call. More...

virtual void	stopRender (QgsRenderContext &context)=0
	Finishes rendering and cleans up any resources. More...

virtual QString	type () const =0
	Returns unique type name of the renderer implementation. More...

virtual QMap< QString, QSet< QString > >	usedAttributes (const QgsRenderContext &)
	Returns field names of sub-layers that will be used for rendering. Must be called between startRender/stopRender. More...

virtual bool	willRenderFeature (const QgsFeature &feature, int tileZoom, const QString &layerName, QgsRenderContext &context)=0
	Returns `true` if the specified feature will be rendered in the given render context. More...

virtual void	writeXml (QDomElement &elem, const QgsReadWriteContext &context) const =0
	Writes renderer's properties to given XML element. More...

Static Public Member Functions
static QList< QgsVectorTileBasicRendererStyle >	simpleStyle (const QColor &polygonFillColor, const QColor &polygonStrokeColor, double polygonStrokeWidth, const QColor &lineStrokeColor, double lineStrokeWidth, const QColor &pointFillColor, const QColor &pointStrokeColor, double pointSize)
	Returns a list of styles to render all layers with the given fill/stroke colors, stroke widths and marker sizes. More...

static QList< QgsVectorTileBasicRendererStyle >	simpleStyleWithRandomColors ()
	Returns a list of styles to render all layers, using random colors. More...

Detailed Description

The default vector tile renderer implementation.

It has an ordered list of "styles", each defines a rendering rule.

Since: QGIS 3.14

Definition at line 169 of file qgsvectortilebasicrenderer.h.

Constructor & Destructor Documentation

◆ QgsVectorTileBasicRenderer()

QgsVectorTileBasicRenderer::QgsVectorTileBasicRenderer ( )

Constructs renderer with no styles.

Definition at line 103 of file qgsvectortilebasicrenderer.cpp.

Member Function Documentation

◆ clone()

QgsVectorTileBasicRenderer * QgsVectorTileBasicRenderer::clone ( ) const

overridevirtual

Returns a clone of the renderer.

Implements QgsVectorTileRenderer.

Definition at line 112 of file qgsvectortilebasicrenderer.cpp.

◆ readXml()

void QgsVectorTileBasicRenderer::readXml	(	const QDomElement &	elem,
		const QgsReadWriteContext &	context
	)

overridevirtual

Reads renderer's properties from given XML element.

Implements QgsVectorTileRenderer.

Definition at line 411 of file qgsvectortilebasicrenderer.cpp.

◆ renderBackground()

void QgsVectorTileBasicRenderer::renderBackground ( QgsRenderContext & context )

overridevirtual

Renders the background if defined.

Implements QgsVectorTileRenderer.

Definition at line 165 of file qgsvectortilebasicrenderer.cpp.

◆ renderSelectedFeatures()

void QgsVectorTileBasicRenderer::renderSelectedFeatures	(	const QList< QgsFeature > &	selection,
		QgsRenderContext &	context
	)

overridevirtual

Renders the specified features in a selected state.

This will be called after rendering the tiles, so that the selected features are always visible on the top of the layer.

Since: QGIS 3.28

Implements QgsVectorTileRenderer.

Definition at line 285 of file qgsvectortilebasicrenderer.cpp.

◆ renderTile()

void QgsVectorTileBasicRenderer::renderTile	(	const QgsVectorTileRendererData &	tile,
		QgsRenderContext &	context
	)

overridevirtual

Renders given vector tile. Must be called between startRender/stopRender.

Implements QgsVectorTileRenderer.

Definition at line 193 of file qgsvectortilebasicrenderer.cpp.

◆ requiredLayers()

QSet< QString > QgsVectorTileBasicRenderer::requiredLayers	(	QgsRenderContext &	context,
		int	tileZoom
	)		const

overridevirtual

Returns a list of the layers required for rendering.

Only layers which are visible at the specified tileZoom should be included in this list.

An empty string present in the list indicates that all layer in the tiles are required.

Since: QGIS 3.16

Reimplemented from QgsVectorTileRenderer.

Definition at line 147 of file qgsvectortilebasicrenderer.cpp.

◆ setStyle()

void QgsVectorTileBasicRenderer::setStyle	(	int	index,
		const QgsVectorTileBasicRendererStyle &	style
	)

inline

Updates style definition at the paricular index of the list (the index must be in interval [0,N-1] otherwise this function does nothing)

Definition at line 193 of file qgsvectortilebasicrenderer.h.

◆ setStyles()

void QgsVectorTileBasicRenderer::setStyles ( const QList< QgsVectorTileBasicRendererStyle > & styles )

Sets list of styles of the renderer.

Definition at line 426 of file qgsvectortilebasicrenderer.cpp.

◆ simpleStyle()

QList< QgsVectorTileBasicRendererStyle > QgsVectorTileBasicRenderer::simpleStyle	(	const QColor &	polygonFillColor,
		const QColor &	polygonStrokeColor,
		double	polygonStrokeWidth,
		const QColor &	lineStrokeColor,
		double	lineStrokeWidth,
		const QColor &	pointFillColor,
		const QColor &	pointStrokeColor,
		double	pointSize
	)