QGIS API Documentation
3.8.0-Zanzibar (11aff65)
|
Base class for templated line symbols, e.g. More...
#include <qgslinesymbollayer.h>
Public Member Functions | |
QgsTemplatedLineSymbolLayerBase (bool rotateSymbol=true, double interval=3) | |
Constructor for QgsTemplatedLineSymbolLayerBase. More... | |
double | averageAngleLength () const |
Returns the length of line over which the line's direction is averaged when calculating individual symbol angles. More... | |
const QgsMapUnitScale & | averageAngleMapUnitScale () const |
Returns the map unit scale for the length over which the line's direction is averaged when calculating individual symbol angles. More... | |
QgsUnitTypes::RenderUnit | averageAngleUnit () const |
Returns the unit for the length over which the line's direction is averaged when calculating individual symbol angles. More... | |
double | interval () const |
Returns the interval between individual symbols. More... | |
const QgsMapUnitScale & | intervalMapUnitScale () const |
Returns the map unit scale for the interval between symbols. More... | |
QgsUnitTypes::RenderUnit | intervalUnit () const |
Returns the units for the interval between symbols. More... | |
QgsMapUnitScale | mapUnitScale () const FINAL |
double | offsetAlongLine () const |
Returns the offset along the line for the symbol placement. More... | |
const QgsMapUnitScale & | offsetAlongLineMapUnitScale () const |
Returns the map unit scale used for calculating the offset in map units along line for symbols. More... | |
QgsUnitTypes::RenderUnit | offsetAlongLineUnit () const |
Returns the unit used for calculating the offset along line for symbols. More... | |
QgsUnitTypes::RenderUnit | outputUnit () const FINAL |
Returns the units to use for sizes and widths within the symbol layer. More... | |
Placement | placement () const |
Returns the placement of the symbols. More... | |
QgsStringMap | properties () const override |
Should be reimplemented by subclasses to return a string map that contains the configuration information for the symbol layer. More... | |
void | renderPolygonStroke (const QPolygonF &points, QList< QPolygonF > *rings, QgsSymbolRenderContext &context) FINAL |
Renders the line symbol layer along the outline of polygon, using the given render context. More... | |
void | renderPolyline (const QPolygonF &points, QgsSymbolRenderContext &context) FINAL |
Renders the line symbol layer along the line joining points, using the given render context. More... | |
bool | rotateSymbols () const |
Returns true if the repeating symbols be rotated to match their line segment orientation. More... | |
void | setAverageAngleLength (double length) |
Sets the length of line over which the line's direction is averaged when calculating individual symbol angles. More... | |
void | setAverageAngleMapUnitScale (const QgsMapUnitScale &scale) |
Sets the map unit scale for the length over which the line's direction is averaged when calculating individual symbol angles. More... | |
void | setAverageAngleUnit (QgsUnitTypes::RenderUnit unit) |
Sets the unit for the length over which the line's direction is averaged when calculating individual symbol angles. More... | |
void | setInterval (double interval) |
Sets the interval between individual symbols. More... | |
void | setIntervalMapUnitScale (const QgsMapUnitScale &scale) |
Sets the map unit scale for the interval between symbols. More... | |
void | setIntervalUnit (QgsUnitTypes::RenderUnit unit) |
Sets the units for the interval between symbols. More... | |
void | setMapUnitScale (const QgsMapUnitScale &scale) FINAL |
void | setOffsetAlongLine (double offsetAlongLine) |
Sets the the offset along the line for the symbol placement. More... | |
void | setOffsetAlongLineMapUnitScale (const QgsMapUnitScale &scale) |
Sets the map unit scale used for calculating the offset in map units along line for symbols. More... | |
void | setOffsetAlongLineUnit (QgsUnitTypes::RenderUnit unit) |
Sets the unit used for calculating the offset along line for symbols. More... | |
void | setPlacement (Placement placement) |
Sets the placement of the symbols. More... | |
void | setRotateSymbols (bool rotate) |
Sets whether the repeating symbols should be rotated to match their line segment orientation. More... | |
Public Member Functions inherited from QgsLineSymbolLayer | |
void | drawPreviewIcon (QgsSymbolRenderContext &context, QSize size) override |
double | dxfWidth (const QgsDxfExport &e, QgsSymbolRenderContext &context) const override |
Gets line width. More... | |
QgsMapUnitScale | mapUnitScale () const override |
double | offset () const |
Returns the line's offset. More... | |
const QgsMapUnitScale & | offsetMapUnitScale () const |
Returns the map unit scale for the line's offset. More... | |
QgsUnitTypes::RenderUnit | offsetUnit () const |
Returns the units for the line's offset. More... | |
QgsUnitTypes::RenderUnit | outputUnit () const override |
Returns the units to use for sizes and widths within the symbol layer. More... | |
RenderRingFilter | ringFilter () const |
Returns the line symbol layer's ring filter, which controls which rings are rendered when the line symbol is being used to draw a polygon's rings. More... | |
void | setMapUnitScale (const QgsMapUnitScale &scale) override |
void | setOffset (double offset) |
Sets the line's offset. More... | |
void | setOffsetMapUnitScale (const QgsMapUnitScale &scale) |
Sets the map unit scale for the line's offset. More... | |
void | setOffsetUnit (QgsUnitTypes::RenderUnit unit) |
Sets the unit for the line's offset. More... | |
void | setOutputUnit (QgsUnitTypes::RenderUnit unit) override |
Sets the units to use for sizes and widths within the symbol layer. More... | |
void | setRingFilter (QgsLineSymbolLayer::RenderRingFilter filter) |
Sets the line symbol layer's ring filter, which controls which rings are rendered when the line symbol is being used to draw a polygon's rings. More... | |
virtual void | setWidth (double width) |
Sets the width of the line symbol layer. More... | |
void | setWidthMapUnitScale (const QgsMapUnitScale &scale) |
void | setWidthUnit (QgsUnitTypes::RenderUnit unit) |
Sets the units for the line's width. More... | |
virtual double | width () const |
Returns the estimated width for the line symbol layer. More... | |
virtual double | width (const QgsRenderContext &context) const |
Returns the line symbol layer width, in painter units. More... | |
const QgsMapUnitScale & | widthMapUnitScale () const |
QgsUnitTypes::RenderUnit | widthUnit () const |
Returns the units for the line's width. More... | |
Public Member Functions inherited from QgsSymbolLayer | |
virtual | ~QgsSymbolLayer () |
virtual QgsSymbolLayer * | clone () const =0 |
Shall be reimplemented by subclasses to create a deep copy of the instance. More... | |
virtual QColor | color () const |
The fill color. More... | |
QgsPropertyCollection & | dataDefinedProperties () |
Returns a reference to the symbol layer's property collection, used for data defined overrides. More... | |
const QgsPropertyCollection & | dataDefinedProperties () const |
Returns a reference to the symbol layer's property collection, used for data defined overrides. More... | |
virtual double | dxfAngle (QgsSymbolRenderContext &context) const |
Gets angle. More... | |
virtual QColor | dxfBrushColor (QgsSymbolRenderContext &context) const |
Gets brush/fill color. More... | |
virtual Qt::BrushStyle | dxfBrushStyle () const |
Gets brush/fill style. More... | |
virtual QColor | dxfColor (QgsSymbolRenderContext &context) const |
Gets color. More... | |
virtual QVector< qreal > | dxfCustomDashPattern (QgsUnitTypes::RenderUnit &unit) const |
Gets dash pattern. More... | |
virtual double | dxfOffset (const QgsDxfExport &e, QgsSymbolRenderContext &context) const |
Gets offset. More... | |
virtual Qt::PenStyle | dxfPenStyle () const |
Gets pen style. More... | |
bool | enabled () const |
Returns true if symbol layer is enabled and will be drawn. More... | |
virtual double | estimateMaxBleed (const QgsRenderContext &context) const |
Returns the estimated maximum distance which the layer style will bleed outside the drawn shape when drawn in the specified /a context. More... | |
virtual QColor | fillColor () const |
Gets fill color. More... | |
virtual bool | hasDataDefinedProperties () const |
Returns true if the symbol layer (or any of its sub-symbols) contains data defined properties. More... | |
virtual bool | isCompatibleWithSymbol (QgsSymbol *symbol) const |
Returns if the layer can be used below the specified symbol. More... | |
bool | isLocked () const |
virtual QString | layerType () const =0 |
Returns a string that represents this layer type. More... | |
virtual QString | ogrFeatureStyle (double mmScaleFactor, double mapUnitScaleFactor) const |
QgsPaintEffect * | paintEffect () const |
Returns the current paint effect for the layer. More... | |
virtual void | prepareExpressions (const QgsSymbolRenderContext &context) |
Prepares all data defined property expressions for evaluation. More... | |
int | renderingPass () const |
Specifies the rendering pass in which this symbol layer should be rendered. More... | |
virtual void | setColor (const QColor &color) |
The fill color. More... | |
void | setDataDefinedProperties (const QgsPropertyCollection &collection) |
Sets the symbol layer's property collection, used for data defined overrides. More... | |
virtual void | setDataDefinedProperty (Property key, const QgsProperty &property) |
Sets a data defined property for the layer. More... | |
void | setEnabled (bool enabled) |
Sets whether symbol layer is enabled and should be drawn. More... | |
virtual void | setFillColor (const QColor &color) |
Set fill color. More... | |
void | setLocked (bool locked) |
void | setPaintEffect (QgsPaintEffect *effect) |
Sets the current paint effect for the layer. More... | |
void | setRenderingPass (int renderingPass) |
Specifies the rendering pass in which this symbol layer should be rendered. More... | |
virtual void | setStrokeColor (const QColor &color) |
Set stroke color. More... | |
virtual bool | setSubSymbol (QgsSymbol *symbol) |
Sets layer's subsymbol. takes ownership of the passed symbol. More... | |
virtual void | startRender (QgsSymbolRenderContext &context)=0 |
virtual void | stopRender (QgsSymbolRenderContext &context)=0 |
virtual QColor | strokeColor () const |
Gets stroke color. More... | |
virtual QgsSymbol * | subSymbol () |
Returns the symbol's sub symbol, if present. More... | |
virtual void | toSld (QDomDocument &doc, QDomElement &element, const QgsStringMap &props) const |
QgsSymbol::SymbolType | type () const |
virtual QSet< QString > | usedAttributes (const QgsRenderContext &context) const |
Returns the set of attributes referenced by the layer. More... | |
virtual bool | writeDxf (QgsDxfExport &e, double mmMapUnitScaleFactor, const QString &layerName, QgsSymbolRenderContext &context, QPointF shift=QPointF(0.0, 0.0)) const |
write as DXF More... | |
Protected Member Functions | |
void | copyTemplateSymbolProperties (QgsTemplatedLineSymbolLayerBase *destLayer) const |
Copies all common properties of this layer to another templated symbol layer. More... | |
virtual void | renderSymbol (const QPointF &point, const QgsFeature *feature, QgsRenderContext &context, int layer=-1, bool selected=false)=0 |
Renders the templated symbol at the specified point, using the given render context. More... | |
virtual void | setSymbolAngle (double angle)=0 |
Sets the symbol's angle, in degrees clockwise. More... | |
virtual void | setSymbolLineAngle (double angle)=0 |
Sets the line angle modification for the symbol's angle. More... | |
virtual double | symbolAngle () const =0 |
Returns the symbol's current angle, in degrees clockwise. More... | |
Protected Member Functions inherited from QgsLineSymbolLayer | |
QgsLineSymbolLayer (bool locked=false) | |
Protected Member Functions inherited from QgsSymbolLayer | |
QgsSymbolLayer (QgsSymbol::SymbolType type, bool locked=false) | |
void | copyDataDefinedProperties (QgsSymbolLayer *destLayer) const |
Copies all data defined properties of this layer to another symbol layer. More... | |
void | copyPaintEffect (QgsSymbolLayer *destLayer) const |
Copies paint effect of this layer to another symbol layer. More... | |
void | restoreOldDataDefinedProperties (const QgsStringMap &stringMap) |
Restores older data defined properties from string map. More... | |
Static Protected Member Functions | |
static void | setCommonProperties (QgsTemplatedLineSymbolLayerBase *destLayer, const QgsStringMap &properties) |
Sets all common symbol properties in the destLayer, using the settings serialized in the properties map. More... | |
Friends | |
class | TestQgsMarkerLineSymbol |
Additional Inherited Members | |
Static Public Member Functions inherited from QgsSymbolLayer | |
static const QgsPropertiesDefinition & | propertyDefinitions () |
Returns the symbol layer property definitions. More... | |
Protected Attributes inherited from QgsLineSymbolLayer | |
double | mOffset = 0 |
QgsMapUnitScale | mOffsetMapUnitScale |
QgsUnitTypes::RenderUnit | mOffsetUnit = QgsUnitTypes::RenderMillimeters |
RenderRingFilter | mRingFilter = AllRings |
double | mWidth = 0 |
QgsMapUnitScale | mWidthMapUnitScale |
QgsUnitTypes::RenderUnit | mWidthUnit = QgsUnitTypes::RenderMillimeters |
Protected Attributes inherited from QgsSymbolLayer | |
QColor | mColor |
QgsPropertyCollection | mDataDefinedProperties |
bool | mEnabled |
True if layer is enabled and should be drawn. More... | |
QgsFields | mFields |
bool | mLocked |
QgsPaintEffect * | mPaintEffect = nullptr |
int | mRenderingPass = 0 |
QgsSymbol::SymbolType | mType |
Static Protected Attributes inherited from QgsSymbolLayer | |
static const bool | SELECT_FILL_BORDER = false |
Whether fill styles for selected features also highlight symbol stroke. More... | |
static const bool | SELECT_FILL_STYLE = false |
Whether fill styles for selected features uses symbol layer style. More... | |
static const bool | SELECTION_IS_OPAQUE = true |
Whether styles for selected features ignore symbol alpha. More... | |
Base class for templated line symbols, e.g.
line symbols which draw markers or hash lines at intervals along the line feature.
Definition at line 254 of file qgslinesymbollayer.h.
Defines how/where the templated symbol should be placed on the line.
Definition at line 261 of file qgslinesymbollayer.h.
QgsTemplatedLineSymbolLayerBase::QgsTemplatedLineSymbolLayerBase | ( | bool | rotateSymbol = true , |
double | interval = 3 |
||
) |
Constructor for QgsTemplatedLineSymbolLayerBase.
Creates a template line placed at the specified interval (in millimeters).
The rotateSymbol argument specifies whether individual symbols should be rotated to match the line segment alignment.
Definition at line 744 of file qgslinesymbollayer.cpp.
|
inline |
Returns the length of line over which the line's direction is averaged when calculating individual symbol angles.
Longer lengths smooth out angles from jagged lines to a greater extent.
Units are retrieved through averageAngleUnit()
Definition at line 414 of file qgslinesymbollayer.h.
|
inline |
Returns the map unit scale for the length over which the line's direction is averaged when calculating individual symbol angles.
Definition at line 466 of file qgslinesymbollayer.h.
|
inline |
Returns the unit for the length over which the line's direction is averaged when calculating individual symbol angles.
Definition at line 446 of file qgslinesymbollayer.h.
|
protected |
Copies all common properties of this layer to another templated symbol layer.
Definition at line 979 of file qgslinesymbollayer.cpp.
|
inline |
Returns the interval between individual symbols.
Units are specified through intervalUnits().
Definition at line 298 of file qgslinesymbollayer.h.
|
inline |
Returns the map unit scale for the interval between symbols.
Definition at line 337 of file qgslinesymbollayer.h.
|
inline |
Returns the units for the interval between symbols.
Definition at line 321 of file qgslinesymbollayer.h.
|
virtual |
Reimplemented from QgsSymbolLayer.
Definition at line 925 of file qgslinesymbollayer.cpp.
|
inline |
Returns the offset along the line for the symbol placement.
For Interval placements, this is the distance between the start of the line and the first symbol. For FirstVertex and LastVertex placements, this is the distance between the symbol and the start of the line or the end of the line respectively. This setting has no effect for Vertex or CentralPoint placements.
Definition at line 361 of file qgslinesymbollayer.h.
|
inline |
Returns the map unit scale used for calculating the offset in map units along line for symbols.
Definition at line 396 of file qgslinesymbollayer.h.
|
inline |
Returns the unit used for calculating the offset along line for symbols.
Definition at line 382 of file qgslinesymbollayer.h.
|
virtual |
Returns the units to use for sizes and widths within the symbol layer.
Individual symbol layer subclasses will interpret this in different ways, e.g., a marker symbol layer may use it to specify the units for the marker size, while a line symbol layer may use it to specify the units for the line width.
Reimplemented from QgsSymbolLayer.
Definition at line 907 of file qgslinesymbollayer.cpp.
|
inline |
Returns the placement of the symbols.
Definition at line 343 of file qgslinesymbollayer.h.
|
overridevirtual |
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.
Implements QgsSymbolLayer.
Reimplemented in QgsHashedLineSymbolLayer.
Definition at line 936 of file qgslinesymbollayer.cpp.
|
virtual |
Renders the line symbol layer along the outline of polygon, using the given render context.
The exterior ring of the polygon is specified in points. Optionally, interior rings are set via the rings argument.
Reimplemented from QgsLineSymbolLayer.
Definition at line 863 of file qgslinesymbollayer.cpp.
|
virtual |
Renders the line symbol layer along the line joining points, using the given render context.
Implements QgsLineSymbolLayer.
Definition at line 751 of file qgslinesymbollayer.cpp.
|
protectedpure virtual |
Renders the templated symbol at the specified point, using the given render context.
The feature argument is used to pass the feature currently being rendered (when available).
If only a single symbol layer from the symbol should be rendered, it should be specified in the layer argument. A layer of -1 indicates that all symbol layers should be rendered.
If selected is true then the symbol will be drawn using the "selected feature" style and colors instead of the symbol's normal style.
Implemented in QgsHashedLineSymbolLayer, and QgsMarkerLineSymbolLayer.
|
inline |
Returns true
if the repeating symbols be rotated to match their line segment orientation.
Definition at line 285 of file qgslinesymbollayer.h.
|
inline |
Sets the length of line over which the line's direction is averaged when calculating individual symbol angles.
Longer lengths smooth out angles from jagged lines to a greater extent.
Units are set through setAverageAngleUnit()
Definition at line 426 of file qgslinesymbollayer.h.
|
inline |
Sets the map unit scale for the length over which the line's direction is averaged when calculating individual symbol angles.
Definition at line 456 of file qgslinesymbollayer.h.
|
inline |
Sets the unit for the length over which the line's direction is averaged when calculating individual symbol angles.
Definition at line 436 of file qgslinesymbollayer.h.
|
staticprotected |
Sets all common symbol properties in the destLayer, using the settings serialized in the properties map.
Definition at line 999 of file qgslinesymbollayer.cpp.
|
inline |
Sets the interval between individual symbols.
interval | interval size. Units are specified through setIntervalUnit() |
Definition at line 306 of file qgslinesymbollayer.h.
|
inline |
Sets the map unit scale for the interval between symbols.
Definition at line 329 of file qgslinesymbollayer.h.
|
inline |
Sets the units for the interval between symbols.
unit | interval units |
Definition at line 314 of file qgslinesymbollayer.h.
|
virtual |
Reimplemented from QgsSymbolLayer.
Definition at line 917 of file qgslinesymbollayer.cpp.
|
inline |
Sets the the offset along the line for the symbol placement.
For Interval placements, this is the distance between the start of the line and the first symbol. For FirstVertex and LastVertex placements, this is the distance between the symbol and the start of the line or the end of the line respectively. This setting has no effect for Vertex or CentralPoint placements.
offsetAlongLine | Distance to offset markers along the line. The offset unit is set via setOffsetAlongLineUnit. |
Definition at line 374 of file qgslinesymbollayer.h.
|
inline |
Sets the map unit scale used for calculating the offset in map units along line for symbols.
Definition at line 402 of file qgslinesymbollayer.h.
|
inline |
Sets the unit used for calculating the offset along line for symbols.
unit | Offset along line unit type. |
Definition at line 390 of file qgslinesymbollayer.h.
|
inline |
Sets the placement of the symbols.
Definition at line 349 of file qgslinesymbollayer.h.
|
inline |
Sets whether the repeating symbols should be rotated to match their line segment orientation.
Definition at line 291 of file qgslinesymbollayer.h.
|
protectedpure virtual |
Sets the symbol's angle, in degrees clockwise.
Implemented in QgsHashedLineSymbolLayer, and QgsMarkerLineSymbolLayer.
|
protectedpure virtual |
Sets the line angle modification for the symbol's angle.
This angle is added to the symbol's rotation and data defined rotation before rendering the symbol, and is used for orienting symbols to match the line's angle.
angle | Angle in degrees, valid values are between 0 and 360 |
Implemented in QgsHashedLineSymbolLayer, and QgsMarkerLineSymbolLayer.
|
protectedpure virtual |
Returns the symbol's current angle, in degrees clockwise.
Implemented in QgsHashedLineSymbolLayer, and QgsMarkerLineSymbolLayer.
|
friend |
Definition at line 557 of file qgslinesymbollayer.h.