RuntimeLoader QML Type
Importe un élément 3D lors de l'exécution. En savoir plus...
| Import Statement: | import QtQuick3D.AssetUtils |
| Since: | Qt 6.2 |
| Inherits: |
Énumérations
Caractéristiques
- bounds : Bounds
- errorString : string
- instancing : Instancing
- source : url
- status : enumeration
Méthodes
Description détaillée
Le type RuntimeLoader permet de charger une ressource 3D directement depuis sa source lors de l'exécution, sans avoir à la convertir au préalable au format interne d'QtQuick3D.
RuntimeLoader prend en charge les fichiers .obj et glTF version 2.0, aussi bien au format texte (.gltf) qu’au format binaire (.glb).
Avertissement : RuntimeLoader ne place pas le contenu des ressources en bac à sable et ne le valide pas. Le chargement de ressources mal formées ou non fiables peut avoir des implications en matière de sécurité. Consultez source pour plus de détails.
Documentation sur l'énumération
QueryFilter
Spécifie le type d'objets à rechercher.
| Constante | Description |
|---|---|
RuntimeLoader.Textures | Recherche d'objets de texture |
RuntimeLoader.Materials | Recherche d'objets de matériau |
RuntimeLoader.Nodes | Recherche d'objets de nœuds |
RuntimeLoader.Cameras | Requête concernant les objets caméra |
RuntimeLoader.Lights | Requête concernant les objets « lumière » |
RuntimeLoader.Models | Requête concernant les objets « modèle » |
Voir aussi queryAll().
Documentation sur les propriétés
bounds : Bounds [read-only]
Cette propriété décrit les limites du volume englobant le modèle importé.
Remarque : cette valeur peut ne pas être disponible avant le premier rendu.
errorString : string [read-only]
Cette propriété contient une chaîne de caractères lisible par l'utilisateur indiquant l'état de la dernière opération de chargement.
instancing : Instancing
Si cette propriété est définie, le modèle importé ne sera pas rendu normalement. À la place, un certain nombre d'instances seront rendues, conformément à la définition du tableau d'instances.
Pour plus d’informations, consultez la documentation générale sur le rendu instancié.
source : url
Cette propriété contient l'emplacement du fichier source renfermant la ressource 3D. La modification de cette propriété entraîne le déchargement de la ressource actuelle et tente de charger une ressource à partir de l'URL indiquée.
La réussite ou l'échec de l'opération de chargement est indiqué par status.
Avertissement : RuntimeLoader ne met pas en sandbox ni ne valide le contenu des ressources. Le chargement de ressources mal formées ou non fiables peut avoir des implications en matière de sécurité. Les développeurs d’applications doivent en tenir compte avec soin avant d’autoriser le chargement de contenu fourni par l’utilisateur qui ne fait pas partie de l’application.
status : enumeration [read-only]
Cette propriété indique l'état de la dernière opération de chargement.
| Constante | Description |
|---|---|
RuntimeLoader.Empty | Aucune URL n'a été spécifiée. |
RuntimeLoader.Success | L'opération de chargement a réussi. |
RuntimeLoader.Error | L'opération de chargement a échoué. Un message d'erreur lisible par l'utilisateur est fourni par errorString. |
Documentation de la méthode
[since 6.12] Object3D query(string arg)
Renvoie l'objet portant le nom indiqué, ou « null » si aucun objet portant ce nom n'existe.
Le paramètre arg correspond au nom de l’objet à interroger ou à une chaîne de requête. Par exemple, pour interroger l’objet nommé « PaintMaterialX », utilisez le code suivant :
var object = runtimeLoader.query("PaintMaterial")Le code ci-dessus fonctionne comme prévu à condition que les objets soient nommés de manière cohérente dans le fichier de ressources source. Cependant, s'il existe plusieurs objets portant le même nom, la requête renverra le premier objet trouvé correspondant au nom donné. Pour interroger un objet spécifique et éviter toute ambiguïté, utilisez le chemin d'accès complet de l'objet.
var object = runtimeLoader.query("/House2/Wall001/Mirror/Material")Remarque : même avec des chemins d’accès, il est possible qu’un fichier de ressources mal structuré contienne plusieurs objets ayant le même chemin d’accès, car les chemins d’accès sont construits à partir des noms d’objets figurant dans le fichier de ressources source.
Remarque : les noms d’objets sont définis tels qu’ils apparaissent dans le fichier de ressources source.
Cette méthode a été introduite dans Qt 6.12.
[since 6.12] List<Object3D> queryAll(QueryFilter filter)
Renvoie une liste de tous les objets correspondant au filtre spécifié.
Le paramètre « filter » spécifie le type d'objets à rechercher. Par exemple, pour rechercher tous les matériaux, utilisez le code suivant :
var materials = runtimeLoader.queryAll(RuntimeLoader.Materials)Le code ci-dessus renvoie une liste de tous les matériaux présents dans le fichier de ressources source.
Cette méthode a été introduite dans Qt 6.12.
© 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.
