QGIS API Documentation  3.2.0-Bonn (bc43194)
qgsvectorlayerdiagramprovider.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgsvectorlayerdiagramprovider.cpp
3  --------------------------------------
4  Date : September 2015
5  Copyright : (C) 2015 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 
17 
18 #include "qgsgeometry.h"
19 #include "qgslabelsearchtree.h"
20 #include "qgsvectorlayer.h"
22 #include "diagram/qgsdiagram.h"
23 #include "qgsgeos.h"
24 
25 #include "feature.h"
26 #include "labelposition.h"
27 
29  : QgsAbstractLabelProvider( layer )
30  , mSettings( *layer->diagramLayerSettings() )
31  , mDiagRenderer( layer->diagramRenderer()->clone() )
32  , mFields( layer->fields() )
33  , mLayerCrs( layer->crs() )
34  , mSource( ownFeatureLoop ? new QgsVectorLayerFeatureSource( layer ) : nullptr )
35  , mOwnsSource( ownFeatureLoop )
36 {
37  init();
38 }
39 
40 
42 {
43  mName = mLayerId;
44  mPriority = 1 - mSettings.priority() / 10.0; // convert 0..10 --> 1..0
47 }
48 
49 
51 {
52  if ( mOwnsSource )
53  delete mSource;
54 
55  qDeleteAll( mFeatures );
56 
57  // renderer is owned by mSettings
58 }
59 
60 
62 {
63  if ( !mSource )
64  {
65  // we have created the provider with "own feature loop" == false
66  // so it is assumed that prepare() has been already called followed by registerFeature() calls
67  return mFeatures;
68  }
69 
70  QSet<QString> attributeNames;
71  if ( !prepare( context, attributeNames ) )
72  return QList<QgsLabelFeature *>();
73 
74  QgsRectangle layerExtent = context.extent();
77 
78  QgsFeatureRequest request;
79  request.setFilterRect( layerExtent );
80  request.setSubsetOfAttributes( attributeNames, mFields );
81  QgsFeatureIterator fit = mSource->getFeatures( request );
82 
83 
84  QgsFeature fet;
85  while ( fit.nextFeature( fet ) )
86  {
87  context.expressionContext().setFeature( fet );
88  registerFeature( fet, context );
89  }
90 
91  return mFeatures;
92 }
93 
94 
96 {
97 #if 1 // XXX strk
98  // features are pre-rotated but not scaled/translated,
99  // so we only disable rotation here. Ideally, they'd be
100  // also pre-scaled/translated, as suggested here:
101  // https://issues.qgis.org/issues/11856
102  QgsMapToPixel xform = context.mapToPixel();
103  xform.setMapRotation( 0, 0, 0 );
104 #else
105  const QgsMapToPixel &xform = context.mapToPixel();
106 #endif
107 
108  QgsDiagramLabelFeature *dlf = dynamic_cast<QgsDiagramLabelFeature *>( label->getFeaturePart()->feature() );
109 
110  QgsFeature feature;
111  feature.setFields( mFields );
112  feature.setValid( true );
113  feature.setId( label->getFeaturePart()->featureId() );
114  feature.setAttributes( dlf->attributes() );
115 
116  context.expressionContext().setFeature( feature );
117 
118  //calculate top-left point for diagram
119  //first, calculate the centroid of the label (accounts for PAL creating
120  //rotated labels when we do not want to draw the diagrams rotated)
121  double centerX = 0;
122  double centerY = 0;
123  for ( int i = 0; i < 4; ++i )
124  {
125  centerX += label->getX( i );
126  centerY += label->getY( i );
127  }
128  QgsPointXY outPt( centerX / 4.0, centerY / 4.0 );
129  //then, calculate the top left point for the diagram with this center position
130  QgsPointXY centerPt = xform.transform( outPt.x() - label->getWidth() / 2,
131  outPt.y() - label->getHeight() / 2 );
132 
133  mSettings.renderer()->renderDiagram( feature, context, centerPt.toQPointF(), mSettings.dataDefinedProperties() );
134 
135  //insert into label search tree to manipulate position interactively
136  mEngine->results()->mLabelSearchTree->insertLabel( label, label->getFeaturePart()->featureId(), mLayerId, QString(), QFont(), true, false );
137 
138 }
139 
140 
141 bool QgsVectorLayerDiagramProvider::prepare( const QgsRenderContext &context, QSet<QString> &attributeNames )
142 {
144  const QgsMapSettings &mapSettings = mEngine->mapSettings();
145 
146  if ( context.coordinateTransform().isValid() )
147  // this is context for layer rendering - use its CT as it includes correct datum transform
149  else
150  {
151  // otherwise fall back to creating our own CT - this one may not have the correct datum transform!
155  }
156 
158 
159  bool result = s2.prepare( context.expressionContext() );
160 
161  //add attributes needed by the diagram renderer
162  attributeNames.unite( s2.referencedFields( context.expressionContext() ) );
163 
164  return result;
165 }
166 
167 
169 {
170  QgsLabelFeature *label = registerDiagram( feature, context, obstacleGeometry );
171  if ( label )
172  mFeatures << label;
173 }
174 
175 
177 {
178  const QgsMapSettings &mapSettings = mEngine->mapSettings();
179 
180  const QgsDiagramRenderer *dr = mSettings.renderer();
181  if ( dr )
182  {
183  QList<QgsDiagramSettings> settingList = dr->diagramSettings();
184  if ( !settingList.isEmpty() && settingList.at( 0 ).scaleBasedVisibility )
185  {
186  double maxScale = settingList.at( 0 ).maximumScale;
187  if ( maxScale > 0 && context.rendererScale() < maxScale )
188  {
189  return nullptr;
190  }
191 
192  double minScale = settingList.at( 0 ).minimumScale;
193  if ( minScale > 0 && context.rendererScale() > minScale )
194  {
195  return nullptr;
196  }
197  }
198  }
199 
200  // data defined show diagram? check this before doing any other processing
202  return nullptr;
203 
204  // data defined obstacle?
206 
207  //convert geom to geos
208  QgsGeometry geom = feat.geometry();
209  QgsGeometry extentGeom = QgsGeometry::fromRect( mapSettings.visibleExtent() );
210  if ( !qgsDoubleNear( mapSettings.rotation(), 0.0 ) )
211  {
212  //PAL features are prerotated, so extent also needs to be unrotated
213  extentGeom.rotate( -mapSettings.rotation(), mapSettings.visibleExtent().center() );
214  }
215 
216  geos::unique_ptr geomCopy;
217  std::unique_ptr<QgsGeometry> scopedPreparedGeom;
218  if ( QgsPalLabeling::geometryRequiresPreparation( geom, context, mSettings.coordinateTransform(), extentGeom ) )
219  {
220  scopedPreparedGeom.reset( new QgsGeometry( QgsPalLabeling::prepareGeometry( geom, context, mSettings.coordinateTransform(), extentGeom ) ) );
221  QgsGeometry *preparedGeom = scopedPreparedGeom.get();
222  if ( preparedGeom->isNull() )
223  return nullptr;
224  geomCopy = QgsGeos::asGeos( *preparedGeom );
225  }
226  else
227  {
228  geomCopy = QgsGeos::asGeos( geom );
229  }
230 
231  if ( !geomCopy )
232  return nullptr; // invalid geometry
233 
234  geos::unique_ptr geosObstacleGeomClone;
235  std::unique_ptr<QgsGeometry> scopedObstacleGeom;
236  if ( isObstacle && obstacleGeometry && QgsPalLabeling::geometryRequiresPreparation( obstacleGeometry, context, mSettings.coordinateTransform(), extentGeom ) )
237  {
238  QgsGeometry preparedObstacleGeom = QgsPalLabeling::prepareGeometry( obstacleGeometry, context, mSettings.coordinateTransform(), extentGeom );
239  geosObstacleGeomClone = QgsGeos::asGeos( preparedObstacleGeom );
240  }
241  else if ( mSettings.isObstacle() && !obstacleGeometry.isNull() )
242  {
243  geosObstacleGeomClone = QgsGeos::asGeos( obstacleGeometry );
244  }
245 
246  double diagramWidth = 0;
247  double diagramHeight = 0;
248  if ( dr )
249  {
250  QSizeF diagSize = dr->sizeMapUnits( feat, context );
251  if ( diagSize.isValid() )
252  {
253  diagramWidth = diagSize.width();
254  diagramHeight = diagSize.height();
255  }
256  }
257 
258  // feature to the layer
259  bool alwaysShow = mSettings.showAllDiagrams();
260  context.expressionContext().setOriginalValueVariable( alwaysShow );
262 
263  // new style data defined position
264  bool ddPos = false;
265  double ddPosX = 0.0;
266  double ddPosY = 0.0;
271  {
272  ddPosX = mSettings.dataDefinedProperties().valueAsDouble( QgsDiagramLayerSettings::PositionX, context.expressionContext(), std::numeric_limits<double>::quiet_NaN() );
273  ddPosY = mSettings.dataDefinedProperties().valueAsDouble( QgsDiagramLayerSettings::PositionY, context.expressionContext(), std::numeric_limits<double>::quiet_NaN() );
274 
275  ddPos = !std::isnan( ddPosX ) && !std::isnan( ddPosY );
276 
277  if ( ddPos )
278  {
280  if ( ct.isValid() && !ct.isShortCircuited() )
281  {
282  double z = 0;
283  ct.transformInPlace( ddPosX, ddPosY, z );
284  }
285  //data defined diagram position is always centered
286  ddPosX -= diagramWidth / 2.0;
287  ddPosY -= diagramHeight / 2.0;
288  }
289  }
290 
291  QgsDiagramLabelFeature *lf = new QgsDiagramLabelFeature( feat.id(), std::move( geomCopy ), QSizeF( diagramWidth, diagramHeight ) );
292  lf->setHasFixedPosition( ddPos );
293  lf->setFixedPosition( QgsPointXY( ddPosX, ddPosY ) );
294  lf->setHasFixedAngle( true );
295  lf->setFixedAngle( 0 );
296  lf->setAlwaysShow( alwaysShow );
297  lf->setIsObstacle( isObstacle );
298  if ( geosObstacleGeomClone )
299  {
300  lf->setObstacleGeometry( std::move( geosObstacleGeomClone ) );
301  }
302 
303  if ( dr )
304  {
305  //append the diagram attributes to lbl
306  lf->setAttributes( feat.attributes() );
307  }
308 
309  // data defined priority?
312  {
315  priorityD = qBound( 0.0, priorityD, 10.0 );
316  priorityD = 1 - priorityD / 10.0; // convert 0..10 --> 1..0
317  lf->setPriority( priorityD );
318  }
319 
320  // z-Index
321  double zIndex = mSettings.zIndex();
324  {
325  context.expressionContext().setOriginalValueVariable( zIndex );
327  }
328  lf->setZIndex( zIndex );
329 
330  // label distance
331  QgsPointXY ptZero = mapSettings.mapToPixel().toMapCoordinates( 0, 0 );
332  QgsPointXY ptOne = mapSettings.mapToPixel().toMapCoordinates( 1, 0 );
333  double dist = mSettings.distance();
334 
337  {
340  }
341 
342  dist *= ptOne.distance( ptZero );
343 
344  lf->setDistLabel( dist );
345  return lf;
346 }
QgsFeatureId id
Definition: qgsfeature.h:71
Wrapper for iterator of features from vector data provider or vector layer.
void setCoordinateTransform(const QgsCoordinateTransform &transform)
Sets the coordinate transform associated with the layer.
A rectangle specified with double values.
Definition: qgsrectangle.h:40
y-coordinate data defined diagram position
double rendererScale() const
Returns the renderer map scale.
void setMapRotation(double degrees, double cx, double cy)
Set map rotation in degrees (clockwise)
QgsPalLayerSettings::Placement mPlacement
Placement strategy.
QgsDiagramRenderer * mDiagRenderer
Diagram renderer instance (owned by mSettings)
void setFields(const QgsFields &fields, bool initAttributes=false)
Assign a field map with the feature to allow attribute access by attribute name.
Definition: qgsfeature.cpp:155
QgsFeatureId featureId() const
Returns the unique ID of the feature.
Definition: feature.cpp:151
bool isObstacle() const
Returns whether the feature associated with a diagram acts as an obstacle for other labels or diagram...
bool isNull() const
Returns true if the geometry is null (ie, contains no underlying geometry accessible via geometry() )...
double valueAsDouble(int key, const QgsExpressionContext &context, double defaultValue=0.0, bool *ok=nullptr) const
Calculates the current value of the property with the specified key and interprets it as a double...
QgsLabelFeature * feature()
Returns the parent feature.
Definition: feature.h:118
double rotation() const
Returns the rotation of the resulting map image, in degrees clockwise.
const QgsLabelingEngine * mEngine
Associated labeling engine.
QgsCoordinateTransform coordinateTransform() const
Returns the coordinate transform associated with the layer, or an invalid transform if no transformat...
void setFeature(const QgsFeature &feature)
Convenience function for setting a feature for the context.
double mPriority
Default priority of labels.
void init()
initialization method - called from constructors
QgsDiagramRenderer * renderer()
Returns the diagram renderer associated with the layer.
int priority() const
Returns the diagram priority.
double getY(int i=0) const
Returns the down-left y coordinate.
double y
Definition: qgspointxy.h:48
bool hasProperty(int key) const override
Returns true if the collection contains a property with the specified key.
A class to represent a 2D point.
Definition: qgspointxy.h:43
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the diagram&#39;s property collection, used for data defined overrides.
bool qgsDoubleNear(double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
Compare two doubles (but allow some difference)
Definition: qgis.h:251
OperationResult rotate(double rotation, const QgsPointXY &center)
Rotate this geometry around the Z axis.
#define Q_NOWARN_DEPRECATED_PUSH
Definition: qgis.h:538
QgsFeatureRequest & setSubsetOfAttributes(const QgsAttributeList &attrs)
Set a subset of attributes that will be fetched.
virtual QgsFeatureIterator getFeatures(const QgsFeatureRequest &request=QgsFeatureRequest())=0
Gets an iterator for features matching the specified request.
QgsVectorLayerDiagramProvider(QgsVectorLayer *layer, bool ownFeatureLoop=true)
Convenience constructor to initialize the provider from given vector layer.
A geometry is the spatial representation of a feature.
Definition: qgsgeometry.h:104
void setAttributes(const QgsAttributes &attrs)
Sets the feature&#39;s attributes.
Definition: qgsfeature.cpp:127
bool insertLabel(pal::LabelPosition *labelPos, int featureId, const QString &layerName, const QString &labeltext, const QFont &labelfont, bool diagram=false, bool pinned=false, const QString &providerId=QString())
Inserts label position.
QSet< QString > referencedFields(const QgsExpressionContext &context=QgsExpressionContext()) const
Returns the set of any fields referenced by the layer&#39;s diagrams.
FeaturePart * getFeaturePart()
Returns the feature corresponding to this labelposition.
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
Definition: qgsfeature.h:62
void renderDiagram(const QgsFeature &feature, QgsRenderContext &c, QPointF pos, const QgsPropertyCollection &properties=QgsPropertyCollection()) const
Renders the diagram for a specified feature at a specific position in the passed render context...
Z-index for diagram ordering.
void setAlwaysShow(bool enabled)
Sets whether label should be always shown (sets very high label priority)
QgsRectangle visibleExtent() const
Returns the actual extent derived from requested extent that takes takes output image size into accou...
virtual bool prepare(const QgsRenderContext &context, QSet< QString > &attributeNames)
Prepare for registration of features.
bool isValid() const
Returns true if the coordinate transform is valid, ie both the source and destination CRS have been s...
QgsCoordinateReferenceSystem destinationCrs() const
returns CRS of destination coordinate reference system
QList< QgsLabelFeature * > mFeatures
List of generated label features (owned by the provider)
void setHasFixedPosition(bool enabled)
Sets whether the label should use a fixed position instead of being automatically placed...
The QgsMapSettings class contains configuration for rendering of the map.
Perform transforms between map coordinates and device coordinates.
Definition: qgsmaptopixel.h:36
QgsPointXY transform(const QgsPointXY &p) const
Transform the point from map (world) coordinates to device coordinates.
static QgsGeometry fromRect(const QgsRectangle &rect)
Creates a new geometry from a QgsRectangle.
Diagram priority (between 0 and 10)
QPointF toQPointF() const
Converts a point to a QPointF.
Definition: qgspointxy.h:148
QgsLabelFeature * registerDiagram(QgsFeature &feat, QgsRenderContext &context, const QgsGeometry &obstacleGeometry=QgsGeometry())
helper method to register one diagram feautre
bool mOwnsSource
Whether layer&#39;s feature source is owned.
void setIsObstacle(bool enabled)
Sets whether the feature will act as an obstacle for labels.
void setZIndex(double zIndex)
Sets the label&#39;s z-index.
const QgsRectangle & extent() const
unsigned int mLinePlacementFlags
Extra placement flags for linestring geometries.
Evaluates and returns the diagram settings relating to a diagram for a specific feature.
bool isShortCircuited() const
Returns true if the transform short circuits because the source and destination are equivalent...
double getHeight() const
bool prepare(const QgsExpressionContext &context=QgsExpressionContext()) const
Prepares the diagrams for a specified expression context.
std::unique_ptr< GEOSGeometry, GeosDeleter > unique_ptr
Scoped GEOS pointer.
Definition: qgsgeos.h:79
void setFixedAngle(double angle)
Sets angle in degrees of the fixed angle (relevant only if hasFixedAngle() returns true) ...
This class wraps a request for features to a vector layer (or directly its vector data provider)...
void drawLabel(QgsRenderContext &context, pal::LabelPosition *label) const override
draw this label at the position determined by the labeling engine
QgsFeatureRequest & setFilterRect(const QgsRectangle &rectangle)
Sets the rectangle from which features will be taken.
QgsCoordinateTransform coordinateTransform() const
Returns the current coordinate transform for the context, or an invalid transform is no coordinate tr...
x-coordinate data defined diagram position
void setDistLabel(double dist)
Applies to "around point" placement strategy or linestring features.
void setId(QgsFeatureId id)
Sets the feature ID for this feature.
Definition: qgsfeature.cpp:112
QgsGeometry geometry() const
Returns the geometry associated with this feature.
Definition: qgsfeature.cpp:101
Whether diagram features act as obstacles for other diagrams/labels.
QgsFields mFields
Layer&#39;s fields.
double distance(double x, double y) const
Returns the distance between this point and a specified x, y coordinate.
Definition: qgspointxy.h:190
const QgsMapToPixel & mapToPixel() const
The QgsAbstractLabelProvider class is an interface class.
double zIndex() const
Returns the diagram z-index.
QgsCoordinateReferenceSystem mLayerCrs
Layer&#39;s CRS.
double x
Definition: qgspointxy.h:47
void setFixedPosition(const QgsPointXY &point)
Sets coordinates of the fixed position (relevant only if hasFixedPosition() returns true) ...
LinePlacementFlags linePlacementFlags() const
Returns the diagram placement flags.
Partial snapshot of vector layer&#39;s state (only the members necessary for access to features) ...
void setRenderer(QgsDiagramRenderer *diagramRenderer)
Sets the diagram renderer associated with the layer.
QgsAbstractGeometry * get()
Returns a modifiable (non-const) reference to the underlying abstract geometry primitive.
QgsExpressionContext & expressionContext()
Gets the expression context.
void transformInPlace(double &x, double &y, double &z, TransformDirection direction=ForwardTransform) const SIP_THROW(QgsCsException)
Transforms an array of x, y and z double coordinates in place, from the source CRS to the destination...
Stores the settings for rendering of all diagrams for a layer.
Class that adds extra information to QgsLabelFeature for labeling of diagrams.
bool valueAsBool(int key, const QgsExpressionContext &context, bool defaultValue=false, bool *ok=nullptr) const
Calculates the current value of the property with the specified key and interprets it as an boolean...
#define Q_NOWARN_DEPRECATED_POP
Definition: qgis.h:539
Placement
Placement modes which determine how label candidates are generated for a feature. ...
void setValid(bool validity)
Sets the validity of the feature.
Definition: qgsfeature.cpp:181
Placement placement() const
Returns the diagram placement.
double distance() const
Returns the distance between the diagram and the feature (in mm).
Contains information about the context of a rendering operation.
The QgsLabelFeature class describes a feature that should be used within the labeling engine...
const QgsMapToPixel & mapToPixel() const
static geos::unique_ptr asGeos(const QgsGeometry &geometry, double precision=0)
Returns a geos geometry - caller takes ownership of the object (should be deleted with GEOSGeom_destr...
Definition: qgsgeos.cpp:166
Transform from destination to source CRS.
QString mName
Name of the layer.
Distance to diagram from feature.
virtual void registerFeature(QgsFeature &feature, QgsRenderContext &context, const QgsGeometry &obstacleGeometry=QgsGeometry())
Register a feature for labeling as one or more QgsLabelFeature objects stored into mFeatures...
double getWidth() const
double getX(int i=0) const
Returns the down-left x coordinate.
void setHasFixedAngle(bool enabled)
Sets whether the label should use a fixed angle instead of using angle from automatic placement...
QList< QgsLabelFeature * > labelFeatures(QgsRenderContext &context) override
Returns list of label features (they are owned by the provider and thus deleted on its destruction) ...
virtual QList< QgsDiagramSettings > diagramSettings() const =0
Returns list with all diagram settings in the renderer.
void setAttributes(const QgsAttributes &attrs)
Store feature&#39;s attributes - used for rendering of diagrams.
const QgsMapSettings & mapSettings() const
Gets associated map settings.
QgsLabelingResults * results() const
For internal use by the providers.
Class for doing transforms between two map coordinate systems.
LabelPosition is a candidate feature label position.
Definition: labelposition.h:55
void setObstacleGeometry(geos::unique_ptr obstacleGeom)
Sets the label&#39;s obstacle geometry, if different to the feature geometry.
static bool geometryRequiresPreparation(const QgsGeometry &geometry, QgsRenderContext &context, const QgsCoordinateTransform &ct, const QgsGeometry &clipGeometry=QgsGeometry())
Checks whether a geometry requires preparation before registration with PAL.
Whether to show the diagram.
virtual QSizeF sizeMapUnits(const QgsFeature &feature, const QgsRenderContext &c) const
Returns size of the diagram for a feature in map units. Returns an invalid QSizeF in case of error...
static QgsGeometry prepareGeometry(const QgsGeometry &geometry, QgsRenderContext &context, const QgsCoordinateTransform &ct, const QgsGeometry &clipGeometry=QgsGeometry())
Prepares a geometry for registration with PAL.
const QgsAttributes & attributes()
Gets feature&#39;s attributes - used for rendering of diagrams.
QgsPointXY center() const
Returns the center point of the rectangle.
Definition: qgsrectangle.h:229
QgsAbstractFeatureSource * mSource
Layer&#39;s feature source.
bool nextFeature(QgsFeature &f)
Represents a vector layer which manages a vector based data sets.
void setOriginalValueVariable(const QVariant &value)
Sets the original value variable value for the context.
QString mLayerId
Associated layer&#39;s ID, if applicable.
QgsDiagramLayerSettings mSettings
Diagram layer settings.
QgsPointXY toMapCoordinates(int x, int y) const
QgsAttributes attributes
Definition: qgsfeature.h:72
bool isActive() const
Returns whether the property is currently active.
QgsRectangle transformBoundingBox(const QgsRectangle &rectangle, TransformDirection direction=ForwardTransform, bool handle180Crossover=false) const SIP_THROW(QgsCsException)
Transforms a rectangle from the source CRS to the destination CRS.
QgsProperty property(int key) const override
Returns a matching property from the collection, if one exists.
bool showAllDiagrams() const
Returns whether the layer should show all diagrams, including overlapping diagrams.
void setPriority(double priority)
Sets the priority for labeling the feature.