QGIS API Documentation  2.99.0-Master (5dc91b4)
labelposition.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 LABELPOSITION_H
31 #define LABELPOSITION_H
32 
33 #define SIP_NO_FILE
34 
35 
36 #include "qgis_core.h"
37 #include "pointset.h"
38 #include "rtree.hpp"
39 #include <fstream>
40 
41 namespace pal
42 {
43 
44  class FeaturePart;
45  class Pal;
46  class Label;
47 
48 
55  class CORE_EXPORT LabelPosition : public PointSet
56  {
57  friend class CostCalculator;
58  friend class PolygonCostCalculator;
59 
60  public:
61 
65  enum Quadrant
66  {
75  QuadrantBelowRight
76  };
77 
92  LabelPosition( int id, double x1, double y1,
93  double w, double h,
94  double alpha, double cost,
95  FeaturePart *feature, bool isReversed = false, Quadrant quadrant = QuadrantOver );
96 
98  LabelPosition( const LabelPosition &other );
99 
100  ~LabelPosition() override { delete nextPart; }
101 
107  bool isIn( double *bbox );
108 
114  bool isIntersect( double *bbox );
115 
119  bool intersects( const GEOSPreparedGeometry *geometry );
120 
124  bool within( const GEOSPreparedGeometry *geometry );
125 
131  bool isInside( double *bbox );
132 
139  bool isInConflict( LabelPosition *ls );
140 
142  void getBoundingBox( double amin[2], double amax[2] ) const;
143 
145  double getDistanceToPoint( double xp, double yp ) const;
146 
148  bool crossesLine( PointSet *line ) const;
149 
151  bool crossesBoundary( PointSet *polygon ) const;
152 
157  int polygonIntersectionCost( PointSet *polygon ) const;
158 
162  bool intersectsWithPolygon( PointSet *polygon ) const;
163 
165  void offsetPosition( double xOffset, double yOffset );
166 
171  int getId() const;
172 
173 
178  FeaturePart *getFeaturePart();
179 
180  int getNumOverlaps() const { return nbOverlap; }
181  void resetNumOverlaps() { nbOverlap = 0; } // called from problem.cpp, pal.cpp
182 
183  int getProblemFeatureId() const { return probFeat; }
184 
188  void setProblemIds( int probFid, int lpId )
189  {
190  probFeat = probFid;
191  id = lpId;
192  if ( nextPart ) nextPart->setProblemIds( probFid, lpId );
193  }
194 
199  double cost() const { return mCost; }
200 
206  void setCost( double newCost ) { mCost = newCost; }
207 
214  void setConflictsWithObstacle( bool conflicts );
215 
220  bool conflictsWithObstacle() const { return mHasObstacleConflict; }
221 
223  void validateCost();
224 
229  double getX( int i = 0 ) const;
230 
235  double getY( int i = 0 ) const;
236 
237  double getWidth() const { return w; }
238  double getHeight() const { return h; }
239 
244  double getAlpha() const;
245  bool getReversed() const { return reversed; }
246  bool getUpsideDown() const { return upsideDown; }
247 
248  Quadrant getQuadrant() const { return quadrant; }
249  LabelPosition *getNextPart() const { return nextPart; }
250  void setNextPart( LabelPosition *next ) { nextPart = next; }
251 
252  // -1 if not multi-part
253  int getPartId() const { return partId; }
254  void setPartId( int id ) { partId = id; }
255 
257  int incrementUpsideDownCharCount() { return ++mUpsideDownCharCount; }
258 
260  int upsideDownCharCount() const { return mUpsideDownCharCount; }
261 
262  void removeFromIndex( RTree<LabelPosition *, double, 2, double> *index );
263  void insertIntoIndex( RTree<LabelPosition *, double, 2, double> *index );
264 
265  typedef struct
266  {
267  Pal *pal = nullptr;
268  FeaturePart *obstacle = nullptr;
269  } PruneCtx;
270 
272  static bool pruneCallback( LabelPosition *candidatePosition, void *ctx );
273 
274  // for counting number of overlaps
275  typedef struct
276  {
277  LabelPosition *lp = nullptr;
278  int *nbOv = nullptr;
279  double *cost = nullptr;
280  double *inactiveCost = nullptr;
281  //int *feat;
282  } CountContext;
283 
284  /*
285  * count overlap, ctx = p_lp
286  */
287  static bool countOverlapCallback( LabelPosition *lp, void *ctx );
288 
289  static bool countFullOverlapCallback( LabelPosition *lp, void *ctx );
290 
291  static bool removeOverlapCallback( LabelPosition *lp, void *ctx );
292 
293  // for polygon cost calculation
294  static bool polygonObstacleCallback( pal::FeaturePart *obstacle, void *ctx );
295 
296  protected:
297 
298  int id;
299 
300  FeaturePart *feature = nullptr;
301 
302  // bug # 1 (maxence 10/23/2008)
303  int probFeat;
304 
306 
307  double alpha;
308  double w;
309  double h;
310 
311  LabelPosition *nextPart = nullptr;
312  int partId;
313 
314  //True if label direction is the same as line / polygon ring direction.
315  //Could be used by the application to draw a directional arrow ('<' or '>')
316  //if the layer arrangement is P_LINE
317  bool reversed;
318 
320 
322 
323  bool isInConflictSinglePart( LabelPosition *lp );
324  bool isInConflictMultiPart( LabelPosition *lp );
325 
326  private:
327  double mCost;
328  bool mHasObstacleConflict;
329  int mUpsideDownCharCount;
330 
334  int partCount() const;
335 
340  double polygonIntersectionCostForParts( PointSet *polygon ) const;
341 
342  };
343 
344 } // end namespace
345 
346 #endif
void setCost(double newCost)
Sets the candidate label position&#39;s geographical cost.
int incrementUpsideDownCharCount()
Increases the count of upside down characters for this label position.
Main Pal labeling class.
Definition: pal.h:89
int getProblemFeatureId() const
double cost() const
Returns the candidate label position&#39;s geographical cost.
double getHeight() const
LabelPosition * getNextPart() const
Quadrant getQuadrant() const
Main class to handle feature.
Definition: feature.h:96
int upsideDownCharCount() const
Returns the number of upside down characters for this label position.
void setPartId(int id)
void setNextPart(LabelPosition *next)
double getWidth() const
bool conflictsWithObstacle() const
Returns whether the position is marked as conflicting with an obstacle feature.
int getNumOverlaps() const
LabelPosition is a candidate feature label position.
Definition: labelposition.h:55
Quadrant
Position of label candidate relative to feature.
Definition: labelposition.h:65
bool getUpsideDown() const
void setProblemIds(int probFid, int lpId)
Set problem feature ID and assigned label candidate ID.
bool getReversed() const
Data structure to compute polygon&#39;s candidates costs.
int getPartId() const
LabelPosition::Quadrant quadrant
~LabelPosition() override