En esta página

Object3D QML Type (Uncreatable)

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

Nota: Se trata de un tipo que no se puede crear. No se puede instanciar en QML.

Propiedades

Descripción detallada

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

  • Tipos espaciales que representan objetos en la escena 3D; 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 las subclases de ` Node `, proporcionando datos de algún tipo. Esto incluye, entre otros, ` Material`, ` Geometry` y ` Texture`.

Además de los tipos mencionados, Object3D también puede actuar como clase padre de Qt Quick items, así como de cualquier instancia de ` QObject `. Para obtener más información sobre cómo añadir elementos 2D a la escena 3D, consulta «Escenas 3D con contenido 2D» en Qt Quick.

Véase también Node.

Documentación de propiedades

children : list<Object3D>

resources : list<Object>

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

Por lo general, no es necesario hacer referencia a estas propiedades al añadir objetos hijos o recursos, ya que la propiedad predeterminada ` data ` asignará automáticamente los objetos hijos a las propiedades ` children ` y ` resources `, según corresponda. Consulte la documentación de ` QtQuick3D::Object3D::data ` para obtener más detalles.

Nota: QtQuick3D ::Object3D::resources no devuelve una lista de recursos 3D a pesar de su nombre. El nombre proviene de la semántica de QQuickItem. Los recursos 3D son subclases de QQuickObject3D y, por lo tanto, se devolverán en la lista de QtQuick3D::Object3D::children.

data : list<Object> [default]

La propiedad «data» te permite mezclar libremente elementos secundarios y recursos de Object3D dentro de un objeto. Si asignas un Object3D a la lista «data», este se convierte en un elemento secundario, y si asignas cualquier otro tipo de objeto, se añade como recurso.

Así, puedes escribir:

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 predeterminada para ` Object3D ` y, por lo tanto, todos los objetos hijos se asignan automáticamente a esta propiedad.

parent : Object3D

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

Nota: El padrede un « Object3D » no tiene por qué ser necesariamente el mismo que su padre de objeto. Esto es necesario porque el padre de objeto puede ser un elemento que no sea de tipo « Object3D », por ejemplo, el objeto raíz de una escena.

state : string

Esta propiedad contiene el nombre del estado actual del objeto.

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

Véase también «Estadosde Qt Quick ».

states : list<State>

Esta propiedad contiene la lista de estados posibles para este objeto. Para cambiar el estado de este objeto, establece la propiedad ` state ` en uno de estos estados, o bien establece la propiedad ` state ` en una cadena vacía para que el objeto vuelva a su estado por defecto.

Esta propiedad se especifica como una lista de objetos State. Por ejemplo, a continuación se muestra un QtQuick3D::Node con los 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 }
        }
    ]
}

Consulte «Estados deQt Quick » y «Animación y transiciones en Qt Quick » para obtener más detalles sobre el uso de estados y transiciones.

Nota: Esta propiedad funciona igual que QtQuick::Item::states, pero es necesaria porque QtQuick3D::Object3D no es una subclase de QtQuick::Item.

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

transitions : list<Transition>

Esta propiedad contiene la lista de transiciones de este objeto. Estas 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 {
            //...
        }
    ]
}

Consulte «Estados deQt Quick » y «Animación y transiciones» en Qt Quick para obtener más detalles sobre el uso de estados y transiciones.

Nota: Esta propiedad funciona igual que QtQuick::Item::transitions, pero es necesaria porque QtQuick3D::Object3D no es una subclase de QtQuick::Item.

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

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