Class: QgsRasterRendererWidget

Abstract base class for widgets which configure a QgsRasterRenderer.

Class Hierarchy

Base classes

QWidget
QObject
QPaintDevice

Subclasses

QgsHillshadeRendererWidget	Renderer widget for the hill shade renderer.
QgsMultiBandColorRendererWidget	Constructor for QgsMultiBandColorRendererWidget.
QgsPalettedRendererWidget	Constructor for QgsSingleBandPseudoColorRendererWidget.
QgsRasterContourRendererWidget	Configuration widget for QgsRasterContourRenderer
QgsSingleBandGrayRendererWidget	Constructor for QgsSingleBandGrayRendererWidget.
QgsSingleBandPseudoColorRendererWidget	Single band pseudo color renderer widget consists of a color ramp shader widget, a raster min max widget and a band selector.

class qgis.gui.QgsRasterRendererWidget

Bases: QWidget

__init__(layer: QgsRasterLayer | None, extent: QgsRectangle)

Constructor for QgsRasterRendererWidget.

Parameters:

• layer (Optional[QgsRasterLayer]) – associated raster layer

• extent (QgsRectangle) – current canvas extent

contrastEnhancementAlgorithm(self) → QgsContrastEnhancement.ContrastEnhancementAlgorithm

Returns the contrast enhancement algorithm to be used by the raster renderer.

Added in version 3.26.

Return type:

QgsContrastEnhancement.ContrastEnhancementAlgorithm

doComputations(self)

Load programmatically with current values

mapCanvas(self) → QgsMapCanvas | None

Returns the map canvas associated with the widget.

See also

setMapCanvas()

Return type:

Optional[QgsMapCanvas]

max(self, index: int = 0) → str

Parameters:

index (int = 0)

Return type:

str

min(self, index: int = 0) → str

Parameters:

index (int = 0)

Return type:

str

minMaxWidget(self) → QgsRasterMinMaxWidget | None

Returns min/max widget when it exists.

Return type:

Optional[QgsRasterMinMaxWidget]

rasterLayer(self) → QgsRasterLayer | None

Returns the raster layer associated with the widget.

See also

setRasterLayer()

Return type:

Optional[QgsRasterLayer]

renderer(self) → QgsRasterRenderer | None

Creates a new renderer, using the properties defined in the widget.

The caller takes ownership of the returned renderer.

Return type:

Optional[QgsRasterRenderer]

selectedBand(self, index: int = 0) → int

Parameters:

index (int = 0)

Return type:

int

setContrastEnhancementAlgorithm(self, algorithm: QgsContrastEnhancement.ContrastEnhancementAlgorithm)

Sets the contrast enhancement algorithm to be used by the raster renderer.

Added in version 3.26.

Parameters:

algorithm (QgsContrastEnhancement.ContrastEnhancementAlgorithm)

setMapCanvas(self, canvas: QgsMapCanvas | None)

Sets the map canvas associated with the widget. This allows the widget to retrieve the current map extent and other properties from the canvas.

Parameters:

canvas (Optional[QgsMapCanvas]) – map canvas

See also

mapCanvas()

setMax(self, value: str | None, index: int = 0)

Parameters:

• value (Optional[str])

• index (int = 0)

setMin(self, value: str | None, index: int = 0)

Parameters:

• value (Optional[str])

• index (int = 0)

setRasterLayer(self, layer: QgsRasterLayer | None)

Sets the raster layer associated with the widget.

See also

rasterLayer()

Parameters:

layer (Optional[QgsRasterLayer])

setStdDev(self, value: str | None)

Parameters:

value (Optional[str])

stdDev(self) → str

Return type:

str

signal widgetChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.