QGIS API Documentation 3.32.0-Lima (311a8cb8a6)
Public Slots | Signals | Public Member Functions | List of all members
QgsCameraController Class Reference

3 More...

#include <qgscameracontroller.h>

Inheritance diagram for QgsCameraController:
Inheritance graph
[legend]

Public Slots

void depthBufferCaptured (const QImage &depthImage)
 Sets the depth buffer image used by the camera controller to calculate world position from a pixel's coordinates and depth. More...
 
void setCameraNavigationMode (Qgis::NavigationMode navigationMode)
 Sets the navigation mode used by the camera controller. More...
 

Signals

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

Public Member Functions

 QgsCameraController (Qgs3DMapScene *scene)
 Constructs the camera controller with optional parent node that will take ownership. More...
 
 ~QgsCameraController () override
 
Qt3DRender::QCamera * camera () const
 Returns camera that is being controlled. More...
 
double cameraMovementSpeed () const
 Returns the camera movement speed. More...
 
Qgis::NavigationMode cameraNavigationMode () const
 Returns the navigation mode used by the camera controller. More...
 
QgsCameraPose cameraPose () const
 Returns camera pose. More...
 
float distance () const
 Returns distance of the camera from the point it is looking at. More...
 
void frameTriggered (float dt)
 Called internally from 3D scene when a new frame is generated. Updates camera according to keyboard/mouse input. More...
 
QgsVector3D lookingAtPoint () const
 Returns the point in the world coordinates towards which the camera is looking. More...
 
void moveView (float tx, float ty)
 Move the map by tx and ty. More...
 
float pitch () const
 Returns pitch angle in degrees (0 = looking from the top, 90 = looking from the side). More...
 
void readXml (const QDomElement &elem)
 Reads camera configuration from the given DOM element. More...
 
