- class QBoundingVolume#
can be used to override the bounding volume of an entity. More…
Inherited by:
QPickingProxy
,QGeometryRenderer
,QMesh
,QTorusMesh
,QSphereMesh
,QPlaneMesh
,QExtrudedTextMesh
,QCylinderMesh
,QCuboidMesh
,QConeMesh
Synopsis#
Properties#
Methods#
def
__init__()
def
maxPoint()
def
minPoint()
def
view()
Slots#
def
setMaxPoint()
def
setMinPoint()
def
setView()
Signals#
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
Detailed Description#
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 . TheimplicitMinPoint
andimplicitMaxPoint
properties will be updated if the geometry changes. Note that this is done asynchronously on a background thread so you should check the value ofimplicitPointsValid
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.
Note
Properties can be used directly when
from __feature__ import true_property
is used or via accessor functions otherwise.* * * Holds maximum extent of the bounding volume computed from the specified view.
- Access functions:
* * * Holds minimum extent of the bounding volume computed from the specified view.
- Access functions:
- property implicitPointsValidᅟ: bool#
* * * True if a view has been assigned and the implicit extent properties are up to date. * *
See also
updateImplicitBounds
- Access functions:
* * * 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:
* * * 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:
- property viewᅟ: QGeometryView#
* * * Holds a pointer to the instance of
QGeometryView
which will be used, if set, * to compute the bounding volume.- Access functions:
Signal
viewChanged()
- __init__([parent=None])#
- Parameters:
parent –
QNode
Constructs a new
QBoundingVolume
withparent
.- areImplicitPointsValid()#
- Return type:
bool
Getter of property
implicitPointsValidᅟ
.Getter of property
implicitMaxPointᅟ
.Notification signal of property
implicitMaxPointᅟ
.Getter of property
implicitMinPointᅟ
.Notification signal of property
implicitMinPointᅟ
.- implicitPointsValidChanged(implicitPointsValid)#
- Parameters:
implicitPointsValid – bool
Notification signal of property
implicitPointsValidᅟ
.Getter of property
maxPointᅟ
.Notification signal of property
maxPointᅟ
.Getter of property
minPointᅟ
.Notification signal of property
minPointᅟ
.Setter of property
maxPointᅟ
.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ᅟ
.