qgsmapboxglstyleconverter.h

Go to the documentation of this file.

/***************************************************************************
  qgsmapboxglstyleconverter.h
  --------------------------------------
  Date                 : September 2020
  Copyright            : (C) 2020 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 QGSMAPBOXGLSTYLECONVERTER_H
#define QGSMAPBOXGLSTYLECONVERTER_H
 
#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgsproperty.h"
#include <QVariantMap>
#include <memory>
#include <QImage>
 
class QgsVectorTileRenderer;
class QgsVectorTileLabeling;
class QgsVectorTileBasicRendererStyle;
class QgsVectorTileBasicLabelingStyle;
 
class CORE_EXPORT QgsMapBoxGlStyleConversionContext
{
  public:
 
    void pushWarning( const QString &warning );
 
    QStringList warnings() const { return mWarnings; }
 
    void clearWarnings() { mWarnings.clear(); }
 
    QgsUnitTypes::RenderUnit targetUnit() const;
 
    void setTargetUnit( QgsUnitTypes::RenderUnit targetUnit );
 
    double pixelSizeConversionFactor() const;
 
    void setPixelSizeConversionFactor( double sizeConversionFactor );
 
    QImage spriteImage() const;
 
    QVariantMap spriteDefinitions() const;
 
    void setSprites( const QImage &image, const QVariantMap &definitions );
 
    void setSprites( const QImage &image, const QString &definitions );
 
    QString layerId() const;
 
    void setLayerId( const QString &value );
 
  private:
 
    QStringList mWarnings;
 
    QString mLayerId;
 
    QgsUnitTypes::RenderUnit mTargetUnit = QgsUnitTypes::RenderPixels;
 
    double mSizeConversionFactor = 1.0;
 
    QImage mSpriteImage;
    QVariantMap mSpriteDefinitions;
};
 
class CORE_EXPORT QgsMapBoxGlStyleConverter
{
  public:
 
    QgsMapBoxGlStyleConverter();
 
    QgsMapBoxGlStyleConverter( const QgsMapBoxGlStyleConverter &other ) = delete;
    QgsMapBoxGlStyleConverter &operator=( const QgsMapBoxGlStyleConverter &other ) = delete;
 
    ~QgsMapBoxGlStyleConverter();
 
    enum Result
    {
      Success = 0, 
      NoLayerList = 1, 
    };
 
    Result convert( const QVariantMap &style, QgsMapBoxGlStyleConversionContext *context = nullptr );
 
    Result convert( const QString &style, QgsMapBoxGlStyleConversionContext *context = nullptr );
 
    QString errorMessage() const { return mError; }
 
    QStringList warnings() const { return mWarnings; }
 
    QgsVectorTileRenderer *renderer() const SIP_FACTORY;
 
    QgsVectorTileLabeling *labeling() const SIP_FACTORY;
 
  protected:
 
    enum PropertyType
    {
      Color, 
      Numeric, 
      Opacity, 
      Point, 
    };
 
    void parseLayers( const QVariantList &layers, QgsMapBoxGlStyleConversionContext *context = nullptr );
 
    static bool parseFillLayer( const QVariantMap &jsonLayer, QgsVectorTileBasicRendererStyle &style SIP_OUT, QgsMapBoxGlStyleConversionContext &context, bool isBackgroundStyle = false );
 
    static bool parseLineLayer( const QVariantMap &jsonLayer, QgsVectorTileBasicRendererStyle &style SIP_OUT, QgsMapBoxGlStyleConversionContext &context );
 
    static bool parseCircleLayer( const QVariantMap &jsonLayer, QgsVectorTileBasicRendererStyle &style SIP_OUT, QgsMapBoxGlStyleConversionContext &context );
 
    static void parseSymbolLayer( const QVariantMap &jsonLayer,
                                  QgsVectorTileBasicRendererStyle &rendererStyle SIP_OUT,
                                  bool &hasRenderer SIP_OUT,
                                  QgsVectorTileBasicLabelingStyle &labelingStyle SIP_OUT,
                                  bool &hasLabeling SIP_OUT, QgsMapBoxGlStyleConversionContext &context );
 
    static bool parseSymbolLayerAsRenderer( const QVariantMap &jsonLayer,
                                            QgsVectorTileBasicRendererStyle &rendererStyle SIP_OUT, QgsMapBoxGlStyleConversionContext &context );
 
    static QgsProperty parseInterpolateColorByZoom( const QVariantMap &json, QgsMapBoxGlStyleConversionContext &context, QColor *defaultColor SIP_OUT = nullptr );
 
    static QgsProperty parseInterpolateByZoom( const QVariantMap &json, QgsMapBoxGlStyleConversionContext &context, double multiplier = 1, double *defaultNumber SIP_OUT = nullptr );
 
    static QgsProperty parseInterpolateOpacityByZoom( const QVariantMap &json, int maxOpacity, QgsMapBoxGlStyleConversionContext *contextPtr = 0 );
 
    static QString parseOpacityStops( double base, const QVariantList &stops, int maxOpacity, QgsMapBoxGlStyleConversionContext &context );
 
    static QgsProperty parseInterpolatePointByZoom( const QVariantMap &json, QgsMapBoxGlStyleConversionContext &context, double multiplier = 1, QPointF *defaultPoint SIP_OUT = nullptr );
 
    static QgsProperty parseInterpolateStringByZoom( const QVariantMap &json, QgsMapBoxGlStyleConversionContext &context,
        const QVariantMap &conversionMap,
        QString *defaultString SIP_OUT = nullptr );
 
    static QString parsePointStops( double base, const QVariantList &stops, QgsMapBoxGlStyleConversionContext &context, double multiplier = 1 );
 
    static QString parseArrayStops( const QVariantList &stops, QgsMapBoxGlStyleConversionContext &context, double multiplier = 1 );
 
    static QString parseStops( double base, const QVariantList &stops, double multiplier, QgsMapBoxGlStyleConversionContext &context );
 
    static QString parseStringStops( const QVariantList &stops, QgsMapBoxGlStyleConversionContext &context,
                                     const QVariantMap &conversionMap,
                                     QString *defaultString SIP_OUT = nullptr );
 
 
    static QString parseLabelStops( const QVariantList &stops, QgsMapBoxGlStyleConversionContext &context );
 
    static QgsProperty parseValueList( const QVariantList &json, PropertyType type, QgsMapBoxGlStyleConversionContext &context, double multiplier = 1,
                                       int maxOpacity = 255, QColor *defaultColor SIP_OUT = nullptr, double *defaultNumber SIP_OUT = nullptr );
 
 
    static QgsProperty parseMatchList( const QVariantList &json, PropertyType type, QgsMapBoxGlStyleConversionContext &context, double multiplier = 1,
                                       int maxOpacity = 255, QColor *defaultColor SIP_OUT = nullptr, double *defaultNumber SIP_OUT = nullptr );
 
    static QgsProperty parseInterpolateListByZoom( const QVariantList &json, PropertyType type, QgsMapBoxGlStyleConversionContext &context, double multiplier = 1,
        int maxOpacity = 255, QColor *defaultColor SIP_OUT = nullptr, double *defaultNumber SIP_OUT = nullptr );
 
    static QString parseColorExpression( const QVariant &colorExpression, QgsMapBoxGlStyleConversionContext &context );
 
    static QColor parseColor( const QVariant &color, QgsMapBoxGlStyleConversionContext &context );
 
    static void colorAsHslaComponents( const QColor &color, int &hue, int &saturation, int &lightness, int &alpha );
 
    static QString interpolateExpression( double zoomMin, double zoomMax, QVariant valueMin, QVariant valueMax, double base, double multiplier = 1, QgsMapBoxGlStyleConversionContext *contextPtr = 0 );
 
    static Qt::PenCapStyle parseCapStyle( const QString &style );
 
    static Qt::PenJoinStyle parseJoinStyle( const QString &style );
 
    static QString parseExpression( const QVariantList &expression, QgsMapBoxGlStyleConversionContext &context, bool colorExpected = false );
 
    static QImage retrieveSprite( const QString &name, QgsMapBoxGlStyleConversionContext &context, QSize &spriteSize );
 
    static QString retrieveSpriteAsBase64( const QVariant &value, QgsMapBoxGlStyleConversionContext &context, QSize &spriteSize, QString &spriteProperty, QString &spriteSizeProperty );
 
  private:
 
#ifdef SIP_RUN
    QgsMapBoxGlStyleConverter( const QgsMapBoxGlStyleConverter &other );
#endif
 
    static QString parseValue( const QVariant &value, QgsMapBoxGlStyleConversionContext &context, bool colorExpected = false );
 
    static QString parseKey( const QVariant &value, QgsMapBoxGlStyleConversionContext &context );
 
    static QString processLabelField( const QString &string, bool &isExpression );
 
    static bool numericArgumentsOnly( const QVariant &bottomVariant, const QVariant &topVariant, double &bottom, double &top );
 
    QString mError;
    QStringList mWarnings;
 
    std::unique_ptr< QgsVectorTileRenderer > mRenderer;
    std::unique_ptr< QgsVectorTileLabeling > mLabeling;
 
};
 
#endif // QGSMAPBOXGLSTYLECONVERTER_H