Object3D QML Type

Tipo base abstracto de todos los nodos y recursos 3D. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

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

Descripción detallada

Object3D es la clase base para todos los tipos 3D de Qt Quick. Esto incluye:

• Tipos espaciales que representan objetos en la escena 3D, estos normalmente tendrán una posición y/o una dirección. Por ejemplo, Model, Camera, o Light. Estos tipos heredan de Node, que a su vez hereda de Object3D.
• Tipos de recursos que no representan por sí mismos un objeto en el mundo 3D, sino que sirven como componentes de subclases de Node, proporcionando datos de algún tipo. Esto incluye, entre otros, Material, Geometry, y Texture.

Además de los tipos anteriores, Object3D también puede servir de padre para Qt Quick itemsasí como instancias arbitrarias de QObject. Para obtener más información sobre la adición de elementos 2D a la escena 3D, consulte Qt Quick Escenas 3D con contenido 2D.

Véase también Node.

Documentación de propiedades

La propiedad children contiene la lista de hijos visuales de este objeto. La propiedad resources contiene los recursos no visuales a los que se desea hacer referencia por su nombre.

Generalmente no es necesario hacer referencia a estas propiedades cuando se añaden objetos hijos o recursos, ya que la propiedad por defecto data asignará automáticamente objetos hijos a las propiedades children y resources según corresponda. Consulte la documentación de QtQuick3D::Object3D::data para más detalles.

data : list<Object> [default]

La propiedad data permite mezclar libremente Object3D hijos y recursos en un objeto. Si asigna un Object3D a la lista de datos, se convierte en hijo y si asigna cualquier otro tipo de objeto, se añade como recurso.

Así que puedes escribir

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

en lugar de:

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

Por lo general, no debería ser necesario hacer referencia a la propiedad data, ya que es la propiedad por defecto para Object3D y, por tanto, todos los objetos hijo se asignan automáticamente a esta propiedad.

parent : Object3D

Esta propiedad contiene el padre del Object3D en una escena 3D.

state : string

Esta propiedad contiene el nombre del estado actual del objeto.

Si el elemento se encuentra en su estado por defecto, es decir, no se ha establecido ningún estado explícito, esta propiedad contendrá una cadena vacía. Del mismo modo, puede devolver un elemento a su estado por defecto estableciendo esta propiedad a una cadena vacía.

Véase también Qt Quick States.

states : list<State>

Esta propiedad contiene la lista de posibles estados de este objeto. Para cambiar el estado de este objeto, establezca la propiedad state a uno de estos estados, o establezca la propiedad state a una cadena vacía para revertir el objeto a su estado por defecto.

Esta propiedad se especifica como una lista de objetos State. Por ejemplo, abajo hay un QtQuick3D::Node con estados "above_state" y "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 }
        }
    ]
}

Ver Qt Quick Estados y Animación y Transiciones en Qt Quick para más detalles sobre el uso de estados y transiciones.

Véase también QtQuick3D::Object3D::transitions.

transitions : list<Transition>

Esta propiedad contiene la lista de transiciones para este objeto. Éstas definen las transiciones que se aplicarán al objeto cada vez que cambie su state.

Esta propiedad se especifica como una lista de objetos Transition. Por ejemplo:

import QtQuick
import QtQuick3D

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

Ver Qt Quick Estados y Animación y Transiciones en Qt Quick para más detalles sobre el uso de estados y transiciones.

Véase también QtQuick3D::Object3D::states.