QGIS API Documentation  3.16.0-Hannover (43b64b13f3)
qgsvectortilerenderer.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgsvectortilerenderer.h
3  --------------------------------------
4  Date : March 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 QGSVECTORTILERENDERER_H
17 #define QGSVECTORTILERENDERER_H
18 
19 #include "qgis_core.h"
20 
21 #include "qgsfeature.h"
22 
23 #include "qgstiles.h"
24 
25 class QgsRenderContext;
26 
28 typedef QMap<QString, QVector<QgsFeature> > QgsVectorTileFeatures SIP_SKIP;
29 
37 class CORE_EXPORT QgsVectorTileRendererData
38 {
39  public:
41  explicit QgsVectorTileRendererData( QgsTileXYZ id ): mId( id ) {}
42 
44  QgsTileXYZ id() const { return mId; }
45 
47  void setTilePolygon( QPolygon polygon ) { mTilePolygon = polygon; }
49  QPolygon tilePolygon() const { return mTilePolygon; }
50 
52  void setFields( const QMap<QString, QgsFields> &fields ) { mFields = fields; }
54  QMap<QString, QgsFields> fields() const { return mFields; }
55 
57  void setFeatures( const QgsVectorTileFeatures &features ) SIP_SKIP { mFeatures = features; }
59  QgsVectorTileFeatures features() const SIP_SKIP { return mFeatures; }
61  QStringList layers() const { return mFeatures.keys(); }
63  QVector<QgsFeature> layerFeatures( const QString &layerName ) const { return mFeatures[layerName]; }
64 
65  private:
67  QgsTileXYZ mId;
69  QMap<QString, QgsFields> mFields;
71  QgsVectorTileFeatures mFeatures;
73  QPolygon mTilePolygon;
74 };
75 
88 class CORE_EXPORT QgsVectorTileRenderer
89 {
90 
91 #ifdef SIP_RUN
93 
94  const QString type = sipCpp->type();
95 
96  if ( type == QLatin1String( "basic" ) )
97  sipType = sipType_QgsVectorTileBasicRenderer;
98  else
99  sipType = 0;
100  SIP_END
101 #endif
102 
103  public:
104  virtual ~QgsVectorTileRenderer() = default;
105 
107  virtual QString type() const = 0;
108 
111 
113  virtual void startRender( QgsRenderContext &context, int tileZoom, const QgsTileRange &tileRange ) = 0;
114 
116  virtual QMap<QString, QSet<QString> > usedAttributes( const QgsRenderContext & ) SIP_SKIP { return QMap<QString, QSet<QString> >(); }
117 
118  //TODO QGIS 4.0 -- make pure virtual
119 
129  virtual QSet< QString > requiredLayers( QgsRenderContext &context, int tileZoom ) const { Q_UNUSED( context ); Q_UNUSED( tileZoom ); return QSet< QString >() << QString(); }
130 
132  virtual void stopRender( QgsRenderContext &context ) = 0;
133 
135  virtual void renderTile( const QgsVectorTileRendererData &tile, QgsRenderContext &context ) = 0;
136 
138  virtual void writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const = 0;
140  virtual void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) = 0;
142  virtual void resolveReferences( const QgsProject &project ) { Q_UNUSED( project ) }
143 
144 };
145 
146 #endif // QGSVECTORTILERENDERER_H
QgsVectorTileRenderer::type
virtual QString type() const =0
Returns unique type name of the renderer implementation.
QgsTileXYZ
Stores coordinates of a tile in a tile matrix set.
Definition: qgstiles.h:33
QgsReadWriteContext
The class is used as a container of context for various read/write operations on other objects.
Definition: qgsreadwritecontext.h:35
QgsVectorTileRenderer::stopRender
virtual void stopRender(QgsRenderContext &context)=0
Finishes rendering and cleans up any resources.
QgsVectorTileRendererData::setFields
void setFields(const QMap< QString, QgsFields > &fields)
Sets per-layer fields.
Definition: qgsvectortilerenderer.h:52
QgsTileRange
Range of tiles in a tile matrix to be rendered.
Definition: qgstiles.h:66
qgsfeature.h
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
QgsVectorTileRenderer::~QgsVectorTileRenderer
virtual ~QgsVectorTileRenderer()=default
QgsVectorTileRendererData::tilePolygon
QPolygon tilePolygon() const
Returns polygon (made out of four corners of the tile) in screen coordinates calculated from render c...
Definition: qgsvectortilerenderer.h:49
QgsProject
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition: qgsproject.h:95
QgsVectorTileRendererData::id
QgsTileXYZ id() const
Returns coordinates of the tile.
Definition: qgsvectortilerenderer.h:44
SIP_FACTORY
#define SIP_FACTORY
Definition: qgis_sip.h:76
QgsVectorTileRendererData::QgsVectorTileRendererData
QgsVectorTileRendererData(QgsTileXYZ id)
Constructs the object.
Definition: qgsvectortilerenderer.h:41
SIP_CONVERT_TO_SUBCLASS_CODE
#define SIP_CONVERT_TO_SUBCLASS_CODE(code)
Definition: qgis_sip.h:177
QgsVectorTileRendererData::fields
QMap< QString, QgsFields > fields() const
Returns per-layer fields.
Definition: qgsvectortilerenderer.h:54
SIP_SKIP
#define SIP_SKIP
Definition: qgis_sip.h:126
QgsVectorTileRenderer
Abstract base class for all vector tile renderer implementations.
Definition: qgsvectortilerenderer.h:89
QgsVectorTileRenderer::readXml
virtual void readXml(const QDomElement &elem, const QgsReadWriteContext &context)=0
Reads renderer's properties from given XML element.
QgsVectorTileRendererData::setFeatures
void setFeatures(const QgsVectorTileFeatures &features)
Sets features of the tile.
Definition: qgsvectortilerenderer.h:57
QgsVectorTileRenderer::usedAttributes
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...
Definition: qgsvectortilerenderer.h:116
QgsVectorTileRendererData::setTilePolygon
void setTilePolygon(QPolygon polygon)
Sets polygon of the tile.
Definition: qgsvectortilerenderer.h:47
QgsVectorTileRenderer::renderTile
virtual void renderTile(const QgsVectorTileRendererData &tile, QgsRenderContext &context)=0
Renders given vector tile. Must be called between startRender/stopRender.
qgstiles.h
QgsVectorTileRendererData::layers
QStringList layers() const
Returns list of layer names present in the tile.
Definition: qgsvectortilerenderer.h:61
QgsVectorTileRendererData::layerFeatures
QVector< QgsFeature > layerFeatures(const QString &layerName) const
Returns list of all features within a single sub-layer.
Definition: qgsvectortilerenderer.h:63
QgsVectorTileRenderer::clone
virtual QgsVectorTileRenderer * clone() const =0
Returns a clone of the renderer.
QgsVectorTileRenderer::startRender
virtual void startRender(QgsRenderContext &context, int tileZoom, const QgsTileRange &tileRange)=0
Initializes rendering. It should be paired with a stopRender() call.
QgsVectorTileRendererData::features
QgsVectorTileFeatures features() const
Returns features of the tile grouped by sub-layer names.
Definition: qgsvectortilerenderer.h:59
QgsVectorTileFeatures
QMap< QString, QVector< QgsFeature > > QgsVectorTileFeatures
Features of a vector tile, grouped by sub-layer names (key of the map)
Definition: qgsvectortilerenderer.h:25
SIP_END
#define SIP_END
Definition: qgis_sip.h:194
QgsVectorTileRenderer::writeXml
virtual void writeXml(QDomElement &elem, const QgsReadWriteContext &context) const =0
Writes renderer's properties to given XML element.
QgsVectorTileRenderer::resolveReferences
virtual void resolveReferences(const QgsProject &project)
Resolves references to other objects - second phase of loading - after readXml()
Definition: qgsvectortilerenderer.h:142
QgsVectorTileRenderer::requiredLayers
virtual QSet< QString > requiredLayers(QgsRenderContext &context, int tileZoom) const
Returns a list of the layers required for rendering.
Definition: qgsvectortilerenderer.h:129