Class: QgsElevationProfileCanvas¶

class qgis.gui.QgsElevationProfileCanvas¶

Bases: QgsPlotCanvas

A canvas for elevation profiles.

New in version 3.26.

QgsElevationProfileCanvas(parent: QWidget = None) Constructor for QgsElevationProfileCanvas, with the specified parent widget.

Methods

actionEvent

canvasPointToPlotPoint

Converts a canvas point to the equivalent plot point.

centerPlotOn

param x

changeEvent

childEvent

clear

Clears the current profile.

closeEvent

connectNotify

contextMenuEvent

create

crs

rtype

QgsCoordinateReferenceSystem

customEvent

destroy

disconnectNotify

dragEnterEvent

dragLeaveEvent

dragMoveEvent

drawBackground

drawForeground

drawFrame

dropEvent

enterEvent

event

eventFilter

focusInEvent

focusNextChild

focusNextPrevChild

focusOutEvent

focusPreviousChild

hideEvent

identify

Identify results visible at the specified plot point.

initPainter

initStyleOption

inputMethodEvent

invalidateCurrentPlotExtent

Invalidates the current plot extent, which means that the visible plot area will be recalculated and "zoom full" operation occur when the next profile generation completes.

isSignalConnected

keyPressEvent

keyReleaseEvent

layers

Returns the list of layers included in the profile.

leaveEvent

metric

mouseDoubleClickEvent

mouseMoveEvent

param e

mousePressEvent

mouseReleaseEvent

moveEvent

nativeEvent

paintEvent

param event

panContentsBy

param dx

plotArea

Returns the interior rectangle representing the surface of the plot, in canvas coordinates.

plotPointToCanvasPoint

Converts a plot point to the equivalent canvas point.

profileCurve

Returns the profile curve.

receivers

refresh

Triggers a complete regeneration of the profile, causing the profile extraction to perform in the background.

render

Renders a portion of the profile using the specified render context.

resizeEvent

param event

scalePlot

scalePlot(self, xFactor: float, yFactor: float) Scales the plot axis by the given factors.

scrollContentsBy

sender

senderSignalIndex

setCrs

Sets the crs associated with the canvas' map coordinates.

setLayers

Sets the list of layers to include in the profile.

setProfileCurve

Sets the profile curve.

setProject

Sets the project associated with the profile.

setSnappingEnabled

Sets whether snapping of cursor points is enabled.

setTolerance

Sets the profile tolerance (in crs() units).

setViewportMargins

setVisiblePlotRange

Sets the visible area of the plot.

setupViewport

sharedPainter

showEvent

snapToPlot

param point

tabletEvent

timerEvent

toCanvasCoordinates

param point

toMapCoordinates

param point

tolerance

Returns the tolerance of the profile (in crs() units).

updateMicroFocus

viewportEvent

viewportMargins

viewportSizeHint

visibleDistanceRange

Returns the distance range currently visible in the plot.

visibleElevationRange

Returns the elevation range currently visible in the plot.

wheelEvent

wheelZoom

param event

zoomFull

Zooms to the full extent of the profile.

zoomToRect

param rect

Signals

activeJobCountChanged

Emitted when the number of active background jobs changes.

canvasPointHovered

Emitted when the mouse hovers over the specified point (in canvas coordinates).

actionEvent(self, QActionEvent)¶

activeJobCountChanged¶

Emitted when the number of active background jobs changes. [signal]

Parameters: count (int) –

canvasPointHovered¶

Emitted when the mouse hovers over the specified point (in canvas coordinates).

The profilePoint argument gives the hovered profile point, which may be snapped. [signal]

Parameters

point (QgsPointXY) –
profilePoint (QgsProfilePoint) –

canvasPointToPlotPoint(self, point: Union[QPointF, QPoint]) → QgsProfilePoint¶

Converts a canvas point to the equivalent plot point.

See also

plotPointToCanvasPoint()

Parameters: point (Union[QPointF) –
Return type: QgsProfilePoint

centerPlotOn(self, x: float, y: float)¶

Parameters

x (float) –
y (float) –

changeEvent(self, QEvent)¶

childEvent(self, QChildEvent)¶

clear(self)¶: Clears the current profile.

closeEvent(self, QCloseEvent)¶

connectNotify(self, QMetaMethod)¶

contextMenuEvent(self, QContextMenuEvent)¶

create(self, window: sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)¶

crs(self) → QgsCoordinateReferenceSystem¶

Return type: QgsCoordinateReferenceSystem

customEvent(self, QEvent)¶

destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)¶

disconnectNotify(self, QMetaMethod)¶

dragEnterEvent(self, QDragEnterEvent)¶

dragLeaveEvent(self, QDragLeaveEvent)¶

dragMoveEvent(self, QDragMoveEvent)¶

drawBackground(self, QPainter, QRectF)¶

drawForeground(self, QPainter, QRectF)¶

drawFrame(self, QPainter)¶

dropEvent(self, QDropEvent)¶

enterEvent(self, QEvent)¶

event(self, e: QEvent) → bool¶

eventFilter(self, QObject, QEvent) → bool¶

focusInEvent(self, QFocusEvent)¶

focusNextChild(self) → bool¶

focusNextPrevChild(self, bool) → bool¶

focusOutEvent(self, QFocusEvent)¶

focusPreviousChild(self) → bool¶

hideEvent(self, QHideEvent)¶

identify(self, point: Union[QPointF, QPoint]) → List[QgsProfileIdentifyResults]¶

Identify results visible at the specified plot point.

identify(self, rect: QRectF) -> List[QgsProfileIdentifyResults] Identify results visible within the specified plot rect.

