Q3DScene Class

Property Documentation

activeCamera : Q3DCamera*

This property holds the currently active camera in the 3D scene.

When a new Q3DCamera object is set, it is automatically added as child of the scene.

Access functions:

Q3DCamera *	activeCamera() const
void	setActiveCamera(Q3DCamera *camera)

Notifier signal:

void	activeCameraChanged(Q3DCamera *camera)

activeLight : Q3DLight*

This property holds the currently active light in the 3D scene.

When a new Q3DLight objects is set, it is automatically added as child of the scene.

Access functions:

Q3DLight *	activeLight() const
void	setActiveLight(Q3DLight *light)

Notifier signal:

void	activeLightChanged(Q3DLight *light)

devicePixelRatio : float

This property holds the device pixel ratio that is used when mapping input coordinates to pixel coordinates.

Access functions:

float	devicePixelRatio() const
void	setDevicePixelRatio(float pixelRatio)

Notifier signal:

void	devicePixelRatioChanged(float pixelRatio)

graphPositionQuery : QPoint

This property holds the coordinates for the user input that should be processed by the scene as a graph position query.

If this property is set to a value other than invalidSelectionPoint(), the graph tries to match a graph position to the specified coordinates within the primary viewport. After the rendering pass, this property is returned to its default state of invalidSelectionPoint(). The queried graph position can be read from the QAbstract3DGraph::queriedGraphPosition property after the next render pass.

There is no single correct 3D coordinate to match a particular screen position, so to be consistent, the queries are always done against the inner sides of an invisible box surrounding the graph.

Note: Bar graphs allow graph position queries only at the graph floor level.

Access functions:

QPoint	graphPositionQuery() const
void	setGraphPositionQuery(const QPoint &point)

Notifier signal:

void	graphPositionQueryChanged(const QPoint &position)

See also QAbstract3DGraph::queriedGraphPosition.

primarySubViewport : QRect

This property holds the current subviewport rectangle inside the viewport where the primary view of the data visualization is targeted.

If isSlicingActive() is false, the primary sub viewport is equal to viewport(). If isSlicingActive() is true and the primary sub viewport has not been explicitly set, it will be one fifth of viewport().

Note: Setting primarySubViewport larger than or outside of the viewport resizes the viewport accordingly.

Access functions:

QRect	primarySubViewport() const
void	setPrimarySubViewport(const QRect &primarySubViewport)

Notifier signal:

void	primarySubViewportChanged(const QRect &subViewport)

secondarySubViewport : QRect

This property holds the secondary viewport rectangle inside the viewport.

The secondary viewport is used for drawing the 2D slice view in some visualizations. If it has not been explicitly set, it will be equal to QRect. If isSlicingActive() is true, it will be equal to viewport.

Note: If the secondary sub viewport is larger than or outside of the viewport, the viewport is resized accordingly.

Access functions:

QRect	secondarySubViewport() const
void	setSecondarySubViewport(const QRect &secondarySubViewport)

Notifier signal:

void	secondarySubViewportChanged(const QRect &subViewport)

secondarySubviewOnTop : bool

This property holds whether the 2D slicing view or the 3D view is drawn on top.

Access functions:

bool	isSecondarySubviewOnTop() const
void	setSecondarySubviewOnTop(bool isSecondaryOnTop)

Notifier signal:

void	secondarySubviewOnTopChanged(bool isSecondaryOnTop)

selectionQueryPosition : QPoint

This property holds the coordinates for the user input that should be processed by the scene as a selection.

If this property is set to a value other than invalidSelectionPoint(), the graph tries to select a data item, axis label, or a custom item at the specified coordinates within the primary viewport. After the rendering pass, the property is returned to its default state of invalidSelectionPoint().

Access functions:

QPoint	selectionQueryPosition() const
void	setSelectionQueryPosition(const QPoint &point)

Notifier signal:

void	selectionQueryPositionChanged(const QPoint &position)

See also QAbstract3DGraph::selectedElement.

slicingActive : bool

This property holds whether the 2D slicing view is currently active.

If true, QAbstract3DGraph::selectionMode must have either QAbstract3DGraph::SelectionRow or QAbstract3DGraph::SelectionColumn set to a valid selection.

Note: Not all visualizations support the 2D slicing view.

Access functions:

bool	isSlicingActive() const
void	setSlicingActive(bool isSlicing)

Notifier signal:

void	slicingActiveChanged(bool isSlicingActive)

viewport : const QRect

This property holds a read only property that contains the current viewport rectangle where all the 3D rendering is targeted.

Access functions:

QRect

viewport() const

Notifier signal:

void	viewportChanged(const QRect &viewport)