En esta página

Qt3DCore::QBoundingVolume Class

class Qt3DCore::QBoundingVolume

Se puede utilizar para anular el volumen delimitador de una entidad. Más información...

Encabezado: #include <Qt3DCore/QBoundingVolume>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake: QT += 3dcore
Desde: Qt 6.0
En QML: BoundingVolume
Heredado de: Qt3DCore::QComponent
Heredado por:

Qt3DRender::QGeometryRenderer y Qt3DRender::QPickingProxy

Estado: Obsoleto

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Propiedades

Funciones públicas

QBoundingVolume(Qt3DCore::QNode *parent = nullptr)
bool areImplicitPointsValid() const
QVector3D implicitMaxPoint() const
QVector3D implicitMinPoint() const
QVector3D maxPoint() const
QVector3D minPoint() const
Qt3DCore::QGeometryView *view() const

Ranuras públicas

void setMaxPoint(const QVector3D &maxPoint)
void setMinPoint(const QVector3D &minPoint)
void setView(Qt3DCore::QGeometryView *view)
bool updateImplicitBounds()

Señales

void implicitMaxPointChanged(const QVector3D &implicitMaxPoint)
void implicitMinPointChanged(const QVector3D &implicitMinPoint)
void implicitPointsValidChanged(bool implicitPointsValid)
void maxPointChanged(QVector3D maxPoint)
void minPointChanged(QVector3D minPoint)
void viewChanged(Qt3DCore::QGeometryView *view)

Descripción detallada

El volumen delimitador de una entidad se utiliza para muchas operaciones, como la selección o el recorte del frustum de visión. Normalmente se calcula recorriendo la geometría renderizada.

Se puede utilizar `QBoundingVolume` cuando la aplicación conoce la extensión de la geometría, de modo que ` Qt 3D ` no tenga que calcularla.

Un volumen delimitador puede proporcionarse bien como coordenadas de extensión mínima y máxima, bien como una geometría separada —normalmente más sencilla— que se aproxime a la malla renderizada.

Cuando se utilizan las extensiones mínima y máxima, estas se consideran las esquinas opuestas de una caja delimitadora alineada con los ejes, en el sistema de coordenadas local de la geometría.

QBoundingVolume también se puede utilizar para consultar el volumen delimitador calculado de un ` GeometryView`. Las propiedades ` implicitMinPoint ` y ` implicitMaxPoint ` se actualizarán si la geometría cambia. Ten en cuenta que esto se realiza de forma asíncrona en un hilo en segundo plano, por lo que debes comprobar el valor de ` implicitPointsValid ` antes de leerlas.

Puede forzar la actualización de los límites implícitos llamando a ` updateImplicitBounds`. Esto bloqueará el hilo de llamada hasta que los resultados estén disponibles.

Nota: ` GeometryRenderer ` hereda de ` BoundingVolume ` y, por lo tanto, admite tanto la lectura de límites implícitos como el establecimiento de límites explícitos.

Documentación de propiedades

[read-only] implicitMaxPoint : QVector3D

* * * Contiene la extensión máxima del volumen delimitador calculada a partir de la vista especificada.

Funciones de acceso:

QVector3D implicitMaxPoint() const

Señal de notificación:

void implicitMaxPointChanged(const QVector3D &implicitMaxPoint)

[read-only] implicitMinPoint : QVector3D

* * * Contiene la extensión mínima del volumen delimitador calculada a partir de la vista especificada.

Funciones de acceso:

QVector3D implicitMinPoint() const

Señal de notificación:

void implicitMinPointChanged(const QVector3D &implicitMinPoint)

[read-only] implicitPointsValid : bool

* * * Es verdadero si se ha asignado una vista y las propiedades de extensión implícitas están actualizadas. * *

Funciones de acceso:

bool areImplicitPointsValid() const

Señal del notificador:

void implicitPointsValidChanged(bool implicitPointsValid)

Véase también updateImplicitBounds.

maxPoint : QVector3D

* * * Extensión máxima del volumen delimitador especificada por el usuario. Cuando se establece (junto con la * extensión mínima), se utilizará internamente para evitar calcular el volumen a partir de la * geometría.

Funciones de acceso:

QVector3D maxPoint() const
void setMaxPoint(const QVector3D &maxPoint)

Señal de notificación:

void maxPointChanged(QVector3D maxPoint)

minPoint : QVector3D

* * * Extensión mínima del volumen delimitador especificada por el usuario. Cuando se define (junto con la * extensión máxima), se utilizará internamente para evitar calcular el volumen a partir de la * geometría.

Funciones de acceso:

QVector3D minPoint() const
void setMinPoint(const QVector3D &minPoint)

Señal de notificación:

void minPointChanged(QVector3D minPoint)

view : QGeometryView*

* * * Contiene un puntero a la instancia de QGeometryView que se utilizará, si se ha establecido, * para calcular el volumen delimitador.

Funciones de acceso:

Qt3DCore::QGeometryView *view() const
void setView(Qt3DCore::QGeometryView *view)

Señal de notificación:

void viewChanged(Qt3DCore::QGeometryView *view)

Documentación de las funciones de miembro

[explicit] QBoundingVolume::QBoundingVolume(Qt3DCore::QNode *parent = nullptr)

Crea un nuevo objeto `QBoundingVolume` con ` parent`.

[slot] bool QBoundingVolume::updateImplicitBounds()

* Actualiza los límites implícitos de la vista especificada. Devuelve * true si el cálculo se ha realizado correctamente y «false» en caso contrario. * *

Nota: Los cálculos se realizan en el hilo de llamada, lo que * podría llevar bastante tiempo en el caso de mallas grandes.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.