QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
qgsvectortilebasiclabeling.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsvectortilebasiclabeling.h
3 --------------------------------------
4 Date : April 2020
5 Copyright : (C) 2020 by Martin Dobias
6 Email : wonder dot sk at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#ifndef QGSVECTORTILEBASICLABELING_H
17#define QGSVECTORTILEBASICLABELING_H
18
19
21
22
24
32{
33 public:
34
36 void setLabelSettings( const QgsPalLayerSettings &settings ) { mLabelSettings = settings; }
38 QgsPalLayerSettings labelSettings() const { return mLabelSettings; }
39
41 void setStyleName( const QString &name ) { mStyleName = name; }
43 QString styleName() const { return mStyleName; }
44
46 void setLayerName( const QString &name ) { mLayerName = name; }
48 QString layerName() const { return mLayerName; }
49
51 void setGeometryType( QgsWkbTypes::GeometryType geomType ) { mGeometryType = geomType; }
53 QgsWkbTypes::GeometryType geometryType() const { return mGeometryType; }
54
56 void setFilterExpression( const QString &expr ) { mExpression = expr; }
58 QString filterExpression() const { return mExpression; }
59
61 void setEnabled( bool enabled ) { mEnabled = enabled; }
63 bool isEnabled() const { return mEnabled; }
64
66 void setMinZoomLevel( int minZoom ) { mMinZoomLevel = minZoom; }
68 int minZoomLevel() const { return mMinZoomLevel; }
69
71 void setMaxZoomLevel( int maxZoom ) { mMaxZoomLevel = maxZoom; }
73 int maxZoomLevel() const { return mMaxZoomLevel; }
74
76 bool isActive( int zoomLevel ) const
77 {
78 return mEnabled && ( mMinZoomLevel == -1 || zoomLevel >= mMinZoomLevel ) && ( mMaxZoomLevel == -1 || zoomLevel <= mMaxZoomLevel );
79 }
80
82 void writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const;
84 void readXml( const QDomElement &elem, const QgsReadWriteContext &context );
85
86 private:
87 QString mStyleName;
88 QString mLayerName;
89 QgsWkbTypes::GeometryType mGeometryType;
90 bool mEnabled = true;
91 QString mExpression;
92 int mMinZoomLevel = -1;
93 int mMaxZoomLevel = -1;
94
95 QgsPalLayerSettings mLabelSettings;
96};
97
98
108{
109 public:
111
112 QString type() const override;
113 QgsVectorTileLabeling *clone() const override SIP_FACTORY;
114 QgsVectorTileLabelProvider *provider( QgsVectorTileLayer *layer ) const override SIP_SKIP;
115 void writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const override;
116 void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) override;
117
119 void setStyles( const QList<QgsVectorTileBasicLabelingStyle> &styles ) { mStyles = styles; }
121 QList<QgsVectorTileBasicLabelingStyle> styles() const { return mStyles; }
123 void setStyle( int index, const QgsVectorTileBasicLabelingStyle &style ) { mStyles[index] = style; }
125 QgsVectorTileBasicLabelingStyle style( int index ) const { return mStyles[index]; }
126
127 private:
129 QList<QgsVectorTileBasicLabelingStyle> mStyles;
130};
131
132
133#ifndef SIP_RUN
134
142{
143 public:
145 QgsVectorTileBasicLabelProvider( QgsVectorTileLayer *layer, const QList<QgsVectorTileBasicLabelingStyle> &styles );
146
147 QList<QgsAbstractLabelProvider *> subProviders() override;
148 bool prepare( QgsRenderContext &context, QSet<QString> &attributeNames ) override;
149
150 // virtual functions from QgsVectorTileLabelProvider
151 void registerTileFeatures( const QgsVectorTileRendererData &tile, QgsRenderContext &context ) override;
152 QMap<QString, QSet<QString> > usedAttributes( const QgsRenderContext &context, int tileZoom ) const override;
153 QSet< QString > requiredLayers( QgsRenderContext &context, int tileZoom ) const override;
154 void setFields( const QMap<QString, QgsFields> &perLayerFields ) override;
155
156 private:
157 QList<QgsVectorTileBasicLabelingStyle> mStyles;
158
160 QList<QgsVectorLayerLabelProvider *> mSubProviders;
161
162 public:
164 QMap<QString, QgsFields> mPerLayerFields;
165};
166
168#endif
169
170
171#endif // QGSVECTORTILEBASICLABELING_H
QgsMapLayer * layer() const
Returns the associated layer, or nullptr if no layer is associated with the provider.
Contains settings for how a map layer will be labeled.
The class is used as a container of context for various read/write operations on other objects.
Contains information about the context of a rendering operation.
Implementation class for QgsVectorTileBasicLabeling.
QMap< QString, QgsFields > mPerLayerFields
Names of required fields for each sub-layer (only valid between startRender/stopRender calls)
bool prepare(QgsRenderContext &context, QSet< QString > &attributeNames) override
Prepare for registration of features.
void setFields(const QMap< QString, QgsFields > &perLayerFields) override
Sets fields for each sub-layer.
QgsVectorTileBasicLabelProvider(QgsVectorTileLayer *layer, const QList< QgsVectorTileBasicLabelingStyle > &styles)
Constructs a label provider for the given vector tile layer and using styling from QgsVectorTileBasic...
void registerTileFeatures(const QgsVectorTileRendererData &tile, QgsRenderContext &context) override
Registers label features for given tile to the labeling engine.
QMap< QString, QSet< QString > > usedAttributes(const QgsRenderContext &context, int tileZoom) const override
Returns field names for each sub-layer that are required for labeling.
QSet< QString > requiredLayers(QgsRenderContext &context, int tileZoom) const override
Returns a list of the layers required for labeling.
QList< QgsAbstractLabelProvider * > subProviders() override
Returns list of child providers - useful if the provider needs to put labels into more layers with di...
Configuration of a single style within QgsVectorTileBasicLabeling.
QgsPalLayerSettings labelSettings() const
Returns labeling configuration of this style.
void setGeometryType(QgsWkbTypes::GeometryType geomType)
Sets type of the geometry that will be used (point / line / polygon)
QString layerName() const
Returns name of the sub-layer to render (empty layer means that all layers match)
void setLayerName(const QString &name)
Sets name of the sub-layer to render (empty layer means that all layers match)
QString filterExpression() const
Returns filter expression (empty filter means that all features match)
void setMinZoomLevel(int minZoom)
Sets minimum zoom level index (negative number means no limit)
QgsWkbTypes::GeometryType geometryType() const
Returns type of the geometry that will be used (point / line / polygon)
int maxZoomLevel() const
Returns maxnimum zoom level index (negative number means no limit)
void setFilterExpression(const QString &expr)
Sets filter expression (empty filter means that all features match)
int minZoomLevel() const
Returns minimum zoom level index (negative number means no limit)
void setMaxZoomLevel(int maxZoom)
Sets maximum zoom level index (negative number means no limit)
void setStyleName(const QString &name)
Sets human readable name of this style.
bool isActive(int zoomLevel) const
Returns whether the style is active at given zoom level (also checks "enabled" flag)
void setLabelSettings(const QgsPalLayerSettings &settings)
Sets labeling configuration of this style.
void setEnabled(bool enabled)
Sets whether this style is enabled (used for rendering)
QString styleName() const
Returns human readable name of this style.
bool isEnabled() const
Returns whether this style is enabled (used for rendering)
Basic labeling configuration for vector tile layers.
QList< QgsVectorTileBasicLabelingStyle > styles() const
Returns list of styles of the renderer.
void setStyles(const QList< QgsVectorTileBasicLabelingStyle > &styles)
Sets list of styles of the renderer.
void setStyle(int index, const QgsVectorTileBasicLabelingStyle &style)
Updates style definition at the paricular index of the list (the index must be in interval [0,...
QgsVectorTileBasicLabelingStyle style(int index) const
Returns style definition at the particular index.
Internal base class for implementation of label providers for vector tile labeling.
Base class for labeling configuration classes for vector tile layers.
Implements a map layer that is dedicated to rendering of vector tiles.
Contains decoded features of a single vector tile and any other data necessary for rendering of it.
GeometryType
The geometry types are used to group QgsWkbTypes::Type in a coarse way.
Definition: qgswkbtypes.h:141
#define SIP_SKIP
Definition: qgis_sip.h:126
#define SIP_FACTORY
Definition: qgis_sip.h:76