qgsarrowsymbollayer.h

Go to the documentation of this file.

/***************************************************************************
 qgsarrowsymbollayer.h
 ---------------------
 begin                : January 2016
 copyright            : (C) 2016 by Hugo Mercier
 email                : hugo dot mercier at oslandia 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 QGSARROWSYMBOLLAYER_H
#define QGSARROWSYMBOLLAYER_H
 
#include "qgis.h"
#include "qgis_core.h"
#include "qgssymbollayer.h"
 
class QgsFillSymbol;
 

 
class CORE_EXPORT QgsArrowSymbolLayer : public QgsLineSymbolLayer
{
  public:
    QgsArrowSymbolLayer();
    ~QgsArrowSymbolLayer() override;

    static QgsSymbolLayer *create( const QVariantMap &properties = QVariantMap() ) SIP_FACTORY;
 
    QgsArrowSymbolLayer *clone() const override SIP_FACTORY;
    QgsSymbol *subSymbol() override;
    bool setSubSymbol( QgsSymbol *symbol SIP_TRANSFER ) override;
    QSet<QString> usedAttributes( const QgsRenderContext &context ) const override;
    bool hasDataDefinedProperties() const override;
    bool usesMapUnits() const override;
    void setOutputUnit( Qgis::RenderUnit unit ) override;

    double arrowWidth() const { return mArrowWidth; }
    void setArrowWidth( double width ) { mArrowWidth = width; }
    Qgis::RenderUnit arrowWidthUnit() const { return mArrowWidthUnit; }
    void setArrowWidthUnit( Qgis::RenderUnit unit ) { mArrowWidthUnit = unit; }
    QgsMapUnitScale arrowWidthUnitScale() const { return mArrowWidthUnitScale; }
    void setArrowWidthUnitScale( const QgsMapUnitScale &scale ) { mArrowWidthUnitScale = scale; }

    double arrowStartWidth() const { return mArrowStartWidth; }
    void setArrowStartWidth( double width ) { mArrowStartWidth = width; }
    Qgis::RenderUnit arrowStartWidthUnit() const { return mArrowStartWidthUnit; }
    void setArrowStartWidthUnit( Qgis::RenderUnit unit ) { mArrowStartWidthUnit = unit; }
    QgsMapUnitScale arrowStartWidthUnitScale() const { return mArrowStartWidthUnitScale; }
    void setArrowStartWidthUnitScale( const QgsMapUnitScale &scale ) { mArrowStartWidthUnitScale = scale; }

    double headLength() const { return mHeadLength; }
    void setHeadLength( double length ) { mHeadLength = length; }
    Qgis::RenderUnit headLengthUnit() const { return mHeadLengthUnit; }
    void setHeadLengthUnit( Qgis::RenderUnit unit ) { mHeadLengthUnit = unit; }
    QgsMapUnitScale headLengthUnitScale() const { return mHeadLengthUnitScale; }
    void setHeadLengthUnitScale( const QgsMapUnitScale &scale ) { mHeadLengthUnitScale = scale; }

    double headThickness() const { return mHeadThickness; }
    void setHeadThickness( double thickness ) { mHeadThickness = thickness; }
    Qgis::RenderUnit headThicknessUnit() const { return mHeadThicknessUnit; }
    void setHeadThicknessUnit( Qgis::RenderUnit unit ) { mHeadThicknessUnit = unit; }
    QgsMapUnitScale headThicknessUnitScale() const { return mHeadThicknessUnitScale; }
    void setHeadThicknessUnitScale( const QgsMapUnitScale &scale ) { mHeadThicknessUnitScale = scale; }

    bool isCurved() const { return mIsCurved; }
    void setIsCurved( bool isCurved ) { mIsCurved = isCurved; }

    bool isRepeated() const { return mIsRepeated; }
    void setIsRepeated( bool isRepeated ) { mIsRepeated = isRepeated; }

    enum HeadType
    {
      HeadSingle,   //< One single head at the end
      HeadReversed, //< One single head at the beginning
      HeadDouble    //< Two heads
    };

    HeadType headType() const { return mHeadType; }
    void setHeadType( HeadType type ) { mHeadType = type; }

    enum ArrowType
    {
      ArrowPlain,     //< Regular arrow
      ArrowLeftHalf,  //< Halved arrow, only the left side of the arrow is rendered (for straight arrows) or the side toward the exterior (for curved arrows)
      ArrowRightHalf  //< Halved arrow, only the right side of the arrow is rendered (for straight arrows) or the side toward the interior (for curved arrows)
    };

    ArrowType arrowType() const { return mArrowType; }
    void setArrowType( ArrowType type ) { mArrowType = type; }
 
    QVariantMap properties() const override;
    QString layerType() const override;
    void startRender( QgsSymbolRenderContext &context ) override;
    void stopRender( QgsSymbolRenderContext &context ) override;
    void startFeatureRender( const QgsFeature &feature, QgsRenderContext &context ) override;
    void stopFeatureRender( const QgsFeature &feature, QgsRenderContext &context ) override;
    void renderPolyline( const QPolygonF &points, QgsSymbolRenderContext &context ) override;
    void setColor( const QColor &c ) override;
    QColor color() const override;
    bool canCauseArtifactsBetweenAdjacentTiles() const override;
 
  private:
#ifdef SIP_RUN
    QgsArrowSymbolLayer( const QgsArrowSymbolLayer & );
#endif

    std::unique_ptr<QgsFillSymbol> mSymbol;
 
    double mArrowWidth = 1.0;
    Qgis::RenderUnit mArrowWidthUnit = Qgis::RenderUnit::Millimeters;
    QgsMapUnitScale mArrowWidthUnitScale;
 
    double mArrowStartWidth = 1.0;
    Qgis::RenderUnit mArrowStartWidthUnit = Qgis::RenderUnit::Millimeters;
    QgsMapUnitScale mArrowStartWidthUnitScale;
 
    double mHeadLength = 1.5;
    Qgis::RenderUnit mHeadLengthUnit = Qgis::RenderUnit::Millimeters;
    QgsMapUnitScale mHeadLengthUnitScale;
    double mHeadThickness = 1.5;
    Qgis::RenderUnit mHeadThicknessUnit = Qgis::RenderUnit::Millimeters;
    QgsMapUnitScale mHeadThicknessUnitScale;
 
    HeadType mHeadType = HeadSingle;
    ArrowType mArrowType = ArrowPlain;
    bool mIsCurved = true;
    bool mIsRepeated = true;
 
    double mScaledArrowWidth = 1.0;
    double mScaledArrowStartWidth = 1.0;
    double mScaledHeadLength = 1.5;
    double mScaledHeadThickness = 1.5;
    double mScaledOffset = 0.0;
    HeadType mComputedHeadType = HeadSingle;
    ArrowType mComputedArrowType = ArrowPlain;
 
    std::unique_ptr<QgsExpressionContextScope> mExpressionScope;
 
    void _resolveDataDefined( QgsSymbolRenderContext & );
};
 
#endif