QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgssteppedlinescalebarrenderer.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgssteppedlinescalebarrenderer.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#include "qgsscalebarsettings.h"
19#include "qgssymbol.h"
20#include "qgstextrenderer.h"
21#include "qgslinesymbol.h"
22#include <QList>
23#include <QPainter>
24
26{
27 return QStringLiteral( "stepped" );
28}
29
31{
32 return QObject::tr( "Stepped Line" );
33}
34
36{
37 return 7;
38}
39
41{
50}
51
53{
54 return new QgsSteppedLineScaleBarRenderer( *this );
55}
56
57void QgsSteppedLineScaleBarRenderer::draw( QgsRenderContext &context, const QgsScaleBarSettings &settings, const ScaleBarContext &scaleContext ) const
58{
59 if ( !context.painter() )
60 {
61 return;
62 }
63 QPainter *painter = context.painter();
64
65 std::unique_ptr< QgsLineSymbol > sym( settings.lineSymbol()->clone() );
66 sym->startRender( context ) ;
67
68 const double scaledLabelBarSpace = context.convertToPainterUnits( settings.labelBarSpace(), Qgis::RenderUnit::Millimeters );
69 const double scaledBoxContentSpace = context.convertToPainterUnits( settings.boxContentSpace(), Qgis::RenderUnit::Millimeters );
70 const QFontMetricsF fontMetrics = QgsTextRenderer::fontMetrics( context, settings.textFormat() );
71 const double barTopPosition = scaledBoxContentSpace + ( settings.labelVerticalPlacement() == QgsScaleBarSettings::LabelAboveSegment ? fontMetrics.ascent() + scaledLabelBarSpace : 0 );
72 const double barBottomPosition = barTopPosition + context.convertToPainterUnits( settings.height(), Qgis::RenderUnit::Millimeters );
73
74 painter->save();
75 context.setPainterFlagsUsingContext( painter );
76
77 painter->setPen( Qt::NoPen );
78
79 const double xOffset = firstLabelXOffset( settings, context, scaleContext );
80
81 const QList<double> positions = segmentPositions( context, scaleContext, settings );
82 const QList<double> widths = segmentWidths( scaleContext, settings );
83
84 QPolygonF points;
85
86 for ( int i = 0; i < positions.size() + 1; ++i )
87 {
88 // we render one extra place, corresponding to the final position + width (i.e. the "end" of the bar)
89 const double x = i < positions.size() ? context.convertToPainterUnits( positions.at( i ), Qgis::RenderUnit::Millimeters ) + xOffset
90 : context.convertToPainterUnits( positions.at( i - 1 ), Qgis::RenderUnit::Millimeters ) + xOffset + context.convertToPainterUnits( widths.at( i - 1 ), Qgis::RenderUnit::Millimeters );
91 if ( i % 2 == 0 )
92 {
93 points << QPointF( x, barBottomPosition ) << QPointF( x, barTopPosition );
94 }
95 else
96 {
97 points << QPointF( x, barTopPosition ) << QPointF( x, barBottomPosition ) ;
98 }
99 }
100
101 sym->renderPolyline( points, nullptr, context );
102
103 painter->restore();
104
105 sym->stopRender( context );
106
107 //draw labels using the default method
108 drawDefaultLabels( context, settings, scaleContext );
109}
110
111
112
@ Millimeters
Millimeters.
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.
@ FlagRespectsMapUnitsPerScaleBarUnit
Renderer respects the QgsScaleBarSettings::mapUnitsPerScaleBarUnit() setting.
@ FlagRespectsUnits
Renderer respects the QgsScaleBarSettings::units() setting.
The QgsScaleBarSettings class stores the appearance and layout settings for scalebar drawing with Qgs...
QgsLineSymbol * lineSymbol() const
Returns the line 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.
LabelVerticalPlacement labelVerticalPlacement() const
Returns the vertical placement of text labels.
@ LabelAboveSegment
Labels are drawn above the scalebar.
double labelBarSpace() const
Returns the spacing (in millimeters) between labels and the scalebar.
double height() const
Returns the scalebar height (in millimeters).
Scalebar style that draws a stepped line representation of a scalebar.
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.
int sortKey() const override
Returns a sorting key value, where renderers with a lower sort key will be shown earlier in lists.
QgsSteppedLineScaleBarRenderer()=default
Constructor for QgsSteppedLineScaleBarRenderer.
Flags flags() const override
Returns the scalebar rendering flags, which dictates the renderer's behavior.
QgsSteppedLineScaleBarRenderer * clone() const override
Returns a clone of the renderer.
QString visibleName() const override
Returns the user friendly, translated name for the renderer.
QString id() const override
Returns the unique ID for this renderer.
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.