#include <qgssymbolrendercontext.h>

Public Member Functions
	QgsSymbolRenderContext (const QgsSymbolRenderContext &rh)=delete
	QgsSymbolRenderContext cannot be copied.

	QgsSymbolRenderContext (QgsRenderContext &c, Qgis::RenderUnit u, qreal opacity=1.0, bool selected=false, Qgis::SymbolRenderHints renderHints=Qgis::SymbolRenderHints(), const QgsFeature *f=nullptr, const QgsFields &fields=QgsFields(), const QgsMapUnitScale &mapUnitScale=QgsMapUnitScale())
	Constructor for QgsSymbolRenderContext.

	~QgsSymbolRenderContext ()

QgsExpressionContextScope *	expressionContextScope ()
	This scope is always available when a symbol of this type is being rendered.

const QgsFeature *	feature () const
	Returns the current feature being rendered.

QgsFields	fields () const
	Fields of the layer.

int	geometryPartCount () const
	Part count of current geometry.

int	geometryPartNum () const
	Part number of current geometry.

Q_DECL_DEPRECATED QgsMapUnitScale	mapUnitScale () const

qreal	opacity () const
	Returns the opacity for the symbol.

QgsSymbolRenderContext &	operator= (const QgsSymbolRenderContext &)

Qgis::GeometryType	originalGeometryType () const
	Returns the geometry type for the original feature geometry being rendered.

Q_DECL_DEPRECATED double	outputLineWidth (double width) const

Q_DECL_DEPRECATED double	outputPixelSize (double size) const

Q_DECL_DEPRECATED Qgis::RenderUnit	outputUnit () const
	Returns the output unit for the context.

const QgsLegendPatchShape *	patchShape () const
	Returns the symbol patch shape, to use if rendering symbol preview icons.

QgsRenderContext &	renderContext ()
	Returns a reference to the context's render context.

const QgsRenderContext &	renderContext () const
	Returns a reference to the context's render context.

Qgis::SymbolRenderHints	renderHints () const
	Returns the rendering hint flags for the symbol.

bool	selected () const
	Returns `true` if symbols should be rendered using the selected symbol coloring and style.

void	setExpressionContextScope (QgsExpressionContextScope *contextScope)
	Set an expression scope for this symbol.

void	setFeature (const QgsFeature *f)

void	setGeometryPartCount (int count)
	Sets the part count of current geometry.

void	setGeometryPartNum (int num)
	Sets the part number of current geometry.

Q_DECL_DEPRECATED void	setMapUnitScale (const QgsMapUnitScale &scale)

void	setOpacity (qreal opacity)
	Sets the opacity for the symbol.

void	setOriginalGeometryType (Qgis::GeometryType type)
	Sets the geometry type for the original feature geometry being rendered.

void	setOriginalValueVariable (const QVariant &value)
	Sets the original value variable value for data defined symbology.

Q_DECL_DEPRECATED void	setOutputUnit (Qgis::RenderUnit u)
	Sets the output unit for the context.

void	setPatchShape (const QgsLegendPatchShape &shape)
	Sets the symbol patch shape, to use if rendering symbol preview icons.

void	setRenderHints (Qgis::SymbolRenderHints hints)
	Sets rendering hint flags for the symbol.

void	setSelected (bool selected)
	Sets whether symbols should be rendered using the selected symbol coloring and style.

Detailed Description

Definition at line 33 of file qgssymbolrendercontext.h.

Constructor & Destructor Documentation

◆ QgsSymbolRenderContext() [1/2]

QgsSymbolRenderContext::QgsSymbolRenderContext	(	QgsRenderContext &	c,
		Qgis::RenderUnit	u,
		qreal	opacity = `1.0`,
		bool	selected = `false`,
		Qgis::SymbolRenderHints	renderHints = `Qgis::SymbolRenderHints()`,
		const QgsFeature *	f = `nullptr`,
		const QgsFields &	fields = `QgsFields()`,
		const QgsMapUnitScale &	mapUnitScale = `QgsMapUnitScale()`
	)

Constructor for QgsSymbolRenderContext.

Parameters

c
u
opacity	value between 0 (fully transparent) and 1 (fully opaque)
selected	set to `true` if symbol should be drawn in a "selected" state
renderHints	flags controlling rendering behavior
f
fields
mapUnitScale

Definition at line 20 of file qgssymbolrendercontext.cpp.

◆ ~QgsSymbolRenderContext()

QgsSymbolRenderContext::~QgsSymbolRenderContext ( )

default

◆ QgsSymbolRenderContext() [2/2]

QgsSymbolRenderContext::QgsSymbolRenderContext ( const QgsSymbolRenderContext & rh )

