A set of features which influence the labeling process. More...

#include <layer.h>

Public Types
enum	LabelMode { LabelPerFeature, LabelPerFeaturePart }

enum	UpsideDownLabels { Upright, ShowDefined, ShowAll }

Public Member Functions
virtual	~Layer ()

bool	active () const
	Returns whether the layer is currently active. More...

QgsPalLayerSettings::Placement	arrangement () const
	Returns the layer's arrangement policy. More...

LineArrangementFlags	arrangementFlags () const
	Returns the layer's arrangement flags. More...

bool	centroidInside () const
	Returns whether labels placed at the centroid of features within the layer are forced to be placed inside the feature's geometry. More...

void	chopFeaturesAtRepeatDistance ()
	Chop layer features at the repeat distance *. More...

int	connectedFeatureId (QgsFeatureId featureId) const
	Returns the connected feature ID for a label feature ID, which is unique for all features which have been joined as a result of joinConnectedFeatures() More...

bool	displayAll () const

int	featureCount ()
	Returns the number of features in layer. More...

bool	isCurved () const
	Returns true if the layer has curved labels. More...

void	joinConnectedFeatures ()
	Join connected features with the same label text. More...

bool	labelLayer () const
	Returns whether the layer will be labeled or not. More...

LabelMode	labelMode () const
	Returns the layer's labeling mode. More...

bool	mergeConnectedLines () const
	Returns whether connected lines will be merged before labeling. More...

QString	name () const
	Returns the layer's name. More...

QgsPalLayerSettings::ObstacleType	obstacleType () const
	Returns the obstacle type, which controls how features within the layer act as obstacles for labels. More...

double	priority () const
	Returns the layer's priority, between 0 and 1. More...

QgsAbstractLabelProvider *	provider () const
	Returns pointer to the associated provider. More...

bool	registerFeature (QgsLabelFeature *label)
	Register a feature in the layer. More...

void	setActive (bool active)
	Sets whether the layer is currently active. More...

void	setArrangement (QgsPalLayerSettings::Placement arrangement)
	Sets the layer's arrangement policy. More...

void	setArrangementFlags (LineArrangementFlags flags)
	Sets the layer's arrangement flags. More...

void	setCentroidInside (bool forceInside)
	Sets whether labels placed at the centroid of features within the layer are forced to be placed inside the feature's geometry. More...

void	setLabelLayer (bool toLabel)
	Sets whether the layer will be labeled. More...

void	setLabelMode (LabelMode mode)
	Sets the layer's labeling mode. More...

void	setMergeConnectedLines (bool merge)
	Sets whether connected lines should be merged before labeling. More...

void	setObstacleType (QgsPalLayerSettings::ObstacleType obstacleType)
	Sets the obstacle type, which controls how features within the layer act as obstacles for labels. More...

void	setPriority (double priority)
	Sets the layer's priority. More...

void	setUpsidedownLabels (UpsideDownLabels ud)
	Sets how upside down labels will be handled within the layer. More...

UpsideDownLabels	upsidedownLabels () const
	Returns how upside down labels are handled within the layer. More...

Protected Member Functions
	Layer (QgsAbstractLabelProvider provider, const QString &name, QgsPalLayerSettings::Placement arrangement, double defaultPriority, bool active, bool toLabel, Pal pal, bool displayAll=false)
	Create a new layer. More...

void	addFeaturePart (FeaturePart *fpart, const QString &labelText=QString())
	Add newly created feature part into r tree and to the list. More...

void	addObstaclePart (FeaturePart *fpart)
	Add newly created obstacle part into r tree and to the list. More...

Protected Attributes
bool	mActive

QgsPalLayerSettings::Placement	mArrangement
	Optional flags used for some placement methods. More...

LineArrangementFlags	mArrangementFlags

bool	mCentroidInside

QHash< QgsFeatureId, int >	mConnectedFeaturesIds

QHash< QString, QLinkedList< FeaturePart * > *>	mConnectedHashtable

QStringList	mConnectedTexts

double	mDefaultPriority

bool	mDisplayAll

RTree< FeaturePart , double, 2, double, 8, 4 >	mFeatureIndex

QLinkedList< FeaturePart * >	mFeatureParts
	List of feature parts. More...

QHash< QgsFeatureId, QgsLabelFeature * >	mHashtable
	Lookup table of label features (owned by the label feature provider that created them) More...

bool	mLabelLayer

bool	mMergeLines

LabelMode	mMode

QMutex	mMutex

QString	mName

RTree< FeaturePart , double, 2, double, 8, 4 >	mObstacleIndex

QList< FeaturePart * >	mObstacleParts
	List of obstacle parts. More...

QgsPalLayerSettings::ObstacleType	mObstacleType

QgsAbstractLabelProvider *	mProvider

UpsideDownLabels	mUpsidedownLabels

Pal *	pal = nullptr

Friends
class	FeaturePart

class	LabelPosition

class	Pal

class	Problem

Detailed Description

A set of features which influence the labeling process.

Note: not available in Python bindings

Definition at line 63 of file layer.h.

Member Enumeration Documentation

◆ LabelMode

enum pal::Layer::LabelMode

Enumerator
LabelPerFeature
LabelPerFeaturePart

Definition at line 73 of file layer.h.

◆ UpsideDownLabels

enum pal::Layer::UpsideDownLabels

Enumerator
Upright
ShowDefined
ShowAll

Definition at line 74 of file layer.h.

Constructor & Destructor Documentation

◆ ~Layer()

Layer::~Layer ( )

virtual

Definition at line 70 of file layer.cpp.

◆ Layer()

Layer::Layer	(	QgsAbstractLabelProvider *	provider,
		const QString &	name,
		QgsPalLayerSettings::Placement	arrangement,
		double	defaultPriority,
		bool	active,
		bool	toLabel,
		Pal *	pal,
		bool	displayAll = `false`
	)

protected

Create a new layer.

Parameters

provider	Associated provider
name	Name of the layer (for stats, debugging - does not need to be unique)
arrangement	Arrangement mode : how to place candidates
defaultPriority	layer's prioriry (0 is the best, 1 the worst)
active	is the layer is active (currently displayed)
toLabel	the layer will be labeled whether toLablel is true
pal	pointer to the pal object
displayAll	if true, all features will be labelled even though overlaps occur

Definition at line 44 of file layer.cpp.

Member Function Documentation

◆ active()

bool pal::Layer::active ( ) const

inline

Returns whether the layer is currently active.

See also: setActive

Definition at line 145 of file layer.h.

◆ addFeaturePart()

void Layer::addFeaturePart	(	FeaturePart *	fpart,
		const QString &	labelText = `QString()`
	)

protected

Add newly created feature part into r tree and to the list.

Definition at line 290 of file layer.cpp.

◆ addObstaclePart()

void Layer::addObstaclePart ( FeaturePart * fpart )

protected

Add newly created obstacle part into r tree and to the list.

Definition at line 321 of file layer.cpp.

◆ arrangement()

QgsPalLayerSettings::Placement pal::Layer::arrangement ( ) const

inline

Returns the layer's arrangement policy.

See also: setArrangement

Definition at line 102 of file layer.h.

◆ arrangementFlags()

LineArrangementFlags pal::Layer::arrangementFlags ( ) const

inline

Returns the layer's arrangement flags.

See also: setArrangementFlags

Definition at line 120 of file layer.h.

◆ centroidInside()

bool pal::Layer::centroidInside ( ) const

inline

Returns whether labels placed at the centroid of features within the layer are forced to be placed inside the feature's geometry.

See also: setCentroidInside

Definition at line 245 of file layer.h.

◆ chopFeaturesAtRepeatDistance()

