Qt3DCore::QBoundingVolume Class
class Qt3DCore::QBoundingVolumepuede utilizarse para modificar el volumen límite de una entidad. Más...
| Cabecera: | #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 |
| Hereda de: | Qt3DCore::QComponent |
| Heredado de: | |
| Estado: | Deprecated |
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 el picking o el view frustum culling. Normalmente se calcula recorriendo la geometría renderizada.
QBoundingVolume puede utilizarse cuando la aplicación conoce la extensión de la geometría, de forma que Qt 3D no tenga que calcularla.
Un volumen delimitador puede proporcionarse como coordenadas de extensión mínima y máxima, o como una geometría separada, normalmente más simple, que se aproxima a la malla renderizada.
Cuando se utilizan extensiones mínimas y máximas, se considera que son las esquinas opuestas de un cuadro delimitador alineado con el eje, en el sistema de coordenadas local de la geometría.
QBoundingVolume también puede utilizarse para consultar el volumen calculado de un GeometryView. Las propiedades implicitMinPoint y implicitMaxPoint se actualizarán si cambia la geometría. Tenga en cuenta que esto se hace de forma asíncrona en un hilo de fondo, por lo que debe comprobar el valor de implicitPointsValid antes de leerlos.
Puedes forzar la actualización de las extensiones implícitas llamando a updateImplicitBounds. Esto se bloqueará en el subproceso de llamada hasta que los resultados estén disponibles.
Nota: GeometryRenderer hereda de BoundingVolume y, por tanto, también permite leer límites implícitos o establecer límites explícitos.
Documentación de propiedades
[read-only] implicitMaxPoint : QVector3D
* * Contiene la extensión máxima del volumen delimitador calculado a partir de la vista especificada.
Funciones de acceso:
| QVector3D | implicitMaxPoint() const |
Señal del notificador:
| void | implicitMaxPointChanged(const QVector3D &implicitMaxPoint) |
[read-only] implicitMinPoint : QVector3D
* * Mantiene la extensión mínima del volumen delimitador calculado a partir de la vista especificada.
Funciones de acceso:
| QVector3D | implicitMinPoint() const |
Señal notificadora:
| void | implicitMinPointChanged(const QVector3D &implicitMinPoint) |
[read-only] implicitPointsValid : bool
* * * True 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 de notificador:
| void | implicitPointsValidChanged(bool implicitPointsValid) |
Véase también updateImplicitBounds.
maxPoint : QVector3D
* El usuario especifica la extensión máxima del volumen delimitador. 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 establece (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 establece, * para calcular el volumen delimitador.
Funciones de acceso:
| Qt3DCore::QGeometryView * | view() const |
| void | setView(Qt3DCore::QGeometryView *view) |
Señal del notificador:
| void | viewChanged(Qt3DCore::QGeometryView *view) |
Documentación de la función miembro
[explicit] QBoundingVolume::QBoundingVolume(Qt3DCore::QNode *parent = nullptr)
Construye un nuevo QBoundingVolume con parent.
[slot] bool QBoundingVolume::updateImplicitBounds()
* Actualiza los límites implícitos de la vista especificada. Devuelve * true si el cálculo tuvo éxito y false en caso contrario. * *
Nota: Los cálculos se realizan en el hilo de llamada, esto * podría tomar un tiempo significativo para 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.
