#include <qgspallabeling.h>

Static Public Member Functions
static void	drawLabelCandidateRect (pal::LabelPosition lp, QPainter painter, const QgsMapToPixel xform, QList< QgsLabelCandidate > candidates=nullptr)

static bool	geometryRequiresPreparation (const QgsGeometry &geometry, QgsRenderContext &context, const QgsCoordinateTransform &ct, const QgsGeometry &clipGeometry=QgsGeometry())
	Checks whether a geometry requires preparation before registration with PAL. More...

static QgsGeometry	prepareGeometry (const QgsGeometry &geometry, QgsRenderContext &context, const QgsCoordinateTransform &ct, const QgsGeometry &clipGeometry=QgsGeometry())
	Prepares a geometry for registration with PAL. More...

static QStringList	splitToGraphemes (const QString &text)
	Splits a text string to a list of graphemes, which are the smallest allowable character divisions in the string. More...

static QStringList	splitToLines (const QString &text, const QString &wrapCharacter, int autoWrapLength=0, bool useMaxLineLengthWhenAutoWrapping=true)
	Splits a text string to a list of separate lines, using a specified wrap character (wrapCharacter). More...

static bool	staticWillUseLayer (QgsVectorLayer *layer)
	called to find out whether the layer is used for labeling More...

Friends
class	QgsDxfExport

class	QgsPalLayerSettings

class	QgsVectorLayerLabelProvider

Detailed Description

Definition at line 982 of file qgspallabeling.h.

Member Function Documentation

◆ drawLabelCandidateRect()

void QgsPalLabeling::drawLabelCandidateRect	(	pal::LabelPosition *	lp,
		QPainter *	painter,
		const QgsMapToPixel *	xform,
		QList< QgsLabelCandidate > *	candidates = `nullptr`
	)

static

Note: not available in Python bindings

Definition at line 3453 of file qgspallabeling.cpp.

◆ geometryRequiresPreparation()

bool QgsPalLabeling::geometryRequiresPreparation	(	const QgsGeometry &	geometry,
		QgsRenderContext &	context,
		const QgsCoordinateTransform &	ct,
		const QgsGeometry &	clipGeometry = `QgsGeometry()`
	)

static

Checks whether a geometry requires preparation before registration with PAL.

Parameters

geometry	geometry to prepare
context	render context
ct	coordinate transform, or invalid transform if no transformation required
clipGeometry	geometry to clip features to, if applicable

Returns: true if geometry requires preparation

Since: QGIS 2.9

Definition at line 2843 of file qgspallabeling.cpp.

◆ prepareGeometry()

QgsGeometry QgsPalLabeling::prepareGeometry	(	const QgsGeometry &	geometry,
		QgsRenderContext &	context,
		const QgsCoordinateTransform &	ct,
		const QgsGeometry &	clipGeometry = `QgsGeometry()`
	)

static

Prepares a geometry for registration with PAL.

Handles reprojection, rotation, clipping, etc.

Parameters

geometry	geometry to prepare
context	render context
ct	coordinate transform, or invalid transform if no transformation required
clipGeometry	geometry to clip features to, if applicable

Returns: prepared geometry

Since: QGIS 2.9

Definition at line 2915 of file qgspallabeling.cpp.

◆ splitToGraphemes()

QStringList QgsPalLabeling::splitToGraphemes ( const QString & text )

static

Splits a text string to a list of graphemes, which are the smallest allowable character divisions in the string.

This accounts for scripts were individual characters are not allowed to be split apart (e.g., Arabic and Indic based scripts)

Parameters

text	string to split

Returns: list of graphemes

Since: QGIS 2.10

Definition at line 2901 of file qgspallabeling.cpp.

◆ splitToLines()

QStringList QgsPalLabeling::splitToLines	(	const QString &	text,
		const QString &	wrapCharacter,
		int	autoWrapLength = `0`,
		bool	useMaxLineLengthWhenAutoWrapping = `true`
	)

static

Splits a text string to a list of separate lines, using a specified wrap character (wrapCharacter).

The text string will be split on either newline characters or the wrap character.

Since QGIS 3.4 the autoWrapLength argument can be used to specify an ideal length of line to automatically wrap text to (automatic wrapping is disabled if autoWrapLength is 0). This automatic wrapping is performed after processing wrapping using wrapCharacter. When auto wrapping is enabled, the useMaxLineLengthWhenAutoWrapping argument controls whether the lines should be wrapped to an ideal maximum of autoWrapLength characters, or if false then the lines are wrapped to an ideal minimum length of autoWrapLength characters.

Since: QGIS 2.9

Definition at line 2870 of file qgspallabeling.cpp.

◆ staticWillUseLayer()

bool QgsPalLabeling::staticWillUseLayer ( QgsVectorLayer * layer )

static

called to find out whether the layer is used for labeling

Since: QGIS 2.4

Definition at line 2837 of file qgspallabeling.cpp.

Friends And Related Function Documentation

◆ QgsDxfExport

friend class QgsDxfExport

friend

Definition at line 1063 of file qgspallabeling.h.

◆ QgsPalLayerSettings

friend class QgsPalLayerSettings

friend

Definition at line 1075 of file qgspallabeling.h.

◆ QgsVectorLayerLabelProvider

friend class QgsVectorLayerLabelProvider

friend

Definition at line 1062 of file qgspallabeling.h.

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

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

Static Public Member Functions

Friends

Detailed Description

Member Function Documentation

◆ drawLabelCandidateRect()

◆ geometryRequiresPreparation()

◆ prepareGeometry()

◆ splitToGraphemes()

◆ splitToLines()

◆ staticWillUseLayer()

Friends And Related Function Documentation

◆ QgsDxfExport

◆ QgsPalLayerSettings

◆ QgsVectorLayerLabelProvider