void Layer::chopFeaturesAtRepeatDistance ( )

Chop layer features at the repeat distance *.

Definition at line 419 of file layer.cpp.

◆ connectedFeatureId()

int Layer::connectedFeatureId ( QgsFeatureId featureId ) const

Returns the connected feature ID for a label feature ID, which is unique for all features which have been joined as a result of joinConnectedFeatures()

Returns: connected feature ID, or -1 if feature was not joined

Definition at line 414 of file layer.cpp.

◆ displayAll()

bool pal::Layer::displayAll ( ) const

inline

Definition at line 83 of file layer.h.

◆ featureCount()

int pal::Layer::featureCount ( )

inline

Returns the number of features in layer.

Definition at line 88 of file layer.h.

◆ isCurved()

bool pal::Layer::isCurved ( ) const

inline

Returns true if the layer has curved labels.

Definition at line 107 of file layer.h.

◆ joinConnectedFeatures()

void Layer::joinConnectedFeatures ( )

Join connected features with the same label text.

Definition at line 351 of file layer.cpp.

◆ labelLayer()

bool pal::Layer::labelLayer ( ) const

inline

Returns whether the layer will be labeled or not.

See also: setLabelLayer

Definition at line 160 of file layer.h.

◆ labelMode()

LabelMode pal::Layer::labelMode ( ) const

inline

Returns the layer's labeling mode.

See also: setLabelMode

Definition at line 203 of file layer.h.

◆ mergeConnectedLines()

bool pal::Layer::mergeConnectedLines ( ) const

inline

Returns whether connected lines will be merged before labeling.

See also: setMergeConnectedLines

Definition at line 216 of file layer.h.

◆ name()

QString pal::Layer::name ( ) const

inline

Returns the layer's name.

Definition at line 96 of file layer.h.

◆ obstacleType()

QgsPalLayerSettings::ObstacleType pal::Layer::obstacleType ( ) const

inline

Returns the obstacle type, which controls how features within the layer act as obstacles for labels.

See also: setObstacleType

Definition at line 167 of file layer.h.

◆ priority()

double pal::Layer::priority ( ) const

inline

Returns the layer's priority, between 0 and 1.

0 corresponds to highest priority, 1 to lowest priority.

See also: setPriority

Definition at line 190 of file layer.h.

◆ provider()

QgsAbstractLabelProvider* pal::Layer::provider ( ) const

inline

Returns pointer to the associated provider.

Definition at line 91 of file layer.h.

◆ registerFeature()

bool Layer::registerFeature ( QgsLabelFeature * label )

Register a feature in the layer.

Does not take ownership of the label feature (it is owned by its provider).

Exceptions

PalException::FeatureExists

Returns: true on success (i.e. valid geometry)

Definition at line 96 of file layer.cpp.

◆ setActive()

void pal::Layer::setActive ( bool active )

inline

Sets whether the layer is currently active.

Active means "is currently displayed or used as obstacles". When a layer is deactivated then feature of this layer will not be used for either labeling or as obstacles.

Parameters

active set to true to make the layer active, or false to deactivate the layer

See also: active

Definition at line 139 of file layer.h.

◆ setArrangement()

void pal::Layer::setArrangement ( QgsPalLayerSettings::Placement arrangement )

inline

Sets the layer's arrangement policy.

Parameters

arrangement arrangement policy

See also: arrangement

Definition at line 114 of file layer.h.

◆ setArrangementFlags()

void pal::Layer::setArrangementFlags ( LineArrangementFlags flags )

inline

Sets the layer's arrangement flags.

Parameters

flags arrangement flags

See also: arrangementFlags

Definition at line 127 of file layer.h.

◆ setCentroidInside()

void pal::Layer::setCentroidInside ( bool forceInside )

inline

Sets whether labels placed at the centroid of features within the layer are forced to be placed inside the feature's geometry.

Parameters

