QGIS API Documentation  2.15.0-Master (5773d0d)
qgspointdisplacementrenderer.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgspointdisplacementrenderer.cpp
3  --------------------------------
4  begin : January 26, 2010
5  copyright : (C) 2010 by Marco Hugentobler
6  email : marco at hugis dot net
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 
18 #ifndef QGSPOINTDISPLACEMENTRENDERER_H
19 #define QGSPOINTDISPLACEMENTRENDERER_H
20 
21 #include "qgsfeature.h"
22 #include "qgssymbolv2.h"
23 #include "qgspoint.h"
24 #include "qgsrendererv2.h"
25 #include <QFont>
26 #include <QSet>
27 
28 class QgsSpatialIndex;
29 
32 {
33  public:
34 
37  enum Placement
38  {
39  Ring,
40  ConcentricRings
41  };
42 
43  QgsPointDisplacementRenderer( const QString& labelAttributeName = "" );
45 
46  QgsPointDisplacementRenderer* clone() const override;
47 
48  virtual void toSld( QDomDocument& doc, QDomElement &element ) const override;
49 
51  bool renderFeature( QgsFeature& feature, QgsRenderContext& context, int layer = -1, bool selected = false, bool drawVertexMarker = false ) override;
52 
54  virtual QList<QString> usedAttributes() override;
56  virtual int capabilities() override;
60  virtual QgsSymbolV2List symbols( QgsRenderContext& context ) override;
64  virtual QgsSymbolV2* symbolForFeature( QgsFeature& feature, QgsRenderContext& context ) override;
68  virtual QgsSymbolV2* originalSymbolForFeature( QgsFeature& feat, QgsRenderContext& context ) override;
72  virtual QgsSymbolV2List symbolsForFeature( QgsFeature& feat, QgsRenderContext& context ) override;
76  virtual QgsSymbolV2List originalSymbolsForFeature( QgsFeature& feat, QgsRenderContext& context ) override;
80  virtual bool willRenderFeature( QgsFeature& feat, QgsRenderContext& context ) override;
81 
82  virtual void startRender( QgsRenderContext& context, const QgsFields& fields ) override;
83 
84  void stopRender( QgsRenderContext& context ) override;
85 
87  static QgsFeatureRendererV2* create( QDomElement& symbologyElem );
88  QDomElement save( QDomDocument& doc ) override;
89 
91 
93  QgsLegendSymbolList legendSymbolItems( double scaleDenominator = -1, const QString& rule = "" ) override;
94 
95  void setLabelAttributeName( const QString& name ) { mLabelAttributeName = name; }
96  QString labelAttributeName() const { return mLabelAttributeName; }
97 
99  void setEmbeddedRenderer( QgsFeatureRendererV2* r );
100  QgsFeatureRendererV2* embeddedRenderer() const { return mRenderer;}
101 
104  Q_DECL_DEPRECATED void setDisplacementGroups( const QList<QMap<QgsFeatureId, QgsFeature> >& list ) { Q_UNUSED( list ); }
105 
106  void setLabelFont( const QFont& f ) { mLabelFont = f; }
107  QFont labelFont() const { return mLabelFont;}
108 
109  void setCircleWidth( double w ) { mCircleWidth = w; }
110  double circleWidth() const { return mCircleWidth; }
111 
112  void setCircleColor( const QColor& c ) { mCircleColor = c; }
113  QColor circleColor() const { return mCircleColor; }
114 
115  void setLabelColor( const QColor& c ) { mLabelColor = c;}
116  QColor labelColor() const { return mLabelColor; }
117 
118  void setCircleRadiusAddition( double d ) { mCircleRadiusAddition = d; }
119  double circleRadiusAddition() const { return mCircleRadiusAddition; }
120 
121  void setMaxLabelScaleDenominator( double d ) { mMaxLabelScaleDenominator = d; }
122  double maxLabelScaleDenominator() const { return mMaxLabelScaleDenominator; }
123 
128  Placement placement() const { return mPlacement; }
129 
135  void setPlacement( Placement placement ) { mPlacement = placement; }
136 
138  QgsMarkerSymbolV2* centerSymbol() { return mCenterSymbol;}
140  void setCenterSymbol( QgsMarkerSymbolV2* symbol );
141 
148  void setTolerance( double t ) { mTolerance = t; }
149 
155  double tolerance() const { return mTolerance; }
156 
163  void setToleranceUnit( QgsSymbolV2::OutputUnit unit ) { mToleranceUnit = unit; }
164 
170  QgsSymbolV2::OutputUnit toleranceUnit() const { return mToleranceUnit; }
171 
178  void setToleranceMapUnitScale( const QgsMapUnitScale& scale ) { mToleranceMapUnitScale = scale; }
179 
185  const QgsMapUnitScale& toleranceMapUnitScale() const { return mToleranceMapUnitScale; }
186 
190  static QgsPointDisplacementRenderer* convertFromRenderer( const QgsFeatureRendererV2 *renderer );
191 
192  private:
193 
195  QgsFeatureRendererV2* mRenderer;
196 
198  QString mLabelAttributeName;
200  int mLabelIndex;
201 
203  QgsMarkerSymbolV2* mCenterSymbol;
204 
206  double mTolerance;
207  QgsSymbolV2::OutputUnit mToleranceUnit;
208  QgsMapUnitScale mToleranceMapUnitScale;
209 
210  Placement mPlacement;
211 
213  QFont mLabelFont;
214  QColor mLabelColor;
216  double mCircleWidth;
218  QColor mCircleColor;
220  double mCircleRadiusAddition;
222  bool mDrawLabels;
224  double mMaxLabelScaleDenominator;
225 
228  QList<DisplacementGroup> mDisplacementGroups;
230  QMap<QgsFeatureId, int> mGroupIndex;
232  QgsSpatialIndex* mSpatialIndex;
234  QSet<QgsFeatureId> mSelectedFeatures;
235 
237  QgsRectangle searchRect( const QgsPoint& p, double distance ) const;
239  void printInfoDisplacementGroups();
240 
242  QString getLabel( const QgsFeature& f );
243 
244  //rendering methods
245  void renderPoint( const QPointF& point, QgsSymbolV2RenderContext& context, const QList<QgsMarkerSymbolV2*>& symbols,
246  const QStringList& labels );
247 
248  //helper functions
249  void calculateSymbolAndLabelPositions( QgsSymbolV2RenderContext &symbolContext, QPointF centerPoint, int nPosition, double symbolDiagonal, QList<QPointF>& symbolPositions, QList<QPointF>& labelShifts , double &circleRadius ) const;
250  void drawGroup( const DisplacementGroup& group, QgsRenderContext& context );
251  void drawCircle( double radiusPainterUnits, QgsSymbolV2RenderContext& context, QPointF centerPoint, int nSymbols );
252  void drawSymbols( const QgsFeature& f, QgsRenderContext& context, const QList<QgsMarkerSymbolV2*>& symbolList, const QList<QPointF>& symbolPositions, bool selected = false );
253  void drawLabels( QPointF centerPoint, QgsSymbolV2RenderContext& context, const QList<QPointF>& labelShifts, const QStringList& labelList );
255  QgsSymbolV2* firstSymbolForFeature( QgsFeatureRendererV2* r, QgsFeature& f, QgsRenderContext& context );
256 };
257 
258 #endif // QGSPOINTDISPLACEMENTRENDERER_H
A rectangle specified with double values.
Definition: qgsrectangle.h:35
Placement
Placement methods for dispersing points.
OutputUnit
The unit of the output.
Definition: qgssymbolv2.h:62
double tolerance() const
Returns the tolerance distance for grouping points.
virtual Q_DECL_DEPRECATED QgsSymbolV2 * originalSymbolForFeature(QgsFeature &feature)
Return symbol for feature.
void setLabelAttributeName(const QString &name)
virtual QDomElement save(QDomDocument &doc)
store renderer info to XML element
const QgsMapUnitScale & toleranceMapUnitScale() const
Returns the map unit scale object for the distance tolerance.
Container of fields for a vector layer.
Definition: qgsfield.h:193
virtual QList< QString > usedAttributes()=0
Returns a set of attributes required for this renderer.
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
Definition: qgsfeature.h:187
virtual Q_DECL_DEPRECATED bool willRenderFeature(QgsFeature &feat)
Returns whether the renderer will render a feature or not.
virtual QgsLegendSymbologyList legendSymbologyItems(QSize iconSize)
return a list of symbology items for the legend
virtual void startRender(QgsRenderContext &context, const QgsFields &fields)=0
Needs to be called when a new render cycle is started.
void setToleranceUnit(QgsSymbolV2::OutputUnit unit)
Sets the units for the tolerance distance.
virtual void stopRender(QgsRenderContext &context)=0
Needs to be called when a render cycle has finished to clean up.
virtual Q_DECL_DEPRECATED QgsSymbolV2List originalSymbolsForFeature(QgsFeature &feat)
Equivalent of originalSymbolsForFeature() call extended to support renderers that may use more symbol...
virtual bool renderFeature(QgsFeature &feature, QgsRenderContext &context, int layer=-1, bool selected=false, bool drawVertexMarker=false)
Render a feature using this renderer in the given context.
virtual QgsFeatureRendererV2 * clone() const =0
virtual Q_DECL_DEPRECATED QgsSymbolV2 * symbolForFeature(QgsFeature &feature)
To be overridden.
virtual QgsLegendSymbolList legendSymbolItems(double scaleDenominator=-1, const QString &rule="")
return a list of item text / symbol
Placement placement() const
Returns the placement method used for dispersing the points.
void setPlacement(Placement placement)
Sets the placement method used for dispersing the points.
virtual Q_DECL_DEPRECATED QgsSymbolV2List symbols()
For symbol levels.
A class to represent a point.
Definition: qgspoint.h:117
QgsFeatureRendererV2 * embeddedRenderer() const
virtual void toSld(QDomDocument &doc, QDomElement &element) const
used from subclasses to create SLD Rule elements following SLD v1.1 specs
A renderer that automatically displaces points with the same position.
Contains information about the context of a rendering operation.
Struct for storing maximum and minimum scales for measurements in map units.
virtual Q_DECL_DEPRECATED QgsSymbolV2List symbolsForFeature(QgsFeature &feat)
Returns list of symbols used for rendering the feature.
Q_DECL_DEPRECATED void setDisplacementGroups(const QList< QMap< QgsFeatureId, QgsFeature > > &list)
not available in python bindings
void setToleranceMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale object for the distance tolerance.
virtual int capabilities()
returns bitwise OR-ed capabilities of the renderer
QgsSymbolV2::OutputUnit toleranceUnit() const
Returns the units for the tolerance distance.
QgsMarkerSymbolV2 * centerSymbol()
Returns the symbol for the center of a displacement group (but not ownership of the symbol) ...
void setTolerance(double t)
Sets the tolerance distance for grouping points.