Class: QgsVectorTileRenderer

Abstract base class for all vector tile renderer implementations.

For rendering it is expected that client code calls:

Added in version 3.14.

Note

This is an abstract class, with methods which must be implemented by a subclass.

The following methods must be implemented: clone(), readXml(), renderBackground(), renderSelectedFeatures(), renderTile(), startRender(), stopRender(), type(), willRenderFeature(), writeXml()

Class Hierarchy

Inheritance diagram of qgis.core.QgsVectorTileRenderer

Subclasses

QgsVectorTileBasicRenderer

The default vector tile renderer implementation.
class qgis.core.QgsVectorTileRenderer[source]

Bases: object

abstract clone(self) → QgsVectorTileRenderer | None[source]

Returns a clone of the renderer

Return type:

Optional[QgsVectorTileRenderer]

abstract readXml(self, elem: QDomElement, context: QgsReadWriteContext)[source]

Reads renderer’s properties from given XML element

Parameters:
abstract renderBackground(self, context: QgsRenderContext)[source]

Renders the background if defined

Parameters:

context (QgsRenderContext)

abstract renderSelectedFeatures(self, selection: Iterable[QgsFeature], context: QgsRenderContext)[source]

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.

Added in version 3.28.

Parameters:
abstract renderTile(self, tile: QgsVectorTileRendererData, context: QgsRenderContext)[source]

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

Parameters:
virtual requiredLayers(self, context: QgsRenderContext, tileZoom: int) → Set[str]

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.

Added in version 3.16.

Parameters:
Return type:

Set[str]

virtual resolveReferences(self, project: QgsProject)[source]

Resolves references to other objects - second phase of loading - after readXml()

Parameters:

project (QgsProject)

abstract startRender(self, context: QgsRenderContext, tileZoom: int, tileRange: QgsTileRange)[source]

Initializes rendering. It should be paired with a stopRender() call.

Parameters:
abstract stopRender(self, context: QgsRenderContext)[source]

Finishes rendering and cleans up any resources

Parameters:

context (QgsRenderContext)

abstract type(self) → str[source]

Returns unique type name of the renderer implementation

Return type:

str

abstract willRenderFeature(self, feature: QgsFeature, tileZoom: int, layerName: str | None, context: QgsRenderContext) → bool[source]

Returns True if the specified feature will be rendered in the given render context.

Added in version 3.28.

Parameters:
Return type:

bool

abstract writeXml(self, elem: QDomElement, context: QgsReadWriteContext)[source]

Writes renderer’s properties to given XML element

Parameters: