PySide6.Qt3DCore.Qt3DCore.QBoundingVolume

class QBoundingVolume

can be used to override the bounding volume of an entity.

Details

An entity’s bounding volume is used for many operations such as picking or view frustum culling. It is normally computed by traversing the rendered geometry.

QBoundingVolume can be used when the extent of the geometry is known to the application so that Qt 3D does not have to compute it.

A bounding volume can be provided either as minimum and maximum extent coordinates, or a separate, usually simpler, geometry that approximates the rendered mesh.

When using minimum and maximum extents, these are considered to be the opposite corners of an axis aligned bounding box, in the geometry’s local coordinate system.

QBoundingVolume can also be used to query the computed bounding volume of a GeometryView . The implicitMinPoint and implicitMaxPoint properties will be updated if the geometry changes. Note that this is done asynchronously on a background thread so you should check the value of implicitPointsValid before reading them.

You can force the implicit extents to be updated by calling updateImplicitBounds . This will block on the calling thread until the results are available.

Note

GeometryRenderer inherits BoundingVolume and thus supports reading implicit bounds or setting explicit bounds also.

Inherited by: QPickingProxy, QGeometryRenderer, QMesh, QTorusMesh, QSphereMesh, QPlaneMesh, QExtrudedTextMesh, QCylinderMesh, QCuboidMesh, QConeMesh

Synopsis

Properties

• implicitMaxPointᅟ

• implicitMinPointᅟ

• implicitPointsValidᅟ

• maxPointᅟ

• minPointᅟ

• viewᅟ

Methods

• def __init__()

• def areImplicitPointsValid()

• def implicitMaxPoint()

• def implicitMinPoint()

• def maxPoint()

• def minPoint()

• def view()

Slots

• def setMaxPoint()

• def setMinPoint()

• def setView()

• def updateImplicitBounds()

Signals

• def implicitMaxPointChanged()

• def implicitMinPointChanged()

• def implicitPointsValidChanged()

• def maxPointChanged()

• def minPointChanged()

• def viewChanged()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property implicitMaxPointᅟ: QVector3D

* * * Holds maximum extent of the bounding volume computed from the specified view.

Access functions:

• implicitMaxPoint()

• Signal implicitMaxPointChanged()

property implicitMinPointᅟ: QVector3D

* * * Holds minimum extent of the bounding volume computed from the specified view.

Access functions:

• implicitMinPoint()

• Signal implicitMinPointChanged()

property implicitPointsValidᅟ: bool

* * * True if a view has been assigned and the implicit extent properties are up to date. * *

See also

updateImplicitBounds

Access functions:

• areImplicitPointsValid()

• Signal implicitPointsValidChanged()

property maxPointᅟ: QVector3D

* * * User specified maximum extent of the bounding volume. When set (along with minimum * extent), this will be used internally to avoid computing the volume from the * geometry.

Access functions:

• maxPoint()

• setMaxPoint()

• Signal maxPointChanged()

property minPointᅟ: QVector3D

* * * User specified minimum extent of the bounding volume. When set (along with maximum * extent), this will be used internally to avoid computing the volume from the * geometry.

Access functions:

• minPoint()

• setMinPoint()

• Signal minPointChanged()

property viewᅟ: QGeometryView

* * * Holds a pointer to the instance of QGeometryView which will be used, if set, * to compute the bounding volume.

Access functions:

• view()

• setView()

• Signal viewChanged()

__init__([parent=None])

Parameters:

parent – QNode

Constructs a new QBoundingVolume with parent.

areImplicitPointsValid()

Return type:

bool

Getter of property implicitPointsValidᅟ .

implicitMaxPoint()

Return type:

QVector3D

Getter of property implicitMaxPointᅟ .

implicitMaxPointChanged(implicitMaxPoint)

Parameters:

implicitMaxPoint – QVector3D

Notification signal of property implicitMaxPointᅟ .

implicitMinPoint()

Return type:

QVector3D

Getter of property implicitMinPointᅟ .

implicitMinPointChanged(implicitMinPoint)

Parameters:

implicitMinPoint – QVector3D

Notification signal of property implicitMinPointᅟ .

implicitPointsValidChanged(implicitPointsValid)

Parameters:

implicitPointsValid – bool

Notification signal of property implicitPointsValidᅟ .

maxPoint()

Return type:

QVector3D

See also

setMaxPoint()

Getter of property maxPointᅟ .

maxPointChanged(maxPoint)

Parameters:

maxPoint – QVector3D

Notification signal of property maxPointᅟ .

minPoint()

Return type:

QVector3D

See also

setMinPoint()

Getter of property minPointᅟ .

minPointChanged(minPoint)

Parameters:

minPoint – QVector3D

Notification signal of property minPointᅟ .

setMaxPoint(maxPoint)

Parameters:

maxPoint – QVector3D

See also

maxPoint()

Setter of property maxPointᅟ .

setMinPoint(minPoint)

Parameters:

minPoint – QVector3D

See also

minPoint()

Setter of property minPointᅟ .

setView(view)

Parameters:

view – QGeometryView

See also

view()

Setter of property viewᅟ .

updateImplicitBounds()

Return type:

bool

* Updates the implicit bounds of the specified view. Returns * true if the computation succeeded and false otherwise. * *

Note

The calculations are done in the call thread, this * could take significant time for large meshes.

view()

Return type:

QGeometryView

See also

setView()

Getter of property viewᅟ .

viewChanged(view)

Parameters:

view – QGeometryView

Notification signal of property viewᅟ .