QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
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
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
25namespace QgsWms
26{
27
35 {
36 public:
38 enum Flag
39 {
41 UseOpacity = 0x02,
42 UseFilter = 0x04,
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
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
255 bool isValidWidthHeight( int width, int height ) const;
256
260 int mapWidth() const;
261
265 int mapHeight() const;
266
271 bool isExternalLayer( const QString &name ) const;
272
277 void setSocketFeedback( QgsFeedback *feedback );
278
284
285 private:
286 void initNicknameLayers();
287 void initRestrictedLayers();
288 void initLayerGroupsRecursive( const QgsLayerTreeGroup *group, const QString &groupName );
289
290 void searchLayersToRender();
291 void searchLayersToRenderSld();
292 void searchLayersToRenderStyle();
293 void removeUnwantedLayers();
294
295 void checkLayerReadPermissions();
296
297 bool layerScaleVisibility( const QString &name ) const;
298
299 const QgsProject *mProject = nullptr;
300 QgsServerInterface *mInterface = nullptr;
301 QgsWmsParameters mParameters;
302 Flags mFlags = Flags();
303 double mScaleDenominator = -1.0;
304
305 // nickname of all layers defined within the project
306 QMultiMap<QString, QgsMapLayer *> mNicknameLayers;
307
308 // map of layers to use for rendering
309 QList<QgsMapLayer *> mLayersToRender;
310
311 // list of layers which are not usable
312 QStringList mRestrictedLayers;
313
314 QMap<QString, QList<QgsMapLayer *> > mLayerGroups;
315
316 QMap<QString, QDomElement> mSlds;
317 QMap<QString, QString> mStyles;
318
319 // list for external layers
320 QList<QgsMapLayer *> mExternalLayers;
321
322 QgsFeedback *mSocketFeedback = nullptr;
323 };
324};
325
326#endif
A helper class that centralizes restrictions given by all the access control filter plugins.
Base class for feedback objects to be used for cancellation of something running in a worker thread.
Definition: qgsfeedback.h:44
Layer tree group node serves as a container for layers and further groups.
Base class for all map layer types.
Definition: qgsmaplayer.h:75
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition: qgsproject.h:107
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...
QgsFeedback * socketFeedback() const
Returns the response feedback if any.
~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.
void setSocketFeedback(QgsFeedback *feedback)
Sets the response feedback.
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.