Abstract base class for marker symbol layers. More...

#include <qgssymbollayer.h>

Inheritance diagram for QgsMarkerSymbolLayer:

[legend]

Public Types
enum	HorizontalAnchorPoint { Left , HCenter , Right }
	Symbol horizontal anchor points. More...

enum	VerticalAnchorPoint { Top , VCenter , Bottom }
	Symbol vertical anchor points. More...

Public Types inherited from QgsSymbolLayer
enum	Property { PropertySize = 0 , PropertyAngle , PropertyName , PropertyFillColor , PropertyStrokeColor , PropertyStrokeWidth , PropertyStrokeStyle , PropertyOffset , PropertyCharacter , PropertyWidth , PropertyHeight , PropertyPreserveAspectRatio , PropertyFillStyle , PropertyJoinStyle , PropertySecondaryColor , PropertyLineAngle , PropertyLineDistance , PropertyGradientType , PropertyCoordinateMode , PropertyGradientSpread , PropertyGradientReference1X , PropertyGradientReference1Y , PropertyGradientReference2X , PropertyGradientReference2Y , PropertyGradientReference1IsCentroid , PropertyGradientReference2IsCentroid , PropertyBlurRadius , PropertyShapeburstUseWholeShape , PropertyShapeburstMaxDistance , PropertyShapeburstIgnoreRings , PropertyFile , PropertyDistanceX , PropertyDistanceY , PropertyDisplacementX , PropertyDisplacementY , PropertyOpacity , PropertyCustomDash , PropertyCapStyle , PropertyPlacement , PropertyInterval , PropertyOffsetAlongLine , PropertyAverageAngleLength , PropertyHorizontalAnchor , PropertyVerticalAnchor , PropertyLayerEnabled , PropertyArrowWidth , PropertyArrowStartWidth , PropertyArrowHeadLength , PropertyArrowHeadThickness , PropertyArrowHeadType , PropertyArrowType , PropertyOffsetX , PropertyOffsetY , PropertyPointCount , PropertyRandomSeed , PropertyClipPoints , PropertyDensityArea , PropertyFontFamily , PropertyFontStyle , PropertyDashPatternOffset , PropertyTrimStart , PropertyTrimEnd , PropertyLineStartWidthValue , PropertyLineEndWidthValue , PropertyLineStartColorValue , PropertyLineEndColorValue , PropertyMarkerClipping , PropertyRandomOffsetX , PropertyRandomOffsetY , PropertyLineClipping }
	Data definable properties. More...

Public Member Functions
	QgsMarkerSymbolLayer (const QgsMarkerSymbolLayer &other)=delete
	QgsMarkerSymbolLayer cannot be copied. More...

double	angle () const
	Returns the rotation angle for the marker, in degrees clockwise from north. More...

virtual QRectF	bounds (QPointF point, QgsSymbolRenderContext &context)=0
	Returns the approximate bounding box of the marker symbol layer, taking into account any data defined overrides and offsets which are set for the marker layer. More...

void	drawPreviewIcon (QgsSymbolRenderContext &context, QSize size) override

virtual double	dxfAngle (QgsSymbolRenderContext &context) const override
	Gets angle. More...

virtual double	dxfSize (const QgsDxfExport &e, QgsSymbolRenderContext &context) const override
	Gets marker size. More...

HorizontalAnchorPoint	horizontalAnchorPoint () const
	Returns the horizontal anchor point for positioning the symbol. More...

QgsMapUnitScale	mapUnitScale () const override

QPointF	offset () const
	Returns the marker's offset, which is the horizontal and vertical displacement which the rendered marker will have from the original feature's geometry. More...

const QgsMapUnitScale &	offsetMapUnitScale () const
	Returns the map unit scale for the symbol's offset. More...

Qgis::RenderUnit	offsetUnit () const
	Returns the units for the symbol's offset. More...

QgsMarkerSymbolLayer &	operator= (const QgsMarkerSymbolLayer &other)=delete
	QgsMarkerSymbolLayer cannot be copied. More...

Qgis::RenderUnit	outputUnit () const override
	Returns the units to use for sizes and widths within the symbol layer. More...

virtual void	renderPoint (QPointF point, QgsSymbolRenderContext &context)=0
	Renders a marker at the specified point. More...

Qgis::ScaleMethod	scaleMethod () const
	Returns the method to use for scaling the marker's size. More...

void	setAngle (double angle)
	Sets the rotation angle for the marker. More...

void	setHorizontalAnchorPoint (HorizontalAnchorPoint h)
	Sets the horizontal anchor point for positioning the symbol. More...

void	setLineAngle (double lineAngle)
	Sets the line angle modification for the symbol's angle. More...

void	setMapUnitScale (const QgsMapUnitScale &scale) override

void	setOffset (QPointF offset)
	Sets the marker's offset, which is the horizontal and vertical displacement which the rendered marker should have from the original feature's geometry. More...

void	setOffsetMapUnitScale (const QgsMapUnitScale &scale)
	Sets the map unit scale for the symbol's offset. More...

void	setOffsetUnit (Qgis::RenderUnit unit)
	Sets the units for the symbol's offset. More...

void	setOutputUnit (Qgis::RenderUnit unit) override
	Sets the units to use for sizes and widths within the symbol layer. More...

void	setScaleMethod (Qgis::ScaleMethod scaleMethod)
	Sets the method to use for scaling the marker's size. More...

virtual void	setSize (double size)
	Sets the symbol size. More...

void	setSizeMapUnitScale (const QgsMapUnitScale &scale)
	Sets the map unit scale for the symbol's size. More...

void	setSizeUnit (Qgis::RenderUnit unit)
	Sets the units for the symbol's size. More...

void	setVerticalAnchorPoint (VerticalAnchorPoint v)
	Sets the vertical anchor point for positioning the symbol. More...

double	size () const
	Returns the symbol size. More...

const QgsMapUnitScale &	sizeMapUnitScale () const
	Returns the map unit scale for the symbol's size. More...

Qgis::RenderUnit	sizeUnit () const
	Returns the units for the symbol's size. More...

void	startRender (QgsSymbolRenderContext &context) override
	Called before a set of rendering operations commences on the supplied render context. More...

void	stopRender (QgsSymbolRenderContext &context) override
	Called after a set of rendering operations has finished on the supplied render context. More...

void	toSld (QDomDocument &doc, QDomElement &element, const QVariantMap &props) const override
	Saves the symbol layer as SLD. More...

VerticalAnchorPoint	verticalAnchorPoint () const
	Returns the vertical anchor point for positioning the symbol. More...

virtual void	writeSldMarker (QDomDocument &doc, QDomElement &element, const QVariantMap &props) const
	Writes the symbol layer definition as a SLD XML element. More...

Public Member Functions inherited from QgsSymbolLayer
	QgsSymbolLayer (const QgsSymbolLayer &other)=delete
	QgsSymbolLayer cannot be copied. More...

virtual	~QgsSymbolLayer ()

virtual bool	canCauseArtifactsBetweenAdjacentTiles () const
	Returns `true` if the symbol layer rendering can cause visible artifacts across a single feature when the feature is rendered as a series of adjacent map tiles each containing a portion of the feature's geometry. More...

virtual QgsSymbolLayer *	clone () const =0
	Shall be reimplemented by subclasses to create a deep copy of the instance. More...

virtual QColor	color () const
	Returns the "representative" color of the symbol layer. 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 void	drawPreviewIcon (QgsSymbolRenderContext &context, QSize size)=0

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 (Qgis::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...

virtual double	dxfSize (const QgsDxfExport &e, QgsSymbolRenderContext &context) const
	Gets marker size. More...

virtual double	dxfWidth (const QgsDxfExport &e, QgsSymbolRenderContext &context) const
	Gets line width. 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
	Returns the fill color for the symbol layer. More...

virtual Qgis::SymbolLayerFlags	flags () const
	Returns flags which control the symbol layer's behavior. More...

virtual bool	hasDataDefinedProperties () const
	Returns `true` if the symbol layer (or any of its sub-symbols) contains data defined properties. More...

QString	id () const
	Returns symbol layer identifier This id is unique in the whole project. More...

virtual bool	isCompatibleWithSymbol (QgsSymbol *symbol) const
	Returns if the layer can be used below the specified symbol. More...

bool	isLocked () const
	Returns `true` if the symbol layer colors are locked and the layer will ignore any symbol-level color changes. More...

virtual QString	layerType () const =0
	Returns a string that represents this layer type. More...

virtual QgsMapUnitScale	mapUnitScale () const

virtual QList< QgsSymbolLayerReference >	masks () const
	Returns masks defined by this symbol layer. More...

virtual QString	ogrFeatureStyle (double mmScaleFactor, double mapUnitScaleFactor) const

QgsSymbolLayer &	operator= (const QgsSymbolLayer &other)=delete
	QgsSymbolLayer cannot be copied. More...

virtual Qgis::RenderUnit	outputUnit () const
	Returns the units to use for sizes and widths within the symbol layer. More...

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...

virtual void	prepareMasks (const QgsSymbolRenderContext &context)
	Prepares all mask internal objects according to what is defined in context This should be called prior to calling startRender() method. More...

virtual QVariantMap	properties () const =0
	Should be reimplemented by subclasses to return a string map that contains the configuration information for the symbol layer. More...

int	renderingPass () const
	Specifies the rendering pass in which this symbol layer should be rendered. More...

virtual void	setColor (const QColor &color)
	Sets the "representative" color for the symbol layer. 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)
	Sets the fill color for the symbol layer. More...

void	setId (const QString &id)
	Set symbol layer identifier This id has to be unique in the whole project. More...

void	setLocked (bool locked)
	Sets whether the layer's colors are locked. More...

virtual void	setMapUnitScale (const QgsMapUnitScale &scale)

virtual void	setOutputUnit (Qgis::RenderUnit unit)
	Sets the units to use for sizes and widths within the symbol layer. More...

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)
	Sets the stroke color for the symbol layer. More...

virtual bool	setSubSymbol (QgsSymbol *symbol)
	Sets layer's subsymbol. takes ownership of the passed symbol. More...

virtual void	startFeatureRender (const QgsFeature &feature, QgsRenderContext &context)
	Called before the layer will be rendered for a particular feature. More...

virtual void	startRender (QgsSymbolRenderContext &context)=0
	Called before a set of rendering operations commences on the supplied render context. More...

virtual void	stopFeatureRender (const QgsFeature &feature, QgsRenderContext &context)
	Called after the layer has been rendered for a particular feature. More...

virtual void	stopRender (QgsSymbolRenderContext &context)=0
	Called after a set of rendering operations has finished on the supplied render context. More...

virtual QColor	strokeColor () const
	Returns the stroke color for the symbol layer. More...

virtual QgsSymbol *	subSymbol ()
	Returns the symbol's sub symbol, if present. More...

virtual void	toSld (QDomDocument &doc, QDomElement &element, const QVariantMap &props) const
	Saves the symbol layer as SLD. More...

Qgis::SymbolType	type () const

virtual QSet< QString >	usedAttributes (const QgsRenderContext &context) const
	Returns the set of attributes referenced by the layer. More...

virtual bool	usesMapUnits () const
	Returns `true` if the symbol layer has any components which use map unit based sizes. 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
	QgsMarkerSymbolLayer (bool locked=false)
	Constructor for QgsMarkerSymbolLayer. More...

void	markerOffset (QgsSymbolRenderContext &context, double &offsetX, double &offsetY) const
	Calculates the required marker offset, including both the symbol offset and any displacement required to align with the marker's anchor point. More...

void	markerOffset (QgsSymbolRenderContext &context, double width, double height, double &offsetX, double &offsetY) const
	Calculates the required marker offset, including both the symbol offset and any displacement required to align with the marker's anchor point. More...

void	markerOffset (QgsSymbolRenderContext &context, double width, double height, Qgis::RenderUnit widthUnit, Qgis::RenderUnit heightUnit, double &offsetX, double &offsetY, const QgsMapUnitScale &widthMapUnitScale, const QgsMapUnitScale &heightMapUnitScale) const

Protected Member Functions inherited from QgsSymbolLayer
	QgsSymbolLayer (Qgis::SymbolType type, bool locked=false)
	Constructor for QgsSymbolLayer. More...

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	installMasks (QgsRenderContext &context, bool recursive)
	When rendering, install masks on context painter if recursive is `true` masks are installed recursively for all children symbol layers. More...

void	removeMasks (QgsRenderContext &context, bool recursive)
	When rendering, remove previously installed masks from context painter if recursive is `true` masks are removed recursively for all children symbol layers. More...

void	restoreOldDataDefinedProperties (const QVariantMap &stringMap)
	Restores older data defined properties from string map. More...

Static Protected Member Functions
static QPointF	_rotatedOffset (QPointF offset, double angle)
	Adjusts a marker offset to account for rotation. More...

Protected Attributes
double	mAngle = 0
	Marker rotation angle, in degrees clockwise from north. More...

HorizontalAnchorPoint	mHorizontalAnchorPoint = HCenter
	Horizontal anchor point. More...

double	mLineAngle = 0
	Line rotation angle (see setLineAngle() for details) More...

QPointF	mOffset
	Marker offset. More...

QgsMapUnitScale	mOffsetMapUnitScale
	Offset map unit scale. More...

Qgis::RenderUnit	mOffsetUnit = Qgis::RenderUnit::Millimeters
	Offset units. More...

Qgis::ScaleMethod	mScaleMethod = Qgis::ScaleMethod::ScaleDiameter
	Marker size scaling method. More...

double	mSize = 2.0
	Marker size. More...

QgsMapUnitScale	mSizeMapUnitScale
	Marker size map unit scale. More...

Qgis::RenderUnit	mSizeUnit = Qgis::RenderUnit::Millimeters
	Marker size unit. More...

VerticalAnchorPoint	mVerticalAnchorPoint = VCenter
	Vertical anchor point. More...

Protected Attributes inherited from QgsSymbolLayer
QPainterPath	mClipPath

QColor	mColor

QgsPropertyCollection	mDataDefinedProperties

bool	mEnabled = true
	True if layer is enabled and should be drawn. More...

QgsFields	mFields

QString	mId

bool	mLocked = false

std::unique_ptr< QgsPaintEffect >	mPaintEffect

int	mRenderingPass = 0

Qgis::SymbolType	mType

Additional Inherited Members
Static Public Member Functions inherited from QgsSymbolLayer
static const QgsPropertiesDefinition &	propertyDefinitions ()
	Returns the symbol layer property definitions. More...

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...

Detailed Description

Abstract base class for marker symbol layers.

Definition at line 742 of file qgssymbollayer.h.

Member Enumeration Documentation

◆ HorizontalAnchorPoint

enum QgsMarkerSymbolLayer::HorizontalAnchorPoint

Symbol horizontal anchor points.

Enumerator
Left	Align to left side of symbol.
HCenter	Align to horizontal center of symbol.
Right	Align to right side of symbol.

Definition at line 747 of file qgssymbollayer.h.

◆ VerticalAnchorPoint

enum QgsMarkerSymbolLayer::VerticalAnchorPoint

Symbol vertical anchor points.

Enumerator
Top	Align to top of symbol.
VCenter	Align to vertical center of symbol.
Bottom	Align to bottom of symbol.

Definition at line 755 of file qgssymbollayer.h.

Constructor & Destructor Documentation

◆ QgsMarkerSymbolLayer() [1/2]

QgsMarkerSymbolLayer::QgsMarkerSymbolLayer ( const QgsMarkerSymbolLayer & other )

delete

QgsMarkerSymbolLayer cannot be copied.

◆ QgsMarkerSymbolLayer() [2/2]

QgsMarkerSymbolLayer::QgsMarkerSymbolLayer ( bool locked = false )

protected

Constructor for QgsMarkerSymbolLayer.

Parameters

locked set to true to lock symbol color

Definition at line 498 of file qgssymbollayer.cpp.

Member Function Documentation

◆ _rotatedOffset()

QPointF QgsMarkerSymbolLayer::_rotatedOffset	(	QPointF	offset,
		double	angle
	)

staticprotected

Adjusts a marker offset to account for rotation.

Parameters

offset	offset prior to rotation
angle	rotation angle in degrees clockwise from north

Returns: adjusted offset

Definition at line 648 of file qgssymbollayer.cpp.

◆ angle()

double QgsMarkerSymbolLayer::angle ( ) const

inline

Returns the rotation angle for the marker, in degrees clockwise from north.

See also: setAngle()

Definition at line 794 of file qgssymbollayer.h.

◆ bounds()

virtual QRectF QgsMarkerSymbolLayer::bounds	(	QPointF	point,
		QgsSymbolRenderContext &	context
	)

pure virtual

Returns the approximate bounding box of the marker symbol layer, taking into account any data defined overrides and offsets which are set for the marker layer.

Returns: approximate symbol bounds, in painter units

Since: QGIS 2.14

Implemented in QgsEllipseSymbolLayer, QgsSimpleMarkerSymbolLayerBase, QgsSimpleMarkerSymbolLayer, QgsSvgMarkerSymbolLayer, QgsRasterMarkerSymbolLayer, QgsFontMarkerSymbolLayer, QgsMaskMarkerSymbolLayer, and QgsVectorFieldSymbolLayer.

◆ drawPreviewIcon()

void QgsMarkerSymbolLayer::drawPreviewIcon	(	QgsSymbolRenderContext &	context,
		QSize	size
	)

overridevirtual

Implements QgsSymbolLayer.

Reimplemented in QgsVectorFieldSymbolLayer.

Definition at line 534 of file qgssymbollayer.cpp.

◆ dxfAngle()

double QgsMarkerSymbolLayer::dxfAngle ( QgsSymbolRenderContext & context ) const

overridevirtual

Gets angle.

Reimplemented from QgsSymbolLayer.

Definition at line 934 of file qgssymbollayer.cpp.

