QGIS API Documentation 3.40.0-Bratislava (b56115d8743)
|
3 More...
#include <qgscameracontroller.h>
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. | |
void | setCameraNavigationMode (Qgis::NavigationMode navigationMode) |
Sets the navigation mode used by the camera controller. | |
Signals | |
void | cameraChanged () |
Emitted when camera has been updated. | |
void | cameraMovementSpeedChanged (double speed) |
Emitted whenever the camera movement speed is changed by the controller. | |
void | cameraRotationCenterChanged (QVector3D position) |
Emitted when the camera rotation center changes. | |
void | navigationModeChanged (Qgis::NavigationMode mode) |
Emitted when the navigation mode is changed using the hotkey ctrl + ~. | |
void | requestDepthBufferCapture () |
Emitted to ask for the depth buffer image. | |
void | setCursorPosition (QPoint point) |
Emitted when the mouse cursor position should be moved to the specified point on the map viewport. | |
Public Member Functions | |
QgsCameraController (Qgs3DMapScene *scene) | |
Constructs the camera controller with optional parent node that will take ownership. | |
~QgsCameraController () override | |
Qt3DRender::QCamera * | camera () const |
Returns camera that is being controlled. | |
double | cameraMovementSpeed () const |
Returns the camera movement speed. | |
Qgis::NavigationMode | cameraNavigationMode () const |
Returns the navigation mode used by the camera controller. | |
QgsCameraPose | cameraPose () const |
Returns camera pose. | |
float | distance () const |
Returns distance of the camera from the point it is looking at. | |
void | frameTriggered (float dt) |
Called internally from 3D scene when a new frame is generated. Updates camera according to keyboard/mouse input. | |
QgsVector3D | lookingAtPoint () const |
Returns the point in the world coordinates towards which the camera is looking. | |
void | moveView (float tx, float ty) |
Move the map by tx and ty. | |
float | pitch () const |
Returns pitch angle in degrees (0 = looking from the top, 90 = looking from the side). | |
void | readXml (const QDomElement &elem) |
Reads camera configuration from the given DOM element. | |
void | resetView (float distance) |
Move camera back to the initial position (looking down towards origin of world's coordinates) | |
void | rotateAroundViewCenter (float deltaYaw) |
Rotate clockwise the view by deltaYaw around the view center (camera moves) | |
void | rotateCamera (float diffPitch, float diffYaw) |
Rotates the camera on itself. | |
void | setCameraHeadingAngle (float angle) |
Set camera heading to angle (used for rotating the view) | |
void | setCameraMovementSpeed (double movementSpeed) |
Sets the camera movement speed. | |
void | setCameraPose (const QgsCameraPose &camPose) |
Sets camera pose. | |
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. | |
void | setVerticalAxisInversion (Qgis::VerticalAxisInversion inversion) |
Sets the vertical axis inversion behavior. | |
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. | |
void | tiltUpAroundViewCenter (float deltaPitch) |
Tilt up the view by deltaPitch around the view center (camera moves) | |
Qgis::VerticalAxisInversion | verticalAxisInversion () const |
Returns the vertical axis inversion behavior. | |
void | walkView (double tx, double ty, double tz) |
Walks into the map by tx, ty, and tz. | |
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. | |
QDomElement | writeXml (QDomDocument &doc) const |
Writes camera configuration to the given DOM element. | |
float | yaw () const |
Returns yaw angle in degrees. | |
void | zoom (float factor) |
Zoom the map by factor. | |
Friends | |
class | TestQgs3DCameraController |
class | TestQgs3DRendering |
3
Object that controls camera movement based on user input
Definition at line 57 of file qgscameracontroller.h.
QgsCameraController::QgsCameraController | ( | Qgs3DMapScene * | scene | ) |
Constructs the camera controller with optional parent node that will take ownership.
Definition at line 30 of file qgscameracontroller.cpp.
|
overridedefault |
|
inline |
Returns camera that is being controlled.
Definition at line 77 of file qgscameracontroller.h.
|
signal |
Emitted when camera has been updated.
|
inline |
Returns the camera movement speed.
Definition at line 90 of file qgscameracontroller.h.
|
signal |
Emitted whenever the camera movement speed is changed by the controller.
|
inline |
Returns the navigation mode used by the camera controller.
Definition at line 84 of file qgscameracontroller.h.
|
inline |
|
signal |
Emitted when the camera rotation center changes.
|
slot |
Sets the depth buffer image used by the camera controller to calculate world position from a pixel's coordinates and depth.
Definition at line 1051 of file qgscameracontroller.cpp.
|
inline |
Returns distance of the camera from the point it is looking at.
The value should not be smaller than 10.
Definition at line 147 of file qgscameracontroller.h.
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.
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.
void QgsCameraController::moveView | ( | float | tx, |
float | ty | ||
) |
Move the map by tx and ty.
Definition at line 977 of file qgscameracontroller.cpp.
|
signal |
Emitted when the navigation mode is changed using the hotkey ctrl + ~.
|
inline |
Returns pitch angle in degrees (0 = looking from the top, 90 = looking from the side).
The angle should range from 0 to 180.
Definition at line 154 of file qgscameracontroller.h.
void QgsCameraController::readXml | ( | const QDomElement & | elem | ) |
Reads camera configuration from the given DOM element.
Definition at line 198 of file qgscameracontroller.cpp.
|
signal |
Emitted to ask for the depth buffer image.
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.
void QgsCameraController::rotateAroundViewCenter | ( | float | deltaYaw | ) |
Rotate clockwise the view by deltaYaw around the view center (camera moves)
Definition at line 962 of file qgscameracontroller.cpp.
void QgsCameraController::rotateCamera | ( | float | diffPitch, |
float | diffYaw | ||
) |
Rotates the camera on itself.
diffPitch | the pitch difference |
diffYaw | the yaw difference |
Definition at line 102 of file qgscameracontroller.cpp.
void QgsCameraController::setCameraHeadingAngle | ( | float | angle | ) |
Set camera heading to angle (used for rotating the view)
Definition at line 971 of file qgscameracontroller.cpp.
void QgsCameraController::setCameraMovementSpeed | ( | double | movementSpeed | ) |
Sets the camera movement speed.
Definition at line 86 of file qgscameracontroller.cpp.
|
slot |
Sets the navigation mode used by the camera controller.
Definition at line 76 of file qgscameracontroller.cpp.
void QgsCameraController::setCameraPose | ( | const QgsCameraPose & | camPose | ) |
|
signal |
Emitted when the mouse cursor position should be moved to the specified point on the map viewport.
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.
Definition at line 167 of file qgscameracontroller.cpp.
void QgsCameraController::setVerticalAxisInversion | ( | Qgis::VerticalAxisInversion | inversion | ) |
Sets the vertical axis inversion behavior.
Definition at line 97 of file qgscameracontroller.cpp.
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.
void QgsCameraController::tiltUpAroundViewCenter | ( | float | deltaPitch | ) |
Tilt up the view by deltaPitch around the view center (camera moves)
Definition at line 953 of file qgscameracontroller.cpp.
|
inline |
Returns the vertical axis inversion behavior.
Definition at line 102 of file qgscameracontroller.h.
void QgsCameraController::walkView | ( | double | tx, |
double | ty, | ||
double | tz | ||
) |
Walks into the map by tx, ty, and tz.
Definition at line 789 of file qgscameracontroller.cpp.
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 996 of file qgscameracontroller.cpp.
QDomElement QgsCameraController::writeXml | ( | QDomDocument & | doc | ) | const |
Writes camera configuration to the given DOM element.
Definition at line 186 of file qgscameracontroller.cpp.
|
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.
Definition at line 161 of file qgscameracontroller.h.
void QgsCameraController::zoom | ( | float | factor | ) |
Zoom the map by factor.
Definition at line 520 of file qgscameracontroller.cpp.
|
friend |
Definition at line 359 of file qgscameracontroller.h.
|
friend |
Definition at line 358 of file qgscameracontroller.h.