Class: QgsRasterFillSymbolLayer

class qgis.core.QgsRasterFillSymbolLayer(imageFilePath: str = '')

Bases: QgsImageFillSymbolLayer

Constructor for QgsRasterFillSymbolLayer, using a raster fill from the specified imageFilePath.

A class for filling symbols with a repeated raster image.

New in version 2.7.

Parameters

imageFilePath

Feature = 0
class FillCoordinateMode

Bases: int

Viewport = 1
applyDataDefinedSettings(self, context: QgsSymbolRenderContext)
Parameters

context (QgsSymbolRenderContext) –

clone(self)QgsRasterFillSymbolLayer
Return type

QgsRasterFillSymbolLayer

coordinateMode(self) → QgsRasterFillSymbolLayer.FillCoordinateMode

Coordinate mode for fill. Controls how the top left corner of the image fill is positioned relative to the feature.

Return type

QgsRasterFillSymbolLayer.FillCoordinateMode

Returns

coordinate mode

copyDataDefinedProperties(self, destLayer: QgsSymbolLayer)

Copies all data defined properties of this layer to another symbol layer.

Parameters

destLayer – destination layer

copyPaintEffect(self, destLayer: QgsSymbolLayer)

Copies paint effect of this layer to another symbol layer

Parameters

destLayer – destination layer

New in version 2.9.

create(properties: Dict[str, str] = {})QgsSymbolLayer

Creates a new QgsRasterFillSymbolLayer from a properties map. The caller takes ownership of the returned object.

Parameters

properties (Dict[str) –

Return type

QgsSymbolLayer

estimateMaxBleed(self, context: QgsRenderContext) → float
Parameters

context (QgsRenderContext) –

Return type

float

imageFilePath(self) → str

The path to the raster image used for the fill.

Return type

str

Returns

path to image file

layerType(self) → str
Return type

str

offset(self) → QPointF

Returns the offset for the fill.

Return type

QPointF

Returns

offset for fill

See also

setOffset()

See also

offsetUnit()

offsetMapUnitScale(self)QgsMapUnitScale

Returns the map unit scale for the fill’s offset.

Return type

QgsMapUnitScale

Returns

map unit scale for offset

See also

offset()

See also

offsetUnit()

offsetUnit(self) → QgsUnitTypes.RenderUnit

Returns the units for the fill’s offset.

Return type

QgsUnitTypes.RenderUnit

Returns

units for offset

See also

setOffsetUnit()

See also

offset()

opacity(self) → float

Returns the opacity for the raster image used in the fill.

Return type

float

Returns

opacity value between 0 (fully transparent) and 1 (fully opaque)

See also

setOpacity()

properties(self) → Dict[str, str]
Return type

Dict[str, str]

renderPolygon(self, points: QPolygonF, rings: Iterable[QPolygonF], context: QgsSymbolRenderContext)
Parameters
resolvePaths(properties: Dict[str, str], pathResolver: QgsPathResolver, saving: bool)

Turns relative paths in properties map to absolute when reading and vice versa when writing. Used internally when reading/writing symbols.

New in version 3.0.

Parameters
  • properties (Dict[str) –

  • pathResolver (QgsPathResolver) –

  • saving (bool) –

restoreOldDataDefinedProperties(self, stringMap: Dict[str, str])

Restores older data defined properties from string map.

New in version 3.0.

setCoordinateMode(self, mode: QgsRasterFillSymbolLayer.FillCoordinateMode)

Set the coordinate mode for fill. Controls how the top left corner of the image fill is positioned relative to the feature.

Parameters

mode (QgsRasterFillSymbolLayer.FillCoordinateMode) – coordinate mode

See also

coordinateMode()

setImageFilePath(self, imagePath: str)

Sets the path to the raster image used for the fill.

Parameters

imagePath (str) – path to image file

See also

imageFilePath()

setOffset(self, offset: Union[QPointF, QPoint])

Sets the offset for the fill.

Parameters

offset (Union[QPointF) – offset for fill

See also

offset()

See also

setOffsetUnit()

setOffsetMapUnitScale(self, scale: QgsMapUnitScale)

Sets the map unit scale for the fill’s offset.

Parameters

scale (QgsMapUnitScale) – map unit scale for offset

See also

setOffset()

See also

setOffsetUnit()

setOffsetUnit(self, unit: QgsUnitTypes.RenderUnit)

Sets the units for the fill’s offset.

Parameters

unit (QgsUnitTypes.RenderUnit) – units for offset

See also

offsetUnit()

See also

setOffset()

setOpacity(self, opacity: float)

Sets the opacity for the raster image used in the fill.

Parameters

opacity (float) – opacity value between 0 (fully transparent) and 1 (fully opaque)

See also

opacity()

setSubSymbol(self, symbol: QgsSymbol) → bool
Parameters

symbol (QgsSymbol) –

Return type

bool

setWidth(self, width: float)

Sets the width for scaling the image used in the fill. The image’s height will also be scaled to maintain the image’s aspect ratio.

Parameters

width (float) – width for scaling the image

See also

width()

See also

setWidthUnit()

setWidthMapUnitScale(self, scale: QgsMapUnitScale)

Sets the map unit scale for the image’s width.

Parameters

scale (QgsMapUnitScale) – map unit scale for width

See also

setWidth()

See also

setWidthUnit()

setWidthUnit(self, unit: QgsUnitTypes.RenderUnit)

Sets the units for the image’s width.

Parameters

unit (QgsUnitTypes.RenderUnit) – units for width

See also

widthUnit()

See also

setWidth()

startRender(self, context: QgsSymbolRenderContext)
Parameters

context (QgsSymbolRenderContext) –

stopRender(self, context: QgsSymbolRenderContext)
Parameters

context (QgsSymbolRenderContext) –

subSymbol(self)QgsSymbol
Return type

QgsSymbol

width(self) → float

Returns the width used for scaling the image used in the fill. The image’s height is scaled to maintain the image’s aspect ratio.

Return type

float

Returns

width used for scaling the image

See also

setWidth()

See also

widthUnit()

widthMapUnitScale(self)QgsMapUnitScale

Returns the map unit scale for the image’s width.

Return type

QgsMapUnitScale

Returns

map unit scale for width

See also

width()

See also

widthUnit()

widthUnit(self) → QgsUnitTypes.RenderUnit

Returns the units for the image’s width.

Return type

QgsUnitTypes.RenderUnit

Returns

units for width

See also

setWidthUnit()

See also

width()