Object3D QML Type (Uncreatable)

Type de base abstrait de tous les nœuds et ressources 3D. En savoir plus...

Remarque : il s'agit d'un type non créable. Il ne peut pas être instancié en QML.

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

Propriétés

• children : list<Object3D>
• data : list<Object>
• parent : Object3D
• resources : list<Object>
• state : string
• states : list<State>
• transitions : list<Transition>

Description détaillée

Object3D est la classe de base de tous les types 3D d'Qt Quick. Cela inclut :

• Les types spatiaux qui représentent des objets dans la scène 3D ; ceux-ci possèdent généralement une position et/ou une direction. Par exemple : ` Model`, ` Camera` ou ` Light`. Ces types héritent de ` Node`, qui hérite lui-même de `Object3D`.
• Les types de ressources qui ne représentent pas eux-mêmes un objet dans l’univers 3D, mais servent plutôt de composants aux sous-classes de ` Node `, en fournissant des données d’un certain type. Cela inclut, entre autres, ` Material`, ` Geometry` et ` Texture`.

Outre les types mentionnés ci-dessus, Object3D peut également servir de classe parente pour Qt Quick items, ainsi que pour des instances arbitraires de ` QObject `. Pour plus d’informations sur l’ajout d’éléments 2D à la scène 3D, reportez-vous à la section « Scènes avec du contenu 2D » deQt Quick 3D.

Voir également Node.

Documentation sur les propriétés

La propriété `children` contient la liste des enfants visuels de cet objet. La propriété `resources` contient les ressources non visuelles que vous souhaitez référencer par leur nom.

Il n’est généralement pas nécessaire de faire référence à ces propriétés lors de l’ajout d’objets enfants ou de ressources, car la propriété par défaut ` data ` attribuera automatiquement les objets enfants aux propriétés ` children ` et ` resources ` selon le cas. Consultez la documentation de ` QtQuick3D::Object3D::data ` pour plus de détails.

data : list<Object> [default]

La propriété « data » vous permet de combiner librement des enfants et des ressources de type « Object3D » au sein d’un objet. Si vous attribuez un objet de type « Object3D » à la liste « data », celui-ci devient un enfant ; si vous attribuez tout autre type d’objet, celui-ci est ajouté en tant que ressource.

Vous pouvez donc écrire :

Object3D {
    Node {}
    DirectionalLight {}
    Timer {}
}

au lieu de :

Item {
    children: [
        Node {},
        DirectionalLight {}
    ]
    resources: [
        Timer {}
    ]
}

En règle générale, il ne devrait pas être nécessaire de faire référence à la propriété « data », car il s’agit de la propriété par défaut pour les objets « Object3D » et, par conséquent, tous les objets enfants sont automatiquement affectés à cette propriété.

parent : Object3D

Cette propriété contient le parent de l'Object3D e dans une scène 3D.

state : string

Cette propriété contient le nom de l'état actuel de l'objet.

Si l'élément se trouve dans son état par défaut, c'est-à-dire qu'aucun état explicite n'a été défini, cette propriété contient alors une chaîne vide. De même, vous pouvez rétablir l'état par défaut d'un élément en définissant cette propriété sur une chaîne vide.

Voir également États d'Qt Quick .

states : list<State>

Cette propriété contient la liste des états possibles pour cet objet. Pour modifier l'état de cet objet, définissez la propriété ` state ` sur l'un de ces états, ou définissez la propriété ` state ` sur une chaîne vide pour rétablir l'état par défaut de l'objet.

Cette propriété est spécifiée sous la forme d'une liste d'objets State. Par exemple, voici un QtQuick3D::Node avec les états « above_state » et « below_state » :

import QtQuick
import QtQuick3D

Node {
    id: root
    y: 0

    states: [
        State {
            name: "above_state"
            PropertyChanges { target: root; y: 100 }
        },
        State {
            name: "below_state"
            PropertyChanges { target: root; y: -100 }
        }
    ]
}

Consultez la section « États d’Qt Quick » et « Animation et transitions » dans Qt Quick pour plus de détails sur l’utilisation des états et des transitions.

Voir également QtQuick3D::Object3D::transitions.

transitions : list<Transition>

Cette propriété contient la liste des transitions associées à cet objet. Celles-ci définissent les transitions à appliquer à l'objet chaque fois qu'il change d'state.

Cette propriété est spécifiée sous la forme d’une liste d’objets « Transition ». Par exemple :

import QtQuick
import QtQuick3D

Node {
    transitions: [
        Transition {
            //...
        },
        Transition {
            //...
        }
    ]
}

Consultez les sections « États d’Qt Quick » et « Animation et transitions » sur Qt Quick pour plus de détails sur l’utilisation des états et des transitions.

Voir également QtQuick3D::Object3D::states.