SceneLoader QML Type

Permet de charger une scène existante. En savoir plus...

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

• Liste de tous les membres, y compris les membres hérités

Propriétés

• source : url
• status : enumeration

Méthodes

• Entity component(string entityName, enumeration componentType)
• Entity entity(string entityName)
• list entityNames()

Description détaillée

À partir d'un fichier source 3D, SceneLoader tentera de l'analyser et de construire une arborescence d'objets Entity dotés des composants appropriés : GeometryRenderer, Transform et Material.

Le chargeur tentera de déterminer le meilleur matériau à utiliser en fonction des propriétés du fichier de modèle. Si vous souhaitez utiliser un matériau personnalisé, vous devrez parcourir l'arborescence et remplacer les matériaux par défaut associés par les vôtres.

Comme son nom l’indique, SceneLoader charge un sous-arbre de scène complet. Si vous souhaitez charger un élément géométrique isolé, il est préférable d’utiliser plutôt le module Mesh.

En interne, SceneLoader s'appuie sur l'utilisation de plugins pour prendre en charge une grande variété de formats de fichiers 3D. Voici une liste des formats pris en charge par Qt3D.

Voir également Mesh et GeometryRenderer.

Documentation des propriétés

source : url

Contient l'URL de la source à charger.

status : enumeration [read-only]

Indique l'état du chargement de la scène.

• SceneLoader.Aucun
• SceneLoader.Chargement
• SceneLoader.Prêt
• SceneLoader.Erreur

Voir aussi Qt3DRender::QSceneLoader::Status.

Documentation de la méthode

Entity component(string entityName, enumeration componentType)

Renvoie un composant dont la propriété « componentType » correspond à celle d’une entité chargée, et dont le « objectName » correspond à celui de entityName. Si l’entité comporte plusieurs composants correspondants, c’est le premier élément de la liste des composants de l’entité qui est renvoyé. En l’absence de correspondance, un élément indéfini est renvoyé.

• SceneLoader.UnknownComponent Type de composant inconnu
• SceneLoader.GeometryRendererComponent Composant Qt3DRender::QGeometryRenderer
• SceneLoader.TransformComponent Composant Qt3DCore::QTransform
• SceneLoader.MaterialComponent : composant Qt3DRender::QMaterial
• SceneLoader.LightComponent Composant Qt3DRender::QAbstractLight
• SceneLoader.CameraLensComponent Composant Qt3DRender::QCameraLens

Voir aussi Qt3DRender::QSceneLoader::ComponentType.

Entity entity(string entityName)

Renvoie une entité chargée dont l'objectName correspond au paramètre entityName. Si plusieurs entités portent le même nom, celle qui sera renvoyée n'est pas définie, mais ce sera toujours la même.

list entityNames()

Renvoie une liste des « objectNames » des entités chargées.