Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
Move QgsLabelFeature and QgsTextLabelFeature class to separate files
No actual code changes This code has been funded by Tuscany Region (Italy) - SITA (CIG: 63526840AE) and commissioned to Gis3W s.a.s.
- Loading branch information
Showing
13 changed files
with
437 additions
and
272 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,43 @@ | ||
#include "qgslabelfeature.h" | ||
This comment has been minimized.
Sorry, something went wrong.
This comment has been minimized.
Sorry, something went wrong. |
||
|
||
#include "feature.h" | ||
|
||
|
||
QgsLabelFeature::QgsLabelFeature( QgsFeatureId id, GEOSGeometry* geometry, const QSizeF& size ) | ||
: mLayer( nullptr ) | ||
, mId( id ) | ||
, mGeometry( geometry ) | ||
, mObstacleGeometry( nullptr ) | ||
, mSize( size ) | ||
, mPriority( -1 ) | ||
, mHasFixedPosition( false ) | ||
, mHasFixedAngle( false ) | ||
, mFixedAngle( 0 ) | ||
, mHasFixedQuadrant( false ) | ||
, mDistLabel( 0 ) | ||
, mRepeatDistance( 0 ) | ||
, mAlwaysShow( false ) | ||
, mIsObstacle( false ) | ||
, mObstacleFactor( 1 ) | ||
, mInfo( nullptr ) | ||
{ | ||
} | ||
|
||
QgsLabelFeature::~QgsLabelFeature() | ||
{ | ||
if ( mGeometry ) | ||
GEOSGeom_destroy_r( QgsGeometry::getGEOSHandler(), mGeometry ); | ||
|
||
if ( mObstacleGeometry ) | ||
GEOSGeom_destroy_r( QgsGeometry::getGEOSHandler(), mObstacleGeometry ); | ||
|
||
delete mInfo; | ||
} | ||
|
||
void QgsLabelFeature::setObstacleGeometry( GEOSGeometry* obstacleGeom ) | ||
{ | ||
if ( mObstacleGeometry ) | ||
GEOSGeom_destroy_r( QgsGeometry::getGEOSHandler(), mObstacleGeometry ); | ||
|
||
mObstacleGeometry = obstacleGeom; | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,233 @@ | ||
#ifndef QGSLABELFEATURE_H | ||
#define QGSLABELFEATURE_H | ||
|
||
#include "qgsgeometry.h" | ||
|
||
#include "qgspallabeling.h" | ||
|
||
namespace pal | ||
{ | ||
class LabelInfo; | ||
} | ||
|
||
class QgsAbstractLabelProvider; | ||
class QgsRenderContext; | ||
class QgsGeometry; | ||
|
||
|
||
/** | ||
* @brief The QgsLabelFeature class describes a feature that | ||
* should be used within the labeling engine. Those may be the usual textual labels, | ||
* diagrams, or any other custom type of map annotations (generated by custom | ||
* label providers). | ||
* | ||
* Instances only contain data relevant to the labeling engine (geometry, label size etc.) | ||
* necessary for the layout. Rendering of labels is done by label providers. | ||
* | ||
* Individual label providers may create subclasses of QgsLabelFeature in order to add | ||
* more data to the instances that will be later used for drawing of labels. | ||
* | ||
* @note this class is not a part of public API yet. See notes in QgsLabelingEngineV2 | ||
* @note added in QGIS 2.12 | ||
*/ | ||
class CORE_EXPORT QgsLabelFeature | ||
{ | ||
public: | ||
//! Create label feature, takes ownership of the geometry instance | ||
QgsLabelFeature( QgsFeatureId id, GEOSGeometry* geometry, const QSizeF& size ); | ||
//! Clean up geometry and curved label info (if present) | ||
virtual ~QgsLabelFeature(); | ||
|
||
//! Identifier of the label (unique within the parent label provider) | ||
QgsFeatureId id() const { return mId; } | ||
|
||
//! Get access to the associated geometry | ||
GEOSGeometry* geometry() const { return mGeometry; } | ||
|
||
/** Sets the label's obstacle geometry, if different to the feature geometry. | ||
* This can be used to override the shape of the feature for obstacle detection, eg to | ||
* buffer around a point geometry to prevent labels being placed too close to the | ||
* point itself. It not set, the feature's geometry is used for obstacle detection. | ||
* Ownership of obstacle geometry is transferred. | ||
* @note added in QGIS 2.14 | ||
* @see obstacleGeometry() | ||
*/ | ||
void setObstacleGeometry( GEOSGeometry* obstacleGeom ); | ||
|
||
/** Returns the label's obstacle geometry, if different to the feature geometry. | ||
* @note added in QGIS 2.14 | ||
* @see setObstacleGeometry() | ||
*/ | ||
GEOSGeometry* obstacleGeometry() const { return mObstacleGeometry; } | ||
|
||
//! Size of the label (in map units) | ||
QSizeF size() const { return mSize; } | ||
|
||
/** Returns the feature's labeling priority. | ||
* @returns feature's priority, as a value between 0 (highest priority) | ||
* and 1 (lowest priority). Returns -1.0 if feature will use the layer's default priority. | ||
* @see setPriority | ||
*/ | ||
double priority() const { return mPriority; } | ||
/** Sets the priority for labeling the feature. | ||
* @param priority feature's priority, as a value between 0 (highest priority) | ||
* and 1 (lowest priority). Set to -1.0 to use the layer's default priority | ||
* for this feature. | ||
* @see priority | ||
*/ | ||
void setPriority( double priority ) { mPriority = priority; } | ||
|
||
//! Whether the label should use a fixed position instead of being automatically placed | ||
bool hasFixedPosition() const { return mHasFixedPosition; } | ||
//! Set whether the label should use a fixed position instead of being automatically placed | ||
void setHasFixedPosition( bool enabled ) { mHasFixedPosition = enabled; } | ||
//! Coordinates of the fixed position (relevant only if hasFixedPosition() returns true) | ||
QgsPoint fixedPosition() const { return mFixedPosition; } | ||
//! Set coordinates of the fixed position (relevant only if hasFixedPosition() returns true) | ||
void setFixedPosition( const QgsPoint& point ) { mFixedPosition = point; } | ||
|
||
//! Whether the label should use a fixed angle instead of using angle from automatic placement | ||
bool hasFixedAngle() const { return mHasFixedAngle; } | ||
//! Set whether the label should use a fixed angle instead of using angle from automatic placement | ||
void setHasFixedAngle( bool enabled ) { mHasFixedAngle = enabled; } | ||
//! Angle in degrees of the fixed angle (relevant only if hasFixedAngle() returns true) | ||
double fixedAngle() const { return mFixedAngle; } | ||
//! Set angle in degrees of the fixed angle (relevant only if hasFixedAngle() returns true) | ||
void setFixedAngle( double angle ) { mFixedAngle = angle; } | ||
|
||
/** Returns whether the quadrant for the label is fixed. | ||
* Applies to "around point" placement strategy. | ||
* @see setFixedQuadrant | ||
* @see quadOffset | ||
*/ | ||
bool hasFixedQuadrant() const { return mHasFixedQuadrant; } | ||
/** Sets whether the quadrant for the label must be respected. This can be used | ||
* to fix the quadrant for specific features when using an "around point" placement. | ||
* @see fixedQuadrant | ||
* @see quadOffset | ||
*/ | ||
void setHasFixedQuadrant( bool enabled ) { mHasFixedQuadrant = enabled; } | ||
//! Applies to "offset from point" placement strategy and "around point" (in case hasFixedQuadrant() returns true). | ||
//! Determines which side of the point to use. | ||
//! For X coordinate, values -1, 0, 1 mean left, center, right. | ||
//! For Y coordinate, values -1, 0, 1 mean above, center, below. | ||
QPointF quadOffset() const { return mQuadOffset; } | ||
//! Set which side of the point to use | ||
//! @see quadOffset | ||
void setQuadOffset( const QPointF& quadOffset ) { mQuadOffset = quadOffset; } | ||
//! Applies only to "offset from point" placement strategy. | ||
//! What offset (in map units) to use from the point | ||
QgsPoint positionOffset() const { return mPositionOffset; } | ||
//! Applies only to "offset from point" placement strategy. | ||
//! Set what offset (in map units) to use from the point | ||
void setPositionOffset( const QgsPoint& offset ) { mPositionOffset = offset; } | ||
//! Applies to "around point" placement strategy or linestring features. | ||
//! Distance of the label from the feature (in map units) | ||
double distLabel() const { return mDistLabel; } | ||
//! Applies to "around point" placement strategy or linestring features. | ||
//! Set distance of the label from the feature (in map units) | ||
void setDistLabel( double dist ) { mDistLabel = dist; } | ||
|
||
//! Applies only to linestring features - after what distance (in map units) | ||
//! the labels should be repeated (0 = no repetitions) | ||
double repeatDistance() const { return mRepeatDistance; } | ||
//! Applies only to linestring features - set after what distance (in map units) | ||
//! the labels should be repeated (0 = no repetitions) | ||
void setRepeatDistance( double dist ) { mRepeatDistance = dist; } | ||
|
||
//! Whether label should be always shown (sets very high label priority) | ||
bool alwaysShow() const { return mAlwaysShow; } | ||
//! Set whether label should be always shown (sets very high label priority) | ||
void setAlwaysShow( bool enabled ) { mAlwaysShow = enabled; } | ||
|
||
/** Returns whether the feature will act as an obstacle for labels. | ||
* @returns true if feature is an obstacle | ||
* @see setIsObstacle | ||
*/ | ||
bool isObstacle() const { return mIsObstacle; } | ||
/** Sets whether the feature will act as an obstacle for labels. | ||
* @param enabled whether feature will act as an obstacle | ||
* @see isObstacle | ||
*/ | ||
void setIsObstacle( bool enabled ) { mIsObstacle = enabled; } | ||
/** Returns the obstacle factor for the feature. The factor controls the penalty | ||
* for labels overlapping this feature. | ||
* @see setObstacleFactor | ||
*/ | ||
double obstacleFactor() const { return mObstacleFactor; } | ||
/** Sets the obstacle factor for the feature. The factor controls the penalty | ||
* for labels overlapping this feature. | ||
* @param factor larger factors ( > 1.0 ) will result in labels | ||
* which are less likely to cover this feature, smaller factors ( < 1.0 ) mean labels | ||
* are more likely to cover this feature (where required) | ||
* @see obstacleFactor | ||
*/ | ||
void setObstacleFactor( double factor ) { mObstacleFactor = factor; } | ||
|
||
/** Text of the label | ||
* | ||
* Used also if "merge connected lines to avoid duplicate labels" is enabled | ||
* to identify which features may be merged. | ||
*/ | ||
QString labelText() const { return mLabelText; } | ||
//! Set text of the label | ||
void setLabelText( const QString& text ) { mLabelText = text; } | ||
|
||
//! Get additional infor required for curved label placement. Returns null if not set | ||
pal::LabelInfo* curvedLabelInfo() const { return mInfo; } | ||
//! takes ownership of the instance | ||
void setCurvedLabelInfo( pal::LabelInfo* info ) { mInfo = info; } | ||
|
||
//! Get PAL layer of the label feature. Should be only used internally in PAL | ||
pal::Layer* layer() const { return mLayer; } | ||
//! Assign PAL layer to the label feature. Should be only used internally in PAL | ||
void setLayer( pal::Layer* layer ) { mLayer = layer; } | ||
|
||
//! Return provider of this instance | ||
QgsAbstractLabelProvider* provider() const; | ||
|
||
protected: | ||
//! Pointer to PAL layer (assigned when registered to PAL) | ||
pal::Layer* mLayer; | ||
|
||
//! Associated ID unique within the parent label provider | ||
QgsFeatureId mId; | ||
//! Geometry of the feature to be labelled | ||
GEOSGeometry* mGeometry; | ||
//! Optional geometry to use for label obstacles, if different to mGeometry | ||
GEOSGeometry* mObstacleGeometry; | ||
//! Width and height of the label | ||
QSizeF mSize; | ||
//! Priority of the label | ||
double mPriority; | ||
//! whether mFixedPosition should be respected | ||
bool mHasFixedPosition; | ||
//! fixed position for the label (instead of automatic placement) | ||
QgsPoint mFixedPosition; | ||
//! whether mFixedAngle should be respected | ||
bool mHasFixedAngle; | ||
//! fixed rotation for the label (instead of automatic choice) | ||
double mFixedAngle; | ||
//! whether mQuadOffset should be respected (only for "around point" placement) | ||
bool mHasFixedQuadrant; | ||
//! whether the side of the label is fixed (only for "around point" placement) | ||
QPointF mQuadOffset; | ||
//! offset of label from the feature (only for "offset from point" placement) | ||
QgsPoint mPositionOffset; | ||
//! distance of label from the feature (only for "around point" placement or linestrings) | ||
double mDistLabel; | ||
//! distance after which label should be repeated (only for linestrings) | ||
double mRepeatDistance; | ||
//! whether to always show label - even in case of collisions | ||
bool mAlwaysShow; | ||
//! whether the feature geometry acts as an obstacle for labels | ||
bool mIsObstacle; | ||
//! how strong is the geometry acting as obstacle | ||
double mObstacleFactor; | ||
//! text of the label | ||
QString mLabelText; | ||
//! extra information for curved labels (may be null) | ||
pal::LabelInfo* mInfo; | ||
}; | ||
|
||
#endif // QGSLABELFEATURE_H |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
@wonder-sk Nice clean up! Just a note - these files are missing copyright headers