16 #ifndef QGSLINESYMBOLLAYER_H
17 #define QGSLINESYMBOLLAYER_H
19 #include "qgis_core.h"
32 #define DEFAULT_SIMPLELINE_COLOR QColor(35,35,35)
33 #define DEFAULT_SIMPLELINE_WIDTH DEFAULT_LINE_WIDTH
34 #define DEFAULT_SIMPLELINE_PENSTYLE Qt::SolidLine
35 #define DEFAULT_SIMPLELINE_JOINSTYLE Qt::BevelJoin
36 #define DEFAULT_SIMPLELINE_CAPSTYLE Qt::SquareCap
72 QString layerType() const override;
77 void renderPolygonStroke( const QPolygonF &points, const QVector<QPolygonF> *rings,
QgsSymbolRenderContext &context ) override;
78 QVariantMap properties() const override;
80 void toSld( QDomDocument &doc, QDomElement &element, const QVariantMap &props ) const override;
81 QString ogrFeatureStyle(
double mmScaleFactor,
double mapUnitScaleFactor ) const override;
82 void setOutputUnit(
QgsUnitTypes::RenderUnit unit ) override;
84 bool usesMapUnits() const override;
88 QVector<qreal> dxfCustomDashPattern(
QgsUnitTypes::RenderUnit &unit ) const override;
89 Qt::PenStyle dxfPenStyle() const override;
93 bool canCauseArtifactsBetweenAdjacentTiles() const override;
100 Qt::PenStyle penStyle()
const {
return mPenStyle; }
464 bool alignDashPattern()
const;
475 void setAlignDashPattern(
bool enabled );
487 bool tweakDashPatternOnCorners()
const;
499 void setTweakDashPatternOnCorners(
bool enabled );
503 Qt::PenStyle mPenStyle = Qt::SolidLine;
509 bool mUseCustomDashPattern =
false;
513 double mDashPatternOffset = 0;
517 double mTrimDistanceStart = 0;
521 double mTrimDistanceEnd = 0;
526 QVector<qreal> mCustomDashVector;
528 bool mAlignDashPattern =
false;
529 bool mPatternCartographicTweakOnSharpCorners =
false;
531 bool mDrawInsidePolygon =
false;
534 void applyDataDefinedSymbology(
QgsSymbolRenderContext &context, QPen &pen, QPen &selPen,
double &offset );
535 void drawPathWithDashPatternTweaks( QPainter *painter,
const QPolygonF &points, QPen pen )
const;
540 #define DEFAULT_MARKERLINE_ROTATE true
541 #define DEFAULT_MARKERLINE_INTERVAL 3
564 double interval = 3 );
638 Q_DECL_DEPRECATED
void setPlacement(
Qgis::MarkerLinePlacement placement )
SIP_DEPRECATED;
645 Qgis::MarkerLinePlacements placements()
const {
return mPlacements; }
652 void setPlacements( Qgis::MarkerLinePlacements placements ) { mPlacements = placements; }
808 QVariantMap properties() const override;
809 bool canCauseArtifactsBetweenAdjacentTiles() const override;
822 virtual
void setSymbolLineAngle(
double angle ) = 0;
827 virtual
double symbolAngle() const = 0;
832 virtual
void setSymbolAngle(
double angle ) = 0;
846 virtual
void renderSymbol( const QPointF &point, const
QgsFeature *feature,
QgsRenderContext &context,
int layer = -1,
bool selected = false ) = 0;
861 void renderPolylineInterval( const QPolygonF &points,
QgsSymbolRenderContext &context,
double averageAngleOver );
862 void renderPolylineVertex( const QPolygonF &points,
QgsSymbolRenderContext &context,
Qgis::MarkerLinePlacement placement =
Qgis::MarkerLinePlacement::Vertex );
863 void renderPolylineCentral( const QPolygonF &points,
QgsSymbolRenderContext &context,
double averageAngleOver );
864 double markerAngle( const QPolygonF &points,
bool isRing,
int vertex );
878 void renderOffsetVertexAlongLine( const QPolygonF &points,
int vertex,
double distance,
QgsSymbolRenderContext &context,
879 Qgis::MarkerLinePlacement placement );
882 static
void collectOffsetPoints( const QVector< QPointF> &points,
883 QVector< QPointF> &dest,
double intervalPainterUnits,
double initialOffset,
double initialLag = 0,
884 int numberPointsRequired = -1 );
886 bool mRotateSymbols = true;
887 double mInterval = 3;
890 Qgis::MarkerLinePlacements mPlacements =
Qgis::MarkerLinePlacement::Interval;
891 double mOffsetAlongLine = 0;
894 double mAverageAngleLength = 4;
897 bool mPlaceOnEveryPart = true;
899 bool mRenderingFeature = false;
900 bool mHasRenderedFirstPart = false;
901 QPointF mFinalVertex;
902 bool mCurrentFeatureIsSelected = false;
903 double mFeatureSymbolOpacity = 1;
905 friend class TestQgsMarkerLineSymbol;
946 QString layerType() const override;
950 void toSld( QDomDocument &doc, QDomElement &element, const QVariantMap &props ) const override;
951 void setColor( const QColor &color ) override;
952 QColor color() const override;
955 void setWidth(
double width ) override;
956 double width() const override;
959 void setOutputUnit(
QgsUnitTypes::RenderUnit unit ) override;
960 bool usesMapUnits() const override;
961 QSet<QString> usedAttributes( const
QgsRenderContext &context ) const override;
962 bool hasDataDefinedProperties() const override;
971 Q_DECL_DEPRECATED
bool rotateMarker() const
SIP_DEPRECATED {
return rotateSymbols(); }
985 void setSymbolLineAngle(
double angle )
override;
986 double symbolAngle()
const override;
987 void setSymbolAngle(
double angle )
override;
988 void renderSymbol(
const QPointF &point,
const QgsFeature *feature,
QgsRenderContext &context,
int layer = -1,
bool selected =
false )
override;
1020 double interval = 3 );
1031 QString layerType() const override;
1034 QVariantMap properties() const override;
1036 void setColor( const QColor &color ) override;
1037 QColor color() const override;
1040 void setWidth(
double width ) override;
1041 double width() const override;
1044 void setOutputUnit(
QgsUnitTypes::RenderUnit unit ) override;
1045 QSet<QString> usedAttributes( const
QgsRenderContext &context ) const override;
1046 bool hasDataDefinedProperties() const override;
1048 bool usesMapUnits() const override;
1055 double hashAngle() const;
1062 void setHashAngle(
double angle );
1069 double hashLength()
const {
return mHashLength; }
1112 void setSymbolLineAngle(
double angle )
override;
1113 double symbolAngle()
const override;
1114 void setSymbolAngle(
double angle )
override;
1115 void renderSymbol(
const QPointF &point,
const QgsFeature *feature,
QgsRenderContext &context,
int layer = -1,
bool selected =
false )
override;
1122 std::unique_ptr< QgsLineSymbol > mHashSymbol;
1124 double mSymbolLineAngle = 0;
1125 double mSymbolAngle = 0;
1127 double mHashAngle = 0;
1128 double mHashLength = 3;
1180 void renderPolylineUsingBrush(
const QPolygonF &points,
QgsSymbolRenderContext &context,
const QBrush &brush,
1181 double patternThickness,
double patternLength );
1183 Qt::PenJoinStyle mPenJoinStyle = Qt::PenJoinStyle::RoundJoin;
1184 Qt::PenCapStyle mPenCapStyle = Qt::PenCapStyle::RoundCap;
1187 void renderLine(
const QPolygonF &points,
QgsSymbolRenderContext &context,
const double lineThickness,
const double patternLength,
const QBrush &sourceBrush );
1221 static
void resolvePaths( QVariantMap &properties, const
QgsPathResolver &pathResolver,
bool saving );
1227 QString path()
const {
return mPath; }
1233 void setPath(
const QString &path );
1255 void setOutputUnit(
QgsUnitTypes::RenderUnit unit ) override;
1257 bool usesMapUnits() const override;
1261 QColor color() const override;
1265 double mOpacity = 1.0;
1290 const QColor &color2 = Qt::white );
1300 QString layerType() const override;
1304 QVariantMap properties() const override;
1306 void setOutputUnit(
QgsUnitTypes::RenderUnit unit ) override;
1308 bool usesMapUnits() const override;
1312 QColor color() const override;
1319 Qgis::GradientColorSource gradientColorType()
const {
return mGradientColorType; }
1357 void setColor2(
const QColor &color2 ) { mColor2 = color2; }
The Qgis class provides global constants for use throughout the application.
MarkerLinePlacement
Defines how/where the symbols should be placed on a line.
GradientColorSource
Gradient color sources.
@ SimpleTwoColor
Simple two color gradient.
Base class for line symbol layer types which draws line sections using a QBrush.
void setPenJoinStyle(Qt::PenJoinStyle style)
Sets the pen join style used to render the line (e.g.
Qt::PenCapStyle penCapStyle() const
Returns the pen cap style used to render the line (e.g.
Qt::PenJoinStyle penJoinStyle() const
Returns the pen join style used to render the line (e.g.
void setPenCapStyle(Qt::PenCapStyle style)
Sets the pen cap style used to render the line (e.g.
Abstract base class for color ramps.
Exports QGIS layers to the DXF format.
Class for parsing and evaluation of expressions (formerly called "search strings").
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Line symbol layer type which draws repeating line sections along a line feature.
void setHashLength(double length)
Sets the length of hash symbols.
QgsUnitTypes::RenderUnit hashLengthUnit() const
Returns the units for the length of hash symbols.
const QgsMapUnitScale & hashLengthMapUnitScale() const
Returns the map unit scale for the hash length.
void setHashLengthUnit(QgsUnitTypes::RenderUnit unit)
Sets the unit for the length of hash symbols.
void setHashLengthMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale for the hash length.
~QgsHashedLineSymbolLayer() override
virtual void renderPolygonStroke(const QPolygonF &points, const QVector< QPolygonF > *rings, QgsSymbolRenderContext &context)
Renders the line symbol layer along the outline of polygon, using the given render context.
virtual void renderPolyline(const QPolygonF &points, QgsSymbolRenderContext &context)=0
Renders the line symbol layer along the line joining points, using the given render context.
QgsUnitTypes::RenderUnit outputUnit() const override
Returns the units to use for sizes and widths within the symbol layer.
double offset() const
Returns the line's offset.
A line symbol type, for rendering LineString and MultiLineString geometries.
Line symbol layer type which draws a gradient pattern perpendicularly along a line.
std::unique_ptr< QgsColorRamp > mGradientRamp
QColor color2() const
Returns the color for endpoint of gradient, only used if the gradient color type is set to SimpleTwoC...
~QgsLineburstSymbolLayer() override
void setGradientColorType(Qgis::GradientColorSource gradientColorType)
Sets the gradient color mode, which controls how gradient color stops are created.
void setColor2(const QColor &color2)
Sets the color for endpoint of gradient, only used if the gradient color type is set to SimpleTwoColo...
Struct for storing maximum and minimum scales for measurements in map units.
Line symbol layer type which draws repeating marker symbols along a line feature.
std::unique_ptr< QgsMarkerSymbol > mMarker
~QgsMarkerLineSymbolLayer() override
Q_DECL_DEPRECATED void setRotateMarker(bool rotate)
Shall the marker be rotated.
A marker symbol type, for rendering Point and MultiPoint geometries.
Resolves relative paths into absolute paths and vice versa.
A store for object properties.
Line symbol layer type which draws line sections using a raster image file.
double opacity() const
Returns the line opacity.
void setOpacity(double opacity)
Set the line opacity.
virtual ~QgsRasterLineSymbolLayer()
Contains information about the context of a rendering operation.
A simple line symbol layer, which renders lines using a line in a variety of styles (e....
QgsUnitTypes::RenderUnit dashPatternOffsetUnit() const
Returns the units for the dash pattern offset.
void setDrawInsidePolygon(bool drawInsidePolygon)
Sets whether the line should only be drawn inside polygons, and any portion of the line which falls o...
void setPenCapStyle(Qt::PenCapStyle style)
Sets the pen cap style used to render the line (e.g.
const QgsMapUnitScale & trimDistanceStartMapUnitScale() const
Returns the map unit scale for the trim distance for the start of the line.
Qt::PenJoinStyle penJoinStyle() const
Returns the pen join style used to render the line (e.g.
void setDashPatternOffsetUnit(QgsUnitTypes::RenderUnit unit)
Sets the unit for the dash pattern offset.
QgsUnitTypes::RenderUnit trimDistanceStartUnit() const
Returns the unit for the trim distance for the start of the line.
void setCustomDashPatternMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale for lengths used in the custom dash pattern.
QgsUnitTypes::RenderUnit customDashPatternUnit() const
Returns the units for lengths used in the custom dash pattern.
void setTrimDistanceEndMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale for the trim distance for the end of the line.
QVector< qreal > customDashVector() const
Returns the custom dash vector, which is the pattern of alternating drawn/skipped lengths used while ...
void setTrimDistanceEnd(double distance)
Sets the trim distance for the end of the line, which dictates a length from the end of the line at w...
void setCustomDashPatternUnit(QgsUnitTypes::RenderUnit unit)
Sets the unit for lengths used in the custom dash pattern.
double trimDistanceStart() const
Returns the trim distance for the start of the line, which dictates a length from the start of the li...
~QgsSimpleLineSymbolLayer() override
void setUseCustomDashPattern(bool b)
Sets whether the line uses a custom dash pattern.
double trimDistanceEnd() const
Returns the trim distance for the end of the line, which dictates a length from the end of the line a...
void setCustomDashVector(const QVector< qreal > &vector)
Sets the custom dash vector, which is the pattern of alternating drawn/skipped lengths used while ren...
bool useCustomDashPattern() const
Returns true if the line uses a custom dash pattern.
QgsUnitTypes::RenderUnit trimDistanceEndUnit() const
Returns the unit for the trim distance for the end of the line.
void setDashPatternOffset(double offset)
Sets the dash pattern offset, which dictates how far along the dash pattern the pattern should start ...
const QgsMapUnitScale & dashPatternOffsetMapUnitScale() const
Returns the map unit scale for the dash pattern offset value.
void setDashPatternOffsetMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale for the dash pattern offset.
void setPenStyle(Qt::PenStyle style)
Sets the pen style used to render the line (e.g.
void setPenJoinStyle(Qt::PenJoinStyle style)
Sets the pen join style used to render the line (e.g.
double dashPatternOffset() const
Returns the dash pattern offset, which dictates how far along the dash pattern the pattern should sta...
void setTrimDistanceStartUnit(QgsUnitTypes::RenderUnit unit)
Sets the unit for the trim distance for the start of the line.
void setTrimDistanceStartMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale for the trim distance for the start of the line.
void setTrimDistanceEndUnit(QgsUnitTypes::RenderUnit unit)
Sets the unit for the trim distance for the end of the line.
Qt::PenCapStyle penCapStyle() const
Returns the pen cap style used to render the line (e.g.
const QgsMapUnitScale & trimDistanceEndMapUnitScale() const
Returns the map unit scale for the trim distance for the end of the line.
const QgsMapUnitScale & customDashPatternMapUnitScale() const
Returns the map unit scale for lengths used in the custom dash pattern.
bool drawInsidePolygon() const
Returns true if the line should only be drawn inside polygons, and any portion of the line which fall...
void setTrimDistanceStart(double distance)
Sets the trim distance for the start of the line, which dictates a length from the start of the line ...
Property
Data definable properties.
virtual void startRender(QgsSymbolRenderContext &context)=0
Called before a set of rendering operations commences on the supplied render context.
virtual QgsSymbolLayer * clone() const =0
Shall be reimplemented by subclasses to create a deep copy of the instance.
virtual QVariantMap properties() const =0
Should be reimplemented by subclasses to return a string map that contains the configuration informat...
virtual QString layerType() const =0
Returns a string that represents this layer type.
virtual void stopRender(QgsSymbolRenderContext &context)=0
Called after a set of rendering operations has finished on the supplied render context.
Abstract base class for all rendered symbols.
Base class for templated line symbols, e.g.
bool rotateSymbols() const
Returns true if the repeating symbols be rotated to match their line segment orientation.
bool placeOnEveryPart() const
Returns true if the placement applies for every part of multi-part feature geometries.
double averageAngleLength() const
Returns the length of line over which the line's direction is averaged when calculating individual sy...
const QgsMapUnitScale & intervalMapUnitScale() const
Returns the map unit scale for the interval between symbols.
void setRotateSymbols(bool rotate)
Sets whether the repeating symbols should be rotated to match their line segment orientation.
const QgsMapUnitScale & averageAngleMapUnitScale() const
Returns the map unit scale for the length over which the line's direction is averaged when calculatin...
double interval() const
Returns the interval between individual symbols.
void setAverageAngleMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale for the length over which the line's direction is averaged when calculating i...
double offsetAlongLine() const
Returns the offset along the line for the symbol placement.
~QgsTemplatedLineSymbolLayerBase() override
void setOffsetAlongLine(double offsetAlongLine)
Sets the the offset along the line for the symbol placement.
void setOffsetAlongLineUnit(QgsUnitTypes::RenderUnit unit)
Sets the unit used for calculating the offset along line for symbols.
void setInterval(double interval)
Sets the interval between individual symbols.
const QgsMapUnitScale & offsetAlongLineMapUnitScale() const
Returns the map unit scale used for calculating the offset in map units along line for symbols.
QgsUnitTypes::RenderUnit averageAngleUnit() const
Returns the unit for the length over which the line's direction is averaged when calculating individu...
void setPlaceOnEveryPart(bool respect)
Sets whether the placement applies for every part of multi-part feature geometries.
QgsUnitTypes::RenderUnit offsetAlongLineUnit() const
Returns the unit used for calculating the offset along line for symbols.
void setPlacements(Qgis::MarkerLinePlacements placements)
Sets the placement of the symbols.
QgsUnitTypes::RenderUnit intervalUnit() const
Returns the units for the interval between symbols.
void setAverageAngleUnit(QgsUnitTypes::RenderUnit unit)
Sets the unit for the length over which the line's direction is averaged when calculating individual ...
void setIntervalUnit(QgsUnitTypes::RenderUnit unit)
Sets the units for the interval between symbols.
void setIntervalMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale for the interval between symbols.
void setOffsetAlongLineMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale used for calculating the offset in map units along line for symbols.
void setAverageAngleLength(double length)
Sets the length of line over which the line's direction is averaged when calculating individual symbo...
Helper functions for various unit types.
RenderUnit
Rendering size units.
@ RenderMillimeters
Millimeters.
double ANALYSIS_EXPORT angle(QgsPoint *p1, QgsPoint *p2, QgsPoint *p3, QgsPoint *p4)
Calculates the angle between two segments (in 2 dimension, z-values are ignored)
#define DEFAULT_MARKERLINE_INTERVAL
#define DEFAULT_SIMPLELINE_WIDTH
#define DEFAULT_MARKERLINE_ROTATE
#define DEFAULT_SIMPLELINE_PENSTYLE
#define DEFAULT_SIMPLELINE_JOINSTYLE
#define DEFAULT_SIMPLELINE_COLOR
#define DEFAULT_SIMPLELINE_CAPSTYLE