Qgs3DMapScene Class Reference

3 Entity that encapsulates our 3D scene - contains all other entities (such as terrain) as children. More...

#include <qgs3dmapscene.h>

Inheritance diagram for Qgs3DMapScene:

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...

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...
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...

Detailed Description

3 Entity that encapsulates our 3D scene - contains all other entities (such as terrain) as children.

Since

QGIS 3.0

Definition at line 54 of file qgs3dmapscene.h.

Member Enumeration Documentation

SceneState

enum Qgs3DMapScene::SceneState

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 73 of file qgs3dmapscene.h.

Constructor & Destructor Documentation

Qgs3DMapScene()

Qgs3DMapScene::Qgs3DMapScene	(	const Qgs3DMapSettings &	map,
		QgsAbstract3DEngine *	engine
	)

Constructs a 3D scene based on map settings and Qt 3D renderer configuration.

Definition at line 56 of file qgs3dmapscene.cpp.

Member Function Documentation

cameraController()

QgsCameraController* Qgs3DMapScene::cameraController ( )

inline

Returns camera controller.

Definition at line 62 of file qgs3dmapscene.h.

registerPickHandler()

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 179 of file qgs3dmapscene.cpp.

sceneState()

SceneState Qgs3DMapScene::sceneState ( ) const

inline

Returns the current state of the scene.

Definition at line 80 of file qgs3dmapscene.h.

sceneStateChanged

void Qgs3DMapScene::sceneStateChanged ( )

signal

Emitted when the scene's state has changed.

terrainEntity()

QgsTerrainEntity* Qgs3DMapScene::terrainEntity ( )

inline

Returns terrain entity (may be temporarily nullptr)

Definition at line 64 of file qgs3dmapscene.h.

terrainEntityChanged

void Qgs3DMapScene::terrainEntityChanged ( )

signal

Emitted when the current terrain entity is replaced by a new one.

terrainPendingJobsCount()

int Qgs3DMapScene::terrainPendingJobsCount

(

)

const

Returns number of pending jobs of the terrain entity.

Definition at line 174 of file qgs3dmapscene.cpp.

terrainPendingJobsCountChanged

void Qgs3DMapScene::terrainPendingJobsCountChanged ( )

signal

Emitted when the number of terrain's pending jobs changes.

unregisterPickHandler()

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 195 of file qgs3dmapscene.cpp.

viewZoomFull()

void Qgs3DMapScene::viewZoomFull

(

)

Resets camera view to show the whole scene (top view)

Definition at line 167 of file qgs3dmapscene.cpp.

worldSpaceError()

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 210 of file qgs3dmapscene.cpp.

---

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

• /build/qgis-3.10.0+15buster/src/3d/qgs3dmapscene.h
• /build/qgis-3.10.0+15buster/src/3d/qgs3dmapscene.cpp