Class: QgsLabelingEngineSettings

class qgis.core.QgsLabelingEngineSettings

Bases: sip.wrapper

Stores global configuration for labeling engine

Methods

clear

Returns the configuration to the defaults

defaultTextRenderFormat

Returns the default text rendering format for the labels.

flags

Gets flags of the labeling engine

numCandidatePositions

Gets number of candidate positions that will be generated for each label feature (default to 8)

placementVersion

Returns the placement engine version, which dictates how the label placement problem is solved.

readSettingsFromProject

Read configuration of the labeling engine from a project

searchMethod

Which search method to use for removal collisions between labels

setDefaultTextRenderFormat

Sets the default text rendering format for the labels.

setFlag

Sets whether a particual flag is enabled

setFlags

Sets flags of the labeling engine

setNumCandidatePositions

Sets number of candidate positions that will be generated for each label feature

setPlacementVersion

Sets the placement engine version, which dictates how the label placement problem is solved.

setSearchMethod

Used to set which search method to use for removal collisions between labels

setUnplacedLabelColor

Sets the color to use when rendering unplaced labels.

testFlag

Test whether a particular flag is enabled

unplacedLabelColor

Returns the color to use when rendering unplaced labels.

writeSettingsToProject

Write configuration of the labeling engine to a project

Attributes

Chain

DrawCandidates

DrawLabelRectOnly

DrawUnplacedLabels

Falp

PlacementEngineVersion1

PlacementEngineVersion2

Popmusic_Chain

Popmusic_Tabu

Popmusic_Tabu_Chain

RenderOutlineLabels

UseAllLabels

UsePartialCandidates

Chain = 0
DrawCandidates = 32
DrawLabelRectOnly = 16
DrawUnplacedLabels = 64
Falp = 4
class Flag

Bases: int

class Flags

Bases: sip.wrapper

QgsLabelingEngineSettings.Flags(Union[QgsLabelingEngineSettings.Flags, QgsLabelingEngineSettings.Flag]) QgsLabelingEngineSettings.Flags(QgsLabelingEngineSettings.Flags)

class PlacementEngineVersion

Bases: int

PlacementEngineVersion1 = 0
PlacementEngineVersion2 = 1
Popmusic_Chain = 2
Popmusic_Tabu = 1
Popmusic_Tabu_Chain = 3
RenderOutlineLabels = 8
class Search

Bases: int

UseAllLabels = 2
UsePartialCandidates = 4
clear(self)

Returns the configuration to the defaults

defaultTextRenderFormat(self) → QgsRenderContext.TextRenderFormat

Returns the default text rendering format for the labels.

New in version 3.4.3.

Return type

QgsRenderContext.TextRenderFormat

flags(self) → QgsLabelingEngineSettings.Flags

Gets flags of the labeling engine

Return type

QgsLabelingEngineSettings.Flags

numCandidatePositions(self) → Tuple[int, int, int]

Gets number of candidate positions that will be generated for each label feature (default to 8)

Return type

Tuple[int, int, int]

placementVersion(self) → QgsLabelingEngineSettings.PlacementEngineVersion

Returns the placement engine version, which dictates how the label placement problem is solved.

New in version 3.10.2.

Return type

QgsLabelingEngineSettings.PlacementEngineVersion

readSettingsFromProject(self, project: QgsProject)

Read configuration of the labeling engine from a project

Parameters

project (QgsProject) –

searchMethod(self) → QgsLabelingEngineSettings.Search

Which search method to use for removal collisions between labels

Deprecated since version QGIS: 3.10 - Chain is always used.

Return type

QgsLabelingEngineSettings.Search

setDefaultTextRenderFormat(self, format: QgsRenderContext.TextRenderFormat)

Sets the default text rendering format for the labels.

New in version 3.4.3.

Parameters

format (QgsRenderContext.TextRenderFormat) –

setFlag(self, f: QgsLabelingEngineSettings.Flag, enabled: bool = True)

Sets whether a particual flag is enabled

Parameters
setFlags(self, flags: Union[QgsLabelingEngineSettings.Flags, QgsLabelingEngineSettings.Flag])

Sets flags of the labeling engine

Parameters

flags (Union[QgsLabelingEngineSettings.Flags) –

setNumCandidatePositions(self, candPoint: int, candLine: int, candPolygon: int)

Sets number of candidate positions that will be generated for each label feature

Parameters
  • candPoint (int) –

  • candLine (int) –

  • candPolygon (int) –

setPlacementVersion(self, version: QgsLabelingEngineSettings.PlacementEngineVersion)

Sets the placement engine version, which dictates how the label placement problem is solved.

New in version 3.10.2.

Parameters

version (QgsLabelingEngineSettings.PlacementEngineVersion) –

setSearchMethod(self, s: QgsLabelingEngineSettings.Search)

Used to set which search method to use for removal collisions between labels

Deprecated since version QGIS: 3.10 - Chain is always used.

Parameters

s (QgsLabelingEngineSettings.Search) –

setUnplacedLabelColor(self, color: Union[QColor, Qt.GlobalColor, QGradient])

Sets the color to use when rendering unplaced labels.

New in version 3.10.

Parameters

color (Union[QColor) –

testFlag(self, f: QgsLabelingEngineSettings.Flag) → bool

Test whether a particular flag is enabled

Parameters

f (QgsLabelingEngineSettings.Flag) –

Return type

bool

unplacedLabelColor(self) → QColor

Returns the color to use when rendering unplaced labels.

New in version 3.10.

Return type

QColor

writeSettingsToProject(self, project: QgsProject)

Write configuration of the labeling engine to a project

Parameters

project (QgsProject) –