Class: QgsPalLayerSettings¶
-
class
qgis.core.
QgsPalLayerSettings
¶ Bases:
sip.wrapper
QgsPalLayerSettings(s:
QgsPalLayerSettings
)Methods
Calculates the space required to render the provided
text
in map units.Returns the label callout renderer, responsible for drawing label callouts.
Returns a reference to the label’s property collection, used for data defined overrides.
Returns the label text formatting settings, e.g., font settings, buffer settings, etc.
Returns the
QgsExpression
for this label settings.Returns a pixmap preview for label
settings
.Returns the label obstacle settings.
Returns the polygon placement flags, which dictate how polygon labels can be placed.
Prepare for registration of features.
Returns the labeling property definitions.
Read settings from a DOM element
Returns all field names referenced by the configuration (e.g.
Register a feature for labeling.
Sets the label
callout
renderer, responsible for drawing label callouts.Sets the label’s property collection, used for data defined overrides.
Sets the label text formatting settings, e.g., font settings, buffer settings, etc.
Sets the label obstacle
settings
.Sets the polygon placement
flags
, which dictate how polygon labels can be placed.Sets the label thinning
settings
.Prepares the label settings for rendering.
Finalises the label settings after use.
Returns the label thinning settings.
Write settings into a DOM element
Attributes
-
AboveLine
= 2¶
-
AlwaysShow
= 20¶
-
AroundPoint
= 0¶
-
AutoWrapLength
= 101¶
-
BelowLine
= 4¶
-
Bold
= 1¶
-
BottomLeft
= 7¶
-
BottomMiddle
= 9¶
-
BottomRight
= 11¶
-
BottomSlightlyLeft
= 8¶
-
BottomSlightlyRight
= 10¶
-
BufferBlendMode
= 45¶
-
BufferColor
= 8¶
-
BufferDraw
= 42¶
-
BufferJoinStyle
= 44¶
-
BufferOpacity
= 94¶
-
BufferSize
= 7¶
-
BufferTransp
= 19¶
-
BufferUnit
= 43¶
-
CalloutDraw
= 100¶
-
CentroidWhole
= 76¶
-
Color
= 4¶
-
Curved
= 3¶
-
CurvedCharAngleInOut
= 83¶
-
DirSymbDraw
= 34¶
-
DirSymbLeft
= 35¶
-
DirSymbPlacement
= 37¶
-
DirSymbReverse
= 38¶
-
DirSymbRight
= 36¶
-
class
DirectionSymbols
¶ Bases:
int
-
DistanceUnits
= 81¶
-
Family
= 6¶
-
FontBlendMode
= 30¶
-
FontCase
= 27¶
-
FontLetterSpacing
= 28¶
-
FontLimitPixel
= 24¶
-
FontMaxPixel
= 26¶
-
FontMinPixel
= 25¶
-
FontOpacity
= 92¶
-
FontSizeUnit
= 22¶
-
FontStyle
= 21¶
-
FontTransp
= 18¶
-
FontWordSpacing
= 29¶
-
Free
= 5¶
-
FromPoint
= 0¶
-
FromSymbolBounds
= 1¶
-
Hali
= 11¶
-
Horizontal
= 4¶
-
IsObstacle
= 88¶
-
Italic
= 2¶
-
LabelAllParts
= 103¶
-
LabelDistance
= 13¶
-
LabelRotation
= 96¶
-
Line
= 2¶
-
class
LinePlacementFlags
¶ Bases:
int
-
LinePlacementOptions
= 99¶
-
MapOrientation
= 8¶
-
MaskBufferSize
= 105¶
-
MaskBufferUnit
= 106¶
-
MaskEnabled
= 104¶
-
MaskJoinStyle
= 108¶
-
MaskOpacity
= 107¶
-
MaxScale
= 17¶
-
MaximumScale
= 98¶
-
MiddleLeft
= 5¶
-
MiddleRight
= 6¶
-
MinScale
= 16¶
-
MinimumScale
= 97¶
-
MultiCenter
= 1¶
-
MultiFollowPlacement
= 3¶
-
MultiLeft
= 0¶
-
class
MultiLineAlign
¶ Bases:
int
-
MultiLineAlignment
= 33¶
-
MultiLineHeight
= 32¶
-
MultiLineWrapChar
= 31¶
-
MultiRight
= 2¶
-
NumDecimals
= 40¶
-
NumFormat
= 39¶
-
NumPlusSign
= 41¶
-
ObstacleFactor
= 89¶
-
class
ObstacleType
¶ Bases:
int
-
OffsetQuad
= 77¶
-
OffsetRotation
= 82¶
-
class
OffsetType
¶ Bases:
int
-
OffsetUnits
= 80¶
-
OffsetXY
= 78¶
-
OnLine
= 1¶
-
OrderedPositionsAroundPoint
= 6¶
-
OutsidePolygons
= 8¶
-
OverPoint
= 1¶
-
OverrunDistance
= 102¶
-
PerimeterCurved
= 7¶
-
class
Placement
¶ Bases:
int
-
PolygonBoundary
= 1¶
-
PolygonInterior
= 0¶
-
PolygonLabelOutside
= 109¶
-
PolygonWhole
= 2¶
-
PositionX
= 9¶
-
PositionY
= 10¶
-
class
PredefinedPointPosition
¶ Bases:
int
-
PredefinedPositionOrder
= 91¶
-
Priority
= 87¶
-
class
Property
¶ Bases:
int
-
QuadrantAbove
= 1¶
-
QuadrantAboveLeft
= 0¶
-
QuadrantAboveRight
= 2¶
-
QuadrantBelow
= 7¶
-
QuadrantBelowLeft
= 6¶
-
QuadrantBelowRight
= 8¶
-
QuadrantLeft
= 3¶
-
QuadrantOver
= 4¶
-
class
QuadrantPosition
¶ Bases:
int
-
QuadrantRight
= 5¶
-
RepeatDistance
= 84¶
-
RepeatDistanceUnit
= 86¶
-
Rotation
= 14¶
-
ScaleVisibility
= 23¶
-
ShadowBlendMode
= 75¶
-
ShadowColor
= 74¶
-
ShadowDraw
= 65¶
-
ShadowOffsetAngle
= 67¶
-
ShadowOffsetDist
= 68¶
-
ShadowOffsetUnits
= 69¶
-
ShadowOpacity
= 95¶
-
ShadowRadius
= 70¶
-
ShadowRadiusUnits
= 71¶
-
ShadowScale
= 73¶
-
ShadowTransparency
= 72¶
-
ShadowUnder
= 66¶
-
ShapeBlendMode
= 64¶
-
ShapeDraw
= 46¶
-
ShapeFillColor
= 58¶
-
ShapeJoinStyle
= 62¶
-
ShapeKind
= 47¶
-
ShapeOffset
= 54¶
-
ShapeOffsetUnits
= 55¶
-
ShapeOpacity
= 93¶
-
ShapeRadii
= 56¶
-
ShapeRadiiUnits
= 57¶
-
ShapeRotation
= 53¶
-
ShapeRotationType
= 52¶
-
ShapeSVGFile
= 48¶
-
ShapeSizeType
= 49¶
-
ShapeSizeUnits
= 51¶
-
ShapeSizeX
= 50¶
-
ShapeSizeY
= 85¶
-
ShapeStrokeColor
= 59¶
-
ShapeStrokeWidth
= 60¶
-
ShapeStrokeWidthUnits
= 61¶
-
ShapeTransparency
= 63¶
-
Show
= 15¶
-
ShowAll
= 2¶
-
ShowDefined
= 1¶
-
Size
= 0¶
-
Strikeout
= 5¶
-
SymbolAbove
= 1¶
-
SymbolBelow
= 2¶
-
SymbolLeftRight
= 0¶
-
TextOrientation
= 110¶
-
TopLeft
= 0¶
-
TopMiddle
= 2¶
-
TopRight
= 4¶
-
TopSlightlyLeft
= 1¶
-
TopSlightlyRight
= 3¶
-
Underline
= 3¶
-
Upright
= 0¶
-
class
UpsideDownLabels
¶ Bases:
int
-
Vali
= 12¶
-
ZIndex
= 90¶
-
addDirectionSymbol
¶
-
angleOffset
¶
-
autoWrapLength
¶
-
calculateLabelSize
(self, fm: QFontMetricsF, text: str, f: QgsFeature = None, context: QgsRenderContext = None) → Tuple[float, float, float, float]¶ Calculates the space required to render the provided
text
in map units. Results will be written tolabelX
andlabelY
. If the text orientation is set to rotation-based, the spaced taken to render vertically oriented text will be written torotatedLabelX
androtatedLabelY
.- Parameters
fm (QFontMetricsF) –
text (str) –
f (
QgsFeature
= None) –context (
QgsRenderContext
= None) –
- Return type
Tuple[float, float, float, float]
-
callout
(self) → QgsCallout¶ Returns the label callout renderer, responsible for drawing label callouts.
Ownership is not transferred.
See also
New in version 3.10.
- Return type
-
centroidInside
¶
-
centroidWhole
¶
-
ct
¶
-
dataDefinedProperties
(self) → QgsPropertyCollection¶ Returns a reference to the label’s property collection, used for data defined overrides.
See also
New in version 3.0.
- Return type
-
decimals
¶
-
displayAll
¶
-
dist
¶
-
distMapUnitScale
¶
-
distUnits
¶
-
drawLabels
¶
-
extentGeom
¶
-
fieldIndex
¶
-
fieldName
¶
-
fitInPolygonOnly
¶
-
fontLimitPixelSize
¶
-
fontMaxPixelSize
¶
-
fontMinPixelSize
¶
-
format
(self) → QgsTextFormat¶ Returns the label text formatting settings, e.g., font settings, buffer settings, etc.
See also
New in version 3.0.
- Return type
-
formatNumbers
¶
-
geometryGenerator
¶
-
geometryGeneratorEnabled
¶
-
geometryGeneratorType
¶
-
getLabelExpression
(self) → QgsExpression¶ Returns the
QgsExpression
for this label settings. May beNone
if isExpression isFalse
.- Return type
-
isExpression
¶
-
labelOffsetMapUnitScale
¶
-
labelPerPart
¶
-
labelSettingsPreviewPixmap
(settings: QgsPalLayerSettings, size: QSize, previewText: str = '', padding: int = 0) → QPixmap¶ Returns a pixmap preview for label
settings
.- Parameters
settings (QgsPalLayerSettings) – label settings
size (QSize) – target pixmap size
previewText (str = '') – text to render in preview, or empty for default text
padding (int = 0) – space between icon edge and color ramp
New in version 3.10.
- Return type
QPixmap
-
layerType
¶
-
leftDirectionSymbol
¶
-
property
limitNumLabels
¶ _limitNumLabels(self) -> bool
- Return type
bool
-
mCurFeat
¶
-
mCurFields
¶
-
mFeatsRegPal
¶
-
mFeatsSendingToPal
¶
-
mFeaturesToLabel
¶
-
maxCurvedCharAngleIn
¶
-
maxCurvedCharAngleOut
¶
-
property
maxNumLabels
¶ _maxNumLabels(self) -> int
- Return type
int
-
maximumScale
¶
-
mergeLines
¶
-
property
minFeatureSize
¶ _minFeatureSize(self) -> float
- Return type
float
-
minimumScale
¶
-
multilineAlign
¶
-
property
obstacle
¶ _getIsObstacle(self) -> bool
- Return type
bool
-
property
obstacleFactor
¶ _getObstacleFactor(self) -> float
- Return type
float
-
obstacleSettings
(self) → QgsLabelObstacleSettings¶ Returns the label obstacle settings.
See also
New in version 3.10.2.
- Return type
-
property
obstacleType
¶ _getObstacleType(self) -> QgsPalLayerSettings.ObstacleType
- Return type
-
offsetType
¶
-
offsetUnits
¶
-
overrunDistance
¶
-
overrunDistanceMapUnitScale
¶
-
overrunDistanceUnit
¶
-
placeDirectionSymbol
¶
-
placement
¶
-
placementFlags
¶
-
plusSign
¶
-
polygonPlacementFlags
(self) → QgsLabeling.PolygonPlacementFlags¶ Returns the polygon placement flags, which dictate how polygon labels can be placed.
See also
New in version 3.14.
- Return type
-
prepare
(self, context: QgsRenderContext, attributeNames: Iterable[str], fields: QgsFields, mapSettings: QgsMapSettings, crs: QgsCoordinateReferenceSystem) → Tuple[bool, Set[str]]¶ Prepare for registration of features. The
context
,mapSettings
andfields
parameters give more information about the rendering environment. If targetcrs
is not specified, the targetCrs frommapSettings
will be taken. The parameterattributeNames
should be updated to contain all the field names which the labeling requires for the rendering.New in version 3.8.
- Parameters
context (QgsRenderContext) –
attributeNames (Iterable[str]) –
fields (QgsFields) –
mapSettings (QgsMapSettings) –
crs (QgsCoordinateReferenceSystem) –
- Return type
Tuple[bool, Set[str]]
-
preserveRotation
¶
-
previewBkgrdColor
¶
-
priority
¶
-
propertyDefinitions
() → Dict[int, QgsPropertyDefinition]¶ Returns the labeling property definitions.
New in version 3.0.
- Return type
Dict[int, QgsPropertyDefinition]
-
ptOne
¶
-
ptZero
¶
-
quadOffset
¶
-
readXml
(self, elem: QDomElement, context: QgsReadWriteContext)¶ Read settings from a DOM element
New in version 2.12.
- Parameters
elem (QDomElement) –
context (QgsReadWriteContext) –
-
referencedFields
(self, context: QgsRenderContext) → Set[str]¶ Returns all field names referenced by the configuration (e.g. field name or expression, data defined properties).
New in version 3.14.
- Parameters
context (QgsRenderContext) –
- Return type
Set[str]
-
registerFeature
(self, f: QgsFeature, context: QgsRenderContext)¶ Register a feature for labeling.
- Parameters
f (QgsFeature) – feature to label
context (QgsRenderContext) – render context. The
QgsExpressionContext
contained within the render context must have already had the feature and fields sets prior to calling this method.labelFeature – if using
QgsLabelingEngine
, this will receive the label feature. Not available in Python bindings.symbol – feature symbol to label (ownership is not transferred, and
symbol
must exist until the labeling is complete)
-
repeatDistance
¶
-
repeatDistanceMapUnitScale
¶
-
repeatDistanceUnit
¶
-
reverseDirectionSymbol
¶
-
rightDirectionSymbol
¶
-
scaleVisibility
¶
-
setCallout
(self, callout: QgsCallout)¶ Sets the label
callout
renderer, responsible for drawing label callouts.Ownership of
callout
is transferred to the settings.See also
New in version 3.10.
- Parameters
callout (QgsCallout) –
-
setDataDefinedProperties
(self, collection: QgsPropertyCollection)¶ Sets the label’s property collection, used for data defined overrides.
- Parameters
collection (QgsPropertyCollection) – property collection. Existing properties will be replaced.
See also
See also
Property
New in version 3.0.
-
setFormat
(self, format: QgsTextFormat)¶ Sets the label text formatting settings, e.g., font settings, buffer settings, etc.
- Parameters
format (QgsTextFormat) – label text format
See also
New in version 3.0.
-
setObstacleSettings
(self, settings: QgsLabelObstacleSettings)¶ Sets the label obstacle
settings
.See also
New in version 3.10.2.
- Parameters
settings (QgsLabelObstacleSettings) –
-
setPolygonPlacementFlags
(self, flags: Union[QgsLabeling.PolygonPlacementFlags, QgsLabeling.PolygonPlacementFlag])¶ Sets the polygon placement
flags
, which dictate how polygon labels can be placed.See also
New in version 3.14.
- Parameters
flags (Union[QgsLabeling.PolygonPlacementFlags) –
-
setThinningSettings
(self, settings: QgsLabelThinningSettings)¶ Sets the label thinning
settings
.See also
New in version 3.12.
- Parameters
settings (QgsLabelThinningSettings) –
-
startRender
(self, context: QgsRenderContext)¶ Prepares the label settings for rendering.
This should be called before rendering any labels, and must be followed by a call to
stopRender()
in order to gracefully clean up symbols.New in version 3.10.
- Parameters
context (QgsRenderContext) –
-
stopRender
(self, context: QgsRenderContext)¶ Finalises the label settings after use.
This must be called after a call to
startRender()
, in order to gracefully clean up symbols.New in version 3.10.
- Parameters
context (QgsRenderContext) –
-
substitutions
¶
-
thinningSettings
(self) → QgsLabelThinningSettings¶ Returns the label thinning settings.
See also
New in version 3.12.
- Return type
-
upsidedownLabels
¶
-
useMaxLineLengthForAutoWrap
¶
-
useSubstitutions
¶
-
wrapChar
¶
-
writeXml
(self, doc: QDomDocument, context: QgsReadWriteContext) → QDomElement¶ Write settings into a DOM element
New in version 2.12.
- Parameters
doc (QDomDocument) –
context (QgsReadWriteContext) –
- Return type
QDomElement
-
xOffset
¶
-
xform
¶
-
yOffset
¶
-
zIndex
¶
-