QGIS API Documentation 3.99.0-Master (357b655ed83)
Loading...
Searching...
No Matches
qgsbarchartplot.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsbarchartplot.cpp
3 -------------------
4 begin : June 2025
5 copyright : (C) 2025 by Mathieu
6 email : mathieu at opengis dot ch
7 ***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
18#include "qgsbarchartplot.h"
19
21#include "qgssymbol.h"
22#include "qgssymbollayer.h"
23#include "qgssymbollayerutils.h"
25
26#include <QString>
27
28using namespace Qt::StringLiterals;
29
34
35void QgsBarChartPlot::renderContent( QgsRenderContext &context, QgsPlotRenderContext &, const QRectF &plotArea, const QgsPlotData &plotData )
36{
37 if ( mFillSymbols.empty() )
38 {
39 return;
40 }
41
42 const QList<QgsAbstractPlotSeries *> seriesList = plotData.series();
43 if ( seriesList.isEmpty() )
44 {
45 return;
46 }
47
48 const QStringList categories = plotData.categories();
49 switch ( xAxis().type() )
50 {
52 if ( categories.isEmpty() )
53 {
54 return;
55 }
56 break;
57
59 break;
60 }
61
62 QgsExpressionContextScope *chartScope = new QgsExpressionContextScope( u"chart"_s );
63 const QgsExpressionContextScopePopper scopePopper( context.expressionContext(), chartScope );
64
65 context.painter()->save();
66 context.painter()->setClipRect( plotArea );
67
68 double minX = xMinimum();
69 double maxX = xMaximum();
70 double minY = yMinimum();
71 double maxY = yMaximum();
72 double majorIntervalX = xAxis().gridIntervalMajor();
73 double minorIntervalX = xAxis().gridIntervalMinor();
74 double labelIntervalX = xAxis().labelInterval();
75 double majorIntervalY = yAxis().gridIntervalMajor();
76 double minorIntervalY = yAxis().gridIntervalMinor();
77 double labelIntervalY = yAxis().labelInterval();
78 Qgs2DXyPlot::applyDataDefinedProperties( context, minX, maxX, minY, maxY, majorIntervalX, minorIntervalX, labelIntervalX, majorIntervalY, minorIntervalY, labelIntervalY );
79
80 const double xScale = plotArea.width() / ( maxX - minX );
81 const double yScale = plotArea.height() / ( maxY - minY );
82 const double categoriesWidth = plotArea.width() / categories.size();
83 const double valuesWidth = plotArea.width() * ( minorIntervalX / ( maxX - minX ) );
84 const double barsWidth = xAxis().type() == Qgis::PlotAxisType::Categorical ? categoriesWidth / 2 : valuesWidth / 2;
85 const double barWidth = barsWidth / seriesList.size();
86 int seriesIndex = 0;
87 for ( const QgsAbstractPlotSeries *series : seriesList )
88 {
89 QgsFillSymbol *symbol = fillSymbolAt( seriesIndex % mFillSymbols.size() );
90 if ( !symbol )
91 {
92 continue;
93 }
94 symbol->startRender( context );
95
96 const double barStartAdjustment = -( barsWidth / 2 ) + barWidth * seriesIndex;
97 if ( const QgsXyPlotSeries *xySeries = dynamic_cast<const QgsXyPlotSeries *>( series ) )
98 {
99 const QList<std::pair<double, double>> data = xySeries->data();
100 for ( const std::pair<double, double> &pair : data )
101 {
102 double x = 0;
103 switch ( xAxis().type() )
104 {
106 if ( pair.first < 0 || pair.first >= categories.size() )
107 {
108 continue;
109 }
110 x = ( categoriesWidth * pair.first ) + ( categoriesWidth / 2 ) + barStartAdjustment;
111 chartScope->addVariable( QgsExpressionContextScope::StaticVariable( u"chart_category"_s, categories[pair.first], true ) );
112 break;
113
115 x = ( pair.first - minX ) * xScale + barStartAdjustment;
116 break;
117 }
118
119 double y = ( pair.second - minY ) * yScale;
120
121 const double zero = ( 0.0 - minY ) * yScale;
122 const QPoint topLeft( plotArea.left() + x,
123 plotArea.y() + plotArea.height() - y );
124 const QPoint bottomRight( plotArea.left() + x + barWidth,
125 plotArea.y() + plotArea.height() - zero );
126
127 chartScope->addVariable( QgsExpressionContextScope::StaticVariable( u"chart_value"_s, pair.second, true ) );
128 symbol->renderPolygon( QPolygonF( QRectF( topLeft, bottomRight ) ), nullptr, nullptr, context );
129 }
130 }
131
132 symbol->stopRender( context );
133 seriesIndex++;
134 }
135
136 context.painter()->restore();
137}
138
140{
141 if ( index < 0 || index >= static_cast<int>( mFillSymbols.size() ) )
142 {
143 return nullptr;
144 }
145
146 return mFillSymbols[index].get();
147}
148
150{
151 if ( index < 0 )
152 {
153 return;
154 }
155
156 if ( index + 1 >= static_cast<int>( mFillSymbols.size() ) )
157 {
158 mFillSymbols.resize( index + 1 );
159 }
160
161 mFillSymbols[index].reset( symbol );
162}
163
164bool QgsBarChartPlot::writeXml( QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context ) const
165{
166 Qgs2DXyPlot::writeXml( element, document, context );
167
168 QDomElement fillSymbolsElement = document.createElement( u"fillSymbols"_s );
169 for ( int i = 0; i < static_cast<int>( mFillSymbols.size() ); i++ )
170 {
171 QDomElement fillSymbolElement = document.createElement( u"fillSymbol"_s );
172 fillSymbolElement.setAttribute( u"index"_s, QString::number( i ) );
173 if ( mFillSymbols[i] )
174 {
175 fillSymbolElement.appendChild( QgsSymbolLayerUtils::saveSymbol( QString(), mFillSymbols[i].get(), document, context ) );
176 }
177 fillSymbolsElement.appendChild( fillSymbolElement );
178 }
179 element.appendChild( fillSymbolsElement );
180
181 return true;
182}
183
184bool QgsBarChartPlot::readXml( const QDomElement &element, const QgsReadWriteContext &context )
185{
186 Qgs2DXyPlot::readXml( element, context );
187
188 const QDomNodeList fillSymbolsList = element.firstChildElement( u"fillSymbols"_s ).childNodes();
189 for ( int i = 0; i < fillSymbolsList.count(); i++ )
190 {
191 const QDomElement fillSymbolElement = fillSymbolsList.at( i ).toElement();
192 const int index = fillSymbolElement.attribute( u"index"_s, u"-1"_s ).toInt();
193 if ( index >= 0 )
194 {
195 if ( fillSymbolElement.hasChildNodes() )
196 {
197 const QDomElement symbolElement = fillSymbolElement.firstChildElement( u"symbol"_s );
198 setFillSymbolAt( index, QgsSymbolLayerUtils::loadSymbol< QgsFillSymbol >( symbolElement, context ).release() );
199 }
200 else
201 {
202 setFillSymbolAt( index, nullptr );
203 }
204 }
205 }
206
207 return true;
208}
209
214
216{
217 QgsBarChartPlot *chart = dynamic_cast<QgsBarChartPlot *>( plot );
218 if ( !chart )
219 {
220 return nullptr;
221 }
222
223 return new QgsVectorLayerXyPlotDataGatherer( chart->xAxis().type() );
224}
@ Categorical
The axis represents categories.
Definition qgis.h:3407
@ Interval
The axis represents a range of values.
Definition qgis.h:3406
double yMaximum() const
Returns the maximum value of the y axis.
Definition qgsplot.h:742
double xMinimum() const
Returns the minimum value of the x axis.
Definition qgsplot.h:700
bool readXml(const QDomElement &element, const QgsReadWriteContext &context) override
Reads the plot's properties from an XML element.
Definition qgsplot.cpp:394
void applyDataDefinedProperties(QgsRenderContext &context, double &minX, double &maxX, double &minY, double &maxY, double &majorIntervalX, double &minorIntervalX, double &labelIntervalX, double &majorIntervalY, double &minorIntervalY, double &labelIntervalY) const
Applies 2D XY plot data-defined properties.
Definition qgsplot.cpp:1056
QgsPlotAxis & yAxis()
Returns a reference to the plot's y axis.
Definition qgsplot.h:770
QgsPlotAxis & xAxis()
Returns a reference to the plot's x axis.
Definition qgsplot.h:756
double yMinimum() const
Returns the minimum value of the y axis.
Definition qgsplot.h:714
bool writeXml(QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const override
Writes the plot's properties into an XML element.
Definition qgsplot.cpp:368
double xMaximum() const
Returns the maximum value of the x axis.
Definition qgsplot.h:728
An abstract class used to encapsulate the data for a plot series.
Definition qgsplot.h:204
QString type() const override
Returns the plot's type.
void setFillSymbolAt(int index, QgsFillSymbol *symbol)
Sets the fill symbol to use for the series with matching index.
void renderContent(QgsRenderContext &context, QgsPlotRenderContext &plotContext, const QRectF &plotArea, const QgsPlotData &plotData=QgsPlotData()) override
Renders the plot content.
bool readXml(const QDomElement &element, const QgsReadWriteContext &context) override
Reads the plot's properties from an XML element.
static QgsVectorLayerAbstractPlotDataGatherer * createDataGatherer(QgsPlot *plot)
Returns a new data gatherer for a given bar chart plot.
QgsFillSymbol * fillSymbolAt(int index) const
Returns the fill symbol for the series with matching index.
bool writeXml(QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const override
Writes the plot's properties into an XML element.
static QgsBarChartPlot * create()
Returns a new bar chart.
RAII class to pop scope from an expression context on destruction.
Single scope for storing variables and functions for use within a QgsExpressionContext.
void addVariable(const QgsExpressionContextScope::StaticVariable &variable)
Adds a variable into the context scope.
A fill symbol type, for rendering Polygon and MultiPolygon geometries.
void renderPolygon(const QPolygonF &points, const QVector< QPolygonF > *rings, const QgsFeature *f, QgsRenderContext &context, int layer=-1, bool selected=false)
Renders the symbol using the given render context.
double gridIntervalMinor() const
Returns the interval of minor grid lines for the axis.
Definition qgsplot.h:389
double gridIntervalMajor() const
Returns the interval of major grid lines for the axis.
Definition qgsplot.h:403
Qgis::PlotAxisType type() const
Returns the axis type.
Definition qgsplot.cpp:107
double labelInterval() const
Returns the interval of labels for the axis.
Definition qgsplot.h:417
Encapsulates one or more plot series.
Definition qgsplot.h:300
QStringList categories() const
Returns the name of the series' categories.
Definition qgsplot.cpp:1304
QList< QgsAbstractPlotSeries * > series() const
Returns the list of series forming the plot data.
Definition qgsplot.cpp:1285
static QgsFillSymbol * barChartFillSymbol()
Returns the default fill symbol to use for bar charts.
Definition qgsplot.cpp:1212
Contains information about the context of a plot rendering operation.
Definition qgsplot.h:184
QgsPlot()=default
A container for the context for various read/write operations on objects.
Contains information about the context of a rendering operation.
QPainter * painter()
Returns the destination QPainter for the render operation.
QgsExpressionContext & expressionContext()
Gets the expression context.
static std::unique_ptr< QgsSymbol > loadSymbol(const QDomElement &element, const QgsReadWriteContext &context)
Attempts to load a symbol from a DOM element.
static QDomElement saveSymbol(const QString &symbolName, const QgsSymbol *symbol, QDomDocument &doc, const QgsReadWriteContext &context)
Writes a symbol definition to XML.
void stopRender(QgsRenderContext &context)
Ends the rendering process.
void startRender(QgsRenderContext &context, const QgsFields &fields=QgsFields())
Begins the rendering process for the symbol.
An abstract vector layer plot data gatherer base class.
An vector layer plot data gatherer class for XY series.
Encapsulates the data for an XY plot series.
Definition qgsplot.h:258
Single variable definition for use within a QgsExpressionContextScope.