QGIS API Documentation
3.12.1-București (121cc00ff0)
|
3 Entity that encapsulates our 3D scene - contains all other entities (such as terrain) as children. More...
#include <qgs3dmapscene.h>
Public Types | |
enum | SceneState { Ready, Updating } |
Enumeration of possible states of the 3D scene. More... | |
Signals | |
void | sceneStateChanged () |
Emitted when the scene's state has changed. More... | |
void | terrainEntityChanged () |
Emitted when the current terrain entity is replaced by a new one. More... | |
void | terrainPendingJobsCountChanged () |
Emitted when the number of terrain's pending jobs changes. More... | |
void | totalPendingJobsCountChanged () |
Emitted when the total number of pending jobs changes. More... | |
Public Member Functions | |
Qgs3DMapScene (const Qgs3DMapSettings &map, QgsAbstract3DEngine *engine) | |
Constructs a 3D scene based on map settings and Qt 3D renderer configuration. More... | |
QgsCameraController * | cameraController () |
Returns camera controller. More... | |
void | registerPickHandler (Qgs3DMapScenePickHandler *pickHandler) |
Registers an object that will get results of pick events on 3D entities. Does not take ownership of the pick handler. Adds object picker components to 3D entities. More... | |
SceneState | sceneState () const |
Returns the current state of the scene. More... | |
QgsTerrainEntity * | terrainEntity () |
Returns terrain entity (may be temporarily nullptr ) More... | |
int | terrainPendingJobsCount () const |
Returns number of pending jobs of the terrain entity. More... | |
int | totalPendingJobsCount () const |
Returns number of pending jobs for all chunked entities. More... | |
void | unregisterPickHandler (Qgs3DMapScenePickHandler *pickHandler) |
Unregisters previously registered pick handler. Pick handler is not deleted. Also removes object picker components from 3D entities. More... | |
void | viewZoomFull () |
Resets camera view to show the whole scene (top view) More... | |
float | worldSpaceError (float epsilon, float distance) |
Given screen error (in pixels) and distance from camera (in 3D world coordinates), this function estimates the error in world space. More... | |
3 Entity that encapsulates our 3D scene - contains all other entities (such as terrain) as children.
Definition at line 58 of file qgs3dmapscene.h.
Enumeration of possible states of the 3D scene.
Enumerator | |
---|---|
Ready | The scene is fully loaded/updated. |
Updating | The scene is still being loaded/updated. |
Definition at line 83 of file qgs3dmapscene.h.
Qgs3DMapScene::Qgs3DMapScene | ( | const Qgs3DMapSettings & | map, |
QgsAbstract3DEngine * | engine | ||
) |
Constructs a 3D scene based on map settings and Qt 3D renderer configuration.
Definition at line 57 of file qgs3dmapscene.cpp.
|
inline |
Returns camera controller.
Definition at line 66 of file qgs3dmapscene.h.
void Qgs3DMapScene::registerPickHandler | ( | Qgs3DMapScenePickHandler * | pickHandler | ) |
Registers an object that will get results of pick events on 3D entities. Does not take ownership of the pick handler. Adds object picker components to 3D entities.
Definition at line 188 of file qgs3dmapscene.cpp.
|
inline |
Returns the current state of the scene.
Definition at line 90 of file qgs3dmapscene.h.
|
signal |
Emitted when the scene's state has changed.
|
inline |
Returns terrain entity (may be temporarily nullptr
)
Definition at line 68 of file qgs3dmapscene.h.
|
signal |
Emitted when the current terrain entity is replaced by a new one.
int Qgs3DMapScene::terrainPendingJobsCount | ( | ) | const |
Returns number of pending jobs of the terrain entity.
Definition at line 175 of file qgs3dmapscene.cpp.
|
signal |
Emitted when the number of terrain's pending jobs changes.
int Qgs3DMapScene::totalPendingJobsCount | ( | ) | const |
Returns number of pending jobs for all chunked entities.
Definition at line 180 of file qgs3dmapscene.cpp.
|
signal |
Emitted when the total number of pending jobs changes.
void Qgs3DMapScene::unregisterPickHandler | ( | Qgs3DMapScenePickHandler * | pickHandler | ) |
Unregisters previously registered pick handler. Pick handler is not deleted. Also removes object picker components from 3D entities.
Definition at line 203 of file qgs3dmapscene.cpp.
void Qgs3DMapScene::viewZoomFull | ( | ) |
Resets camera view to show the whole scene (top view)
Definition at line 168 of file qgs3dmapscene.cpp.
float Qgs3DMapScene::worldSpaceError | ( | float | epsilon, |
float | distance | ||
) |
Given screen error (in pixels) and distance from camera (in 3D world coordinates), this function estimates the error in world space.
Takes into account camera's field of view and the screen (3D view) size.
Definition at line 235 of file qgs3dmapscene.cpp.