◆ dxfSize()

double QgsMarkerSymbolLayer::dxfSize	(	const QgsDxfExport &	e,
		QgsSymbolRenderContext &	context
	)		const

overridevirtual

Gets marker size.

Reimplemented from QgsSymbolLayer.

Definition at line 911 of file qgssymbollayer.cpp.

◆ horizontalAnchorPoint()

HorizontalAnchorPoint QgsMarkerSymbolLayer::horizontalAnchorPoint ( ) const

inline

Returns the horizontal anchor point for positioning the symbol.

The symbol will be drawn so that the horizontal anchor point is aligned with the marker's desired location.

See also: setHorizontalAnchorPoint(); verticalAnchorPoint()

Definition at line 939 of file qgssymbollayer.h.

◆ mapUnitScale()

QgsMapUnitScale QgsMarkerSymbolLayer::mapUnitScale ( ) const

overridevirtual

Reimplemented from QgsSymbolLayer.

Reimplemented in QgsVectorFieldSymbolLayer.

Definition at line 708 of file qgssymbollayer.cpp.

◆ markerOffset() [1/3]

void QgsMarkerSymbolLayer::markerOffset	(	QgsSymbolRenderContext &	context,
		double &	offsetX,
		double &	offsetY
	)		const

protected

Calculates the required marker offset, including both the symbol offset and any displacement required to align with the marker's anchor point.

Parameters

context	symbol render context
offsetX	will be set to required horizontal offset (in painter units)
offsetY	will be set to required vertical offset (in painter units)

Definition at line 554 of file qgssymbollayer.cpp.

◆ markerOffset() [2/3]

void QgsMarkerSymbolLayer::markerOffset	(	QgsSymbolRenderContext &	context,
		double	width,
		double	height,
		double &	offsetX,
		double &	offsetY
	)		const

protected

Calculates the required marker offset, including both the symbol offset and any displacement required to align with the marker's anchor point.

Parameters

context	symbol render context
width	marker width
height	marker height
offsetX	will be set to required horizontal offset (in painter units)
offsetY	will be set to required vertical offset (in painter units)

Note: available in Python as markerOffsetWithWidthAndHeight

Definition at line 559 of file qgssymbollayer.cpp.

◆ markerOffset() [3/3]

void QgsMarkerSymbolLayer::markerOffset	(	QgsSymbolRenderContext &	context,
		double	width,
		double	height,
		Qgis::RenderUnit	widthUnit,
		Qgis::RenderUnit	heightUnit,
		double &	offsetX,
		double &	offsetY,
		const QgsMapUnitScale &	widthMapUnitScale,
		const QgsMapUnitScale &	heightMapUnitScale
	)		const

protected

Note: available in Python bindings as markerOffset2

Definition at line 564 of file qgssymbollayer.cpp.

◆ offset()

QPointF QgsMarkerSymbolLayer::offset ( ) const

inline

Returns the marker's offset, which is the horizontal and vertical displacement which the rendered marker will have from the original feature's geometry.

Units are specified by offsetUnit().

See also: setOffset(); offsetUnit(); offsetMapUnitScale()

Definition at line 888 of file qgssymbollayer.h.

◆ offsetMapUnitScale()

const QgsMapUnitScale & QgsMarkerSymbolLayer::offsetMapUnitScale ( ) const

inline

Returns the map unit scale for the symbol's offset.

See also: setOffsetMapUnitScale(); offset(); offsetUnit()

Definition at line 922 of file qgssymbollayer.h.

◆ offsetUnit()

Qgis::RenderUnit QgsMarkerSymbolLayer::offsetUnit ( ) const

inline

Returns the units for the symbol's offset.

See also: setOffsetUnit(); offset(); offsetMapUnitScale()

Definition at line 905 of file qgssymbollayer.h.

◆ operator=()

QgsMarkerSymbolLayer & QgsMarkerSymbolLayer::operator= ( const QgsMarkerSymbolLayer & other )

delete

QgsMarkerSymbolLayer cannot be copied.

◆ outputUnit()

Qgis::RenderUnit QgsMarkerSymbolLayer::outputUnit ( ) const

overridevirtual

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.

Returns: output unit, or QgsUnitTypes::RenderUnknownUnit if the symbol layer contains mixed units

See also: setOutputUnit()

Reimplemented from QgsSymbolLayer.

Reimplemented in QgsVectorFieldSymbolLayer.

Definition at line 693 of file qgssymbollayer.cpp.

◆ renderPoint()

virtual void QgsMarkerSymbolLayer::renderPoint	(	QPointF	point,
		QgsSymbolRenderContext &	context
	)

