Class: QgsCameraController

Class Hierarchy

Base classes

QObject

Methods

cameraMovementSpeed	Returns the camera movement speed
cameraNavigationMode	Returns the navigation mode used by the camera controller.
cameraPose	Returns camera pose
depthBufferCaptured	Sets the depth buffer image used by the camera controller to calculate world position from a pixel's coordinates and depth
distance	Returns distance of the camera from the point it is looking at.
frameTriggered	Called internally from 3D scene when a new frame is generated.
lookingAtPoint	Returns the point in the world coordinates towards which the camera is looking
moveView	Move the map by tx and ty
pitch	Returns pitch angle in degrees (0 = looking from the top, 90 = looking from the side).
readXml	Reads camera configuration from the given DOM element
resetView	Move camera back to the initial position (looking down towards origin of world's coordinates)
rotateAroundViewCenter	Rotate clockwise the view by deltaYaw around the view center (camera moves)
rotateCamera	Rotates the camera on itself.
setCameraHeadingAngle	Set camera heading to angle (used for rotating the view)
setCameraMovementSpeed	Sets the camera movement speed
setCameraNavigationMode	Sets the navigation mode used by the camera controller.
setCameraPose	Sets camera pose
setLookingAtPoint	Sets the complete camera configuration: the point towards it is looking (in 3D world coordinates), the distance of the camera from the point, pitch angle in degrees (0 = looking from the top, 90 = looking from the side) and yaw angle in degrees.
setVerticalAxisInversion	Sets the vertical axis inversion behavior.
setViewFromTop	Sets camera to look down towards given point in world coordinate, in given distance from plane with zero elevation
tiltUpAroundViewCenter	Tilt up the view by deltaPitch around the view center (camera moves)
verticalAxisInversion	Returns the vertical axis inversion behavior.
walkView	Walks into the map by tx, ty, and tz
willHandleKeyEvent	Returns True if the camera controller will handle the specified key event, preventing it from being instead handled by parents of the 3D window before the controller ever receives it.
writeXml	Writes camera configuration to the given DOM element
yaw	Returns yaw angle in degrees.
zoom	Zoom the map by factor

Signals

cameraChanged	Emitted when camera has been updated
cameraMovementSpeedChanged	Emitted whenever the camera movement speed is changed by the controller.
cameraRotationCenterChanged	Emitted when the camera rotation center changes
navigationModeChanged	Emitted when the navigation mode is changed using the hotkey ctrl + ~
requestDepthBufferCapture	Emitted to ask for the depth buffer image
setCursorPosition	Emitted when the mouse cursor position should be moved to the specified point on the map viewport.

class qgis._3d.QgsCameraController

Bases: QObject

signal cameraChanged

Emitted when camera has been updated

cameraMovementSpeed(self) → float

Returns the camera movement speed

Added in version 3.18.

Return type:

float

signal cameraMovementSpeedChanged(speed: float)

Emitted whenever the camera movement speed is changed by the controller.

Parameters:

speed (float)

cameraNavigationMode(self) → Qgis.NavigationMode

Returns the navigation mode used by the camera controller.

Added in version 3.18.

Return type:

Qgis.NavigationMode

cameraPose(self) → QgsCameraPose

Returns camera pose

Added in version 3.4.

Return type:

QgsCameraPose

signal cameraRotationCenterChanged(position: QVector3D)

Emitted when the camera rotation center changes

Added in version 3.24.

Parameters:

position (QVector3D)

depthBufferCaptured(self, depthImage: QImage)

Sets the depth buffer image used by the camera controller to calculate world position from a pixel’s coordinates and depth

Added in version 3.24.

Parameters:

depthImage (QImage)

distance(self) → float

Returns distance of the camera from the point it is looking at. The value should not be smaller than 10.

Added in version 3.4.

Return type:

float

frameTriggered(self, dt: float)

Called internally from 3D scene when a new frame is generated. Updates camera according to keyboard/mouse input

Parameters:

dt (float)

lookingAtPoint(self) → QgsVector3D

Returns the point in the world coordinates towards which the camera is looking

Return type:

QgsVector3D

moveView(self, tx: float, ty: float)

Move the map by tx and ty

Parameters:

• tx (float)

• ty (float)

signal navigationModeChanged(mode: Qgis.NavigationMode)

Emitted when the navigation mode is changed using the hotkey ctrl + ~

Parameters:

mode (Qgis.NavigationMode)

pitch(self) → float

Returns pitch angle in degrees (0 = looking from the top, 90 = looking from the side). The angle should range from 0 to 180.

Added in version 3.4.

Return type:

float

readXml(self, elem: QDomElement)

Reads camera configuration from the given DOM element

Parameters:

elem (QDomElement)

signal requestDepthBufferCapture

Emitted to ask for the depth buffer image

Added in version 3.24.

resetView(self, distance: float)

Move camera back to the initial position (looking down towards origin of world’s coordinates)

Parameters:

distance (float)

rotateAroundViewCenter(self, deltaYaw: float)

Rotate clockwise the view by deltaYaw around the view center (camera moves)

Parameters:

deltaYaw (float)

rotateCamera(self, diffPitch: float, diffYaw: float)

Rotates the camera on itself.

Parameters:

• diffPitch (float) – the pitch difference

• diffYaw (float) – the yaw difference

Added in version 3.30.

setCameraHeadingAngle(self, angle: float)

Set camera heading to angle (used for rotating the view)

Parameters:

angle (float)

setCameraMovementSpeed(self, movementSpeed: float)

Sets the camera movement speed

Added in version 3.18.

Parameters:

movementSpeed (float)

setCameraNavigationMode(self, navigationMode: Qgis.NavigationMode)

Sets the navigation mode used by the camera controller.

Added in version 3.18.

Parameters:

navigationMode (Qgis.NavigationMode)

setCameraPose(self, camPose: QgsCameraPose)

Sets camera pose

Added in version 3.4.

Parameters:

camPose (QgsCameraPose)

signal setCursorPosition(point: QPoint)

Emitted when the mouse cursor position should be moved to the specified point on the map viewport.

Parameters:

point (QPoint)

setLookingAtPoint(self, point: QgsVector3D, distance: float, pitch: float, yaw: float)

Sets the complete camera configuration: the point towards it is looking (in 3D world coordinates), the distance of the camera from the point, pitch angle in degrees (0 = looking from the top, 90 = looking from the side) and yaw angle in degrees.

Added in version 3.4.

Parameters:

• point (QgsVector3D)

• distance (float)

• pitch (float)

• yaw (float)

setVerticalAxisInversion(self, inversion: Qgis.VerticalAxisInversion)

Sets the vertical axis inversion behavior.

Added in version 3.18.

Parameters:

inversion (Qgis.VerticalAxisInversion)

setViewFromTop(self, worldX: float, worldY: float, distance: float, yaw: float = 0)

Sets camera to look down towards given point in world coordinate, in given distance from plane with zero elevation

Parameters:

• worldX (float)

• worldY (float)

• distance (float)

• yaw (float = 0)

tiltUpAroundViewCenter(self, deltaPitch: float)

Tilt up the view by deltaPitch around the view center (camera moves)

Parameters:

deltaPitch (float)

verticalAxisInversion(self) → Qgis.VerticalAxisInversion

Returns the vertical axis inversion behavior.

Added in version 3.18.

Return type:

Qgis.VerticalAxisInversion

walkView(self, tx: float, ty: float, tz: float)

Walks into the map by tx, ty, and tz

Added in version 3.30.

Parameters:

• tx (float)

• ty (float)

• tz (float)

willHandleKeyEvent(self, event: QKeyEvent | None) → bool

Returns True if the camera controller will handle the specified key event, preventing it from being instead handled by parents of the 3D window before the controller ever receives it.

Parameters:

event (Optional[QKeyEvent])

Return type:

bool

writeXml(self, doc: QDomDocument) → QDomElement

Writes camera configuration to the given DOM element

Parameters:

doc (QDomDocument)

Return type:

QDomElement

yaw(self) → float

Returns yaw angle in degrees. Yaw value of zero means the camera is pointing towards north. The angle should range from 0 to 360.

Added in version 3.4.

Return type:

float

zoom(self, factor: float)

Zoom the map by factor

Parameters:

factor (float)