Base class for all diagram types. More...

#include <qgsdiagram.h>

Inheritance diagram for QgsDiagram:

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

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 Q_DECL_DEPRECATED QSizeF	diagramSize (const QgsAttributes &attributes, const QgsRenderContext &c, const QgsDiagramSettings &s, const QgsDiagramInterpolationSettings &is)

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

Q_DECL_DEPRECATED QgsExpression *	getExpression (const QString &expression, const QgsFields *fields)

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 Q_DECL_DEPRECATED void	renderDiagram (const QgsAttributes &att, QgsRenderContext &c, const QgsDiagramSettings &s, QPointF position)

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 ()

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

float	sizePainterUnits (float 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 36 of file qgsdiagram.h.

Constructor & Destructor Documentation

◆ ~QgsDiagram()

virtual QgsDiagram::~QgsDiagram ( )

inlinevirtual

Definition at line 39 of file qgsdiagram.h.

◆ QgsDiagram() [1/2]

QgsDiagram::QgsDiagram ( )

protected

Definition at line 24 of file qgsdiagram.cpp.

◆ QgsDiagram() [2/2]

QgsDiagram::QgsDiagram ( const QgsDiagram & other )

protected

Definition at line 29 of file qgsdiagram.cpp.

Member Function Documentation

◆ clearCache()

void QgsDiagram::clearCache ( )

Definition at line 36 of file qgsdiagram.cpp.

◆ clone()

virtual QgsDiagram* QgsDiagram::clone ( ) const

pure virtual

Returns an instance that is equivalent to this one.

Note: added in 2.4

Implemented in QgsTextDiagram, QgsHistogramDiagram, and QgsPieDiagram.

◆ diagramName()

virtual QString QgsDiagram::diagramName ( ) const

pure virtual

Implemented in QgsTextDiagram, QgsHistogramDiagram, and QgsPieDiagram.

◆ diagramSize() [1/3]

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, QgsHistogramDiagram, and QgsPieDiagram.

◆ diagramSize() [2/3]

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

virtual

Deprecated:: QSizeF diagramSize( const QgsFeature& feature, const QgsRenderContext& c, const QgsDiagramSettings& s, const QgsDiagramInterpolationSettings& is ) should be used instead

Definition at line 155 of file qgsdiagram.cpp.

◆ diagramSize() [3/3]

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, QgsHistogramDiagram, and QgsPieDiagram.

◆ getExpression() [1/2]

QgsExpression * QgsDiagram::getExpression	(	const QString &	expression,
		const QgsFields *	fields
	)

Deprecated:: use QgsExpressionContext variant instead

Definition at line 47 of file qgsdiagram.cpp.

◆ getExpression() [2/2]

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

Returns a prepared expression for the specified context.

Parameters

expression	expression string
context	expression context

Note: added in QGIS 2.12

Definition at line 60 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

Note: added in QGIS 2.16

Implemented in QgsTextDiagram, QgsHistogramDiagram, and QgsPieDiagram.

◆ renderDiagram() [1/2]

void QgsDiagram::renderDiagram	(	const QgsAttributes &	att,
		QgsRenderContext &	c,
		const QgsDiagramSettings &	s,
		QPointF	position
	)

virtual

Deprecated:: void renderDiagram( const QgsFeature& feature, QgsRenderContext& c, const QgsDiagramSettings& s, const QPointF& position ) should be used instead

Definition at line 148 of file qgsdiagram.cpp.

◆ renderDiagram() [2/2]

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, 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 87 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 71 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

Note: added in QGIS 2.16

Definition at line 103 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 77 of file qgsdiagram.cpp.

◆ sizePainterUnits() [2/2]

float QgsDiagram::sizePainterUnits	(	float	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 82 of file qgsdiagram.cpp.

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

/tmp/buildd/qgis-2.18.21+99unstable/src/core/diagram/qgsdiagram.h
/tmp/buildd/qgis-2.18.21+99unstable/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/3]

◆ diagramSize() [2/3]

◆ diagramSize() [3/3]

◆ getExpression() [1/2]

◆ getExpression() [2/2]

◆ legendSize()

◆ renderDiagram() [1/2]

◆ renderDiagram() [2/2]

◆ scaledFont()

◆ setPenWidth()

◆ sizeForValue()

◆ sizePainterUnits() [1/2]

◆ sizePainterUnits() [2/2]