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 "qgseditformconfig.h"
#include "qgsfeaturefilter.h"
#include "qgslayertreemodellegendnode.h"
#include "qgslayoutatlas.h"
#include "qgsmaprendererjob.h"
#include "qgsserversettings.h"
#include "qgswmsparameters.h"
#include "qgswmsrendercontext.h"
 
#include <QDomDocument>
#include <QMap>
#include <QString>
 
class QgsCoordinateReferenceSystem;
class QgsPrintLayout;
class QgsFeature;
class QgsLayout;
class QgsMapLayer;
class QgsMapRendererTask;
class QgsMapSettings;
class QgsPointXY;
class QgsRasterLayer;
class QgsMeshLayer;
class QgsRectangle;
class QgsRenderContext;
class QgsVectorLayer;
class QgsAccessControl;
class QgsDxfExport;
class QgsLayerTreeModel;
class QgsLayerTree;
class QgsServerInterface;
class QgsAttributeEditorElement;
class QgsEditFormConfig;
 
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, const Qgis::LegendJsonRenderFlags &jsonRenderFlags = Qgis::LegendJsonRenderFlags() );

      QJsonObject getLegendGraphicsAsJson( QgsLayerTreeModelLegendNode &legendNode, const Qgis::LegendJsonRenderFlags &jsonRenderFlags = Qgis::LegendJsonRenderFlags() );
 
 
      typedef QSet<QString> SymbolSet;
      typedef QHash<QgsVectorLayer *, SymbolSet> HitTest;

      HitTest symbols();

      std::unique_ptr<QImage> getMap();

      std::unique_ptr<QgsDxfExport> getDxf();

      std::unique_ptr<QgsMapRendererTask> getPdf( const QString &tmpFileName );

      QByteArray getPrint();

      QByteArray getFeatureInfo( const QString &version = "1.3.0" );

      void configureLayers( QList<QgsMapLayer *> &layers, QgsMapSettings *settings = nullptr );
 
    private:
      QgsLegendSettings legendSettings();
 
      // Build and returns highlight layers
      QList<QgsMapLayer *> highlightLayers( QList<QgsWmsParametersHighlightLayer> params );
 
      // Rendering step for layers
      QPainter *layersRendering( const QgsMapSettings &mapSettings, QImage *image ) const;
 
      // Rendering step for annotations
      void annotationsRendering( QPainter *painter, const QgsMapSettings &mapSettings ) 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 );

      QgsRenderContext configureDefaultRenderContext( QPainter *painter = nullptr );
 
      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;

      void writeAttributesTabGroup(
        const QgsAttributeEditorElement *group,
        QgsVectorLayer *layer,
        const QgsFields &fields,
        QgsAttributes &featureAttributes,
        QDomDocument &doc,
        QDomElement &featureElem,
        QgsRenderContext &renderContext,
        QStringList *attributes = nullptr
      ) const;

      void writeAttributesTabLayout(
        QgsEditFormConfig &config,
        QgsVectorLayer *layer,
        const QgsFields &fields,
        QgsAttributes &featureAttributes,
        QDomDocument &doc,
        QDomElement &featureElem,
        QgsRenderContext &renderContext,
        QStringList *attributes = nullptr
      ) const;

      void writeVectorLayerAttribute(
        int attributeIndex,
        QgsVectorLayer *layer,
        const QgsFields &fields,
        QgsAttributes &featureAttributes,
        QDomDocument &doc,
        QDomElement &featureElem,
        QgsRenderContext &renderContext,
        QStringList *attributes = nullptr
      ) const;

      bool featureInfoFromMeshLayer(
        QgsMeshLayer *layer, const QgsMapSettings &mapSettings, const QgsPointXY *infoPoint, const QgsRenderContext &renderContext, QDomDocument &infoDocument, QDomElement &layerElement, const QString &version
      ) const;
      bool featureInfoFromRasterLayer(
        QgsRasterLayer *layer, const QgsMapSettings &mapSettings, const QgsPointXY *infoPoint, const QgsRenderContext &renderContext, 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 QgsCoordinateReferenceSystem &destCRS ) 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, QgsLayoutAtlas *atlas );
 
      void removeTemporaryLayers();
 
      void logRenderingErrors( const QgsMapRendererJob::Errors &errors ) const;
 
      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;
      const QgsWmsRenderContext &mContext;

      bool mIsTemporal = false;
  };
 
} // namespace QgsWms
 
#endif