QGIS API Documentation  3.18.1-Zürich (202f1bf7e5)
qgswmsrendercontext.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgswmsrendercontext.h
3  ---------------------
4  begin : March 22, 2019
5  copyright : (C) 2019 by Paul Blottiere
6  email : [email protected]
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 
18 #ifndef QGSWMSRENDERCONTEXT_H
19 #define QGSWMSRENDERCONTEXT_H
20 
21 #include "qgswmsparameters.h"
22 #include "qgsproject.h"
23 #include "qgsserverinterface.h"
24 
25 namespace QgsWms
26 {
27 
35  {
36  public:
38  enum Flag
39  {
41  UseOpacity = 0x02,
42  UseFilter = 0x04,
43  UseSelection = 0x08,
45  UpdateExtent = 0x20,
51  UseTileBuffer = 0x800,
52  AddAllLayers = 0x1000
53  };
54  Q_DECLARE_FLAGS( Flags, Flag )
55 
56 
60 
67 
72 
77 
81  const QgsServerSettings &settings() const;
82 
86  const QgsProject *project() const;
87 
91  void setFlag( Flag flag, bool on = true );
92 
98  bool testFlag( Flag flag ) const;
99 
103  QList<QgsMapLayer *> layers() const;
104 
109  QList<QgsMapLayer *> layersToRender() const;
110 
115  QDomElement sld( const QgsMapLayer &layer ) const;
116 
121  QString style( const QgsMapLayer &layer ) const;
122 
127  double scaleDenominator() const;
128 
133  void setScaleDenominator( double scaleDenominator );
134 
139  bool updateExtent() const;
140 
146 
151  int imageQuality() const;
152 
158  int tileBuffer() const;
159 
169  bool renderMapTiles() const;
170 
174  int precision() const;
175 
180  QString layerNickname( const QgsMapLayer &layer ) const;
181 
186  QgsMapLayer *layer( const QString &nickname ) const;
187 
191  bool isValidLayer( const QString &nickname ) const;
192 
197  QList<QgsMapLayer *> layersFromGroup( const QString &nickname ) const;
198 
202  bool isValidGroup( const QString &name ) const;
203 
207  qreal dotsPerMm() const;
208 
213  QStringList flattenedQueryLayers( const QStringList &layerNames ) const;
214 
215 #ifdef HAVE_SERVER_PYTHON_PLUGINS
216 
220  QgsAccessControl *accessControl() const;
221 #endif
222 
227  QMap<QString, QList<QgsMapLayer *> > layerGroups() const;
228 
233  double mapTileBuffer( int mapWidth ) const;
234 
240  QSize mapSize( bool aspectRatio = true ) const;
241 
247  bool isValidWidthHeight() const;
248 
252  int mapWidth() const;
253 
257  int mapHeight() const;
258 
263  bool isExternalLayer( const QString &name ) const;
264 
265  private:
266  void initNicknameLayers();
267  void initRestrictedLayers();
268  void initLayerGroupsRecursive( const QgsLayerTreeGroup *group, const QString &groupName );
269 
270  void searchLayersToRender();
271  void searchLayersToRenderSld();
272  void searchLayersToRenderStyle();
273  void removeUnwantedLayers();
274 
275  void checkLayerReadPermissions();
276 
277  bool layerScaleVisibility( const QString &name ) const;
278 
279  const QgsProject *mProject = nullptr;
280  QgsServerInterface *mInterface = nullptr;
281  QgsWmsParameters mParameters;
282  Flags mFlags = Flags();
283  double mScaleDenominator = -1.0;
284 
285  // nickname of all layers defined within the project
286  QMultiMap<QString, QgsMapLayer *> mNicknameLayers;
287 
288  // map of layers to use for rendering
289  QList<QgsMapLayer *> mLayersToRender;
290 
291  // list of layers which are not usable
292  QStringList mRestrictedLayers;
293 
294  QMap<QString, QList<QgsMapLayer *> > mLayerGroups;
295 
296  QMap<QString, QDomElement> mSlds;
297  QMap<QString, QString> mStyles;
298 
299  // list for external layers
300  QList<QgsMapLayer *> mExternalLayers;
301  };
302 };
303 
304 #endif
A helper class that centralizes restrictions given by all the access control filter plugins.
Layer tree group node serves as a container for layers and further groups.
Base class for all map layer types.
Definition: qgsmaplayer.h:85
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition: qgsproject.h:99
QgsServerInterface Class defining interfaces exposed by QGIS Server and made available to plugins.
Provides a way to retrieve settings by prioritizing according to environment variables,...
Provides an interface to retrieve and manipulate WMS parameters received from the client.
Rendering context for the WMS renderer.
QSize mapSize(bool aspectRatio=true) const
Returns the size (in pixels) of the map to render, according to width and height WMS parameters as we...
bool isExternalLayer(const QString &name) const
Returns true if the layer is an external layer, false otherwise.
bool isValidGroup(const QString &name) const
Returns true if name is a group.
QStringList flattenedQueryLayers(const QStringList &layerNames) const
Returns a list of query layer names where group names are replaced by the names of their layer compon...
~QgsWmsRenderContext()
Destructor for QgsWmsRenderContext.
QgsWmsRenderContext(const QgsProject *project, QgsServerInterface *interface)
Constructor for QgsWmsRenderContext.
QList< QgsMapLayer * > layers() const
Returns a list of all layers read from the project.
void setParameters(const QgsWmsParameters &parameters)
Sets WMS parameters.
QList< QgsMapLayer * > layersToRender() const
Returns a list of all layers to actually render according to the current configuration.
int mapWidth() const
Returns WIDTH or SRCWIDTH according to UseSrcWidthHeight flag.
QgsMapLayer * layer(const QString &nickname) const
Returns the layer corresponding to the nickname, or a nullptr if not found or if the layer do not nee...
int tileBuffer() const
Returns the tile buffer value to use for rendering according to the current configuration.
bool updateExtent() const
Returns true if the extent has to be updated before the rendering, false otherwise.
const QgsServerSettings & settings() const
Returns settings of the server.
void setFlag(Flag flag, bool on=true)
Sets or unsets a rendering flag according to the on value.
bool isValidWidthHeight() const
Returns true if width and height are valid according to the maximum values defined within the project...
QList< QgsMapLayer * > layersFromGroup(const QString &nickname) const
Returns the group's layers list corresponding to the nickname, or an empty list if not found.
QgsWmsParameters parameters() const
Returns WMS parameters.
void setScaleDenominator(double scaleDenominator)
Sets a custom scale denominator.
QString style(const QgsMapLayer &layer) const
Returns a style's name for a specific layer.
QMap< QString, QList< QgsMapLayer * > > layerGroups() const
Returns a map having layer group names as keys and a list of layers as values.
double mapTileBuffer(int mapWidth) const
Returns the tile buffer in geographical units for the given map width in pixels.
QString layerNickname(const QgsMapLayer &layer) const
Returns the nickname (short name, id or name) of the layer according to the current configuration.
double scaleDenominator() const
Returns the scale denominator to use for rendering according to the current configuration.
qreal dotsPerMm() const
Returns default dots per mm according to the current configuration.
bool testFlag(Flag flag) const
Returns the status of a rendering flag.
QDomElement sld(const QgsMapLayer &layer) const
Returns a SLD document for a specific layer.
bool isValidLayer(const QString &nickname) const
Returns true if the layer has to be rendered, false otherwise.
const QgsProject * project() const
Returns the project.
int precision() const
Returns the precision to use according to the current configuration.
int imageQuality() const
Returns the image quality to use for rendering according to the current configuration.
int mapHeight() const
Returns HEIGHT or SRCHEIGHT according to UseSrcWidthHeight flag.
bool renderMapTiles() const
Returns true if WMS requests should use the QgsMapSettings::RenderMapTile flag, so that no visible ar...
Flag
Available rendering options.
@ AddAllLayers
For GetPrint: add layers from LAYER(S) parameter.
Median cut implementation.