pure virtual

Renders a marker at the specified point.

Derived classes must implement this to handle drawing the point.

Parameters

point	position at which to render point, in painter units
context	symbol render context

Implemented in QgsEllipseSymbolLayer, QgsSimpleMarkerSymbolLayerBase, QgsSimpleMarkerSymbolLayer, QgsSvgMarkerSymbolLayer, QgsRasterMarkerSymbolLayer, QgsFontMarkerSymbolLayer, QgsMaskMarkerSymbolLayer, and QgsVectorFieldSymbolLayer.

◆ scaleMethod()

Qgis::ScaleMethod QgsMarkerSymbolLayer::scaleMethod ( ) const

inline

Returns the method to use for scaling the marker's size.

See also: setScaleMethod()

Definition at line 869 of file qgssymbollayer.h.

◆ setAngle()

void QgsMarkerSymbolLayer::setAngle ( double angle )

inline

Sets the rotation angle for the marker.

Parameters

angle angle in degrees clockwise from north.

See also: angle(); setLineAngle()

Definition at line 788 of file qgssymbollayer.h.

◆ setHorizontalAnchorPoint()

void QgsMarkerSymbolLayer::setHorizontalAnchorPoint ( HorizontalAnchorPoint h )

inline

Sets the horizontal anchor point for positioning the symbol.

Parameters

h	anchor point. Symbol will be drawn so that the horizontal anchor point is aligned with the marker's desired location.

See also: horizontalAnchorPoint(); setVerticalAnchorPoint()

Definition at line 931 of file qgssymbollayer.h.

◆ setLineAngle()

void QgsMarkerSymbolLayer::setLineAngle ( double lineAngle )

inline

Sets the line angle modification for the symbol's angle.

This angle is added to the marker's rotation and data defined rotation before rendering the symbol, and is usually used for orienting symbols to match a line's angle.

Parameters

lineAngle Angle in degrees clockwise from north, valid values are between 0 and 360

See also: setAngle(); angle()

Since: QGIS 2.9

Definition at line 805 of file qgssymbollayer.h.

◆ setMapUnitScale()

void QgsMarkerSymbolLayer::setMapUnitScale ( const QgsMapUnitScale & scale )

overridevirtual

Reimplemented from QgsSymbolLayer.

Reimplemented in QgsVectorFieldSymbolLayer.

Definition at line 702 of file qgssymbollayer.cpp.

◆ setOffset()

void QgsMarkerSymbolLayer::setOffset ( QPointF offset )

inline

Sets the marker's offset, which is the horizontal and vertical displacement which the rendered marker should have from the original feature's geometry.

Parameters

offset marker offset. Units are specified by offsetUnit()

See also: offset(); setOffsetUnit(); setOffsetMapUnitScale()

Definition at line 879 of file qgssymbollayer.h.

◆ setOffsetMapUnitScale()

void QgsMarkerSymbolLayer::setOffsetMapUnitScale ( const QgsMapUnitScale & scale )

inline

Sets the map unit scale for the symbol's offset.

Parameters

scale offset map unit scale

See also: offsetMapUnitScale(); setOffset(); setOffsetUnit()

Definition at line 914 of file qgssymbollayer.h.

◆ setOffsetUnit()

void QgsMarkerSymbolLayer::setOffsetUnit ( Qgis::RenderUnit unit )

inline

Sets the units for the symbol's offset.

Parameters

unit	offset units

See also: offsetUnit(); setOffset(); setOffsetMapUnitScale()

Definition at line 897 of file qgssymbollayer.h.

◆ setOutputUnit()

void QgsMarkerSymbolLayer::setOutputUnit ( Qgis::RenderUnit unit )

overridevirtual

Sets 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.

Parameters

unit	output units

See also: outputUnit()

Reimplemented from QgsSymbolLayer.

Reimplemented in QgsVectorFieldSymbolLayer.

Definition at line 687 of file qgssymbollayer.cpp.

◆ setScaleMethod()

void QgsMarkerSymbolLayer::setScaleMethod ( Qgis::ScaleMethod scaleMethod )

inline

Sets the method to use for scaling the marker's size.

Parameters

scaleMethod scale method

See also: scaleMethod()

Definition at line 863 of file qgssymbollayer.h.

◆ setSize()

virtual void QgsMarkerSymbolLayer::setSize ( double size )

inlinevirtual

Sets the symbol size.

Parameters

size	symbol size. Units are specified by sizeUnit().

See also: size(); setSizeUnit(); setSizeMapUnitScale()

