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

#include <layer.h>

Public Types
enum	UpsideDownLabels { Upright, ShowDefined, ShowAll }

Public 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...

virtual	~Layer ()

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

QgsPalLayerSettings::Placement	arrangement () const
	Returns the layer's arrangement policy. 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...

std::size_t	maximumLineLabelCandidates () const
	Returns the maximum number of line label candidates to generate for features in this layer. More...

std::size_t	maximumPointLabelCandidates () const
	Returns the maximum number of point label candidates to generate for features in this layer. More...

std::size_t	maximumPolygonLabelCandidates () const
	Returns the maximum number of polygon label candidates to generate for features in this layer. More...

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

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

QgsLabelObstacleSettings::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	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	setMergeConnectedLines (bool merge)
	Sets whether connected lines should be merged before labeling. More...

void	setObstacleType (QgsLabelObstacleSettings::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
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...

bool	mCentroidInside

QHash< QgsFeatureId, int >	mConnectedFeaturesIds

QHash< QString, QVector< FeaturePart * > >	mConnectedHashtable

double	mDefaultPriority

bool	mDisplayAll

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

std::vector< geos::unique_ptr >	mGeosObstacleGeometries

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

bool	mLabelLayer

bool	mMergeLines

QMutex	mMutex

QString	mName

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

QgsLabelObstacleSettings::ObstacleType	mObstacleType = QgsLabelObstacleSettings::PolygonBoundary

Pal *	mPal = nullptr

QgsAbstractLabelProvider *	mProvider

UpsideDownLabels	mUpsidedownLabels

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 61 of file layer.h.

Member Enumeration Documentation

◆ UpsideDownLabels

enum pal::Layer::UpsideDownLabels

Enumerator
Upright
ShowDefined
ShowAll

Definition at line 71 of file layer.h.

Constructor & Destructor Documentation

◆ Layer()

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

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 45 of file layer.cpp.

◆ ~Layer()

Layer::~Layer ( )

virtual

Definition at line 65 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 207 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 268 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 280 of file layer.cpp.

◆ arrangement()

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

inline

Returns the layer's arrangement policy.

See also: setArrangement

Definition at line 177 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 294 of file layer.h.

◆ chopFeaturesAtRepeatDistance()

void Layer::chopFeaturesAtRepeatDistance ( )

Chop layer features at the repeat distance.

Definition at line 348 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 343 of file layer.cpp.

◆ displayAll()

bool pal::Layer::displayAll ( ) const

inline

Definition at line 95 of file layer.h.

◆ featureCount()

int pal::Layer::featureCount ( )

inline

Returns the number of features in layer.

Definition at line 100 of file layer.h.

◆ isCurved()

bool pal::Layer::isCurved ( ) const

inline

Returns true if the layer has curved labels.

Definition at line 182 of file layer.h.

◆ joinConnectedFeatures()

void Layer::joinConnectedFeatures ( )

Join connected features with the same label text.

Definition at line 303 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 222 of file layer.h.

◆ maximumLineLabelCandidates()

std::size_t pal::Layer::maximumLineLabelCandidates ( ) const

inline

Returns the maximum number of line label candidates to generate for features in this layer.

Definition at line 127 of file layer.h.

◆ maximumPointLabelCandidates()

std::size_t pal::Layer::maximumPointLabelCandidates ( ) const

inline

Returns the maximum number of point label candidates to generate for features in this layer.

Definition at line 106 of file layer.h.

◆ maximumPolygonLabelCandidates()

std::size_t pal::Layer::maximumPolygonLabelCandidates ( ) const

inline

Returns the maximum number of polygon label candidates to generate for features in this layer.

Definition at line 148 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 265 of file layer.h.

◆ name()

QString pal::Layer::name ( ) const

inline

Returns the layer's name.

Definition at line 171 of file layer.h.

◆ obstacleType()

QgsLabelObstacleSettings::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 229 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 252 of file layer.h.

◆ provider()

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

inline

Returns pointer to the associated provider.

Definition at line 166 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 85 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 201 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 189 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 287 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 216 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 259 of file layer.h.

◆ setObstacleType()

void pal::Layer::setObstacleType ( QgsLabelObstacleSettings::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 237 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 75 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 272 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 278 of file layer.h.

Friends And Related Function Documentation

◆ FeaturePart

friend class FeaturePart

friend

Definition at line 64 of file layer.h.

◆ LabelPosition

friend class LabelPosition

friend

Definition at line 68 of file layer.h.

◆ Pal

friend class Pal

friend

Definition at line 63 of file layer.h.

◆ Problem

friend class Problem

friend

Definition at line 66 of file layer.h.

Member Data Documentation

◆ mActive

bool pal::Layer::mActive

protected

Definition at line 337 of file layer.h.

◆ mArrangement

QgsPalLayerSettings::Placement pal::Layer::mArrangement

protected

Optional flags used for some placement methods.

Definition at line 343 of file layer.h.

◆ mCentroidInside

bool pal::Layer::mCentroidInside

protected

Definition at line 340 of file layer.h.

◆ mConnectedFeaturesIds

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

protected

Definition at line 353 of file layer.h.

◆ mConnectedHashtable

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

protected

Definition at line 352 of file layer.h.

◆ mDefaultPriority

double pal::Layer::mDefaultPriority

protected

Definition at line 334 of file layer.h.

◆ mDisplayAll

bool pal::Layer::mDisplayAll

protected

Definition at line 339 of file layer.h.

◆ mFeatureParts

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

protected

List of feature parts.

Definition at line 325 of file layer.h.

◆ mGeosObstacleGeometries

std::vector< geos::unique_ptr > pal::Layer::mGeosObstacleGeometries

protected

Definition at line 330 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 350 of file layer.h.

◆ mLabelLayer

bool pal::Layer::mLabelLayer

protected

Definition at line 338 of file layer.h.

◆ mMergeLines

bool pal::Layer::mMergeLines

protected

Definition at line 345 of file layer.h.

◆ mMutex

QMutex pal::Layer::mMutex

protected

Definition at line 355 of file layer.h.

◆ mName

QString pal::Layer::mName

protected

Definition at line 322 of file layer.h.

◆ mObstacleParts

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

protected

List of obstacle parts.

Definition at line 328 of file layer.h.

◆ mObstacleType

QgsLabelObstacleSettings::ObstacleType pal::Layer::mObstacleType = QgsLabelObstacleSettings::PolygonBoundary

protected

Definition at line 336 of file layer.h.

◆ mPal

Pal* pal::Layer::mPal = nullptr

protected

Definition at line 332 of file layer.h.

◆ mProvider

QgsAbstractLabelProvider* pal::Layer::mProvider

protected

Definition at line 321 of file layer.h.

◆ mUpsidedownLabels

UpsideDownLabels pal::Layer::mUpsidedownLabels

protected

Definition at line 347 of file layer.h.

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

/build/qgis-3.16.0+99unstable/src/core/pal/layer.h
/build/qgis-3.16.0+99unstable/src/core/pal/layer.cpp

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Enumeration Documentation

◆ UpsideDownLabels

Constructor & Destructor Documentation

◆ Layer()

◆ ~Layer()

Member Function Documentation

◆ active()

◆ addFeaturePart()

◆ addObstaclePart()

◆ arrangement()

◆ centroidInside()

◆ chopFeaturesAtRepeatDistance()

◆ connectedFeatureId()

◆ displayAll()

◆ featureCount()

◆ isCurved()

◆ joinConnectedFeatures()

◆ labelLayer()

◆ maximumLineLabelCandidates()

◆ maximumPointLabelCandidates()

◆ maximumPolygonLabelCandidates()

◆ mergeConnectedLines()

◆ name()

◆ obstacleType()

◆ priority()

◆ provider()

◆ registerFeature()

◆ setActive()

◆ setArrangement()

◆ setCentroidInside()

◆ setLabelLayer()

◆ setMergeConnectedLines()

◆ setObstacleType()

◆ setPriority()

◆ setUpsidedownLabels()

◆ upsidedownLabels()

Friends And Related Function Documentation

◆ FeaturePart

◆ LabelPosition

◆ Pal

◆ Problem

Member Data Documentation

◆ mActive

◆ mArrangement

◆ mCentroidInside

◆ mConnectedFeaturesIds

◆ mConnectedHashtable

◆ mDefaultPriority

◆ mDisplayAll

◆ mFeatureParts

◆ mGeosObstacleGeometries

◆ mHashtable

◆ mLabelLayer

◆ mMergeLines

◆ mMutex

◆ mName

◆ mObstacleParts

◆ mObstacleType

◆ mPal

◆ mProvider

◆ mUpsidedownLabels