A layer of spacial entites. 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...

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

bool	displayAll () const

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

bool	fitInPolygonOnly () const
	Returns whether labels which do not fit completely within a polygon feature are discarded. 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...

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 (Arrangement arrangement)
	Sets the layer's arrangement policy. More...

void	setArrangementFlags (const 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	setFitInPolygonOnly (bool fitInPolygon)
	Sets whether labels which do not fit completely within a polygon feature are discarded. 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 (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, Arrangement 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...

Protected Attributes
bool	mActive

Arrangement	mArrangement
	Optional flags used for some placement methods. More...

LineArrangementFlags	mArrangementFlags

bool	mCentroidInside

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

QStringList	mConnectedTexts

double	mDefaultPriority

bool	mDisplayAll

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

bool	mFitInPolygon

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

ObstacleType	mObstacleType

QgsAbstractLabelProvider *	mProvider

UpsideDownLabels	mUpsidedownLabels

Pal *	pal

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

Friends
bool	extractFeatCallback (FeaturePart ft_ptr, void ctx)

class	FeaturePart

class	LabelPosition

class	Pal

class	Problem

Detailed Description

A layer of spacial entites.

a layer is a bog of feature with some data which influence the labelling process

Author: Maxence Laurent (maxence dot laurent at heig-vd dot ch)

Definition at line 57 of file layer.h.

Member Enumeration Documentation

enum pal::Layer::LabelMode

Enumerator
LabelPerFeature
LabelPerFeaturePart

Definition at line 68 of file layer.h.

enum pal::Layer::UpsideDownLabels

Enumerator
Upright
ShowDefined
ShowAll

Definition at line 69 of file layer.h.

Constructor & Destructor Documentation

pal::Layer::~Layer ( )

virtual

Definition at line 74 of file layer.cpp.

pal::Layer::Layer	(	QgsAbstractLabelProvider *	provider,
		const QString &	name,
		Arrangement	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 48 of file layer.cpp.

Member Function Documentation

bool pal::Layer::active ( ) const

inline

Returns whether the layer is currently active.

See also: setActive

Definition at line 128 of file layer.h.

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

protected

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

Definition at line 217 of file layer.cpp.

Arrangement pal::Layer::arrangement ( ) const

inline

Returns the layer's arrangement policy.

See also: setArrangement

Definition at line 94 of file layer.h.

LineArrangementFlags pal::Layer::arrangementFlags ( ) const

inline

Returns the layer's arrangement flags.

See also: setArrangementFlags

Definition at line 105 of file layer.h.

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

void pal::Layer::chopFeaturesAtRepeatDistance ( )

Chop layer features at the repeat distance.

Definition at line 320 of file layer.cpp.

bool pal::Layer::displayAll ( ) const

inline

Definition at line 78 of file layer.h.

int pal::Layer::featureCount ( )

inline

Returns the number of features in layer.

Definition at line 82 of file layer.h.

bool pal::Layer::fitInPolygonOnly ( ) const

inline

Returns whether labels which do not fit completely within a polygon feature are discarded.

See also: setFitInPolygonOnly

Definition at line 229 of file layer.h.

void pal::Layer::joinConnectedFeatures ( )

Join connected features with the same label text.

Definition at line 265 of file layer.cpp.

bool pal::Layer::labelLayer ( ) const

inline

Returns whether the layer will be labeled or not.

See also: setLabelLayer

Definition at line 141 of file layer.h.

LabelMode pal::Layer::labelMode ( ) const

inline

Returns the layer's labeling mode.

See also: setLabelMode

Definition at line 178 of file layer.h.

bool pal::Layer::mergeConnectedLines ( ) const

inline

Returns whether connected lines will be merged before labeling.

See also: setMergeConnectedLines

Definition at line 189 of file layer.h.

QString pal::Layer::name ( ) const

inline

Returns the layer's name.

Definition at line 89 of file layer.h.

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

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

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

inline

Returns pointer to the associated provider.

Definition at line 85 of file layer.h.

bool pal::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 100 of file layer.cpp.

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

void pal::Layer::setArrangement ( Arrangement arrangement )

inline

Sets the layer's arrangement policy.

Parameters

arrangement arrangement policy

See also: arrangement

Definition at line 100 of file layer.h.

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

inline

Sets the layer's arrangement flags.

Parameters

flags arrangement flags

See also: arrangementFlags

Definition at line 111 of file layer.h.

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

void pal::Layer::setFitInPolygonOnly ( bool fitInPolygon )

inline

Sets whether labels which do not fit completely within a polygon feature are discarded.

Parameters

fitInPolygon set to true to discard labels which do not fit within polygon features. Set to false to allow labels which partially fall outside the polygon.

See also: fitInPolygonOnly

Definition at line 223 of file layer.h.

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

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

inline

Sets the layer's labeling mode.

Parameters

mode	label mode

See also: labelMode

Definition at line 173 of file layer.h.

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

void pal::Layer::setObstacleType ( 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 154 of file layer.h.

void pal::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 90 of file layer.cpp.

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

UpsideDownLabels pal::Layer::upsidedownLabels ( ) const

inline

Returns how upside down labels are handled within the layer.

See also: setUpsidedownLabels

Definition at line 200 of file layer.h.

Friends And Related Function Documentation

bool extractFeatCallback	(	FeaturePart *	ft_ptr,
		void *	ctx
	)

friend

Definition at line 151 of file pal.cpp.

friend class FeaturePart

friend

Definition at line 60 of file layer.h.

friend class LabelPosition

friend

Definition at line 64 of file layer.h.

friend class Pal

friend

Definition at line 59 of file layer.h.

friend class Problem

friend

Definition at line 62 of file layer.h.

Member Data Documentation

bool pal::Layer::mActive

protected

Definition at line 259 of file layer.h.

Arrangement pal::Layer::mArrangement

protected

Optional flags used for some placement methods.

Definition at line 266 of file layer.h.

LineArrangementFlags pal::Layer::mArrangementFlags

protected

Definition at line 267 of file layer.h.

bool pal::Layer::mCentroidInside

protected

Definition at line 262 of file layer.h.

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

protected

Definition at line 278 of file layer.h.

QStringList pal::Layer::mConnectedTexts

protected

Definition at line 279 of file layer.h.

double pal::Layer::mDefaultPriority

protected

Definition at line 256 of file layer.h.

bool pal::Layer::mDisplayAll

protected

Definition at line 261 of file layer.h.

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

protected

List of feature parts.

Definition at line 252 of file layer.h.

bool pal::Layer::mFitInPolygon

protected

Definition at line 263 of file layer.h.

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

protected

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

Definition at line 276 of file layer.h.

bool pal::Layer::mLabelLayer

protected

Definition at line 260 of file layer.h.

bool pal::Layer::mMergeLines

protected

Definition at line 269 of file layer.h.

LabelMode pal::Layer::mMode

protected

Definition at line 268 of file layer.h.

QMutex pal::Layer::mMutex

protected

Definition at line 281 of file layer.h.

QString pal::Layer::mName

protected

Definition at line 249 of file layer.h.

ObstacleType pal::Layer::mObstacleType

protected

Definition at line 258 of file layer.h.

QgsAbstractLabelProvider* pal::Layer::mProvider

protected

Definition at line 248 of file layer.h.

UpsideDownLabels pal::Layer::mUpsidedownLabels

protected

Definition at line 271 of file layer.h.

Pal* pal::Layer::pal

protected

Definition at line 254 of file layer.h.

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

protected

Definition at line 274 of file layer.h.

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

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

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation