Class: QgsGradientFillSymbolLayer

A fill symbol layer which draws a smooth color gradient over a polygon.

Class Hierarchy

Base classes

QgsFillSymbolLayer	Abstract base class for fill symbol layers.
QgsSymbolLayer	Abstract base class for symbol layers.

class qgis.core.QgsGradientFillSymbolLayer

Bases: QgsFillSymbolLayer

__init__(color: QColor | Qt.GlobalColor = DEFAULT_SIMPLEFILL_COLOR, color2: QColor | Qt.GlobalColor = Qt.white, gradientColorType: Qgis.GradientColorSource = Qgis.GradientColorSource.SimpleTwoColor, gradientType: Qgis.GradientType = Qgis.GradientType.Linear, coordinateMode: Qgis.SymbolCoordinateReference = Qgis.SymbolCoordinateReference.Feature, gradientSpread: Qgis.GradientSpread = Qgis.GradientSpread.Pad)

Constructor for QgsGradientFillSymbolLayer.

Parameters:

• color (Union[QColor, Qt.GlobalColor] = DEFAULT_SIMPLEFILL_COLOR)

• color2 (Union[QColor, Qt.GlobalColor] = Qt.white)

• gradientColorType (Qgis.GradientColorSource = Qgis.GradientColorSource.SimpleTwoColor)

• gradientType (Qgis.GradientType = Qgis.GradientType.Linear)

• coordinateMode (Qgis.SymbolCoordinateReference = Qgis.SymbolCoordinateReference.Feature)

• gradientSpread (Qgis.GradientSpread = Qgis.GradientSpread.Pad)

GradientColorType

alias of GradientColorSource

GradientCoordinateMode

alias of SymbolCoordinateReference

class GradientSpread(*values)

Bases: IntEnum

Gradient spread options, which control how gradients are rendered outside of their start and end points.

Note

Prior to QGIS 3.24 this was available as QgsGradientFillSymbolLayer.GradientSpread

Added in version 3.24.

• Pad: Pad out gradient using colors at endpoint of gradient

• Reflect: Reflect gradient

• Repeat: Repeat gradient

class GradientType(*values)

Bases: IntEnum

Gradient types.

Note

Prior to QGIS 3.24 this was available as QgsGradientFillSymbolLayer.GradientType

Added in version 3.24.

• Linear: Linear gradient

• Radial: Radial (circular) gradient

• Conical: Conical (polar) gradient

color2(self) → QColor

Returns the color for endpoint of gradient, only used if the gradient color type is set to SimpleTwoColor.

See also

setColor2()

Return type:

QColor

colorRamp(self) → QgsColorRamp | None

Returns the color ramp used for the gradient fill. This is only used if the gradient color type is set to ColorRamp.

See also

setColorRamp()

See also

gradientColorType()

Return type:

Optional[QgsColorRamp]

coordinateMode(self) → Qgis.SymbolCoordinateReference

Returns the coordinate mode for gradient, which controls how the gradient stops are positioned.

See also

setCoordinateMode()

Return type:

Qgis.SymbolCoordinateReference

static create(properties: Dict[str, Any] = {}) → QgsSymbolLayer | None

Creates a new QgsGradientFillSymbolLayer using the specified properties map containing symbol properties (see properties()).

Caller takes ownership of the returned symbol layer.

Parameters:

properties (Dict[str, Any] = {})

Return type:

Optional[QgsSymbolLayer]

gradientColorType(self) → Qgis.GradientColorSource

Returns the gradient color mode, which controls how gradient color stops are created.

See also

setGradientColorType()

Return type:

Qgis.GradientColorSource

gradientSpread(self) → Qgis.GradientSpread

Returns the gradient spread mode, which controls how the gradient behaves outside of the predefined stops.

See also

setGradientSpread()

Return type:

Qgis.GradientSpread

gradientType(self) → Qgis.GradientType

Returns the type of gradient, e.g., linear or radial.

See also

setGradientType()

Return type:

Qgis.GradientType

offset(self) → QPointF

Returns the offset by which polygons will be translated during rendering.

Units are specified by offsetUnit().

See also

setOffset()

See also

offsetUnit()

