QGIS API Documentation 3.43.0-Master (b60ef06885e)
qgssymbolrendercontext.h
Go to the documentation of this file.
1/***************************************************************************
2 qgssymbolrendercontext.h
3 ---------------------
4 begin : November 2009
5 copyright : (C) 2009 by Martin Dobias
6 email : wonder dot sk at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#ifndef QGSSYMBOLRENDERCONTEXT_H
17#define QGSSYMBOLRENDERCONTEXT_H
18
19#include "qgis_core.h"
20#include "qgis.h"
21#include "qgsmapunitscale.h"
22#include "qgsfields.h"
23
25class QgsFeature;
28
34class CORE_EXPORT QgsSymbolRenderContext
35{
36 public:
37
38 //TODO QGIS 4.0 - remove mapUnitScale and renderunit
39
51 QgsSymbolRenderContext( QgsRenderContext &c, Qgis::RenderUnit u, qreal opacity = 1.0, bool selected = false, Qgis::SymbolRenderHints renderHints = Qgis::SymbolRenderHints(), const QgsFeature *f = nullptr, const QgsFields &fields = QgsFields(), const QgsMapUnitScale &mapUnitScale = QgsMapUnitScale() );
52
54
56
60 QgsRenderContext &renderContext() { return mRenderContext; }
61
66 const QgsRenderContext &renderContext() const SIP_SKIP { return mRenderContext; }
67
73 void setOriginalValueVariable( const QVariant &value );
74
79 Q_DECL_DEPRECATED Qgis::RenderUnit outputUnit() const SIP_DEPRECATED { return mOutputUnit; }
80
85 Q_DECL_DEPRECATED void setOutputUnit( Qgis::RenderUnit u ) SIP_DEPRECATED { mOutputUnit = u; }
86
90 Q_DECL_DEPRECATED QgsMapUnitScale mapUnitScale() const SIP_DEPRECATED { return mMapUnitScale; }
91
95 Q_DECL_DEPRECATED void setMapUnitScale( const QgsMapUnitScale &scale ) SIP_DEPRECATED { mMapUnitScale = scale; }
96
102 qreal opacity() const { return mOpacity; }
103
109 void setOpacity( qreal opacity ) { mOpacity = opacity; }
110
115 bool selected() const { return mSelected; }
116
121 void setSelected( bool selected ) { mSelected = selected; }
122
127 Qgis::SymbolRenderHints renderHints() const { return mRenderHints; }
128
135 bool forceVectorRendering() const;
136
141 void setRenderHints( Qgis::SymbolRenderHints hints ) { mRenderHints = hints; }
142
149 void setRenderHint( Qgis::SymbolRenderHint hint, bool enabled = true ) { mRenderHints.setFlag( hint, enabled ); }
150
151 void setFeature( const QgsFeature *f ) { mFeature = f; }
152
156 const QgsFeature *feature() const { return mFeature; }
157
162 void setOriginalGeometryType( Qgis::GeometryType type ) { mOriginalGeometryType = type; }
163
171 Qgis::GeometryType originalGeometryType() const { return mOriginalGeometryType; }
172
178 QgsFields fields() const { return mFields; }
179
183 int geometryPartCount() const { return mGeometryPartCount; }
184
188 void setGeometryPartCount( int count ) { mGeometryPartCount = count; }
189
193 int geometryPartNum() const { return mGeometryPartNum; }
194
198 void setGeometryPartNum( int num ) { mGeometryPartNum = num; }
199
203 Q_DECL_DEPRECATED double outputLineWidth( double width ) const SIP_DEPRECATED;
204
208 Q_DECL_DEPRECATED double outputPixelSize( double size ) const SIP_DEPRECATED;
209
210 // workaround for sip 4.7. Don't use assignment - will fail with assertion error
212
218 QgsExpressionContextScope *expressionContextScope();
219
227 void setExpressionContextScope( QgsExpressionContextScope *contextScope SIP_TRANSFER );
228
235 const QgsLegendPatchShape *patchShape() const;
236
243 void setPatchShape( const QgsLegendPatchShape &shape );
244
245 private:
246
247#ifdef SIP_RUN
249#endif
250
251 QgsRenderContext &mRenderContext;
252 std::unique_ptr< QgsExpressionContextScope > mExpressionContextScope;
253 Qgis::RenderUnit mOutputUnit;
254 QgsMapUnitScale mMapUnitScale;
255 qreal mOpacity = 1.0;
256 bool mSelected;
257 Qgis::SymbolRenderHints mRenderHints;
258 const QgsFeature *mFeature; //current feature
259 QgsFields mFields;
260 int mGeometryPartCount;
261 int mGeometryPartNum;
262 Qgis::GeometryType mOriginalGeometryType = Qgis::GeometryType::Unknown;
263 std::unique_ptr< QgsLegendPatchShape > mPatchShape;
264};
265
266
267#endif // QGSSYMBOLRENDERCONTEXT_H
268
SymbolRenderHint
Flags controlling behavior of symbols during rendering.
Definition qgis.h:733
GeometryType
The geometry types are used to group Qgis::WkbType in a coarse way.
Definition qgis.h:337
@ Unknown
Unknown types.
RenderUnit
Rendering size units.
Definition qgis.h:5013
QFlags< SymbolRenderHint > SymbolRenderHints
Symbol render hints.
Definition qgis.h:741
Single scope for storing variables and functions for use within a QgsExpressionContext.
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:58
Container of fields for a vector layer.
Definition qgsfields.h:46
Represents a patch shape for use in map legends.
Struct for storing maximum and minimum scales for measurements in map units.
Contains information about the context of a rendering operation.
Encapsulates the context in which a symbol is being rendered.
void setOpacity(qreal opacity)
Sets the opacity for the symbol.
void setRenderHint(Qgis::SymbolRenderHint hint, bool enabled=true)
Sets a rendering hint flag for the symbol.
const QgsFeature * feature() const
Returns the current feature being rendered.
Q_DECL_DEPRECATED void setMapUnitScale(const QgsMapUnitScale &scale)
Qgis::GeometryType originalGeometryType() const
Returns the geometry type for the original feature geometry being rendered.
QgsFields fields() const
Fields of the layer.
void setSelected(bool selected)
Sets whether symbols should be rendered using the selected symbol coloring and style.
void setOriginalGeometryType(Qgis::GeometryType type)
Sets the geometry type for the original feature geometry being rendered.
int geometryPartNum() const
Part number of current geometry.
bool selected() const
Returns true if symbols should be rendered using the selected symbol coloring and style.
Qgis::SymbolRenderHints renderHints() const
Returns the rendering hint flags for the symbol.
Q_DECL_DEPRECATED QgsMapUnitScale mapUnitScale() const
int geometryPartCount() const
Part count of current geometry.
void setRenderHints(Qgis::SymbolRenderHints hints)
Sets rendering hint flags for the symbol.
void setGeometryPartCount(int count)
Sets the part count of current geometry.
const QgsRenderContext & renderContext() const
Returns a reference to the context's render context.
void setGeometryPartNum(int num)
Sets the part number of current geometry.
Q_DECL_DEPRECATED Qgis::RenderUnit outputUnit() const
Returns the output unit for the context.
QgsSymbolRenderContext(const QgsSymbolRenderContext &rh)=delete
Q_DECL_DEPRECATED void setOutputUnit(Qgis::RenderUnit u)
Sets the output unit for the context.
void setFeature(const QgsFeature *f)
qreal opacity() const
Returns the opacity for the symbol.
QgsRenderContext & renderContext()
Returns a reference to the context's render context.
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into c
#define SIP_DEPRECATED
Definition qgis_sip.h:106
#define SIP_FORCE
Definition qgis_sip.h:131
#define SIP_SKIP
Definition qgis_sip.h:126
#define SIP_TRANSFER
Definition qgis_sip.h:36