QGIS API Documentation  3.2.0-Bonn (bc43194)
qgslabelfeature.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgslabelfeature.h
3  ---------------------
4  begin : December 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 #ifndef QGSLABELFEATURE_H
16 #define QGSLABELFEATURE_H
17 
18 #define SIP_NO_FILE
19 
20 #include "qgis_core.h"
21 #include "qgspallabeling.h"
22 #include "geos_c.h"
23 #include "qgsgeos.h"
24 #include "qgsmargins.h"
25 
26 namespace pal
27 {
28  class LabelInfo;
29 }
30 
32 class QgsRenderContext;
33 class QgsGeometry;
34 
35 
53 class CORE_EXPORT QgsLabelFeature
54 {
55  public:
56 
58  QgsLabelFeature( QgsFeatureId id, geos::unique_ptr geometry, QSizeF size );
60  virtual ~QgsLabelFeature();
61 
63  QgsFeatureId id() const { return mId; }
64 
66  GEOSGeometry *geometry() const { return mGeometry.get(); }
67 
77  void setObstacleGeometry( geos::unique_ptr obstacleGeom );
78 
84  GEOSGeometry *obstacleGeometry() const { return mObstacleGeometry.get(); }
85 
95  void setPermissibleZone( const QgsGeometry &geometry );
96 
105  QgsGeometry permissibleZone() const { return mPermissibleZone; }
106 
112  //TODO - remove when QgsGeometry caches GEOS preparedness
113  const GEOSPreparedGeometry *permissibleZonePrepared() const { return mPermissibleZoneGeosPrepared.get(); }
114 
116  QSizeF size() const { return mSize; }
117 
128  void setVisualMargin( const QgsMargins &margin ) { mVisualMargin = margin; }
129 
134  const QgsMargins &visualMargin() const { return mVisualMargin; }
135 
142  void setSymbolSize( QSizeF size ) { mSymbolSize = size; }
143 
151  const QSizeF &symbolSize() const { return mSymbolSize; }
152 
159  double priority() const { return mPriority; }
160 
168  void setPriority( double priority ) { mPriority = priority; }
169 
176  double zIndex() const { return mZIndex; }
177 
185  void setZIndex( double zIndex ) { mZIndex = zIndex; }
186 
188  bool hasFixedPosition() const { return mHasFixedPosition; }
190  void setHasFixedPosition( bool enabled ) { mHasFixedPosition = enabled; }
192  QgsPointXY fixedPosition() const { return mFixedPosition; }
194  void setFixedPosition( const QgsPointXY &point ) { mFixedPosition = point; }
195 
197  bool hasFixedAngle() const { return mHasFixedAngle; }
199  void setHasFixedAngle( bool enabled ) { mHasFixedAngle = enabled; }
201  double fixedAngle() const { return mFixedAngle; }
203  void setFixedAngle( double angle ) { mFixedAngle = angle; }
204 
211  bool hasFixedQuadrant() const { return mHasFixedQuadrant; }
212 
219  void setHasFixedQuadrant( bool enabled ) { mHasFixedQuadrant = enabled; }
220 
227  QPointF quadOffset() const { return mQuadOffset; }
228 
233  void setQuadOffset( QPointF quadOffset ) { mQuadOffset = quadOffset; }
234 
239  QgsPointXY positionOffset() const { return mPositionOffset; }
240 
245  void setPositionOffset( const QgsPointXY &offset ) { mPositionOffset = offset; }
246 
253  QgsPalLayerSettings::OffsetType offsetType() const { return mOffsetType; }
254 
261  void setOffsetType( QgsPalLayerSettings::OffsetType type ) { mOffsetType = type; }
262 
267  double distLabel() const { return mDistLabel; }
268 
273  void setDistLabel( double dist ) { mDistLabel = dist; }
274 
280  QVector< QgsPalLayerSettings::PredefinedPointPosition > predefinedPositionOrder() const { return mPredefinedPositionOrder; }
281 
287  void setPredefinedPositionOrder( const QVector< QgsPalLayerSettings::PredefinedPointPosition > &order ) { mPredefinedPositionOrder = order; }
288 
293  double repeatDistance() const { return mRepeatDistance; }
294 
299  void setRepeatDistance( double dist ) { mRepeatDistance = dist; }
300 
302  bool alwaysShow() const { return mAlwaysShow; }
304  void setAlwaysShow( bool enabled ) { mAlwaysShow = enabled; }
305 
311  bool isObstacle() const { return mIsObstacle; }
312 
318  void setIsObstacle( bool enabled ) { mIsObstacle = enabled; }
319 
325  double obstacleFactor() const { return mObstacleFactor; }
326 
335  void setObstacleFactor( double factor ) { mObstacleFactor = factor; }
336 
343  QString labelText() const { return mLabelText; }
345  void setLabelText( const QString &text ) { mLabelText = text; }
346 
348  pal::LabelInfo *curvedLabelInfo() const { return mInfo; }
350  void setCurvedLabelInfo( pal::LabelInfo *info ) { mInfo = info; }
351 
353  pal::Layer *layer() const { return mLayer; }
355  void setLayer( pal::Layer *layer ) { mLayer = layer; }
356 
358  QgsAbstractLabelProvider *provider() const;
359 
360  protected:
362  pal::Layer *mLayer = nullptr;
363 
373  QSizeF mSize;
377  QSizeF mSymbolSize;
379  double mPriority;
381  double mZIndex;
389  double mFixedAngle;
393  QPointF mQuadOffset;
397  double mDistLabel;
401  QVector< QgsPalLayerSettings::PredefinedPointPosition > mPredefinedPositionOrder;
411  QString mLabelText;
413  pal::LabelInfo *mInfo = nullptr;
414 
415  private:
416 
418  geos::unique_ptr mPermissibleZoneGeos;
419 
420  // TODO - not required when QgsGeometry caches geos preparedness
421  geos::prepared_unique_ptr mPermissibleZoneGeosPrepared;
422 
423 };
424 
425 #endif // QGSLABELFEATURE_H
QString labelText() const
Text of the label.
double obstacleFactor() const
Returns the obstacle factor for the feature.
double distLabel() const
Applies to "around point" placement strategy or linestring features.
QgsFeatureId id() const
Identifier of the label (unique within the parent label provider)
void setSymbolSize(QSizeF size)
Sets the size of the rendered symbol associated with this feature.
QgsPointXY mFixedPosition
fixed position for the label (instead of automatic placement)
double priority() const
Returns the feature&#39;s labeling priority.
void setVisualMargin(const QgsMargins &margin)
Sets the visual margin for the label feature.
bool alwaysShow() const
Whether label should be always shown (sets very high label priority)
std::unique_ptr< const GEOSPreparedGeometry, GeosDeleter > prepared_unique_ptr
Scoped GEOS prepared geometry pointer.
Definition: qgsgeos.h:84
A set of features which influence the labeling process.
Definition: layer.h:63
A class to represent a 2D point.
Definition: qgspointxy.h:43
QString mLabelText
text of the label
QgsMargins mVisualMargin
Visual margin of label contents.
const GEOSPreparedGeometry * permissibleZonePrepared() const
Returns a GEOS prepared geometry representing the label&#39;s permissibleZone().
bool mIsObstacle
whether the feature geometry acts as an obstacle for labels
GEOSGeometry * geometry() const
Gets access to the associated geometry.
void setObstacleFactor(double factor)
Sets the obstacle factor for the feature.
A geometry is the spatial representation of a feature.
Definition: qgsgeometry.h:104
const QSizeF & symbolSize() const
Returns the size of the rendered symbol associated with this feature, if applicable.
void setCurvedLabelInfo(pal::LabelInfo *info)
takes ownership of the instance
bool mHasFixedQuadrant
whether mQuadOffset should be respected (only for "around point" placement)
bool isObstacle() const
Returns whether the feature will act as an obstacle for labels.
double mRepeatDistance
distance after which label should be repeated (only for linestrings)
double mObstacleFactor
how strong is the geometry acting as obstacle
QgsFeatureId mId
Associated ID unique within the parent label provider.
const QgsMargins & visualMargin() const
Returns the visual margin for the label feature.
void setAlwaysShow(bool enabled)
Sets whether label should be always shown (sets very high label priority)
void setLabelText(const QString &text)
Sets text of the label.
bool mHasFixedPosition
whether mFixedPosition should be respected
double ANALYSIS_EXPORT angle(QgsPoint *p1, QgsPoint *p2, QgsPoint *p3, QgsPoint *p4)
Calculates the angle between two segments (in 2 dimension, z-values are ignored)
Definition: MathUtils.cpp:786
QgsPointXY positionOffset() const
Applies only to "offset from point" placement strategy.
void setHasFixedPosition(bool enabled)
Sets whether the label should use a fixed position instead of being automatically placed...
void setPositionOffset(const QgsPointXY &offset)
Applies only to "offset from point" placement strategy.
QSizeF mSize
Width and height of the label.
geos::unique_ptr mObstacleGeometry
Optional geometry to use for label obstacles, if different to mGeometry.
double mFixedAngle
fixed rotation for the label (instead of automatic choice)
double zIndex() const
Returns the label&#39;s z-index.
pal::LabelInfo * curvedLabelInfo() const
Gets additional infor required for curved label placement. Returns null if not set.
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.
bool hasFixedQuadrant() const
Returns whether the quadrant for the label is fixed.
QgsGeometry permissibleZone() const
Returns the label&#39;s permissible zone geometry.
QSizeF mSymbolSize
Size of associated rendered symbol, if applicable.
QVector< QgsPalLayerSettings::PredefinedPointPosition > mPredefinedPositionOrder
Ordered list of predefined positions for label (only for OrderedPositionsAroundPoint placement) ...
void setLayer(pal::Layer *layer)
Assign PAL layer to the label feature. Should be only used internally in PAL.
std::unique_ptr< GEOSGeometry, GeosDeleter > unique_ptr
Scoped GEOS pointer.
Definition: qgsgeos.h:79
Optional additional info about label (for curved labels)
Definition: feature.h:55
void setFixedAngle(double angle)
Sets angle in degrees of the fixed angle (relevant only if hasFixedAngle() returns true) ...
bool hasFixedAngle() const
Whether the label should use a fixed angle instead of using angle from automatic placement.
pal::Layer * layer() const
Gets PAL layer of the label feature. Should be only used internally in PAL.
OffsetType
Behavior modifier for label offset and distance, only applies in some label placement modes...
double fixedAngle() const
Angle in degrees of the fixed angle (relevant only if hasFixedAngle() returns true) ...
void setPredefinedPositionOrder(const QVector< QgsPalLayerSettings::PredefinedPointPosition > &order)
Sets the priority ordered list of predefined positions for label candidates.
void setOffsetType(QgsPalLayerSettings::OffsetType type)
Sets the offset type, which determines how offsets and distance to label behaves. ...
void setDistLabel(double dist)
Applies to "around point" placement strategy or linestring features.
bool mAlwaysShow
whether to always show label - even in case of collisions
The QgsAbstractLabelProvider class is an interface class.
double repeatDistance() const
Applies only to linestring features - after what distance (in map units) the labels should be repeate...
QSizeF size() const
Size of the label (in map units)
QgsPointXY mPositionOffset
offset of label from the feature (only for "offset from point" placement)
void setFixedPosition(const QgsPointXY &point)
Sets coordinates of the fixed position (relevant only if hasFixedPosition() returns true) ...
bool mHasFixedAngle
whether mFixedAngle should be respected
QPointF quadOffset() const
Applies to "offset from point" placement strategy and "around point" (in case hasFixedQuadrant() retu...
Contains information about the context of a rendering operation.
bool hasFixedPosition() const
Whether the label should use a fixed position instead of being automatically placed.
geos::unique_ptr mGeometry
Geometry of the feature to be labelled.
The QgsLabelFeature class describes a feature that should be used within the labeling engine...
double mPriority
Priority of the label.
GEOSGeometry * obstacleGeometry() const
Returns the label&#39;s obstacle geometry, if different to the feature geometry.
QgsPalLayerSettings::OffsetType offsetType() const
Returns the offset type, which determines how offsets and distance to label behaves.
void setHasFixedAngle(bool enabled)
Sets whether the label should use a fixed angle instead of using angle from automatic placement...
void setRepeatDistance(double dist)
Applies only to linestring features - set after what distance (in map units) the labels should be rep...
void setHasFixedQuadrant(bool enabled)
Sets whether the quadrant for the label must be respected.
qint64 QgsFeatureId
Definition: qgsfeature.h:37
QgsGeometry mPermissibleZone
Optional geometry to use for label&#39;s permissible zone.
QgsPointXY fixedPosition() const
Coordinates of the fixed position (relevant only if hasFixedPosition() returns true) ...
double mDistLabel
distance of label from the feature (only for "around point" placement or linestrings) ...
QVector< QgsPalLayerSettings::PredefinedPointPosition > predefinedPositionOrder() const
Returns the priority ordered list of predefined positions for label candidates.
double mZIndex
Z-index of label (higher z-index labels are rendered on top of lower z-index labels) ...
QgsPalLayerSettings::OffsetType mOffsetType
Offset type for certain placement modes.
The QgsMargins class defines the four margins of a rectangle.
Definition: qgsmargins.h:37
void setQuadOffset(QPointF quadOffset)
Set which side of the point to use.
void setPriority(double priority)
Sets the priority for labeling the feature.
QPointF mQuadOffset
whether the side of the label is fixed (only for "around point" placement)