Class: QgsRasterContourRenderer

class qgis.core.QgsRasterContourRenderer

Bases: QgsRasterRenderer

Raster renderer that generates contours on the fly for a source raster band.

New in version 3.14.

QgsRasterContourRenderer(input: QgsRasterInterface) Creates a contour renderer

Methods

block

param bandNo

clone

QgsRasterContourRenderer cannot be copied.

contourIndexInterval

Returns the interval of index contour lines (index contour lines are typical further apart and with a wider line symbol)

contourIndexSymbol

Returns the symbol of index contour lines

contourInterval

Returns the interval of contour lines generation

contourSymbol

Returns the symbol used for contour lines

create

Creates an instance of the renderer based on definition from XML (used by renderer registry)

createLegendNodes

param nodeLayer

downscale

Returns by how much the renderer will scale down the request to the data provider.

initHistogram

Fill in histogram defaults if not specified

initStatistics

Fill in statistics defaults if not specified

inputBand

Returns the number of the input raster band

renderColorForNodataPixel

Returns the color for the renderer to use to represent nodata pixels.

setContourIndexInterval

Sets the interval of index contour lines (index contour lines are typical further apart and with a wider line symbol)

setContourIndexSymbol

Sets the symbol of index contour lines

setContourInterval

Sets the interval of contour lines generation

setContourSymbol

Sets the symbol used for contour lines.

setDownscale

Sets by how much the renderer will scale down the request to the data provider.

setInputBand

Sets the number of the input raster band

usesBands

rtype

List[int]

writeXml

param doc

block(self, bandNo: int, extent: QgsRectangle, width: int, height: int, feedback: QgsRasterBlockFeedback = None)QgsRasterBlock
Parameters
Return type

QgsRasterBlock

clone(self)QgsRasterContourRenderer

QgsRasterContourRenderer cannot be copied. Use clone() instead.

Return type

QgsRasterContourRenderer

contourIndexInterval(self)float

Returns the interval of index contour lines (index contour lines are typical further apart and with a wider line symbol)

Return type

float

contourIndexSymbol(self)QgsLineSymbol

Returns the symbol of index contour lines

Return type

QgsLineSymbol

contourInterval(self)float

Returns the interval of contour lines generation

Return type

float

contourSymbol(self)QgsLineSymbol

Returns the symbol used for contour lines

Return type

QgsLineSymbol

create(elem: QDomElement, input: QgsRasterInterface)QgsRasterRenderer

Creates an instance of the renderer based on definition from XML (used by renderer registry)

Parameters
Return type

QgsRasterRenderer

createLegendNodes(self, nodeLayer: QgsLayerTreeLayer)List[QgsLayerTreeModelLegendNode]
Parameters

nodeLayer (QgsLayerTreeLayer) –

Return type

List[QgsLayerTreeModelLegendNode]

downscale(self)float

Returns by how much the renderer will scale down the request to the data provider. For example, for a raster block 1000x500 with downscale 10, the renderer will request raster 100x50 from provider. Higher downscale makes contour lines more simplified (at the expense of losing some detail). The value of one means there will be no downscaling.

Return type

float

initHistogram(self, histogram: QgsRasterHistogram, bandNo: int, binCount: int, minimum: object = Py_None, maximum: object = Py_None, boundingBox: QgsRectangle = QgsRectangle(), sampleSize: int = 0, includeOutOfRange: bool = False)

Fill in histogram defaults if not specified

Note

the parameters are the same as in histogram()

initStatistics(self, statistics: QgsRasterBandStats, bandNo: int, stats: int = QgsRasterBandStats.All, boundingBox: QgsRectangle = QgsRectangle(), binCount: int = 0)

Fill in statistics defaults if not specified

inputBand(self)int

Returns the number of the input raster band

Return type

int

renderColorForNodataPixel(self)int

Returns the color for the renderer to use to represent nodata pixels.

Subclasses should use this rather then nodataColor() to determine the color to use for nodata pixels during an actual rendering operation.

New in version 3.10.

setContourIndexInterval(self, interval: float)

Sets the interval of index contour lines (index contour lines are typical further apart and with a wider line symbol)

Parameters

interval (float) –

setContourIndexSymbol(self, symbol: QgsLineSymbol)

Sets the symbol of index contour lines

Parameters

symbol (QgsLineSymbol) –

setContourInterval(self, interval: float)

Sets the interval of contour lines generation

Parameters

interval (float) –

setContourSymbol(self, symbol: QgsLineSymbol)

Sets the symbol used for contour lines. Takes ownership of the passed symbol

Parameters

symbol (QgsLineSymbol) –

setDownscale(self, scale: float)

Sets by how much the renderer will scale down the request to the data provider.

See also

downscale()

Parameters

scale (float) –

setInputBand(self, band: int)

Sets the number of the input raster band

Parameters

band (int) –

usesBands(self)List[int]
Return type

List[int]

writeXml(self, doc: QDomDocument, parentElem: QDomElement)
Parameters
  • doc (QDomDocument) –

  • parentElem (QDomElement) –