delete

QgsSymbolRenderContext cannot be copied.

Member Function Documentation

◆ expressionContextScope()

QgsExpressionContextScope * QgsSymbolRenderContext::expressionContextScope ( )

This scope is always available when a symbol of this type is being rendered.

Returns: An expression scope for details about this symbol

Definition at line 62 of file qgssymbolrendercontext.cpp.

◆ feature()

const QgsFeature * QgsSymbolRenderContext::feature ( ) const

inline

Returns the current feature being rendered.

This may be nullptr.

Definition at line 141 of file qgssymbolrendercontext.h.

◆ fields()

QgsFields QgsSymbolRenderContext::fields ( ) const

inline

Fields of the layer.

Currently only available in startRender() calls to allow symbols with data-defined properties prepare the expressions (other times fields() returns an empty QgsFields object).

Since: QGIS 2.4

Definition at line 166 of file qgssymbolrendercontext.h.

◆ geometryPartCount()

int QgsSymbolRenderContext::geometryPartCount ( ) const

inline

Part count of current geometry.

Since: QGIS 2.16

Definition at line 172 of file qgssymbolrendercontext.h.

◆ geometryPartNum()

int QgsSymbolRenderContext::geometryPartNum ( ) const

inline

Part number of current geometry.

Since: QGIS 2.16

Definition at line 184 of file qgssymbolrendercontext.h.

◆ mapUnitScale()

Q_DECL_DEPRECATED QgsMapUnitScale QgsSymbolRenderContext::mapUnitScale ( ) const

inline

Deprecated:: Will be removed in QGIS 4.0

Definition at line 91 of file qgssymbolrendercontext.h.

◆ opacity()

qreal QgsSymbolRenderContext::opacity ( ) const

inline

Returns the opacity for the symbol.

Returns: opacity value between 0 (fully transparent) and 1 (fully opaque)

See also: setOpacity()

Definition at line 103 of file qgssymbolrendercontext.h.

◆ operator=()

QgsSymbolRenderContext & QgsSymbolRenderContext::operator= ( const QgsSymbolRenderContext & )

Definition at line 52 of file qgssymbolrendercontext.cpp.

◆ originalGeometryType()

Qgis::GeometryType QgsSymbolRenderContext::originalGeometryType ( ) const

inline

Returns the geometry type for the original feature geometry being rendered.

This can be useful if symbol layers alter their appearance based on geometry type - eg offsetting a simple line style will look different if the simple line is rendering a polygon feature (a closed buffer) vs a line feature (an unclosed offset line).

See also: originalGeometryType()

Since: QGIS 3.0

Definition at line 158 of file qgssymbolrendercontext.h.

◆ outputLineWidth()

double QgsSymbolRenderContext::outputLineWidth ( double width ) const

Deprecated:: Use the size conversion methods in QgsRenderContext instead.

Definition at line 41 of file qgssymbolrendercontext.cpp.

◆ outputPixelSize()

double QgsSymbolRenderContext::outputPixelSize ( double size ) const

Deprecated:: Use the size conversion methods in QgsRenderContext instead.

Definition at line 46 of file qgssymbolrendercontext.cpp.

◆ outputUnit()

Q_DECL_DEPRECATED Qgis::RenderUnit QgsSymbolRenderContext::outputUnit ( ) const

inline

Returns the output unit for the context.

Deprecated:: No longer used and will be removed in QGIS 4.0

Definition at line 80 of file qgssymbolrendercontext.h.

◆ patchShape()

const QgsLegendPatchShape * QgsSymbolRenderContext::patchShape ( ) const

Returns the symbol patch shape, to use if rendering symbol preview icons.

See also: setPatchShape()

Since: QGIS 3.14

Definition at line 72 of file qgssymbolrendercontext.cpp.

◆ renderContext() [1/2]

QgsRenderContext & QgsSymbolRenderContext::renderContext ( )

inline

Returns a reference to the context's render context.

Definition at line 60 of file qgssymbolrendercontext.h.

◆ renderContext() [2/2]

const QgsRenderContext & QgsSymbolRenderContext::renderContext ( ) const

inline

Returns a reference to the context's render context.

Note: Not available in Python bindings.

Definition at line 66 of file qgssymbolrendercontext.h.

◆ renderHints()

Qgis::SymbolRenderHints QgsSymbolRenderContext::renderHints ( ) const

inline

Returns the rendering hint flags for the symbol.

See also: setRenderHints()

Definition at line 128 of file qgssymbolrendercontext.h.

◆ selected()

bool QgsSymbolRenderContext::selected ( ) const

inline

Returns true if symbols should be rendered using the selected symbol coloring and style.

See also: setSelected()