forceInside set to true to force centroid labels to be within the feature. If set to false then the centroid may fall outside the feature.

See also: centroidInside

Definition at line 238 of file layer.h.

◆ setLabelLayer()

void pal::Layer::setLabelLayer ( bool toLabel )

inline

Sets whether the layer will be labeled.

Note: Layers are labelled if and only if labelLayer and active are true

Parameters

toLabel set to false disable labeling this layer

See also: labelLayer; setActive

Definition at line 154 of file layer.h.

◆ setLabelMode()

void pal::Layer::setLabelMode ( LabelMode mode )

inline

Sets the layer's labeling mode.

Parameters

mode	label mode

See also: labelMode

Definition at line 197 of file layer.h.

◆ setMergeConnectedLines()

void pal::Layer::setMergeConnectedLines ( bool merge )

inline

Sets whether connected lines should be merged before labeling.

Parameters

merge set to true to merge connected lines

See also: mergeConnectedLines

Definition at line 210 of file layer.h.

◆ setObstacleType()

void pal::Layer::setObstacleType ( QgsPalLayerSettings::ObstacleType obstacleType )

inline

Sets the obstacle type, which controls how features within the layer act as obstacles for labels.

Parameters

obstacleType new obstacle type

See also: obstacleType

Definition at line 175 of file layer.h.

◆ setPriority()

void Layer::setPriority ( double priority )

Sets the layer's priority.

Parameters

priority layer priority, between 0 and 1. 0 corresponds to highest priority, 1 to lowest priority.

See also: priority

Definition at line 86 of file layer.cpp.

◆ setUpsidedownLabels()

void pal::Layer::setUpsidedownLabels ( UpsideDownLabels ud )

inline

Sets how upside down labels will be handled within the layer.

Parameters

ud	upside down label handling mode

See also: upsidedownLabels

Definition at line 223 of file layer.h.

◆ upsidedownLabels()

UpsideDownLabels pal::Layer::upsidedownLabels ( ) const

inline

Returns how upside down labels are handled within the layer.

See also: setUpsidedownLabels

Definition at line 229 of file layer.h.

Friends And Related Function Documentation

◆ FeaturePart

friend class FeaturePart

friend

Definition at line 66 of file layer.h.

◆ LabelPosition

friend class LabelPosition

friend

Definition at line 70 of file layer.h.

◆ Pal

friend class Pal

friend

Definition at line 65 of file layer.h.

◆ Problem

friend class Problem

friend

Definition at line 68 of file layer.h.

Member Data Documentation

◆ mActive

bool pal::Layer::mActive

protected

Definition at line 286 of file layer.h.

◆ mArrangement

QgsPalLayerSettings::Placement pal::Layer::mArrangement

protected

Optional flags used for some placement methods.

Definition at line 292 of file layer.h.

◆ mArrangementFlags

LineArrangementFlags pal::Layer::mArrangementFlags

protected

Definition at line 293 of file layer.h.

◆ mCentroidInside

bool pal::Layer::mCentroidInside

protected

Definition at line 289 of file layer.h.

◆ mConnectedFeaturesIds

QHash< QgsFeatureId, int > pal::Layer::mConnectedFeaturesIds

protected

Definition at line 309 of file layer.h.

◆ mConnectedHashtable

QHash< QString, QLinkedList<FeaturePart *>* > pal::Layer::mConnectedHashtable

protected

Definition at line 307 of file layer.h.

◆ mConnectedTexts

QStringList pal::Layer::mConnectedTexts

protected

Definition at line 308 of file layer.h.

◆ mDefaultPriority

double pal::Layer::mDefaultPriority

protected

Definition at line 283 of file layer.h.

◆ mDisplayAll

bool pal::Layer::mDisplayAll

protected

Definition at line 288 of file layer.h.

◆ mFeatureIndex

RTree<FeaturePart *, double, 2, double, 8, 4>* pal::Layer::mFeatureIndex

protected

