QGIS API Documentation 4.3.0-Master (3b7b3208a79)
Loading...
Searching...
No Matches
qgssingleboxscalebarrenderer.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgssingleboxscalebarrenderer.cpp
3 --------------------------------
4 begin : June 2008
5 copyright : (C) 2008 by Marco Hugentobler
6 email : marco.hugentobler@karto.baug.ethz.ch
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 "qgspainting.h"
23#include "qgsscalebarsettings.h"
24#include "qgssymbol.h"
25#include "qgstextrenderer.h"
26
27#include <QList>
28#include <QPainter>
29#include <QString>
30
31using namespace Qt::StringLiterals;
32
34{
35 return u"Single Box"_s;
36}
37
39{
40 return QObject::tr( "Single Box" );
41}
42
44{
45 return 1;
46}
47
61
66
67void QgsSingleBoxScaleBarRenderer::draw( QgsRenderContext &context, const QgsScaleBarSettings &settings, const ScaleBarContext &scaleContext ) const
68{
69 if ( !context.painter() )
70 {
71 return;
72 }
73 QPainter *painter = context.painter();
74
75 const double barTopPosition = verticalOffset( context, settings );
76 const double barHeight = context.convertToPainterUnits( settings.height(), Qgis::RenderUnit::Millimeters );
77
78 QgsScopedQPainterState painterState( painter );
79 context.setPainterFlagsUsingContext( painter );
80
81 std::unique_ptr< QgsLineSymbol > lineSymbol( settings.lineSymbol()->clone() );
82 lineSymbol->startRender( context );
83
84 std::unique_ptr< QgsFillSymbol > fillSymbol1( settings.fillSymbol()->clone() );
85 fillSymbol1->startRender( context );
86
87 std::unique_ptr< QgsFillSymbol > fillSymbol2( settings.alternateFillSymbol()->clone() );
88 fillSymbol2->startRender( context );
89
90 painter->setPen( Qt::NoPen );
91 painter->setBrush( Qt::NoBrush );
92
93 bool useColor = true; //alternate brush color/white
94 const double xOffset = firstLabelXOffset( settings, context, scaleContext );
95
96 const QList<double> positions = segmentPositions( context, scaleContext, settings );
97 const QList<double> widths = segmentWidths( scaleContext, settings );
98
99 // draw the fill
100 double minX = 0;
101 double maxX = 0;
102 QgsFillSymbol *currentSymbol = nullptr;
103 for ( int i = 0; i < positions.size(); ++i )
104 {
105 if ( useColor ) //alternating colors
106 {
107 currentSymbol = fillSymbol1.get();
108 }
109 else //secondary fill
110 {
111 currentSymbol = fillSymbol2.get();
112 }
113
114 const double thisX = context.convertToPainterUnits( positions.at( i ), Qgis::RenderUnit::Millimeters ) + xOffset;
115 const double thisWidth = context.convertToPainterUnits( widths.at( i ), Qgis::RenderUnit::Millimeters );
116
117 if ( i == 0 )
118 minX = thisX;
119 if ( i == positions.size() - 1 )
120 maxX = thisX + thisWidth;
121
122 const QRectF segmentRect( thisX, barTopPosition, thisWidth, barHeight );
123 currentSymbol->renderPolygon( QPolygonF() << segmentRect.topLeft() << segmentRect.topRight() << segmentRect.bottomRight() << segmentRect.bottomLeft() << segmentRect.topLeft(), nullptr, nullptr, context );
124 useColor = !useColor;
125 }
126
127 // and then the lines
128 // note that we do this layer-by-layer, to avoid ugliness where the lines touch the outer rect
129 for ( int layer = 0; layer < lineSymbol->symbolLayerCount(); ++layer )
130 {
131 for ( int i = 1; i < positions.size(); ++i )
132 {
133 const double lineX = context.convertToPainterUnits( positions.at( i ), Qgis::RenderUnit::Millimeters ) + xOffset;
134 lineSymbol->renderPolyline( QPolygonF() << QPointF( lineX, barTopPosition ) << QPointF( lineX, barTopPosition + barHeight ), nullptr, context, layer );
135 }
136
137 // outside line
138 lineSymbol->renderPolyline(
139 QPolygonF() << QPointF( minX, barTopPosition ) << QPointF( maxX, barTopPosition ) << QPointF( maxX, barTopPosition + barHeight ) << QPointF( minX, barTopPosition + barHeight ) << QPointF( minX, barTopPosition ),
140 nullptr,
141 context,
142 layer
143 );
144 }
145
146 lineSymbol->stopRender( context );
147 fillSymbol1->stopRender( context );
148 fillSymbol2->stopRender( context );
149
150 painterState.restore();
151
152 //draw labels using the default method
153 drawDefaultLabels( context, settings, scaleContext );
154}
155
157{
158 QgsSimpleFillSymbolLayer *fill = dynamic_cast< QgsSimpleFillSymbolLayer * >( settings.fillSymbol()->symbolLayers().at( 0 ) );
159
160 // restore the fill symbols by default
161 if ( fill && fill->brushStyle() == Qt::NoBrush )
162 {
163 auto fillSymbol = std::make_unique< QgsFillSymbol >();
164 auto fillSymbolLayer = std::make_unique< QgsSimpleFillSymbolLayer >();
165 fillSymbolLayer->setColor( QColor( 0, 0, 0 ) );
166 fillSymbolLayer->setBrushStyle( Qt::SolidPattern );
167 fillSymbolLayer->setStrokeStyle( Qt::SolidLine );
168 fillSymbol->changeSymbolLayer( 0, fillSymbolLayer.release() );
169 settings.setFillSymbol( fillSymbol.release() );
170
171 fillSymbol = std::make_unique< QgsFillSymbol >();
172 fillSymbolLayer = std::make_unique< QgsSimpleFillSymbolLayer >();
173 fillSymbolLayer->setColor( QColor( 255, 255, 255 ) );
174 fillSymbolLayer->setStrokeStyle( Qt::NoPen );
175 fillSymbol->changeSymbolLayer( 0, fillSymbolLayer.release() );
176 settings.setAlternateFillSymbol( fillSymbol.release() );
177 }
178
179 return true;
180}
@ Millimeters
Millimeters.
Definition qgis.h:5759
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 ...
double verticalOffset(QgsRenderContext &context, const QgsScaleBarSettings &settings) const
Calculates the vertical offset to the top of the bar, accounting for text placed above the bar.
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).
void setFillSymbol(QgsFillSymbol *symbol)
Sets the primary fill symbol used to render the scalebar (only used for some scalebar types).
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 height() const
Returns the scalebar height (in millimeters).
Scoped object for saving and restoring a QPainter object's state.
void restore()
Performs a manual restore on the painter state, popping the latest state from the painter.
Renders polygons using a single fill and stroke color.
Qt::BrushStyle brushStyle() const
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.
int sortKey() const override
Returns a sorting key value, where renderers with a lower sort key will be shown earlier in lists.
Flags flags() const override
Returns the scalebar rendering flags, which dictates the renderer's behavior.
QgsSingleBoxScaleBarRenderer * clone() const override
Returns a clone of the renderer.
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.
Contains parameters regarding scalebar calculations.