Return type:

QPointF

offsetMapUnitScale(self) → QgsMapUnitScale

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

See also

offset()

See also

setOffsetMapUnitScale()

Return type:

QgsMapUnitScale

offsetUnit(self) → Qgis.RenderUnit

Returns the units for the fill’s offset.

See also

setOffsetUnit()

See also

offset()

Return type:

Qgis.RenderUnit

referencePoint1(self) → QPointF

Returns the starting point of gradient fill, in the range [0,0] - [1,1].

See also

setReferencePoint1()

Return type:

QPointF

referencePoint1IsCentroid(self) → bool

Returns whether the starting point for the gradient is taken from the feature centroid.

See also

setReferencePoint1IsCentroid()

Return type:

bool

referencePoint2(self) → QPointF

Returns the end point of gradient fill, in the range [0,0] - [1,1].

See also

setReferencePoint2()

Return type:

QPointF

referencePoint2IsCentroid(self) → bool

Returns whether the end point for the gradient is taken from the feature centroid.

See also

setReferencePoint2IsCentroid()

Return type:

bool

setColor2(self, color2: QColor | Qt.GlobalColor)

Sets the color for endpoint of gradient, only used if the gradient color type is set to SimpleTwoColor.

See also

color2()

Parameters:

color2 (Union[QColor, Qt.GlobalColor])

setColorRamp(self, ramp: QgsColorRamp | None)

Sets the color ramp used for the gradient fill. This is only used if the gradient color type is set to ColorRamp.

Parameters:

ramp (Optional[QgsColorRamp]) – color ramp. Ownership is transferred.

See also

colorRamp()

See also

setGradientColorType()

setCoordinateMode(self, coordinateMode: Qgis.SymbolCoordinateReference)

Sets the coordinate mode for gradient, which controls how the gradient stops are positioned.

See also

coordinateMode()

Parameters:

coordinateMode (Qgis.SymbolCoordinateReference)

setGradientColorType(self, gradientColorType: Qgis.GradientColorSource)

Sets the gradient color mode, which controls how gradient color stops are created.

See also

gradientColorType()

Parameters:

gradientColorType (Qgis.GradientColorSource)

setGradientSpread(self, gradientSpread: Qgis.GradientSpread)

Sets the gradient spread mode, which controls how the gradient behaves outside of the predefined stops.

See also

gradientSpread()

Parameters:

gradientSpread (Qgis.GradientSpread)

setGradientType(self, gradientType: Qgis.GradientType)

Sets the type of gradient, e.g., linear or radial.

See also

gradientType()

Parameters:

gradientType (Qgis.GradientType)

setOffset(self, offset: QPointF | QPoint)

Sets an offset by which polygons will be translated during rendering.

Units are specified by offsetUnit().

See also

offset()

See also

setOffsetUnit()

Parameters:

offset (Union[QPointF, QPoint])

setOffsetMapUnitScale(self, scale: QgsMapUnitScale)

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

See also

setOffset()

See also

offsetMapUnitScale()

Parameters:

scale (QgsMapUnitScale)

setOffsetUnit(self, unit: Qgis.RenderUnit)

Sets the unit for the fill’s offset.

See also

offset()

See also

offsetUnit()

Parameters:

unit (Qgis.RenderUnit)

setReferencePoint1(self, referencePoint: QPointF | QPoint)

Sets the starting point of gradient fill, in the range [0,0] - [1,1].

See also

referencePoint1()

Parameters:

referencePoint (Union[QPointF, QPoint])

setReferencePoint1IsCentroid(self, isCentroid: bool)

Sets whether the starting point for the gradient is taken from the feature centroid.

See also

referencePoint1IsCentroid()

Parameters:

isCentroid (bool)

setReferencePoint2(self, referencePoint: QPointF | QPoint)

Sets the end point of gradient fill, in the range [0,0] - [1,1].

See also

referencePoint2()

Parameters:

referencePoint (Union[QPointF, QPoint])

setReferencePoint2IsCentroid(self, isCentroid: bool)

Sets whether the end point for the gradient is taken from the feature centroid.

See also

referencePoint2IsCentroid()

Parameters:

isCentroid (bool)