Definition at line 116 of file qgssymbolrendercontext.h.

◆ setExpressionContextScope()

void QgsSymbolRenderContext::setExpressionContextScope ( QgsExpressionContextScope * contextScope )

Set an expression scope for this symbol.

Will take ownership.

Parameters

contextScope An expression scope for details about this symbol

Definition at line 67 of file qgssymbolrendercontext.cpp.

◆ setFeature()

void QgsSymbolRenderContext::setFeature ( const QgsFeature * f )

inline

Definition at line 136 of file qgssymbolrendercontext.h.

◆ setGeometryPartCount()

void QgsSymbolRenderContext::setGeometryPartCount ( int count )

inline

Sets the part count of current geometry.

Since: QGIS 2.16

Definition at line 178 of file qgssymbolrendercontext.h.

◆ setGeometryPartNum()

void QgsSymbolRenderContext::setGeometryPartNum ( int num )

inline

Sets the part number of current geometry.

Since: QGIS 2.16

Definition at line 190 of file qgssymbolrendercontext.h.

◆ setMapUnitScale()

Q_DECL_DEPRECATED void QgsSymbolRenderContext::setMapUnitScale ( const QgsMapUnitScale & scale )

inline

Deprecated:: Will be removed in QGIS 4.0

Definition at line 96 of file qgssymbolrendercontext.h.

◆ setOpacity()

void QgsSymbolRenderContext::setOpacity ( qreal opacity )

inline

Sets the opacity for the symbol.

Parameters

opacity opacity value between 0 (fully transparent) and 1 (fully opaque)

See also: opacity()

Definition at line 110 of file qgssymbolrendercontext.h.

◆ setOriginalGeometryType()

void QgsSymbolRenderContext::setOriginalGeometryType ( Qgis::GeometryType type )

inline

Sets the geometry type for the original feature geometry being rendered.

See also: originalGeometryType()

Since: QGIS 3.0

Definition at line 148 of file qgssymbolrendercontext.h.

◆ setOriginalValueVariable()

void QgsSymbolRenderContext::setOriginalValueVariable ( const QVariant & value )

Sets the original value variable value for data defined symbology.

Parameters

value value for original value variable. This usually represents the symbol property value before any data defined overrides have been applied.

Since: QGIS 2.12

Definition at line 36 of file qgssymbolrendercontext.cpp.

◆ setOutputUnit()

Q_DECL_DEPRECATED void QgsSymbolRenderContext::setOutputUnit ( Qgis::RenderUnit u )

inline

Sets the output unit for the context.

Deprecated:: No longer used and will be removed in QGIS 4.0

Definition at line 86 of file qgssymbolrendercontext.h.

◆ setPatchShape()

void QgsSymbolRenderContext::setPatchShape ( const QgsLegendPatchShape & shape )

Sets the symbol patch shape, to use if rendering symbol preview icons.

See also: patchShape()

Since: QGIS 3.14

Definition at line 77 of file qgssymbolrendercontext.cpp.

◆ setRenderHints()

void QgsSymbolRenderContext::setRenderHints ( Qgis::SymbolRenderHints hints )

inline

Sets rendering hint flags for the symbol.

See also: renderHints()

Definition at line 134 of file qgssymbolrendercontext.h.

◆ setSelected()

void QgsSymbolRenderContext::setSelected ( bool selected )

inline

Sets whether symbols should be rendered using the selected symbol coloring and style.

See also: selected()

Definition at line 122 of file qgssymbolrendercontext.h.

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

/build/qgis-3.34.0+99sid/src/core/symbology/qgssymbolrendercontext.h
/build/qgis-3.34.0+99sid/src/core/symbology/qgssymbolrendercontext.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsSymbolRenderContext() [1/2]

◆ ~QgsSymbolRenderContext()

◆ QgsSymbolRenderContext() [2/2]

Member Function Documentation

◆ expressionContextScope()

◆ feature()

◆ fields()

◆ geometryPartCount()

◆ geometryPartNum()

◆ mapUnitScale()

◆ opacity()

◆ operator=()

◆ originalGeometryType()

◆ outputLineWidth()

◆ outputPixelSize()

◆ outputUnit()

◆ patchShape()

◆ renderContext() [1/2]

◆ renderContext() [2/2]

◆ renderHints()

◆ selected()

◆ setExpressionContextScope()

◆ setFeature()

◆ setGeometryPartCount()

◆ setGeometryPartNum()

◆ setMapUnitScale()

◆ setOpacity()

◆ setOriginalGeometryType()

◆ setOriginalValueVariable()

◆ setOutputUnit()

◆ setPatchShape()

◆ setRenderHints()

◆ setSelected()