QGIS API Documentation 4.0.0-Norrköping (1ddcee3d0e4)
Loading...
Searching...
No Matches
qgslayoutitempolyline.h
Go to the documentation of this file.
1/***************************************************************************
2 qgslayoutitempolyline.h
3 begin : March 2016
4 copyright : (C) 2016 Paul Blottiere, Oslandia
5 email : paul dot blottiere at oslandia dot com
6 ***************************************************************************/
7
8/***************************************************************************
9 * *
10 * This program is free software; you can redistribute it and/or modify *
11 * it under the terms of the GNU General Public License as published by *
12 * the Free Software Foundation; either version 2 of the License, or *
13 * (at your option) any later version. *
14 * *
15 ***************************************************************************/
16
17#ifndef QGSLAYOUTITEMPOLYLINE_H
18#define QGSLAYOUTITEMPOLYLINE_H
19
20#include "qgis_core.h"
21#include "qgslayout.h"
23#include "qgslogger.h"
24
25#include <QGraphicsPathItem>
26
27class QgsLineSymbol;
28
33class CORE_EXPORT QgsLayoutItemPolyline : public QgsLayoutNodesItem
34{
35 Q_OBJECT
36
37 public:
45
51
56 QgsLayoutItemPolyline( const QPolygonF &polyline, QgsLayout *layout );
57
64
65 int type() const override;
66 QIcon icon() const override;
67 QString displayName() const override;
68 QPainterPath shape() const override;
69 bool isValid() const override;
70
76
83
89 MarkerMode startMarker() const { return mStartMarker; }
90
96 void setStartMarker( MarkerMode mode );
97
103 MarkerMode endMarker() const { return mEndMarker; }
104
110 void setEndMarker( MarkerMode mode );
111
116 void setArrowHeadWidth( double width );
117
122 double arrowHeadWidth() const { return mArrowHeadWidth; }
123
129 void setStartSvgMarkerPath( const QString &path );
130
136 QString startSvgMarkerPath() const { return mStartMarkerFile; }
137
143 void setEndSvgMarkerPath( const QString &path );
144
150 QString endSvgMarkerPath() const { return mEndMarkerFile; }
151
157 QColor arrowHeadStrokeColor() const { return mArrowHeadStrokeColor; }
158
164 void setArrowHeadStrokeColor( const QColor &color );
165
171 QColor arrowHeadFillColor() const { return mArrowHeadFillColor; }
172
178 void setArrowHeadFillColor( const QColor &color );
179
185 void setArrowHeadStrokeWidth( double width );
186
192 double arrowHeadStrokeWidth() const { return mArrowHeadStrokeWidth; }
193
194 bool accept( QgsStyleEntityVisitorInterface *visitor ) const override;
195
196 protected:
197 bool _addNode( int indexPoint, QPointF newPoint, double radius ) override;
198 bool _removeNode( int nodeIndex ) override;
199 void _draw( QgsLayoutItemRenderContext &context, const QStyleOptionGraphicsItem *itemStyle = nullptr ) override;
200 void _readXmlStyle( const QDomElement &elmt, const QgsReadWriteContext &context ) override;
201 void _writeXmlStyle( QDomDocument &doc, QDomElement &elmt, const QgsReadWriteContext &context ) const override;
202 bool writePropertiesToElement( QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context ) const override;
203 bool readPropertiesFromElement( const QDomElement &element, const QDomDocument &document, const QgsReadWriteContext &context ) override;
204
205 protected slots:
206
207 void updateBoundingRect() override;
208
209 private:
211 std::unique_ptr<QgsLineSymbol> mPolylineStyleSymbol;
212
214 MarkerMode mStartMarker = NoMarker;
216 MarkerMode mEndMarker = NoMarker;
217
219 double mArrowHeadWidth = 4.0;
220
222 double mStartArrowHeadHeight = 0.0;
223
225 double mEndArrowHeadHeight = 0.0;
226
228 QString mStartMarkerFile;
229
231 QString mEndMarkerFile;
232
234 double mArrowHeadStrokeWidth = 1.0;
235
236 QColor mArrowHeadStrokeColor = Qt::black;
237 QColor mArrowHeadFillColor = Qt::black;
238
240 void createDefaultPolylineStyleSymbol();
241
246 void refreshSymbol();
247
248 void drawStartMarker( QPainter *painter );
249 void drawEndMarker( QPainter *painter );
250
251 void drawArrow( QPainter *painter, QPointF center, double angle );
252
253 void updateMarkerSvgSizes();
254
264 static void drawArrowHead( QPainter *p, double x, double y, double angle, double arrowHeadWidth );
265 void drawSvgMarker( QPainter *p, QPointF point, double angle, const QString &markerPath, double height ) const;
266
267 double computeMarkerMargin() const;
268
271};
272
273#endif // QGSLAYOUTITEMPOLYLINE_H
Layout item for node based polyline shapes.
double arrowHeadStrokeWidth() const
Returns the pen width in millimeters for the stroke of the arrow head.
QString startSvgMarkerPath() const
Returns the path the an SVG marker drawn at the start of the line.
QString endSvgMarkerPath() const
Returns the path the an SVG marker drawn at the end of the line.
QgsLineSymbol * symbol()
Returns the line symbol used to draw the shape.
QColor arrowHeadFillColor() const
Returns the color used to fill the arrow head.
MarkerMode endMarker() const
Returns the end marker mode, which controls what marker is drawn at the end of the line.
MarkerMode
Vertex marker mode.
@ ArrowHead
Show arrow marker.
@ NoMarker
Don't show marker.
QPainterPath shape() const override
~QgsLayoutItemPolyline() override
static QgsLayoutItemPolyline * create(QgsLayout *layout)
Returns a new polyline item for the specified layout.
QColor arrowHeadStrokeColor() const
Returns the color used to draw the stroke around the the arrow head.
void setSymbol(QgsLineSymbol *symbol)
Sets the symbol used to draw the shape.
MarkerMode startMarker() const
Returns the start marker mode, which controls what marker is drawn at the start of the line.
double arrowHeadWidth() const
Returns the width of line arrow heads in mm.
QgsLayoutItemPolyline(QgsLayout *layout)
Constructor for QgsLayoutItemPolyline for the specified layout.
Contains settings and helpers relating to a render of a QgsLayoutItem.
friend class QgsLayout
virtual bool accept(QgsStyleEntityVisitorInterface *visitor) const
Accepts the specified style entity visitor, causing it to visit all style entities associated with th...
virtual QIcon icon() const
Returns the item's icon.
int type() const override
Returns a unique graphics item type identifier.
virtual QString displayName() const
Gets item display name.
virtual void updateBoundingRect()
Called when the bounding rect of the item should recalculated.
virtual bool _removeNode(int nodeIndex)=0
Method called in removeNode.
virtual void _writeXmlStyle(QDomDocument &doc, QDomElement &elmt, const QgsReadWriteContext &context) const =0
Method called in writeXml.
bool readPropertiesFromElement(const QDomElement &element, const QDomDocument &document, const QgsReadWriteContext &context) override
Sets item state from a DOM element.
bool writePropertiesToElement(QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const override
Stores item state within an XML DOM element.
virtual void _readXmlStyle(const QDomElement &elmt, const QgsReadWriteContext &context)=0
Method called in readXml.
virtual bool isValid() const =0
Must be reimplemented in subclasses.
virtual void _draw(QgsLayoutItemRenderContext &context, const QStyleOptionGraphicsItem *itemStyle=nullptr)=0
Method called in paint.
QgsLayoutNodesItem(QgsLayout *layout)
Constructor for QgsLayoutNodesItem, attached to the specified layout.
virtual bool _addNode(int nodeIndex, QPointF newNode, double radius)=0
Method called in addNode.
const QgsLayout * layout() const
Returns the layout the object is attached to.
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
Definition qgslayout.h:50
A line symbol type, for rendering LineString and MultiLineString geometries.
A container for the context for various read/write operations on objects.
An interface for classes which can visit style entity (e.g.
#define SIP_FACTORY
Definition qgis_sip.h:83