Definition at line 300 of file layer.h.

◆ mFeatureParts

QLinkedList<FeaturePart *> pal::Layer::mFeatureParts

protected

List of feature parts.

Definition at line 276 of file layer.h.

◆ mHashtable

QHash< QgsFeatureId, QgsLabelFeature *> pal::Layer::mHashtable

protected

Lookup table of label features (owned by the label feature provider that created them)

Definition at line 302 of file layer.h.

◆ mLabelLayer

bool pal::Layer::mLabelLayer

protected

Definition at line 287 of file layer.h.

◆ mMergeLines

bool pal::Layer::mMergeLines

protected

Definition at line 295 of file layer.h.

◆ mMode

LabelMode pal::Layer::mMode

protected

Definition at line 294 of file layer.h.

◆ mMutex

QMutex pal::Layer::mMutex

protected

Definition at line 311 of file layer.h.

◆ mName

QString pal::Layer::mName

protected

Definition at line 273 of file layer.h.

◆ mObstacleIndex

RTree<FeaturePart *, double, 2, double, 8, 4>* pal::Layer::mObstacleIndex

protected

Definition at line 305 of file layer.h.

◆ mObstacleParts

QList<FeaturePart *> pal::Layer::mObstacleParts

protected

List of obstacle parts.

Definition at line 279 of file layer.h.

◆ mObstacleType

QgsPalLayerSettings::ObstacleType pal::Layer::mObstacleType

protected

Definition at line 285 of file layer.h.

◆ mProvider

QgsAbstractLabelProvider* pal::Layer::mProvider

protected

Definition at line 272 of file layer.h.

◆ mUpsidedownLabels

UpsideDownLabels pal::Layer::mUpsidedownLabels

protected

Definition at line 297 of file layer.h.

◆ pal

Pal* pal::Layer::pal = nullptr

protected

Definition at line 281 of file layer.h.

The documentation for this class was generated from the following files:

/tmp/buildd/qgis-3.6.0+99unstable/src/core/pal/layer.h
/tmp/buildd/qgis-3.6.0+99unstable/src/core/pal/layer.cpp

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Enumeration Documentation

◆ LabelMode

◆ UpsideDownLabels

Constructor & Destructor Documentation

◆ ~Layer()

◆ Layer()

Member Function Documentation

◆ active()

◆ addFeaturePart()

◆ addObstaclePart()

◆ arrangement()

◆ arrangementFlags()

◆ centroidInside()

◆ chopFeaturesAtRepeatDistance()

◆ connectedFeatureId()

◆ displayAll()

◆ featureCount()

◆ isCurved()

◆ joinConnectedFeatures()

◆ labelLayer()

◆ labelMode()

◆ mergeConnectedLines()

◆ name()

◆ obstacleType()

◆ priority()

◆ provider()

◆ registerFeature()

◆ setActive()

◆ setArrangement()

◆ setArrangementFlags()

◆ setCentroidInside()

◆ setLabelLayer()

◆ setLabelMode()

◆ setMergeConnectedLines()

◆ setObstacleType()

◆ setPriority()

◆ setUpsidedownLabels()

◆ upsidedownLabels()

Friends And Related Function Documentation

◆ FeaturePart

◆ LabelPosition

◆ Pal

◆ Problem

Member Data Documentation

◆ mActive

◆ mArrangement

◆ mArrangementFlags

◆ mCentroidInside

◆ mConnectedFeaturesIds

◆ mConnectedHashtable

◆ mConnectedTexts

◆ mDefaultPriority

◆ mDisplayAll

◆ mFeatureIndex

◆ mFeatureParts

◆ mHashtable

◆ mLabelLayer

◆ mMergeLines

◆ mMode

◆ mMutex

◆ mName

◆ mObstacleIndex

◆ mObstacleParts

◆ mObstacleType

◆ mProvider

◆ mUpsidedownLabels

◆ pal