qgswmsrenderer.h

Go to the documentation of this file.

/***************************************************************************
                              qgswmsrendrer.h
                              -------------------
  begin                : May 14, 2006
  copyright            : (C) 2006 by Marco Hugentobler
                         (C) 2017 by David Marteau
  email                : marco dot hugentobler at karto dot baug dot ethz dot ch
                         david dot marteau at 3liz dot com
 ***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSWMSRENDERER_H
#define QGSWMSRENDERER_H
 
#include "qgsserversettings.h"
#include "qgswmsparameters.h"
#include "qgswmsrendercontext.h"
#include "qgsfeaturefilter.h"
#include "qgslayertreemodellegendnode.h"
#include <QDomDocument>
#include <QMap>
#include <QString>
 
class QgsCoordinateReferenceSystem;
class QgsPrintLayout;
class QgsFeature;
class QgsLayout;
class QgsMapLayer;
class QgsMapSettings;
class QgsPointXY;
class QgsRasterLayer;
class QgsRectangle;
class QgsRenderContext;
class QgsVectorLayer;
class QgsAccessControl;
class QgsDxfExport;
class QgsLayerTreeModel;
class QgsLayerTree;
class QgsServerInterface;
 
class QImage;
class QPaintDevice;
class QPainter;
class QgsLayerTreeGroup;
 
namespace QgsWms
{
 
  class QgsRenderer
  {
    public:
 
      QgsRenderer( const QgsWmsRenderContext &context );
 
      ~QgsRenderer();
 
      QImage *getLegendGraphics( QgsLayerTreeModel &model );
 
      QImage *getLegendGraphics( QgsLayerTreeModelLegendNode &nodeModel );
 
      QJsonObject getLegendGraphicsAsJson( QgsLayerTreeModel &model );
 
      typedef QSet<QString> SymbolSet;
      typedef QHash<QgsVectorLayer *, SymbolSet> HitTest;
 
      HitTest symbols();
 
      QImage *getMap();
 
      std::unique_ptr<QgsDxfExport> getDxf();
 
      QByteArray getPrint();
 
      QByteArray getFeatureInfo( const QString &version = "1.3.0" );
 
      void configureLayers( QList<QgsMapLayer *> &layers, QgsMapSettings *settings = nullptr );
 
    private:
      QgsLegendSettings legendSettings() const;
 
      // Build and returns highlight layers
      QList<QgsMapLayer *> highlightLayers( QList<QgsWmsParametersHighlightLayer> params );
 
      // Build and returns external layers
      QList<QgsMapLayer *> externalLayers( const QList<QgsWmsParametersExternalLayer> &params );
 
      // Rendering step for layers
      QPainter *layersRendering( const QgsMapSettings &mapSettings, QImage &image ) const;
 
      // Rendering step for annotations
      void annotationsRendering( QPainter *painter ) const;
 
      // Set layer opacity
      void setLayerOpacity( QgsMapLayer *layer, int opacity ) const;
 
      // Set layer filter and dimension
      void setLayerFilter( QgsMapLayer *layer, const QList<QgsWmsParametersFilter> &filters );
 
      QStringList dimensionFilter( QgsVectorLayer *layer ) const;
 
      // Set layer python filter
      void setLayerAccessControlFilter( QgsMapLayer *layer ) const;
 
      // Set layer selection
      void setLayerSelection( QgsMapLayer *layer, const QStringList &fids ) const;
 
      // Combine map extent with layer extent
      void updateExtent( const QgsMapLayer *layer, QgsMapSettings &mapSettings ) const;
 
      // Scale image with WIDTH/HEIGHT if necessary
      QImage *scaleImage( const QImage *image ) const;
 
      QImage *createImage( const QSize &size ) const;
 
      void configureMapSettings( const QPaintDevice *paintDevice, QgsMapSettings &mapSettings, bool mandatoryCrsParam = true ) const;
 
      QDomDocument featureInfoDocument( QList<QgsMapLayer *> &layers, const QgsMapSettings &mapSettings,
                                        const QImage *outputImage, const QString &version ) const;
 
      bool featureInfoFromVectorLayer( QgsVectorLayer *layer,
                                       const QgsPointXY *infoPoint,
                                       int nFeatures,
                                       QDomDocument &infoDocument,
                                       QDomElement &layerElement,
                                       const QgsMapSettings &mapSettings,
                                       QgsRenderContext &renderContext,
                                       const QString &version,
                                       QgsRectangle *featureBBox = nullptr,
                                       QgsGeometry *filterGeom = nullptr ) const;
 
      bool featureInfoFromRasterLayer( QgsRasterLayer *layer,
                                       const QgsMapSettings &mapSettings,
                                       const QgsPointXY *infoPoint,
                                       QDomDocument &infoDocument,
                                       QDomElement &layerElement,
                                       const QString &version ) const;
 
      void runHitTest( const QgsMapSettings &mapSettings, HitTest &hitTest ) const;
      void runHitTestLayer( QgsVectorLayer *vl, SymbolSet &usedSymbols, QgsRenderContext &context ) const;
 
      bool testFilterStringSafety( const QString &filter ) const;
      static void groupStringList( QStringList &list, const QString &groupString );
 
      void convertFeatureInfoToSia2045( QDomDocument &doc ) const;
 
      QByteArray convertFeatureInfoToHtml( const QDomDocument &doc ) const;
 
      QByteArray convertFeatureInfoToText( const QDomDocument &doc ) const;
 
      QByteArray convertFeatureInfoToJson( const QList<QgsMapLayer *> &layers, const QDomDocument &doc ) const;
 
      QDomElement createFeatureGML(
        const QgsFeature *feat,
        QgsVectorLayer *layer,
        QDomDocument &doc,
        QgsCoordinateReferenceSystem &crs,
        const QgsMapSettings &mapSettings,
        const QString &typeName,
        bool withGeom,
        int version,
        QStringList *attributes = nullptr ) const;
 
      static QString replaceValueMapAndRelation( QgsVectorLayer *vl, int idx, const QVariant &attributeVal );
      QgsRectangle featureInfoSearchRect( QgsVectorLayer *ml, const QgsMapSettings &ms, const QgsRenderContext &rct, const QgsPointXY &infoPoint ) const;
 
      bool configurePrintLayout( QgsPrintLayout *c, const QgsMapSettings &mapSettings, bool atlasPrint = false );
 
      void removeTemporaryLayers();
 
      void handlePrintErrors( const QgsLayout *layout ) const;
 
      void setLayerStyle( QgsMapLayer *layer, const QString &style ) const;
 
      void setLayerSld( QgsMapLayer *layer, const QDomElement &sld ) const;
 
      QgsWmsParameters mWmsParameters;
 
      QgsFeatureFilter mFeatureFilter;
 
      const QgsProject *mProject = nullptr;
      QList<QgsMapLayer *> mTemporaryLayers;
      QgsWmsRenderContext mContext;
  };
 
} // namespace QgsWms
 
#endif