void resetView (float distance)
 Move camera back to the initial position (looking down towards origin of world's coordinates) More...
 
void rotateAroundViewCenter (float deltaYaw)
 Rotate clockwise the view by deltaYaw around the view center (camera moves) More...
 
void rotateCamera (float diffPitch, float diffYaw)
 Rotates the camera on itself. More...
 
void setCameraHeadingAngle (float angle)
 Set camera heading to angle (used for rotating the view) More...
 
void setCameraMovementSpeed (double movementSpeed)
 Sets the camera movement speed. More...
 
void setCameraPose (const QgsCameraPose &camPose)
 Sets camera pose. More...
 
void setLookingAtPoint (const QgsVector3D &point, float distance, float pitch, float yaw)
 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. More...
 
void setVerticalAxisInversion (Qgis::VerticalAxisInversion inversion)
 Sets the vertical axis inversion behavior. More...
 
void setViewFromTop (float worldX, float worldY, float distance, float yaw=0)
 Sets camera to look down towards given point in world coordinate, in given distance from plane with zero elevation. More...
 
void tiltUpAroundViewCenter (float deltaPitch)
 Tilt up the view by deltaPitch around the view center (camera moves) More...
 
Qgis::VerticalAxisInversion verticalAxisInversion () const
 Returns the vertical axis inversion behavior. More...
 
void walkView (double tx, double ty, double tz)
 Walks into the map by tx, ty, and tz. More...
 
bool willHandleKeyEvent (QKeyEvent *event)
 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. More...
 
QDomElement writeXml (QDomDocument &doc) const
 Writes camera configuration to the given DOM element. More...
 
float yaw () const
 Returns yaw angle in degrees. More...
 
void zoom (float factor)
 Zoom the map by factor. More...
 

Detailed Description

3

Object that controls camera movement based on user input

Note
Not available in Python bindings
Since
QGIS 3.0

Definition at line 60 of file qgscameracontroller.h.

Constructor & Destructor Documentation

◆ QgsCameraController()

QgsCameraController::QgsCameraController ( Qgs3DMapScene scene)

Constructs the camera controller with optional parent node that will take ownership.

Definition at line 30 of file qgscameracontroller.cpp.

◆ ~QgsCameraController()

QgsCameraController::~QgsCameraController ( )
overridedefault

Member Function Documentation

◆ camera()

Qt3DRender::QCamera * QgsCameraController::camera ( ) const
inline

Returns camera that is being controlled.

Note
Not available in Python bindings

Definition at line 80 of file qgscameracontroller.h.

◆ cameraChanged

void QgsCameraController::cameraChanged ( )
signal

Emitted when camera has been updated.

◆ cameraMovementSpeed()

double QgsCameraController::cameraMovementSpeed ( ) const
inline

Returns the camera movement speed.

Since
QGIS 3.18

Definition at line 93 of file qgscameracontroller.h.

◆ cameraMovementSpeedChanged

void QgsCameraController::cameraMovementSpeedChanged ( double  speed)
signal

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

◆ cameraNavigationMode()

Qgis::NavigationMode QgsCameraController::cameraNavigationMode ( ) const
inline

Returns the navigation mode used by the camera controller.

Since
QGIS 3.18

Definition at line 87 of file qgscameracontroller.h.

◆ cameraPose()

QgsCameraPose QgsCameraController::cameraPose ( ) const
inline

Returns camera pose.

Since
QGIS 3.4

Definition at line 143 of file qgscameracontroller.h.

◆ cameraRotationCenterChanged

void QgsCameraController::cameraRotationCenterChanged ( QVector3D  position)
signal

Emitted when the camera rotation center changes.

Since
QGIS 3.24

◆ depthBufferCaptured

void QgsCameraController::depthBufferCaptured ( const QImage &  depthImage)
slot

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

Since
QGIS 3.24

Definition at line 1082 of file qgscameracontroller.cpp.

◆ distance()

float QgsCameraController::distance ( ) const
inline

Returns distance of the camera from the point it is looking at.

The value should not be smaller than 10.

Since
QGIS 3.4

Definition at line 150 of file qgscameracontroller.h.

◆ frameTriggered()

void QgsCameraController::frameTriggered ( float  dt)

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

Definition at line 134 of file qgscameracontroller.cpp.

◆ lookingAtPoint()

QgsVector3D QgsCameraController::lookingAtPoint ( ) const

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

Definition at line 162 of file qgscameracontroller.cpp.

◆ moveView()

void QgsCameraController::moveView ( float  tx,
float  ty 
)

Move the map by tx and ty.

Definition at line 1008 of file qgscameracontroller.cpp.

◆ navigationModeChanged

void QgsCameraController::navigationModeChanged ( Qgis::NavigationMode  mode)
signal

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

◆ pitch()

float QgsCameraController::pitch ( ) const
inline

Returns pitch angle in degrees (0 = looking from the top, 90 = looking from the side).

The angle should range from 0 to 180.

Since
QGIS 3.4

Definition at line 157 of file qgscameracontroller.h.

◆ readXml()

void QgsCameraController::readXml ( const QDomElement &  elem)

Reads camera configuration from the given DOM element.

Definition at line 202 of file qgscameracontroller.cpp.

◆ requestDepthBufferCapture

void QgsCameraController::requestDepthBufferCapture ( )
signal

Emitted to ask for the depth buffer image.

Since
QGIS 3.24

◆ resetView()

void QgsCameraController::resetView ( float  distance)

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

Definition at line 139 of file qgscameracontroller.cpp.

◆ rotateAroundViewCenter()

void QgsCameraController::rotateAroundViewCenter ( float  deltaYaw)

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

Definition at line 993 of file qgscameracontroller.cpp.

◆ rotateCamera()

void QgsCameraController::rotateCamera ( float  diffPitch,
float  diffYaw 
)

Rotates the camera on itself.

Parameters
diffPitchthe pitch difference
diffYawthe yaw difference
Since
QGIS 3.30

Definition at line 102 of file qgscameracontroller.cpp.

◆ setCameraHeadingAngle()

void QgsCameraController::setCameraHeadingAngle ( float  angle)

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

Definition at line 1002 of file qgscameracontroller.cpp.

◆ setCameraMovementSpeed()

void QgsCameraController::setCameraMovementSpeed ( double  movementSpeed)

Sets the camera movement speed.

Since
QGIS 3.18

Definition at line 88 of file qgscameracontroller.cpp.

◆ setCameraNavigationMode

void QgsCameraController::setCameraNavigationMode ( Qgis::NavigationMode  navigationMode)
slot

Sets the navigation mode used by the camera controller.

Since
QGIS 3.18

Definition at line 78 of file qgscameracontroller.cpp.

◆ setCameraPose()

void QgsCameraController::setCameraPose ( const QgsCameraPose camPose)

Sets camera pose.

Since
QGIS 3.4

Definition at line 177 of file qgscameracontroller.cpp.

◆ setCursorPosition

void QgsCameraController::setCursorPosition ( QPoint  point)
signal

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

◆ setLookingAtPoint()

void QgsCameraController::setLookingAtPoint ( const QgsVector3D point,
float  distance,
float  pitch,
float  yaw 
)

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.

Since
QGIS 3.4

Definition at line 167 of file qgscameracontroller.cpp.

◆ setVerticalAxisInversion()

void QgsCameraController::setVerticalAxisInversion ( Qgis::VerticalAxisInversion  inversion)

Sets the vertical axis inversion behavior.

Since
QGIS 3.18

Definition at line 97 of file qgscameracontroller.cpp.

◆ setViewFromTop()

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

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

Definition at line 144 of file qgscameracontroller.cpp.

◆ tiltUpAroundViewCenter()

void QgsCameraController::tiltUpAroundViewCenter ( float  deltaPitch)

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

Definition at line 984 of file qgscameracontroller.cpp.

◆ verticalAxisInversion()

Qgis::VerticalAxisInversion QgsCameraController::verticalAxisInversion ( ) const
inline

Returns the vertical axis inversion behavior.

Since
QGIS 3.18

Definition at line 105 of file qgscameracontroller.h.

◆ walkView()

void QgsCameraController::walkView ( double  tx,
double  ty,
double  tz 
)

Walks into the map by tx, ty, and tz.

Since
QGIS 3.30

Definition at line 820 of file qgscameracontroller.cpp.

◆ willHandleKeyEvent()

bool QgsCameraController::willHandleKeyEvent ( QKeyEvent *  event)

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.

Definition at line 1027 of file qgscameracontroller.cpp.

◆ writeXml()

QDomElement QgsCameraController::writeXml ( QDomDocument &  doc) const

Writes camera configuration to the given DOM element.

Definition at line 190 of file qgscameracontroller.cpp.

◆ yaw()

float QgsCameraController::yaw ( ) const
inline

Returns yaw angle in degrees.

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

Since
QGIS 3.4

Definition at line 164 of file qgscameracontroller.h.

◆ zoom()

void QgsCameraController::zoom ( float  factor)

Zoom the map by factor.

Definition at line 519 of file qgscameracontroller.cpp.


The documentation for this class was generated from the following files: