Subgroup: Text

Class: QgsTextBufferSettings

class qgis.core.QgsTextBufferSettings

Bases: sip.wrapper

QgsTextBufferSettings(other: QgsTextBufferSettings) Copy constructor.

Parameters:other – source settings

Container for settings relating to a text buffer.

Note

QgsTextBufferSettings objects are implicitly shared.

New in version 3.0: Methods

blendMode Returns the blending mode used for drawing the buffer.
color Returns the color of the buffer.
enabled Returns whether the buffer is enabled.
fillBufferInterior Returns whether the interior of the buffer will be filled in.
joinStyle Returns the buffer join style.
opacity Returns the buffer opacity.
paintEffect Returns the current paint effect for the buffer.
readFromLayer Reads settings from a layer’s custom properties (for QGIS 2.
readXml Read settings from a DOM element.
setBlendMode Sets the blending mode used for drawing the buffer.
setColor Sets the color for the buffer.
setEnabled Sets whether the text buffer will be drawn.
setFillBufferInterior Sets whether the interior of the buffer will be filled in.
setJoinStyle Sets the join style used for drawing the buffer.
setOpacity Sets the buffer opacity.
setPaintEffect Sets the current paint effect for the buffer.
setSize Sets the size of the buffer.
setSizeMapUnitScale Sets the map unit scale object for the buffer size.
setSizeUnit Sets the units used for the buffer size.
size Returns the size of the buffer.
sizeMapUnitScale Returns the map unit scale object for the buffer size.
sizeUnit Returns the units for the buffer size.
writeXml Write settings into a DOM element.

Signals

Attributes

blendMode(self) → QPainter.CompositionMode

Returns the blending mode used for drawing the buffer.

See also

setBlendMode()

color(self) → QColor

Returns the color of the buffer.

See also

setColor()

enabled(self) → bool

Returns whether the buffer is enabled.

See also

setEnabled()

fillBufferInterior(self) → bool

Returns whether the interior of the buffer will be filled in. If false, only the stroke of the text will be drawn as the buffer. The effect of this setting is only visible for semi-transparent text.

joinStyle(self) → Qt.PenJoinStyle

Returns the buffer join style.

See also

setJoinStyle()

opacity(self) → float

Returns the buffer opacity. The opacity is a double value between 0 (fully transparent) and 1 (totally opaque).

See also

setOpacity()

paintEffect(self) → QgsPaintEffect

Returns the current paint effect for the buffer.

Returns:paint effect

See also

setPaintEffect()

readFromLayer(self, layer: QgsVectorLayer)

Reads settings from a layer’s custom properties (for QGIS 2.x projects).

Parameters:layer – source vector layer
readXml(self, elem: QDomElement)

Read settings from a DOM element.

See also

writeXml()

setBlendMode(self, mode: QPainter.CompositionMode)

Sets the blending mode used for drawing the buffer.

Parameters:mode – blending mode

See also

blendMode()

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

Sets the color for the buffer.

Parameters:color – buffer color

See also

color()

setEnabled(self, enabled: bool)

Sets whether the text buffer will be drawn.

Parameters:enabled – set to true to draw buffer

See also

enabled()

setFillBufferInterior(self, fill: bool)

Sets whether the interior of the buffer will be filled in.

Parameters:fill – set to false to drawn only the stroke of the text as the buffer, or true to also

shade the area inside the text. The effect of this setting is only visible for semi-transparent text.

setJoinStyle(self, style: Qt.PenJoinStyle)

Sets the join style used for drawing the buffer.

Parameters:style – join style

See also

joinStyle()

setOpacity(self, opacity: float)

Sets the buffer opacity.

Parameters:opacity – opacity as a double value between 0 (fully transparent) and 1 (totally

opaque)

See also

opacity()

setPaintEffect(self, effect: QgsPaintEffect)

Sets the current paint effect for the buffer.

Parameters:effect – paint effect. Ownership is transferred to the buffer settings.

See also

paintEffect()

setSize(self, size: float)

Sets the size of the buffer. The size units are specified using setSizeUnit().

Parameters:size – buffer size

See also

size()

See also

setSizeUnit()

setSizeMapUnitScale(self, scale: QgsMapUnitScale)

Sets the map unit scale object for the buffer size. This is only used if the buffer size is set to QgsUnitTypes.RenderMapUnit.

Parameters:scale – scale for buffer size

See also

setSizeUnit()

setSizeUnit(self, unit: QgsUnitTypes.RenderUnit)

Sets the units used for the buffer size.

Parameters:unit – size unit

See also

setSize()

See also

sizeUnit()

size(self) → float

Returns the size of the buffer.

See also

sizeUnit()

See also

setSize()

sizeMapUnitScale(self) → QgsMapUnitScale

Returns the map unit scale object for the buffer size. This is only used if the buffer size is set to QgsUnitTypes.RenderMapUnit.

See also

sizeUnit()

sizeUnit(self) → QgsUnitTypes.RenderUnit

Returns the units for the buffer size.

See also

size()

See also

setSizeUnit()

writeXml(self, doc: QDomDocument) → QDomElement

Write settings into a DOM element.

See also

readXml()