Sur cette page

BoundingVolume QML Type

peut être utilisé pour remplacer le volume englobant d'une entité. En savoir plus…

Import Statement: import Qt3D.Core 2.12
In C++: QBoundingVolume
Inherited By:

GeometryRenderer

Status: Deprecated

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Méthodes

Description détaillée

Le volume englobant d'une entité est utilisé pour de nombreuses opérations telles que la sélection ou le culling du cône de vue. Il est généralement calculé en parcourant la géométrie rendue.

La fonction `BoundingVolume` peut être utilisée lorsque l'application connaît l'étendue de la géométrie, ce qui évite à ` Qt 3D ` de devoir la calculer.

Un volume englobant peut être fourni soit sous forme de coordonnées d'étendue minimale et maximale, soit sous la forme d'une géométrie distincte, généralement plus simple, qui se rapproche du maillage rendu.

Lorsque l’on utilise des étendues minimale et maximale, celles-ci sont considérées comme les coins opposés d’un parallélépipède rectangulaire aligné sur les axes, dans le système de coordonnées local de la géométrie.

La méthode `BoundingVolume` peut également être utilisée pour interroger le volume englobant calculé d’un ` GeometryView`. Les propriétés ` implicitMinPoint ` et ` implicitMaxPoint ` seront mises à jour si la géométrie change. Notez que cette opération s’effectue de manière asynchrone sur un thread d’arrière-plan ; vous devez donc vérifier la valeur de ` implicitPointsValid ` avant de les lire.

Vous pouvez forcer la mise à jour des limites implicites en appelant ` updateImplicitBounds`. Cela bloquera le thread appelant jusqu’à ce que les résultats soient disponibles.

Remarque : ` GeometryRenderer ` hérite de `BoundingVolume` et prend donc également en charge la lecture des limites implicites ou la définition de limites explicites.

Documentation des propriétés

implicitMaxPoint : vector3d [read-only]

* * * Contient l'étendue maximale du volume englobant calculée à partir de la vue spécifiée.

implicitMinPoint : vector3d [read-only]

* * * Contient l'étendue minimale du volume englobant calculée à partir de la vue spécifiée.

implicitPointsValid : bool [read-only]

* * * Vrai si une vue a été attribuée et si les propriétés d'étendue implicites sont à jour. * *

Voir également updateImplicitBounds.

maxPoint : vector3d

* * * Étendue maximale du volume englobant, spécifiée par l'utilisateur. Lorsqu'elle est définie (en même temps que l'* étendue minimale), cette valeur sera utilisée en interne pour éviter de calculer le volume à partir de la * géométrie.

minPoint : vector3d

* * * Étendue minimale du volume englobant, spécifiée par l'utilisateur. Lorsqu'elle est définie (en même temps que l'étendue maximale), cette valeur sera utilisée en interne pour éviter de calculer le volume à partir de la géométrie.

view : GeometryView

* * * Contient un pointeur vers l'instance de QGeometryView qui sera utilisée, si elle est définie, * pour calculer le volume englobant.

Documentation des méthodes

bool updateImplicitBounds()

* * * Met à jour les limites implicites de la vue spécifiée. Renvoie * true si le calcul a abouti, et false dans le cas contraire. * *

Remarque : les calculs sont effectués dans le thread d'appel, ce qui * peut prendre un temps considérable pour les maillages volumineux.

© 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.