QGIS API Documentation  3.16.0-Hannover (43b64b13f3)
qgsvectortilelabeling.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgsvectortilelabeling.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 QGSVECTORTILELABELING_H
17 #define QGSVECTORTILELABELING_H
18 
19 #include "qgis_core.h"
20 
22 
23 class QgsVectorTileLayer;
25 
26 #ifndef SIP_RUN
27 
34 {
35  public:
38 
40  virtual QMap<QString, QSet<QString> > usedAttributes( const QgsRenderContext &context, int tileZoom ) const = 0;
41 
42  //TODO QGIS 4.0 -- make pure virtual
43 
53  virtual QSet< QString > requiredLayers( QgsRenderContext &context, int tileZoom ) const { Q_UNUSED( context ); Q_UNUSED( tileZoom ); return QSet< QString >() << QString(); }
54 
56  virtual void setFields( const QMap<QString, QgsFields> &perLayerFields ) = 0;
57 
59  virtual void registerTileFeatures( const QgsVectorTileRendererData &tile, QgsRenderContext &context ) = 0;
60 };
61 
62 #endif
63 
70 class CORE_EXPORT QgsVectorTileLabeling
71 {
72 
73 #ifdef SIP_RUN
75 
76  const QString type = sipCpp->type();
77 
78  if ( type == QLatin1String( "basic" ) )
79  sipType = sipType_QgsVectorTileBasicLabeling;
80  else
81  sipType = 0;
82  SIP_END
83 #endif
84 
85  public:
86  virtual ~QgsVectorTileLabeling() = default;
87 
89  virtual QString type() const = 0;
90 
92  virtual QgsVectorTileLabeling *clone() const = 0 SIP_FACTORY;
93 
98  virtual QgsVectorTileLabelProvider *provider( QgsVectorTileLayer *layer ) const SIP_SKIP { Q_UNUSED( layer ) return nullptr; }
99 
101  virtual void writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const = 0;
103  virtual void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) = 0;
105  virtual void resolveReferences( const QgsProject &project ) { Q_UNUSED( project ) }
106 
107 };
108 
109 #endif // QGSVECTORTILELABELING_H
QgsVectorTileLabeling::~QgsVectorTileLabeling
virtual ~QgsVectorTileLabeling()=default
QgsVectorTileLayer
Implements a map layer that is dedicated to rendering of vector tiles.
Definition: qgsvectortilelayer.h:84
QgsReadWriteContext
The class is used as a container of context for various read/write operations on other objects.
Definition: qgsreadwritecontext.h:35
QgsVectorTileLabelProvider
Internal base class for implementation of label providers for vector tile labeling.
Definition: qgsvectortilelabeling.h:34
QgsVectorTileLabeling::resolveReferences
virtual void resolveReferences(const QgsProject &project)
Resolves references to other objects - second phase of loading - after readXml()
Definition: qgsvectortilelabeling.h:105
QgsRenderContext
Contains information about the context of a rendering operation.
Definition: qgsrendercontext.h:58
QgsVectorTileRendererData
Contains decoded features of a single vector tile and any other data necessary for rendering of it.
Definition: qgsvectortilerenderer.h:38
QgsVectorLayerLabelProvider
The QgsVectorLayerLabelProvider class implements a label provider for vector layers.
Definition: qgsvectorlayerlabelprovider.h:41
QgsProject
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition: qgsproject.h:95
SIP_FACTORY
#define SIP_FACTORY
Definition: qgis_sip.h:76
QgsVectorTileLabeling::provider
virtual QgsVectorTileLabelProvider * provider(QgsVectorTileLayer *layer) const SIP_SKIP
Factory for label provider implementation.
Definition: qgsvectortilelabeling.h:98
SIP_CONVERT_TO_SUBCLASS_CODE
#define SIP_CONVERT_TO_SUBCLASS_CODE(code)
Definition: qgis_sip.h:177
SIP_SKIP
#define SIP_SKIP
Definition: qgis_sip.h:126
QgsVectorTileLabelProvider::setFields
virtual void setFields(const QMap< QString, QgsFields > &perLayerFields)=0
Sets fields for each sub-layer.
QgsVectorTileLabelProvider::usedAttributes
virtual QMap< QString, QSet< QString > > usedAttributes(const QgsRenderContext &context, int tileZoom) const =0
Returns field names for each sub-layer that are required for labeling.
QgsVectorTileLabelProvider::requiredLayers
virtual QSet< QString > requiredLayers(QgsRenderContext &context, int tileZoom) const
Returns a list of the layers required for labeling.
Definition: qgsvectortilelabeling.h:53
QgsVectorTileLabeling::clone
virtual QgsVectorTileLabeling * clone() const =0SIP_FACTORY
Returns a new copy of the object.
QgsVectorTileLabelProvider::registerTileFeatures
virtual void registerTileFeatures(const QgsVectorTileRendererData &tile, QgsRenderContext &context)=0
Registers label features for given tile to the labeling engine.
QgsVectorTileLabeling::type
virtual QString type() const =0
Unique type string of the labeling configuration implementation.
QgsAbstractLabelProvider::layer
QgsMapLayer * layer() const
Returns the associated layer, or nullptr if no layer is associated with the provider.
Definition: qgslabelingengine.h:130
qgsvectorlayerlabelprovider.h
QgsVectorTileLabeling
Base class for labeling configuration classes for vector tile layers.
Definition: qgsvectortilelabeling.h:71
QgsVectorTileLabelProvider::QgsVectorTileLabelProvider
QgsVectorTileLabelProvider(QgsVectorTileLayer *layer)
Constructs base label provider class for the given vector tile layer.
Definition: qgsvectortilelabeling.cpp:20
SIP_END
#define SIP_END
Definition: qgis_sip.h:194
QgsVectorTileLabeling::readXml
virtual void readXml(const QDomElement &elem, const QgsReadWriteContext &context)=0
Reads labeling properties from given XML element.
QgsVectorTileLabeling::writeXml
virtual void writeXml(QDomElement &elem, const QgsReadWriteContext &context) const =0
Writes labeling properties to given XML element.