Qt3DCore::QBoundingVolume Class
class Qt3DCore::QBoundingVolumeSe 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: | |
| 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.