Reimplemented in QgsEllipseSymbolLayer.

Definition at line 814 of file qgssymbollayer.h.

◆ setSizeMapUnitScale()

void QgsMarkerSymbolLayer::setSizeMapUnitScale ( const QgsMapUnitScale & scale )

inline

Sets the map unit scale for the symbol's size.

Parameters

scale size map unit scale

See also: sizeMapUnitScale(); setSize(); setSizeUnit()

Definition at line 848 of file qgssymbollayer.h.

◆ setSizeUnit()

void QgsMarkerSymbolLayer::setSizeUnit ( Qgis::RenderUnit unit )

inline

Sets the units for the symbol's size.

Parameters

unit	size units

See also: sizeUnit(); setSize(); setSizeMapUnitScale()

Definition at line 831 of file qgssymbollayer.h.

◆ setVerticalAnchorPoint()

void QgsMarkerSymbolLayer::setVerticalAnchorPoint ( VerticalAnchorPoint v )

inline

Sets the vertical anchor point for positioning the symbol.

Parameters

v	anchor point. Symbol will be drawn so that the vertical anchor point is aligned with the marker's desired location.

See also: verticalAnchorPoint(); setHorizontalAnchorPoint()

Definition at line 948 of file qgssymbollayer.h.

◆ size()

double QgsMarkerSymbolLayer::size ( ) const

inline

Returns the symbol size.

Units are specified by sizeUnit().

See also: setSize(); sizeUnit(); sizeMapUnitScale()

Definition at line 822 of file qgssymbollayer.h.

◆ sizeMapUnitScale()

const QgsMapUnitScale & QgsMarkerSymbolLayer::sizeMapUnitScale ( ) const

inline

Returns the map unit scale for the symbol's size.

See also: setSizeMapUnitScale(); size(); sizeUnit()

Definition at line 856 of file qgssymbollayer.h.

◆ sizeUnit()

Qgis::RenderUnit QgsMarkerSymbolLayer::sizeUnit ( ) const

inline

Returns the units for the symbol's size.

See also: setSizeUnit(); size(); sizeMapUnitScale()

Definition at line 839 of file qgssymbollayer.h.

◆ startRender()

void QgsMarkerSymbolLayer::startRender ( QgsSymbolRenderContext & context )

overridevirtual

Called before a set of rendering operations commences on the supplied render context.

This is always followed by a call to stopRender() after all rendering operations have been completed.

Subclasses can use this method to prepare for a set of rendering operations, e.g. by pre-evaluating paths or images to render, and performing other one-time optimisations.

See also: startFeatureRender(); stopRender()

Implements QgsSymbolLayer.

Reimplemented in QgsVectorFieldSymbolLayer.

Definition at line 524 of file qgssymbollayer.cpp.

◆ stopRender()

void QgsMarkerSymbolLayer::stopRender ( QgsSymbolRenderContext & context )

overridevirtual

Called after a set of rendering operations has finished on the supplied render context.

This is always preceded by a call to startRender() before all rendering operations are commenced.

Subclasses can use this method to cleanup after a set of rendering operations.

See also: startRender(); stopFeatureRender()

Implements QgsSymbolLayer.

Reimplemented in QgsVectorFieldSymbolLayer.

Definition at line 529 of file qgssymbollayer.cpp.

◆ toSld()

void QgsMarkerSymbolLayer::toSld	(	QDomDocument &	doc,
		QDomElement &	element,
		const QVariantMap &	props
	)		const

overridevirtual

Saves the symbol layer as SLD.

Reimplemented from QgsSymbolLayer.

Reimplemented in QgsVectorFieldSymbolLayer.

Definition at line 893 of file qgssymbollayer.cpp.

◆ verticalAnchorPoint()

VerticalAnchorPoint QgsMarkerSymbolLayer::verticalAnchorPoint ( ) const

inline

Returns the vertical anchor point for positioning the symbol.

The symbol will be drawn so that the vertical anchor point is aligned with the marker's desired location.

See also: setVerticalAnchorPoint(); horizontalAnchorPoint()

Definition at line 956 of file qgssymbollayer.h.

◆ writeSldMarker()

virtual void QgsMarkerSymbolLayer::writeSldMarker	(	QDomDocument &	doc,
		QDomElement &	element,
		const QVariantMap &	props
	)		const

inlinevirtual

Writes the symbol layer definition as a SLD XML element.

Parameters

doc	XML document
element	parent XML element
props	symbol layer definition (see properties())

Reimplemented in QgsEllipseSymbolLayer, QgsSimpleMarkerSymbolLayer, QgsSvgMarkerSymbolLayer, and QgsFontMarkerSymbolLayer.

