QGIS API Documentation 3.41.0-Master (a6c88b06562)
|
Rendering context for the WMS renderer. More...
#include <qgswmsrendercontext.h>
Public Types | |
enum | Flag { UseScaleDenominator = 0x01 , UseOpacity = 0x02 , UseFilter = 0x04 , UseSelection = 0x08 , AddHighlightLayers = 0x10 , UpdateExtent = 0x20 , SetAccessControl = 0x40 , AddQueryLayers = 0x80 , UseWfsLayersOnly = 0x100 , AddExternalLayers = 0x200 , UseSrcWidthHeight = 0x400 , UseTileBuffer = 0x800 , AddAllLayers = 0x1000 } |
Available rendering options. More... | |
typedef QFlags< Flag > | Flags |
Public Member Functions | |
QgsWmsRenderContext (const QgsProject *project, QgsServerInterface *interface) | |
Constructor for QgsWmsRenderContext. | |
~QgsWmsRenderContext () | |
qreal | dotsPerMm () const |
Returns default dots per mm according to the current configuration. | |
QStringList | flattenedQueryLayers (const QStringList &layerNames) const |
Returns a list of query layer names where group names are replaced by the names of their layer components. | |
int | imageQuality () const |
Returns the image quality to use for rendering according to the current configuration. | |
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. | |
bool | isValidLayer (const QString &nickname) const |
Returns true if the layer has to be rendered, false otherwise. | |
bool | isValidWidthHeight () const |
Returns true if width and height are valid according to the maximum values defined within the project, false otherwise. | |
bool | isValidWidthHeight (int width, int height) const |
Returns true if width and height are valid according to the maximum image width/height. | |
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 need to be rendered. | |
QMap< QString, QList< QgsMapLayer * > > | layerGroups () const |
Returns a map having layer group names as keys and a list of layers as values. | |
QString | layerNickname (const QgsMapLayer &layer) const |
Returns the nickname (short name, id or name) of the layer according to the current configuration. | |
QList< QgsMapLayer * > | layers () const |
Returns a list of all layers read from 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. | |
QList< QgsMapLayer * > | layersToRender () const |
Returns a list of all layers to actually render according to the current configuration. | |
int | mapHeight () const |
Returns HEIGHT or SRCHEIGHT according to UseSrcWidthHeight flag. | |
QSize | mapSize (bool aspectRatio=true) const |
Returns the size (in pixels) of the map to render, according to width and height WMS parameters as well as the aspectRatio option. | |
double | mapTileBuffer (int mapWidth) const |
Returns the tile buffer in geographical units for the given map width in pixels. | |
int | mapWidth () const |
Returns WIDTH or SRCWIDTH according to UseSrcWidthHeight flag. | |
QgsWmsParameters | parameters () const |
Returns WMS parameters. | |
QgsWmsParametersLayer | parameters (const QgsMapLayer &layer) const |
Returns WMS parameters for a specific layer. | |
int | precision () const |
Returns the precision to use according to the current configuration. | |
const QgsProject * | project () const |
Returns the project. | |
bool | renderMapTiles () const |
Returns true if WMS requests should use the QgsMapSettings::RenderMapTile flag, so that no visible artifacts are visible between adjacent tiles. | |
double | scaleDenominator () const |
Returns the scale denominator to use for rendering according to the current configuration. | |
void | setFlag (Flag flag, bool on=true) |
Sets or unsets a rendering flag according to the on value. | |
void | setParameters (const QgsWmsParameters ¶meters) |
Sets WMS parameters. | |
void | setScaleDenominator (double scaleDenominator) |
Sets a custom scale denominator. | |
void | setSocketFeedback (QgsFeedback *feedback) |
Sets the response feedback. | |
const QgsServerSettings & | settings () const |
Returns settings of the server. | |
QDomElement | sld (const QgsMapLayer &layer) const |
Returns a SLD document for a specific layer. | |
QgsFeedback * | socketFeedback () const |
Returns the response feedback if any. | |
QString | style (const QgsMapLayer &layer) const |
Returns a style's name for a specific layer. | |
bool | testFlag (Flag flag) const |
Returns the status of a rendering flag. | |
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. | |
Rendering context for the WMS renderer.
Definition at line 34 of file qgswmsrendercontext.h.
typedef QFlags< Flag > QgsWms::QgsWmsRenderContext::Flags |
Definition at line 54 of file qgswmsrendercontext.h.
Available rendering options.
Definition at line 38 of file qgswmsrendercontext.h.
QgsWmsRenderContext::~QgsWmsRenderContext | ( | ) |
Definition at line 35 of file qgswmsrendercontext.cpp.
QgsWmsRenderContext::QgsWmsRenderContext | ( | const QgsProject * | project, |
QgsServerInterface * | interface | ||
) |
Constructor for QgsWmsRenderContext.
project | The project to use for the rendering |
interface | The server interface |
Definition at line 28 of file qgswmsrendercontext.cpp.
qreal QgsWmsRenderContext::dotsPerMm | ( | ) | const |
Returns default dots per mm according to the current configuration.
Definition at line 182 of file qgswmsrendercontext.cpp.
QStringList QgsWmsRenderContext::flattenedQueryLayers | ( | const QStringList & | layerNames | ) | const |
Returns a list of query layer names where group names are replaced by the names of their layer components.
Definition at line 197 of file qgswmsrendercontext.cpp.
int QgsWmsRenderContext::imageQuality | ( | ) | const |
Returns the image quality to use for rendering according to the current configuration.
Definition at line 141 of file qgswmsrendercontext.cpp.
bool QgsWmsRenderContext::isExternalLayer | ( | const QString & | name | ) | const |
Returns true if the layer is an external layer, false otherwise.
Definition at line 926 of file qgswmsrendercontext.cpp.
bool QgsWmsRenderContext::isValidGroup | ( | const QString & | name | ) | const |
Returns true if name is a group.
Definition at line 330 of file qgswmsrendercontext.cpp.
bool QgsWmsRenderContext::isValidLayer | ( | const QString & | nickname | ) | const |
Returns true if the layer has to be rendered, false otherwise.
Definition at line 320 of file qgswmsrendercontext.cpp.
bool QgsWmsRenderContext::isValidWidthHeight | ( | ) | const |
Returns true if width and height are valid according to the maximum values defined within the project, false otherwise.
Definition at line 728 of file qgswmsrendercontext.cpp.
bool QgsWmsRenderContext::isValidWidthHeight | ( | int | width, |
int | height | ||
) | const |
Returns true if width and height are valid according to the maximum image width/height.
width | the image width in pixels |
height | the image height in pixels |
Definition at line 733 of file qgswmsrendercontext.cpp.
QgsMapLayer * QgsWmsRenderContext::layer | ( | const QString & | nickname | ) | const |
Returns the layer corresponding to the nickname, or a nullptr if not found or if the layer do not need to be rendered.
Definition at line 304 of file qgswmsrendercontext.cpp.
QMap< QString, QList< QgsMapLayer * > > QgsWmsRenderContext::layerGroups | ( | ) | const |
Returns a map having layer group names as keys and a list of layers as values.
Definition at line 697 of file qgswmsrendercontext.cpp.
QString QgsWmsRenderContext::layerNickname | ( | const QgsMapLayer & | layer | ) | const |
Returns the nickname (short name, id or name) of the layer according to the current configuration.
Definition at line 283 of file qgswmsrendercontext.cpp.
QList< QgsMapLayer * > QgsWmsRenderContext::layers | ( | ) | const |
Returns a list of all layers read from the project.
Definition at line 244 of file qgswmsrendercontext.cpp.
QList< QgsMapLayer * > QgsWmsRenderContext::layersFromGroup | ( | const QString & | nickname | ) | const |
Returns the group's layers list corresponding to the nickname, or an empty list if not found.
Definition at line 325 of file qgswmsrendercontext.cpp.
QList< QgsMapLayer * > QgsWmsRenderContext::layersToRender | ( | ) | const |
Returns a list of all layers to actually render according to the current configuration.
Definition at line 239 of file qgswmsrendercontext.cpp.
int QgsWmsRenderContext::mapHeight | ( | ) | const |
Returns HEIGHT or SRCHEIGHT according to UseSrcWidthHeight flag.
Definition at line 715 of file qgswmsrendercontext.cpp.
QSize QgsWmsRenderContext::mapSize | ( | bool | aspectRatio = true | ) | const |
Returns the size (in pixels) of the map to render, according to width and height WMS parameters as well as the aspectRatio option.
Definition at line 831 of file qgswmsrendercontext.cpp.
double QgsWmsRenderContext::mapTileBuffer | ( | int | mapWidth | ) | const |
Returns the tile buffer in geographical units for the given map width in pixels.
Definition at line 811 of file qgswmsrendercontext.cpp.
int QgsWmsRenderContext::mapWidth | ( | ) | const |
Returns WIDTH or SRCWIDTH according to UseSrcWidthHeight flag.
Definition at line 702 of file qgswmsrendercontext.cpp.
QgsWmsParameters QgsWmsRenderContext::parameters | ( | ) | const |
Returns WMS parameters.
Definition at line 82 of file qgswmsrendercontext.cpp.
QgsWmsParametersLayer QgsWmsRenderContext::parameters | ( | const QgsMapLayer & | layer | ) | const |
Returns WMS parameters for a specific layer.
An empty instance is returned if not available.
Definition at line 123 of file qgswmsrendercontext.cpp.
int QgsWmsRenderContext::precision | ( | ) | const |
Returns the precision to use according to the current configuration.
Definition at line 170 of file qgswmsrendercontext.cpp.
const QgsProject * QgsWmsRenderContext::project | ( | ) | const |
Returns the project.
Definition at line 92 of file qgswmsrendercontext.cpp.
bool QgsWmsRenderContext::renderMapTiles | ( | ) | const |
Returns true
if WMS requests should use the QgsMapSettings::RenderMapTile flag, so that no visible artifacts are visible between adjacent tiles.
This flag can slow down rendering considerably, so it is only used if the corresponding if explicitly opted in.
Definition at line 165 of file qgswmsrendercontext.cpp.
double QgsWmsRenderContext::scaleDenominator | ( | ) | const |
Returns the scale denominator to use for rendering according to the current configuration.
Definition at line 249 of file qgswmsrendercontext.cpp.
void QgsWmsRenderContext::setFlag | ( | Flag | flag, |
bool | on = true |
||
) |
Sets or unsets a rendering flag according to the on value.
Definition at line 65 of file qgswmsrendercontext.cpp.
void QgsWmsRenderContext::setParameters | ( | const QgsWmsParameters & | parameters | ) |
Sets WMS parameters.
Definition at line 41 of file qgswmsrendercontext.cpp.
void QgsWmsRenderContext::setScaleDenominator | ( | double | scaleDenominator | ) |
Sets a custom scale denominator.
In this case, layers to render are updated according to their scale visibility.
Definition at line 265 of file qgswmsrendercontext.cpp.
void QgsWmsRenderContext::setSocketFeedback | ( | QgsFeedback * | feedback | ) |
const QgsServerSettings & QgsWmsRenderContext::settings | ( | ) | const |
Returns settings of the server.
Definition at line 87 of file qgswmsrendercontext.cpp.
QDomElement QgsWmsRenderContext::sld | ( | const QgsMapLayer & | layer | ) | const |
Returns a SLD document for a specific layer.
An empty document is returned if not available.
Definition at line 97 of file qgswmsrendercontext.cpp.
QgsFeedback * QgsWmsRenderContext::socketFeedback | ( | ) | const |
Returns the response feedback if any.
Definition at line 963 of file qgswmsrendercontext.cpp.
QString QgsWmsRenderContext::style | ( | const QgsMapLayer & | layer | ) | const |
Returns a style's name for a specific layer.
An empty string is returned if not available.
Definition at line 110 of file qgswmsrendercontext.cpp.
bool QgsWmsRenderContext::testFlag | ( | Flag | flag | ) | const |
Returns the status of a rendering flag.
flag | The flag to test |
Definition at line 77 of file qgswmsrendercontext.cpp.
int QgsWmsRenderContext::tileBuffer | ( | ) | const |
Returns the tile buffer value to use for rendering according to the current configuration.
Definition at line 153 of file qgswmsrendercontext.cpp.
bool QgsWmsRenderContext::updateExtent | ( | ) | const |
Returns true if the extent has to be updated before the rendering, false otherwise.
Definition at line 271 of file qgswmsrendercontext.cpp.