QGIS API Documentation 3.99.0-Master (2fe06baccd8)
Loading...
Searching...
No Matches
qgshollowscalebarrenderer.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgshollowscalebarrenderer.cpp
3 --------------------------------
4 begin : March 2020
5 copyright : (C) 2020 by Nyall Dawson
6 email : nyall dot dawson at gmail dot com
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
30{
31 return QStringLiteral( "hollow" );
32}
33
35{
36 return QObject::tr( "Hollow" );
37}
38
52
54{
55 return 8;
56}
57
62
63void QgsHollowScaleBarRenderer::draw( QgsRenderContext &context, const QgsScaleBarSettings &settings, const ScaleBarContext &scaleContext ) const
64{
65 if ( !context.painter() )
66 {
67 return;
68 }
69 QPainter *painter = context.painter();
70
71 const double scaledLabelBarSpace = context.convertToPainterUnits( settings.labelBarSpace(), Qgis::RenderUnit::Millimeters );
72 const double scaledBoxContentSpace = context.convertToPainterUnits( settings.boxContentSpace(), Qgis::RenderUnit::Millimeters );
73 const QFontMetricsF fontMetrics = QgsTextRenderer::fontMetrics( context, settings.textFormat() );
74 const double barTopPosition = scaledBoxContentSpace + ( settings.labelVerticalPlacement() == Qgis::ScaleBarDistanceLabelVerticalPlacement::AboveSegment ? fontMetrics.ascent() + scaledLabelBarSpace : 0 );
75 const double barHeight = context.convertToPainterUnits( settings.height(), Qgis::RenderUnit::Millimeters );
76
77 painter->save();
78 context.setPainterFlagsUsingContext( painter );
79
80 std::unique_ptr< QgsLineSymbol > lineSymbol( settings.lineSymbol()->clone() );
81 lineSymbol->startRender( context );
82
83 std::unique_ptr< QgsFillSymbol > fillSymbol1( settings.fillSymbol()->clone() );
84 fillSymbol1->startRender( context );
85
86 std::unique_ptr< QgsFillSymbol > fillSymbol2( settings.alternateFillSymbol()->clone() );
87 fillSymbol2->startRender( context );
88
89 painter->setPen( Qt::NoPen );
90 painter->setBrush( Qt::NoBrush );
91
92 bool useColor = true; //alternate brush color/white
93 const double xOffset = firstLabelXOffset( settings, context, scaleContext );
94
95 const QList<double> positions = segmentPositions( context, scaleContext, settings );
96 const QList<double> widths = segmentWidths( scaleContext, settings );
97
98 // draw the fill
99 double minX = 0;
100 double maxX = 0;
101 QgsFillSymbol *currentSymbol = nullptr;
102 for ( int i = 0; i < positions.size(); ++i )
103 {
104 if ( useColor ) //alternating colors
105 {
106 currentSymbol = fillSymbol1.get();
107 }
108 else //secondary fill
109 {
110 currentSymbol = fillSymbol2.get();
111 }
112
113 const double thisX = context.convertToPainterUnits( positions.at( i ), Qgis::RenderUnit::Millimeters ) + xOffset;
114 const double thisWidth = context.convertToPainterUnits( widths.at( i ), Qgis::RenderUnit::Millimeters );
115
116 if ( i == 0 )
117 minX = thisX;
118 if ( i == positions.size() - 1 )
119 maxX = thisX + thisWidth;
120
121 const QRectF segmentRect( thisX, barTopPosition, thisWidth, barHeight );
122 currentSymbol->renderPolygon( QPolygonF()
123 << segmentRect.topLeft()
124 << segmentRect.topRight()
125 << segmentRect.bottomRight()
126 << segmentRect.bottomLeft()
127 << segmentRect.topLeft(), nullptr, nullptr, context );
128 useColor = !useColor;
129 }
130
131 // and then the lines
132 // note that we do this layer-by-layer, to avoid ugliness where the lines touch the outer rect
133 for ( int layer = 0; layer < lineSymbol->symbolLayerCount(); ++layer )
134 {
135 // horizontal lines
136 bool drawLine = false;
137 for ( int i = 0; i < positions.size(); ++i )
138 {
139 drawLine = !drawLine;
140 if ( !drawLine )
141 continue;
142
143 const double lineX = context.convertToPainterUnits( positions.at( i ), Qgis::RenderUnit::Millimeters ) + xOffset;
144 const double lineLength = context.convertToPainterUnits( widths.at( i ), Qgis::RenderUnit::Millimeters );
145 lineSymbol->renderPolyline( QPolygonF()
146 << QPointF( lineX, barTopPosition + barHeight / 2.0 )
147 << QPointF( lineX + lineLength, barTopPosition + barHeight / 2.0 ),
148 nullptr, context, layer );
149 }
150
151 // vertical lines
152 for ( int i = 1; i < positions.size(); ++i )
153 {
154 const double lineX = context.convertToPainterUnits( positions.at( i ), Qgis::RenderUnit::Millimeters ) + xOffset;
155 lineSymbol->renderPolyline( QPolygonF()
156 << QPointF( lineX, barTopPosition )
157 << QPointF( lineX, barTopPosition + barHeight ),
158 nullptr, context, layer );
159 }
160
161 // outside line
162 lineSymbol->renderPolyline( QPolygonF()
163 << QPointF( minX, barTopPosition )
164 << QPointF( maxX, barTopPosition )
165 << QPointF( maxX, barTopPosition + barHeight )
166 << QPointF( minX, barTopPosition + barHeight )
167 << QPointF( minX, barTopPosition ),
168 nullptr, context, layer );
169 }
170
171 lineSymbol->stopRender( context );
172 fillSymbol1->stopRender( context );
173 fillSymbol2->stopRender( context );
174 painter->restore();
175
176 //draw labels using the default method
177 drawDefaultLabels( context, settings, scaleContext );
178}
179
181{
182 // null the fill symbols by default
183 auto fillSymbol = std::make_unique< QgsFillSymbol >();
184 auto fillSymbolLayer = std::make_unique< QgsSimpleFillSymbolLayer >();
185 fillSymbolLayer->setColor( QColor( 0, 0, 0 ) );
186 fillSymbolLayer->setBrushStyle( Qt::NoBrush );
187 fillSymbolLayer->setStrokeStyle( Qt::NoPen );
188 fillSymbol->changeSymbolLayer( 0, fillSymbolLayer->clone() );
189 settings.setFillSymbol( fillSymbol.release() );
190
191 fillSymbol = std::make_unique< QgsFillSymbol >();
192 fillSymbolLayer->setColor( QColor( 255, 255, 255 ) );
193 fillSymbol->changeSymbolLayer( 0, fillSymbolLayer.release() );
194 settings.setAlternateFillSymbol( fillSymbol.release() );
195
196 return true;
197}
@ AboveSegment
Labels are drawn above the scalebar.
Definition qgis.h:5332
@ Millimeters
Millimeters.
Definition qgis.h:5184
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.
int sortKey() const override
Returns a sorting key value, where renderers with a lower sort key will be shown earlier in lists.
bool applyDefaultSettings(QgsScaleBarSettings &settings) const override
Applies any default settings relating to the scalebar to the passed settings object.
QgsHollowScaleBarRenderer * clone() const override
Returns a clone of the renderer.
QString visibleName() const override
Returns the user friendly, translated name for the renderer.
QgsHollowScaleBarRenderer()=default
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.
QString id() const override
Returns the unique ID for this renderer.
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).
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.