QGIS API Documentation 3.99.0-Master (357b655ed83)
Loading...
Searching...
No Matches
qgsdoubleboxscalebarrenderer.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsdoubleboxscalebarrenderer.cpp
3 --------------------------------
4 begin : June 2008
5 copyright : (C) 2008 by Marco Hugentobler
7 ***************************************************************************/
8/***************************************************************************
9 * *
10 * This program is free software; you can redistribute it and/or modify *
11 * it under the terms of the GNU General Public License as published by *
12 * the Free Software Foundation; either version 2 of the License, or *
13 * (at your option) any later version. *
14 * *
15 ***************************************************************************/
16
18
19#include "qgsfillsymbol.h"
20#include "qgsfillsymbollayer.h"
21#include "qgslinesymbol.h"
22#include "qgsscalebarsettings.h"
23#include "qgssymbol.h"
24#include "qgstextrenderer.h"
25
26#include <QList>
27#include <QPainter>
28#include <QString>
29
30using namespace Qt::StringLiterals;
31
33{
34 return u"Double Box"_s;
35}
36
38{
39 return QObject::tr( "Double Box" );
40}
41
55
57{
58 return 2;
59}
60
65
66void QgsDoubleBoxScaleBarRenderer::draw( QgsRenderContext &context, const QgsScaleBarSettings &settings, const ScaleBarContext &scaleContext ) const
67{
68 if ( !context.painter() )
69 {
70 return;
71 }
72 QPainter *painter = context.painter();
73
74 const double scaledLabelBarSpace = context.convertToPainterUnits( settings.labelBarSpace(), Qgis::RenderUnit::Millimeters );
75 const double scaledBoxContentSpace = context.convertToPainterUnits( settings.boxContentSpace(), Qgis::RenderUnit::Millimeters );
76 const QFontMetricsF fontMetrics = QgsTextRenderer::fontMetrics( context, settings.textFormat() );
77 const double barTopPosition = scaledBoxContentSpace + ( settings.labelVerticalPlacement() == Qgis::ScaleBarDistanceLabelVerticalPlacement::AboveSegment ? fontMetrics.ascent() + scaledLabelBarSpace : 0 );
78 const double segmentHeight = context.convertToPainterUnits( settings.height() / 2, Qgis::RenderUnit::Millimeters );
79
80 painter->save();
81 context.setPainterFlagsUsingContext( painter );
82
83 std::unique_ptr< QgsLineSymbol > lineSymbol( settings.lineSymbol()->clone() );
84 lineSymbol->startRender( context );
85
86 std::unique_ptr< QgsFillSymbol > fillSymbol1( settings.fillSymbol()->clone() );
87 fillSymbol1->startRender( context );
88
89 std::unique_ptr< QgsFillSymbol > fillSymbol2( settings.alternateFillSymbol()->clone() );
90 fillSymbol2->startRender( context );
91
92 painter->setPen( Qt::NoPen );
93 painter->setBrush( Qt::NoBrush );
94
95 bool useColor = true; //alternate brush color/white
96
97 const double xOffset = firstLabelXOffset( settings, context, scaleContext );
98
99 const QList<double> positions = segmentPositions( context, scaleContext, settings );
100 const QList<double> widths = segmentWidths( scaleContext, settings );
101
102 double minX = 0;
103 double maxX = 0;
104 QgsFillSymbol *currentSymbol = nullptr;
105 for ( int i = 0; i < positions.size(); ++i )
106 {
107 //draw top half
108 if ( useColor )
109 {
110 currentSymbol = fillSymbol1.get();
111 }
112 else //secondary symbol
113 {
114 currentSymbol = fillSymbol2.get();
115 }
116
117 const double thisX = context.convertToPainterUnits( positions.at( i ), Qgis::RenderUnit::Millimeters ) + xOffset;
118 const double thisWidth = context.convertToPainterUnits( widths.at( i ), Qgis::RenderUnit::Millimeters );
119
120 if ( i == 0 )
121 minX = thisX;
122 if ( i == positions.size() - 1 )
123 maxX = thisX + thisWidth;
124
125 const QRectF segmentRectTop( thisX, barTopPosition, thisWidth, segmentHeight );
126 currentSymbol->renderPolygon( QPolygonF()
127 << segmentRectTop.topLeft()
128 << segmentRectTop.topRight()
129 << segmentRectTop.bottomRight()
130 << segmentRectTop.bottomLeft()
131 << segmentRectTop.topLeft(),
132 nullptr, nullptr, context );
133 painter->drawRect( segmentRectTop );
134
135 //draw bottom half
136 if ( useColor )
137 {
138 //secondary symbol
139 currentSymbol = fillSymbol2.get();
140 }
141 else //primary symbol
142 {
143 currentSymbol = fillSymbol1.get(); ;
144 }
145
146 const QRectF segmentRectBottom( thisX, barTopPosition + segmentHeight, thisWidth, segmentHeight );
147
148 currentSymbol->renderPolygon( QPolygonF()
149 << segmentRectBottom.topLeft()
150 << segmentRectBottom.topRight()
151 << segmentRectBottom.bottomRight()
152 << segmentRectBottom.bottomLeft()
153 << segmentRectBottom.topLeft(),
154 nullptr, nullptr, context );
155 useColor = !useColor;
156 }
157
158
159 // and then the lines
160 // note that we do this layer-by-layer, to avoid ugliness where the lines touch the outer rect
161 for ( int layer = 0; layer < lineSymbol->symbolLayerCount(); ++layer )
162 {
163 // vertical lines
164 for ( int i = 1; i < positions.size(); ++i )
165 {
166 const double lineX = context.convertToPainterUnits( positions.at( i ), Qgis::RenderUnit::Millimeters ) + xOffset;
167 lineSymbol->renderPolyline( QPolygonF()
168 << QPointF( lineX, barTopPosition )
169 << QPointF( lineX, barTopPosition + segmentHeight * 2 ),
170 nullptr, context, layer );
171 }
172
173 // middle horizontal line
174 lineSymbol->renderPolyline( QPolygonF()
175 << QPointF( minX, barTopPosition + segmentHeight )
176 << QPointF( maxX, barTopPosition + segmentHeight ),
177 nullptr, context, layer );
178
179
180 // outside line
181 lineSymbol->renderPolyline( QPolygonF()
182 << QPointF( minX, barTopPosition )
183 << QPointF( maxX, barTopPosition )
184 << QPointF( maxX, barTopPosition + segmentHeight * 2 )
185 << QPointF( minX, barTopPosition + segmentHeight * 2 )
186 << QPointF( minX, barTopPosition ),
187 nullptr, context, layer );
188 }
189
190 lineSymbol->stopRender( context );
191 fillSymbol1->stopRender( context );
192 fillSymbol2->stopRender( context );
193
194 painter->restore();
195
196 //draw labels using the default method
197 drawDefaultLabels( context, settings, scaleContext );
198}
199
201{
202 QgsSimpleFillSymbolLayer *fill = dynamic_cast< QgsSimpleFillSymbolLayer * >( settings.fillSymbol()->symbolLayers().at( 0 ) );
203
204 // restore the fill symbols by default
205 if ( fill && fill->brushStyle() == Qt::NoBrush )
206 {
207 auto fillSymbol = std::make_unique< QgsFillSymbol >();
208 auto fillSymbolLayer = std::make_unique< QgsSimpleFillSymbolLayer >();
209 fillSymbolLayer->setColor( QColor( 0, 0, 0 ) );
210 fillSymbolLayer->setBrushStyle( Qt::SolidPattern );
211 fillSymbolLayer->setStrokeStyle( Qt::SolidLine );
212 fillSymbol->changeSymbolLayer( 0, fillSymbolLayer.release() );
213 settings.setFillSymbol( fillSymbol.release() );
214
215 fillSymbol = std::make_unique< QgsFillSymbol >();
216 fillSymbolLayer = std::make_unique< QgsSimpleFillSymbolLayer >();
217 fillSymbolLayer->setColor( QColor( 255, 255, 255 ) );
218 fillSymbolLayer->setStrokeStyle( Qt::NoPen );
219 fillSymbol->changeSymbolLayer( 0, fillSymbolLayer.release() );
220 settings.setAlternateFillSymbol( fillSymbol.release() );
221 }
222
223 return true;
224}
@ AboveSegment
Labels are drawn above the scalebar.
Definition qgis.h:5439
@ Millimeters
Millimeters.
Definition qgis.h:5291
Flags flags() const override
Returns the scalebar rendering flags, which dictates the renderer's behavior.
void draw(QgsRenderContext &context, const QgsScaleBarSettings &settings, const QgsScaleBarRenderer::ScaleBarContext &scaleContext) const override
Draws the scalebar using the specified settings and scaleContext to a destination render context.
bool applyDefaultSettings(QgsScaleBarSettings &settings) const override
Applies any default settings relating to the scalebar to the passed settings object.
QString id() const override
Returns the unique ID for this renderer.
QString visibleName() const override
Returns the user friendly, translated name for the renderer.
QgsDoubleBoxScaleBarRenderer * clone() const override
Returns a clone of the renderer.
int sortKey() const override
Returns a sorting key value, where renderers with a lower sort key will be shown earlier in lists.
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.
QgsFillSymbol * clone() const override
Returns a deep copy of this symbol.
QgsLineSymbol * clone() const override
Returns a deep copy of this symbol.
Contains information about the context of a rendering operation.
double convertToPainterUnits(double size, Qgis::RenderUnit unit, const QgsMapUnitScale &scale=QgsMapUnitScale(), Qgis::RenderSubcomponentProperty property=Qgis::RenderSubcomponentProperty::Generic) const
Converts a size from the specified units to painter units (pixels).
QPainter * painter()
Returns the destination QPainter for the render operation.
void setPainterFlagsUsingContext(QPainter *painter=nullptr) const
Sets relevant flags on a destination painter, using the flags and settings currently defined for the ...
void drawDefaultLabels(QgsRenderContext &context, const QgsScaleBarSettings &settings, const QgsScaleBarRenderer::ScaleBarContext &scaleContext) const
Draws default scalebar labels using the specified settings and scaleContext to a destination render c...
QList< double > segmentWidths(const QgsScaleBarRenderer::ScaleBarContext &scaleContext, const QgsScaleBarSettings &settings) const
Returns a list of widths of each segment of the scalebar.
Q_DECL_DEPRECATED QList< double > segmentPositions(const QgsScaleBarRenderer::ScaleBarContext &scaleContext, const QgsScaleBarSettings &settings) const
Returns a list of positions for each segment within the scalebar.
Q_DECL_DEPRECATED double firstLabelXOffset(const QgsScaleBarSettings &settings) const
Returns the x-offset (in millimeters) used for the first label in the scalebar.
@ FlagUsesLabelVerticalPlacement
Renderer uses the QgsScaleBarSettings::labelVerticalPlacement() setting.
@ FlagUsesLabelHorizontalPlacement
Renderer uses the QgsScaleBarSettings::labelHorizontalPlacement() setting.
@ FlagUsesLineSymbol
Renderer utilizes the scalebar line symbol (see QgsScaleBarSettings::lineSymbol() ).
@ FlagUsesUnitLabel
Renderer uses the QgsScaleBarSettings::unitLabel() setting.
@ FlagUsesSegments
Renderer uses the scalebar segments.
@ FlagUsesLabelBarSpace
Renderer uses the QgsScaleBarSettings::labelBarSpace() setting.
@ FlagUsesFillSymbol
Renderer utilizes the scalebar fill symbol (see QgsScaleBarSettings::fillSymbol() ).
@ FlagRespectsMapUnitsPerScaleBarUnit
Renderer respects the QgsScaleBarSettings::mapUnitsPerScaleBarUnit() setting.
@ FlagRespectsUnits
Renderer respects the QgsScaleBarSettings::units() setting.
@ FlagUsesAlternateFillSymbol
Renderer utilizes the alternate scalebar fill symbol (see QgsScaleBarSettings::alternateFillSymbol() ...
Stores the appearance and layout settings for scalebar drawing with QgsScaleBarRenderer.
QgsLineSymbol * lineSymbol() const
Returns the line symbol used to render the scalebar (only used for some scalebar types).
void setAlternateFillSymbol(QgsFillSymbol *symbol)
Sets the secondary fill symbol used to render the scalebar (only used for some scalebar types).
Qgis::ScaleBarDistanceLabelVerticalPlacement labelVerticalPlacement() const
Returns the vertical placement of text labels.
void setFillSymbol(QgsFillSymbol *symbol)
Sets the primary fill symbol used to render the scalebar (only used for some scalebar types).
QgsTextFormat & textFormat()
Returns the text format used for drawing text in the scalebar.
double boxContentSpace() const
Returns the spacing (margin) between the scalebar box and content in millimeters.
QgsFillSymbol * alternateFillSymbol() const
Returns the secondary fill symbol used to render the scalebar (only used for some scalebar types).
QgsFillSymbol * fillSymbol() const
Returns the primary fill symbol used to render the scalebar (only used for some scalebar types).
double labelBarSpace() const
Returns the spacing (in millimeters) between labels and the scalebar.
double height() const
Returns the scalebar height (in millimeters).
Renders polygons using a single fill and stroke color.
Qt::BrushStyle brushStyle() const
static QFontMetricsF fontMetrics(QgsRenderContext &context, const QgsTextFormat &format, double scaleFactor=1.0)
Returns the font metrics for the given text format, when rendered in the specified render context.
Contains parameters regarding scalebar calculations.