Base class for all diagram types. More...

#include <qgsdiagram.h>

Inheritance diagram for QgsDiagram:

[legend]

Public Member Functions
virtual	~QgsDiagram ()

void	clearCache ()

virtual QgsDiagram *	clone () const =0
	Returns an instance that is equivalent to this one. More...

virtual QString	diagramName () const =0
	Gets a descriptive name for this diagram type. More...

virtual QSizeF	diagramSize (const QgsAttributes &attributes, const QgsRenderContext &c, const QgsDiagramSettings &s)=0
	Returns the size in map units the diagram will use to render. More...

virtual QSizeF	diagramSize (const QgsFeature &feature, const QgsRenderContext &c, const QgsDiagramSettings &s, const QgsDiagramInterpolationSettings &is)=0
	Returns the size in map units the diagram will use to render. Interpolate size. More...

QgsExpression *	getExpression (const QString &expression, const QgsExpressionContext &context)
	Returns a prepared expression for the specified context. More...

virtual double	legendSize (double value, const QgsDiagramSettings &s, const QgsDiagramInterpolationSettings &is) const =0
	Returns the size of the legend item for the diagram corresponding to a specified value. More...

virtual void	renderDiagram (const QgsFeature &feature, QgsRenderContext &c, const QgsDiagramSettings &s, QPointF position)=0
	Draws the diagram at the given position (in pixel coordinates) More...

Protected Member Functions
	QgsDiagram ()=default
	Constructor for QgsDiagram. More...

	QgsDiagram (const QgsDiagram &other)

QFont	scaledFont (const QgsDiagramSettings &s, const QgsRenderContext &c)
	Calculates a size to match the current settings and rendering context. More...

void	setPenWidth (QPen &pen, const QgsDiagramSettings &s, const QgsRenderContext &c)
	Changes the pen width to match the current settings and rendering context. More...

QSizeF	sizeForValue (double value, const QgsDiagramSettings &s, const QgsDiagramInterpolationSettings &is) const
	Returns the scaled size of a diagram for a value, respecting the specified diagram interpolation settings. More...

QSizeF	sizePainterUnits (QSizeF size, const QgsDiagramSettings &s, const QgsRenderContext &c)
	Calculates a size to match the current settings and rendering context. More...

double	sizePainterUnits (double l, const QgsDiagramSettings &s, const QgsRenderContext &c)
	Calculates a length to match the current settings and rendering context. More...

Detailed Description

Base class for all diagram types.

Definition at line 38 of file qgsdiagram.h.

Constructor & Destructor Documentation

◆ ~QgsDiagram()

virtual QgsDiagram::~QgsDiagram ( )

inlinevirtual

Definition at line 57 of file qgsdiagram.h.

◆ QgsDiagram() [1/2]

QgsDiagram::QgsDiagram ( )

protecteddefault

Constructor for QgsDiagram.

◆ QgsDiagram() [2/2]

QgsDiagram::QgsDiagram ( const QgsDiagram & other )

protected

Definition at line 20 of file qgsdiagram.cpp.

Member Function Documentation

◆ clearCache()

void QgsDiagram::clearCache ( )

Definition at line 26 of file qgsdiagram.cpp.

◆ clone()

virtual QgsDiagram* QgsDiagram::clone ( ) const

pure virtual

Returns an instance that is equivalent to this one.

Since: QGIS 2.4

Implemented in QgsTextDiagram, QgsStackedBarDiagram, QgsHistogramDiagram, and QgsPieDiagram.

◆ diagramName()

virtual QString QgsDiagram::diagramName ( ) const

pure virtual

Gets a descriptive name for this diagram type.

Implemented in QgsTextDiagram, QgsStackedBarDiagram, QgsHistogramDiagram, and QgsPieDiagram.

◆ diagramSize() [1/2]

virtual QSizeF QgsDiagram::diagramSize	(	const QgsAttributes &	attributes,
		const QgsRenderContext &	c,
		const QgsDiagramSettings &	s
	)

pure virtual

Returns the size in map units the diagram will use to render.

Implemented in QgsTextDiagram, QgsStackedBarDiagram, QgsHistogramDiagram, and QgsPieDiagram.

◆ diagramSize() [2/2]

virtual QSizeF QgsDiagram::diagramSize	(	const QgsFeature &	feature,
		const QgsRenderContext &	c,
		const QgsDiagramSettings &	s,
		const QgsDiagramInterpolationSettings &	is
	)

pure virtual

Returns the size in map units the diagram will use to render. Interpolate size.

Implemented in QgsTextDiagram, QgsStackedBarDiagram, QgsHistogramDiagram, and QgsPieDiagram.

◆ getExpression()

QgsExpression * QgsDiagram::getExpression	(	const QString &	expression,
		const QgsExpressionContext &	context
	)

Returns a prepared expression for the specified context.

Parameters

expression	expression string
context	expression context

Since: QGIS 2.12

Definition at line 37 of file qgsdiagram.cpp.

◆ legendSize()

virtual double QgsDiagram::legendSize	(	double	value,
		const QgsDiagramSettings &	s,
		const QgsDiagramInterpolationSettings &	is
	)		const

pure virtual

Returns the size of the legend item for the diagram corresponding to a specified value.

Parameters

value	value to return legend item size for
s	diagram settings
is	interpolation settings

Since: QGIS 2.16

Implemented in QgsTextDiagram, QgsStackedBarDiagram, QgsHistogramDiagram, and QgsPieDiagram.

◆ renderDiagram()

virtual void QgsDiagram::renderDiagram	(	const QgsFeature &	feature,
		QgsRenderContext &	c,
		const QgsDiagramSettings &	s,
		QPointF	position
	)

pure virtual

Draws the diagram at the given position (in pixel coordinates)

Implemented in QgsTextDiagram, QgsStackedBarDiagram, QgsHistogramDiagram, and QgsPieDiagram.

◆ scaledFont()

QFont QgsDiagram::scaledFont	(	const QgsDiagramSettings &	s,
		const QgsRenderContext &	c
	)

protected

Calculates a size to match the current settings and rendering context.

Parameters

s	The settings that contain the font size and size type
c	The rendering specifying the proper scale units for pixel conversion

Returns: The properly scaled font for rendering

Definition at line 64 of file qgsdiagram.cpp.

◆ setPenWidth()

void QgsDiagram::setPenWidth	(	QPen &	pen,
		const QgsDiagramSettings &	s,
		const QgsRenderContext &	c
	)

protected

Changes the pen width to match the current settings and rendering context.

Parameters

pen	The pen to modify
s	The settings that specify the pen width
c	The rendering specifying the proper scale units for pixel conversion

Definition at line 48 of file qgsdiagram.cpp.

◆ sizeForValue()

QSizeF QgsDiagram::sizeForValue	(	double	value,
		const QgsDiagramSettings &	s,
		const QgsDiagramInterpolationSettings &	is
	)		const

protected

Returns the scaled size of a diagram for a value, respecting the specified diagram interpolation settings.

Parameters

value	value to calculate corresponding circular size for
s	diagram settings
is	interpolation settings

Since: QGIS 2.16

Definition at line 80 of file qgsdiagram.cpp.

◆ sizePainterUnits() [1/2]

QSizeF QgsDiagram::sizePainterUnits	(	QSizeF	size,
		const QgsDiagramSettings &	s,
		const QgsRenderContext &	c
	)

protected

Calculates a size to match the current settings and rendering context.

Parameters

size	The size to convert
s	The settings that specify the size type
c	The rendering specifying the proper scale units for pixel conversion

Returns: The converted size for rendering

Definition at line 54 of file qgsdiagram.cpp.

◆ sizePainterUnits() [2/2]

double QgsDiagram::sizePainterUnits	(	double	l,
		const QgsDiagramSettings &	s,
		const QgsRenderContext &	c
	)

protected

Calculates a length to match the current settings and rendering context.

Parameters

l	The length to convert
s	Unused
c	The rendering specifying the proper scale units for pixel conversion

Returns: The converted length for rendering

Definition at line 59 of file qgsdiagram.cpp.

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

/build/qgis-3.12.1+28bionic/src/core/diagram/qgsdiagram.h
/build/qgis-3.12.1+28bionic/src/core/diagram/qgsdiagram.cpp

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~QgsDiagram()

◆ QgsDiagram() [1/2]

◆ QgsDiagram() [2/2]

Member Function Documentation

◆ clearCache()

◆ clone()

◆ diagramName()

◆ diagramSize() [1/2]

◆ diagramSize() [2/2]

◆ getExpression()

◆ legendSize()

◆ renderDiagram()

◆ scaledFont()

◆ setPenWidth()

◆ sizeForValue()

◆ sizePainterUnits() [1/2]

◆ sizePainterUnits() [2/2]