Definition at line 966 of file qgssymbollayer.h.

Member Data Documentation

◆ mAngle

double QgsMarkerSymbolLayer::mAngle = 0

protected

Marker rotation angle, in degrees clockwise from north.

Definition at line 1028 of file qgssymbollayer.h.

◆ mHorizontalAnchorPoint

HorizontalAnchorPoint QgsMarkerSymbolLayer::mHorizontalAnchorPoint = HCenter

protected

Horizontal anchor point.

Definition at line 1046 of file qgssymbollayer.h.

◆ mLineAngle

double QgsMarkerSymbolLayer::mLineAngle = 0

protected

Line rotation angle (see setLineAngle() for details)

Definition at line 1030 of file qgssymbollayer.h.

◆ mOffset

QPointF QgsMarkerSymbolLayer::mOffset

protected

Marker offset.

Definition at line 1038 of file qgssymbollayer.h.

◆ mOffsetMapUnitScale

QgsMapUnitScale QgsMarkerSymbolLayer::mOffsetMapUnitScale

protected

Offset map unit scale.

Definition at line 1042 of file qgssymbollayer.h.

◆ mOffsetUnit

Qgis::RenderUnit QgsMarkerSymbolLayer::mOffsetUnit = Qgis::RenderUnit::Millimeters

protected

Offset units.

Definition at line 1040 of file qgssymbollayer.h.

◆ mScaleMethod

Qgis::ScaleMethod QgsMarkerSymbolLayer::mScaleMethod = Qgis::ScaleMethod::ScaleDiameter

protected

Marker size scaling method.

Definition at line 1044 of file qgssymbollayer.h.

◆ mSize

double QgsMarkerSymbolLayer::mSize = 2.0

protected

Marker size.

Definition at line 1032 of file qgssymbollayer.h.

◆ mSizeMapUnitScale

QgsMapUnitScale QgsMarkerSymbolLayer::mSizeMapUnitScale

protected

Marker size map unit scale.

Definition at line 1036 of file qgssymbollayer.h.

◆ mSizeUnit

Qgis::RenderUnit QgsMarkerSymbolLayer::mSizeUnit = Qgis::RenderUnit::Millimeters

protected

Marker size unit.

Definition at line 1034 of file qgssymbollayer.h.

◆ mVerticalAnchorPoint

VerticalAnchorPoint QgsMarkerSymbolLayer::mVerticalAnchorPoint = VCenter

protected

Vertical anchor point.

Definition at line 1048 of file qgssymbollayer.h.

The documentation for this class was generated from the following files:

/build/qgis-3.32.0+99sid/src/core/symbology/qgssymbollayer.h
/build/qgis-3.32.0+99sid/src/core/symbology/qgssymbollayer.cpp

Public Types

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ HorizontalAnchorPoint

◆ VerticalAnchorPoint

Constructor & Destructor Documentation

◆ QgsMarkerSymbolLayer() [1/2]

◆ QgsMarkerSymbolLayer() [2/2]

Member Function Documentation

◆ _rotatedOffset()

◆ angle()

◆ bounds()

◆ drawPreviewIcon()

◆ dxfAngle()

◆ dxfSize()

◆ horizontalAnchorPoint()

◆ mapUnitScale()

◆ markerOffset() [1/3]

◆ markerOffset() [2/3]

◆ markerOffset() [3/3]

◆ offset()

◆ offsetMapUnitScale()

◆ offsetUnit()

◆ operator=()

◆ outputUnit()

◆ renderPoint()

◆ scaleMethod()

◆ setAngle()

◆ setHorizontalAnchorPoint()

◆ setLineAngle()

◆ setMapUnitScale()

◆ setOffset()

◆ setOffsetMapUnitScale()

◆ setOffsetUnit()

◆ setOutputUnit()

◆ setScaleMethod()

◆ setSize()

◆ setSizeMapUnitScale()

◆ setSizeUnit()

◆ setVerticalAnchorPoint()

◆ size()

◆ sizeMapUnitScale()

◆ sizeUnit()

◆ startRender()

◆ stopRender()

◆ toSld()

◆ verticalAnchorPoint()

◆ writeSldMarker()

Member Data Documentation

◆ mAngle

◆ mHorizontalAnchorPoint

◆ mLineAngle

◆ mOffset

◆ mOffsetMapUnitScale

◆ mOffsetUnit

◆ mScaleMethod

◆ mSize

◆ mSizeMapUnitScale

◆ mSizeUnit

◆ mVerticalAnchorPoint