QGIS API Documentation  3.9.0-Master (224899f119)
layer.h
Go to the documentation of this file.
1 /*
2  * libpal - Automated Placement of Labels Library
3  *
4  * Copyright (C) 2008 Maxence Laurent, MIS-TIC, HEIG-VD
5  * University of Applied Sciences, Western Switzerland
6  * http://www.hes-so.ch
7  *
8  * Contact:
9  * maxence.laurent <at> heig-vd <dot> ch
10  * or
11  * eric.taillard <at> heig-vd <dot> ch
12  *
13  * This file is part of libpal.
14  *
15  * libpal is free software: you can redistribute it and/or modify
16  * it under the terms of the GNU General Public License as published by
17  * the Free Software Foundation, either version 3 of the License, or
18  * (at your option) any later version.
19  *
20  * libpal is distributed in the hope that it will be useful,
21  * but WITHOUT ANY WARRANTY; without even the implied warranty of
22  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23  * GNU General Public License for more details.
24  *
25  * You should have received a copy of the GNU General Public License
26  * along with libpal. If not, see <http://www.gnu.org/licenses/>.
27  *
28  */
29 
30 #ifndef PAL_LAYER_H_
31 #define PAL_LAYER_H_
32 
33 #define SIP_NO_FILE
34 
35 
36 #include "qgis_core.h"
37 #include "pal.h" // for LineArrangementFlags enum
38 #include "rtree.hpp"
39 #include <QMutex>
40 #include <QLinkedList>
41 #include <QHash>
42 #include <fstream>
43 
44 class QgsLabelFeature;
45 
46 namespace pal
47 {
48 
50  template<class DATATYPE, class ELEMTYPE, int NUMDIMS, class ELEMTYPEREAL, int TMAXNODES, int TMINNODES> class RTree;
52 
53  class FeaturePart;
54  class Pal;
55  class LabelInfo;
56 
63  class CORE_EXPORT Layer
64  {
65  friend class Pal;
66  friend class FeaturePart;
67 
68  friend class Problem;
69 
70  friend class LabelPosition;
71 
72  public:
74  {
75  Upright, // upside-down labels (90 <= angle < 270) are shown upright
76  ShowDefined, // show upside down when rotation is layer- or data-defined
77  ShowAll // show upside down for all labels, including dynamic ones
78  };
79 
80  virtual ~Layer();
81 
82  bool displayAll() const { return mDisplayAll; }
83 
87  int featureCount() { return mHashtable.size(); }
88 
90  QgsAbstractLabelProvider *provider() const { return mProvider; }
91 
95  QString name() const { return mName; }
96 
101  QgsPalLayerSettings::Placement arrangement() const { return mArrangement; }
102 
106  bool isCurved() const { return mArrangement == QgsPalLayerSettings::Curved || mArrangement == QgsPalLayerSettings::PerimeterCurved; }
107 
113  void setArrangement( QgsPalLayerSettings::Placement arrangement ) { mArrangement = arrangement; }
114 
125  void setActive( bool active ) { mActive = active; }
126 
131  bool active() const { return mActive; }
132 
140  void setLabelLayer( bool toLabel ) { mLabelLayer = toLabel; }
141 
146  bool labelLayer() const { return mLabelLayer; }
147 
153  QgsPalLayerSettings::ObstacleType obstacleType() const { return mObstacleType; }
154 
161  void setObstacleType( QgsPalLayerSettings::ObstacleType obstacleType ) { mObstacleType = obstacleType; }
162 
169  void setPriority( double priority );
170 
176  double priority() const { return mDefaultPriority; }
177 
183  void setMergeConnectedLines( bool merge ) { mMergeLines = merge; }
184 
189  bool mergeConnectedLines() const { return mMergeLines; }
190 
196  void setUpsidedownLabels( UpsideDownLabels ud ) { mUpsidedownLabels = ud; }
197 
202  UpsideDownLabels upsidedownLabels() const { return mUpsidedownLabels; }
203 
211  void setCentroidInside( bool forceInside ) { mCentroidInside = forceInside; }
212 
218  bool centroidInside() const { return mCentroidInside; }
219 
229  bool registerFeature( QgsLabelFeature *label );
230 
232  void joinConnectedFeatures();
233 
239  int connectedFeatureId( QgsFeatureId featureId ) const;
240 
242  void chopFeaturesAtRepeatDistance();
243 
244  protected:
246  QString mName;
247 
249  QLinkedList<FeaturePart *> mFeatureParts;
250 
252  QList<FeaturePart *> mObstacleParts;
253 
254  Pal *pal = nullptr;
255 
257 
259  bool mActive;
263 
266 
268 
270 
271  // indexes (spatial and id)
272  RTree<FeaturePart *, double, 2, double, 8, 4> *mFeatureIndex;
274  QHash< QgsFeatureId, QgsLabelFeature *> mHashtable;
275 
276  //obstacle r-tree
277  RTree<FeaturePart *, double, 2, double, 8, 4> *mObstacleIndex;
278 
279  QHash< QString, QVector<FeaturePart *> > mConnectedHashtable;
280  QHash< QgsFeatureId, int > mConnectedFeaturesIds;
281 
282  QMutex mMutex;
283 
297  Layer( QgsAbstractLabelProvider *provider, const QString &name, QgsPalLayerSettings::Placement arrangement, double defaultPriority, bool active, bool toLabel, Pal *pal, bool displayAll = false );
298 
300  void addFeaturePart( FeaturePart *fpart, const QString &labelText = QString() );
301 
303  void addObstaclePart( FeaturePart *fpart );
304 
305  };
306 
307 } // end namespace pal
308 
309 #endif
bool labelLayer() const
Returns whether the layer will be labeled or not.
Definition: layer.h:146
QgsAbstractLabelProvider * provider() const
Returns pointer to the associated provider.
Definition: layer.h:90
bool centroidInside() const
Returns whether labels placed at the centroid of features within the layer are forced to be placed in...
Definition: layer.h:218
QList< FeaturePart * > mObstacleParts
List of obstacle parts.
Definition: layer.h:252
QHash< QgsFeatureId, int > mConnectedFeaturesIds
Definition: layer.h:280
bool mergeConnectedLines() const
Returns whether connected lines will be merged before labeling.
Definition: layer.h:189
bool mMergeLines
Definition: layer.h:267
bool mActive
Definition: layer.h:259
bool mLabelLayer
Definition: layer.h:260
QHash< QgsFeatureId, QgsLabelFeature * > mHashtable
Lookup table of label features (owned by the label feature provider that created them) ...
Definition: layer.h:274
Arranges candidates following the curvature of a line feature. Applies to line layers only...
A set of features which influence the labeling process.
Definition: layer.h:63
double mDefaultPriority
Definition: layer.h:256
qint64 QgsFeatureId
Definition: qgsfeatureid.h:25
Main Pal labeling class.
Definition: pal.h:87
UpsideDownLabels
Definition: layer.h:73
void setUpsidedownLabels(UpsideDownLabels ud)
Sets how upside down labels will be handled within the layer.
Definition: layer.h:196
UpsideDownLabels upsidedownLabels() const
Returns how upside down labels are handled within the layer.
Definition: layer.h:202
void setObstacleType(QgsPalLayerSettings::ObstacleType obstacleType)
Sets the obstacle type, which controls how features within the layer act as obstacles for labels...
Definition: layer.h:161
void setCentroidInside(bool forceInside)
Sets whether labels placed at the centroid of features within the layer are forced to be placed insid...
Definition: layer.h:211
QgsPalLayerSettings::ObstacleType obstacleType() const
Returns the obstacle type, which controls how features within the layer act as obstacles for labels...
Definition: layer.h:153
QString mName
Definition: layer.h:246
bool displayAll() const
Definition: layer.h:82
QHash< QString, QVector< FeaturePart * > > mConnectedHashtable
Definition: layer.h:279
double priority() const
Returns the layer&#39;s priority, between 0 and 1.
Definition: layer.h:176
RTree< FeaturePart *, double, 2, double, 8, 4 > * mFeatureIndex
Definition: layer.h:272
void setArrangement(QgsPalLayerSettings::Placement arrangement)
Sets the layer&#39;s arrangement policy.
Definition: layer.h:113
QgsPalLayerSettings::Placement arrangement() const
Returns the layer&#39;s arrangement policy.
Definition: layer.h:101
int featureCount()
Returns the number of features in layer.
Definition: layer.h:87
bool mCentroidInside
Definition: layer.h:262
QgsPalLayerSettings::ObstacleType mObstacleType
Definition: layer.h:258
Main class to handle feature.
Definition: feature.h:96
The QgsAbstractLabelProvider class is an interface class.
Placement
Placement modes which determine how label candidates are generated for a feature. ...
bool mDisplayAll
Definition: layer.h:261
void setActive(bool active)
Sets whether the layer is currently active.
Definition: layer.h:125
void setLabelLayer(bool toLabel)
Sets whether the layer will be labeled.
Definition: layer.h:140
QgsAbstractLabelProvider * mProvider
Definition: layer.h:245
The QgsLabelFeature class describes a feature that should be used within the labeling engine...
QLinkedList< FeaturePart * > mFeatureParts
List of feature parts.
Definition: layer.h:249
RTree< FeaturePart *, double, 2, double, 8, 4 > * mObstacleIndex
Definition: layer.h:277
QMutex mMutex
Definition: layer.h:282
QString name() const
Returns the layer&#39;s name.
Definition: layer.h:95
bool active() const
Returns whether the layer is currently active.
Definition: layer.h:131
LabelPosition is a candidate feature label position.
Definition: labelposition.h:55
Representation of a labeling problem.
Definition: problem.h:73
QgsPalLayerSettings::Placement mArrangement
Optional flags used for some placement methods.
Definition: layer.h:265
Arranges candidates following the curvature of a polygon&#39;s boundary. Applies to polygon layers only...
bool isCurved() const
Returns true if the layer has curved labels.
Definition: layer.h:106
UpsideDownLabels mUpsidedownLabels
Definition: layer.h:269
void setMergeConnectedLines(bool merge)
Sets whether connected lines should be merged before labeling.
Definition: layer.h:183
ObstacleType
Valid obstacle types, which affect how features within the layer will act as obstacles for labels...