Parameters: point (Union[QPointF) –
Return type: List[QgsProfileIdentifyResults]

initPainter(self, QPainter)¶

initStyleOption(self, QStyleOptionFrame)¶

inputMethodEvent(self, QInputMethodEvent)¶

invalidateCurrentPlotExtent(self)¶: Invalidates the current plot extent, which means that the visible plot area will be recalculated and “zoom full” operation occur when the next profile generation completes.

isSignalConnected(self, QMetaMethod) → bool¶

keyPressEvent(self, e: QKeyEvent)¶

keyReleaseEvent(self, e: QKeyEvent)¶

layers(self) → List[QgsMapLayer]¶

Returns the list of layers included in the profile.

See also

setLayers()

Return type: List[QgsMapLayer]

leaveEvent(self, QEvent)¶

metric(self, QPaintDevice.PaintDeviceMetric) → int¶

mouseDoubleClickEvent(self, e: QMouseEvent)¶

mouseMoveEvent(self, e: QMouseEvent)¶

Parameters: e (QMouseEvent) –

mousePressEvent(self, e: QMouseEvent)¶

mouseReleaseEvent(self, e: QMouseEvent)¶

moveEvent(self, QMoveEvent)¶

nativeEvent(self, Union[QByteArray, bytes, bytearray], sip.voidptr) → Tuple[bool, int]¶

paintEvent(self, event: QPaintEvent)¶

Parameters: event (QPaintEvent) –

panContentsBy(self, dx: float, dy: float)¶

Parameters

dx (float) –
dy (float) –

plotArea(self) → QRectF¶

Returns the interior rectangle representing the surface of the plot, in canvas coordinates.

Return type: QRectF

plotPointToCanvasPoint(self, point: QgsProfilePoint) → QgsPointXY¶

Converts a plot point to the equivalent canvas point.

See also

canvasPointToPlotPoint()

Parameters: point (QgsProfilePoint) –
Return type: QgsPointXY

profileCurve(self) → QgsCurve¶

Returns the profile curve.

The CRS associated with the curve is retrieved via crs().

See also

setProfileCurve()

Return type: QgsCurve

receivers(self, PYQT_SIGNAL) → int¶

refresh(self)¶: Triggers a complete regeneration of the profile, causing the profile extraction to perform in the background.

render(self, context: QgsRenderContext, width: float, height: float, plotSettings: Qgs2DPlot)¶

Renders a portion of the profile using the specified render context.

Parameters

context (QgsRenderContext) –
width (float) –
height (float) –
plotSettings (Qgs2DPlot) –

resizeEvent(self, event: QResizeEvent)¶

Parameters: event (QResizeEvent) –

scalePlot(self, factor: float)¶

scalePlot(self, xFactor: float, yFactor: float) Scales the plot axis by the given factors.

Parameters: factor (float) –

QgsElevationProfileCanvas.scrollContentsBy(self, int, int)

sender(self) → QObject¶

senderSignalIndex(self) → int¶

setCrs(self, crs: QgsCoordinateReferenceSystem)¶

Sets the crs associated with the canvas’ map coordinates.

See also

crs()

Parameters: crs (QgsCoordinateReferenceSystem) –

setLayers(self, layers: Iterable[QgsMapLayer])¶

Sets the list of layers to include in the profile.

See also

layers()

Parameters: layers (Iterable[QgsMapLayer]) –

setProfileCurve(self, curve: QgsCurve)¶

Sets the profile curve.

The CRS associated with curve is set via setCrs().

Ownership is transferred to the plot canvas.

See also

profileCurve()

Parameters: curve (QgsCurve) –

setProject(self, project: QgsProject)¶

Sets the project associated with the profile.

This must be set before any layers which utilize terrain based elevation settings can be included in the canvas.

Parameters: project (QgsProject) –

setSnappingEnabled(self, enabled: bool)¶

Sets whether snapping of cursor points is enabled.

Parameters: enabled (bool) –

setTolerance(self, tolerance: float)¶

Sets the profile tolerance (in crs() units).

This value determines how far from the profileCurve() is appropriate for inclusion of results. For instance, when a profile is generated for a point vector layer this tolerance distance will dictate how far from the actual profile curve a point can reside within to be included in the results.

See also

tolerance()

Parameters: tolerance (float) –

QgsElevationProfileCanvas.setViewportMargins(self, int, int, int, int)
setViewportMargins(self, QMargins) → None¶

setVisiblePlotRange(self, minimumDistance: float, maximumDistance: float, minimumElevation: float, maximumElevation: float)¶

Sets the visible area of the plot.

See also

visibleDistanceRange()

See also

visibleElevationRange()

Parameters

minimumDistance (float) –
maximumDistance (float) –
minimumElevation (float) –
maximumElevation (float) –

setupViewport(self, QWidget)¶

sharedPainter(self) → QPainter¶

showEvent(self, QShowEvent)¶

snapToPlot(self, point: QPoint) → QgsPointXY¶

Parameters: point (QPoint) –
Return type: QgsPointXY

tabletEvent(self, QTabletEvent)¶

timerEvent(self, QTimerEvent)¶

toCanvasCoordinates(self, point: QgsPoint) → QgsPointXY¶

Parameters: point (QgsPoint) –
Return type: QgsPointXY

toMapCoordinates(self, point: QgsPointXY) → QgsPoint¶

Parameters: point (QgsPointXY) –
Return type: QgsPoint

tolerance(self) → float¶

Returns the tolerance of the profile (in crs() units).

This value determines how far from the profileCurve() is appropriate for inclusion of results. For instance, when a profile is generated for a point vector layer this tolerance distance will dictate how far from the actual profile curve a point can reside within to be included in the results.

See also

setTolerance()