Add a new "arrow" symbol layer

The "arrow" symbol layer is a symbol layer allowing to draw straight
or curved arrows from a line layer.

python/core/core.sip

@@ -305,6 +305,7 @@
 %Include symbology-ng/qgssymbollayerv2registry.sip
 %Include symbology-ng/qgssymbollayerv2utils.sip
 %Include symbology-ng/qgsvectorfieldsymbollayer.sip
+%Include symbology-ng/qgsarrowsymbollayer.sip
 
 %Include symbology-ng/qgssymbologyv2conversion.sip
 

python/core/symbology-ng/qgsarrowsymbollayer.sip

@@ -0,0 +1,111 @@
+class QgsArrowSymbolLayer : public QgsLineSymbolLayerV2
+{
+%TypeHeaderCode
+#include <qgsarrowsymbollayer.h>
+%End
+  public:
+    /** Simple constructor */
+    QgsArrowSymbolLayer();
+
+    /**
+     * Create a new QgsArrowSymbolLayer
+     *
+     * @param properties A property map to deserialize saved information from properties()
+     *
+     * @return A new QgsArrowSymbolLayer
+     */
+    static QgsSymbolLayerV2* create( const QgsStringMap& properties ) /Factory/;
+
+    /** Virtual constructor */
+    virtual QgsArrowSymbolLayer* clone() const /Factory/;
+
+    /** Get the sub symbol used for filling */
+    virtual QgsSymbolV2* subSymbol();
+
+    /** Set the sub symbol used for filling */
+    virtual bool setSubSymbol( QgsSymbolV2* symbol );
+
+    /** Return a list of attributes required to render this feature */
+    virtual QSet<QString> usedAttributes() const;
+
+     /** Get current arrow width */
+    double arrowWidth() const;
+    /** Set the arrow width */
+    void setArrowWidth( double w );
+    /** Get the unit for the arrow width */
+    QgsSymbolV2::OutputUnit arrowWidthUnit() const;
+    /** Set the unit for the arrow width */
+    void setArrowWidthUnit( QgsSymbolV2::OutputUnit u );
+    /** Get the scale for the arrow width */
+    QgsMapUnitScale arrowWidthUnitScale() const;
+    /** Set the scale for the arrow width */
+    void setArrowWidthUnitScale( const QgsMapUnitScale& s );
+
+    /** Get current arrow start width. Only meaningfull for single headed arrows */
+    double arrowStartWidth() const;
+    /** Set the arrow start width */
+    void setArrowStartWidth( double w );
+    /** Get the unit for the arrow start width */
+    QgsSymbolV2::OutputUnit arrowStartWidthUnit() const;
+    /** Set the unit for the arrow start width */
+    void setArrowStartWidthUnit( QgsSymbolV2::OutputUnit u );
+    /** Get the scale for the arrow start width */
+    QgsMapUnitScale arrowStartWidthUnitScale() const;
+    /** Set the scale for the arrow start width */
+    void setArrowStartWidthUnitScale( const QgsMapUnitScale& s );
+
+    /** Get the current arrow head size */
+    double headSize() const;
+    /** Set the arrow head size */
+    void setHeadSize( double s );
+    /** Get the unit for the head size */
+    QgsSymbolV2::OutputUnit headSizeUnit() const;
+    /** Set the unit for the head size */
+    void setHeadSizeUnit( QgsSymbolV2::OutputUnit u );
+    /** Get the scale for the head size */
+    QgsMapUnitScale headSizeUnitScale() const;
+    /** Set the scale for the head size */
+    void setHeadSizeUnitScale( const QgsMapUnitScale& s );
+
+    /** Return whether it is a curved arrow or a straight one */
+    bool isCurved() const;
+    /** Set whether it is a curved arrow or a straight one */
+    void setIsCurved( bool isCurved );
+
+    /** Possible head types */
+    enum HeadType
+    {
+      HeadSingle,   //< One single head at the end
+      HeadReversed, //< One single head at the beginning
+      HeadDouble    //< Two heads
+    };
+
+    /** Get the current head type */
+    HeadType headType() const;
+    /** Set the head type */
+    void setHeadType( HeadType t );
+
+    /**
+     * Should be reimplemented by subclasses to return a string map that
+     * contains the configuration information for the symbol layer. This
+     * is used to serialize a symbol layer perstistently.
+     */
+    QgsStringMap properties() const;
+
+    /**
+     * Returns a string that represents this layer type. Used for serialization.
+     * Should match with the string used to register this symbol layer in the registry.
+     */
+    QString layerType() const;
+
+    /** Prepare the rendering */
+    void startRender( QgsSymbolV2RenderContext& context );
+
+    /** End of the rendering */
+    void stopRender( QgsSymbolV2RenderContext& context );
+
+    /** Main drawing method */
+    void renderPolyline( const QPolygonF& points, QgsSymbolV2RenderContext& context );
+private:
+    QgsArrowSymbolLayer( const QgsArrowSymbolLayer& );
+};

python/gui/gui.sip

@@ -198,6 +198,7 @@
 
 %Include symbology-ng/characterwidget.sip
 %Include symbology-ng/qgs25drendererwidget.sip
+%Include symbology-ng/qgsarrowsymbollayerwidget.sip
 %Include symbology-ng/qgsbrushstylecombobox.sip
 %Include symbology-ng/qgscategorizedsymbolrendererv2widget.sip
 %Include symbology-ng/qgscolorrampcombobox.sip

python/gui/symbology-ng/qgsarrowsymbollayerwidget.sip

@@ -0,0 +1,22 @@
+class QgsArrowSymbolLayerWidget: QgsSymbolLayerV2Widget
+{
+%TypeHeaderCode
+#include <qgsarrowsymbollayerwidget.h>
+%End
+  public:
+    /** Constructor
+     * @param layer the layer where this symbol layer is applied
+     * @param parent the parent widget
+     */
+    QgsArrowSymbolLayerWidget( const QgsVectorLayer* layer, QWidget* parent /TransferThis/ = 0 );
+
+    /** Static creation method
+     * @param layer the layer where this symbol layer is applied
+     */
+    static QgsSymbolLayerV2Widget* create( const QgsVectorLayer* layer ) /Factory/;
+
+    /** Set the symbol layer */
+    virtual void setSymbolLayer( QgsSymbolLayerV2* layer );
+    /** Get the current symbol layer */
+    virtual QgsSymbolLayerV2* symbolLayer();
+};

src/core/CMakeLists.txt

@@ -16,6 +16,7 @@ SET(QGIS_CORE_SRCS
   gps/tok.c
 
   symbology-ng/qgs25drenderer.cpp
+  symbology-ng/qgsarrowsymbollayer.cpp
   symbology-ng/qgscategorizedsymbolrendererv2.cpp
   symbology-ng/qgscolorbrewerpalette.cpp
   symbology-ng/qgscptcityarchive.cpp