qgsabstractgeopdfexporter.h

Go to the documentation of this file.

/***************************************************************************
                              qgsabstractgeopdfexporter.h
                             --------------------------
    begin                : August 2019
    copyright            : (C) 2019 by Nyall Dawson
    email                : nyall dot dawson at gmail 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 QGSABSTRACTGEOPDFEXPORTER_H
#define QGSABSTRACTGEOPDFEXPORTER_H

#include "qgis_core.h"
#include <QList>
#include <QTemporaryDir>
#include <QMutex>
#include <QDateTime>
#include "qgsfeature.h"
#include "qgsabstractmetadatabase.h"
#include "qgspolygon.h"

#define SIP_NO_FILE


class QgsGeoPdfRenderedFeatureHandler;

class CORE_EXPORT QgsAbstractGeoPdfExporter
{
  public:

    static bool geoPDFCreationAvailable();

    static QString geoPDFAvailabilityExplanation();

    QgsAbstractGeoPdfExporter() = default;

    virtual ~QgsAbstractGeoPdfExporter() = default;

    struct RenderedFeature
    {

      RenderedFeature() = default;

      RenderedFeature( const QgsFeature &feature, const QgsGeometry &renderedBounds )
        : feature( feature )
        , renderedBounds( renderedBounds )
      {}

      QgsFeature feature;

      QgsGeometry renderedBounds;
    };

    struct CORE_EXPORT ComponentLayerDetail
    {

      QString name;

      QString mapLayerId;

      QString group;

      QString sourcePdfPath;

    };

    struct ControlPoint
    {

      ControlPoint( const QgsPointXY &pagePoint, const QgsPointXY &geoPoint )
        : pagePoint( pagePoint )
        , geoPoint( geoPoint )
      {}

      QgsPointXY pagePoint;

      QgsPointXY geoPoint;
    };

    struct GeoReferencedSection
    {

      QgsRectangle pageBoundsMm;

      QgsPolygon pageBoundsPolygon;

      QgsCoordinateReferenceSystem crs;

      QList< QgsAbstractGeoPdfExporter::ControlPoint > controlPoints;

    };

    void pushRenderedFeature( const QString &layerId, const QgsAbstractGeoPdfExporter::RenderedFeature &feature, const QString &group = QString() );

    struct ExportDetails
    {
      QSizeF pageSizeMm;

      double dpi = 300;

      QList< QgsAbstractGeoPdfExporter::GeoReferencedSection > georeferencedSections;

      QString author;

      QString producer;

      QString creator;

      QDateTime creationDateTime;

      QString subject;

      QString title;

      QgsAbstractMetadataBase::KeywordMap keywords;

      bool useIso32000ExtensionFormatGeoreferencing = true;

      bool useOgcBestPracticeFormatGeoreferencing = false;

      bool includeFeatures = true;

      QMap< QString, QString > customLayerTreeGroups;

    };

    bool finalize( const QList< QgsAbstractGeoPdfExporter::ComponentLayerDetail > &components, const QString &destinationFile, const ExportDetails &details );

    QString errorMessage() { return mErrorMessage; }

    QString generateTemporaryFilepath( const QString &filename ) const;

  protected:

    struct VectorComponentDetail
    {
      QString name;

      QString mapLayerId;

      QString group;

      QString displayAttribute;

      QString sourceVectorPath;

      QString sourceVectorLayer;

    };

  private:

    QMutex mMutex;
    QMap< QString, QMap< QString, QgsFeatureList > > mCollatedFeatures;

    virtual VectorComponentDetail componentDetailForLayerId( const QString &layerId ) = 0;

    QList< VectorComponentDetail > mVectorComponents;

    QString mErrorMessage;
    QTemporaryDir mTemporaryDir;

    bool saveTemporaryLayers();

    QString createCompositionXml( const QList< QgsAbstractGeoPdfExporter::ComponentLayerDetail > &components, const ExportDetails &details );

    friend class TestQgsLayoutGeoPdfExport;
    friend class TestQgsGeoPdfExport;
};

#endif //QGSABSTRACTGEOPDFEXPORTER_H