Node QML Type

El componente base para un objeto que existe en una escena 3D. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• eulerRotation : vector3d
• forward : vector3d
• layers : int
• opacity : real
• pivot : vector3d
• position : vector3d
• right : vector3d
• rotation : quaternion
• scale : vector3d
• scenePosition : vector3d
• sceneRotation : quaternion
• sceneScale : vector3d
• sceneTransform : matrix4x4
• staticFlags : int
• up : vector3d
• visible : bool
• x : real
• y : real
• z : real

Métodos

• vector3d mapDirectionFromNode(QtQuick3D::Node node, vector3d localDirection)
• vector3d mapDirectionFromScene(vector3d sceneDirection)
• vector3d mapDirectionToNode(QtQuick3D::Node node, vector3d localDirection)
• vector3d mapDirectionToScene(vector3d localDirection)
• vector3d mapPositionFromNode(QtQuick3D::Node node, vector3d localPosition)
• vector3d mapPositionFromScene(vector3d scenePosition)
• vector3d mapPositionToNode(QtQuick3D::Node node, vector3d localPosition)
• vector3d mapPositionToScene(vector3d localPosition)
• void rotate(real degrees, vector3d axis, enumeration space)

Descripción detallada

El tipo Nodo sirve como clase base para otros tipos espaciales, tales como, Model, Camera, Light. Estos objetos representan una entidad que existe en la escena 3D, por tener una posición y otras propiedades en el mundo 3D. Con la excepción del nodo raíz, todos los tipos de Nodo se transforman en relación a su Nodo padre, es decir, en coordenadas locales. En muchos sentidos, el tipo Nodo cumple la misma función en las escenas 3D de Qt Quick que Item en las escenas de Qt Quick.

Además de los tipos derivados de Node, también es posible emparentar otros tipos con un Node. Esto incluye instancias de QObject, donde el Nodo sirve simplemente como QObject parent, y elementos deQt Quick .

Envolver otros objetos con el fin de agruparlos en componentes o subárboles puede ser una forma conveniente de, por ejemplo, animar un grupo de nodos como un todo. Este fragmento muestra cómo utilizar Node para animar una cámara:

Node {
    PerspectiveCamera {
        position: Qt.vector3d(0, 0, -600)
    }

    SequentialAnimation on eulerRotation.y {
        loops: Animation.Infinite
        PropertyAnimation {
            duration: 5000
            from: 0
            to: 360
        }
    }
}

Node tiene que ser usado también si se crea una escena fuera de View3D, por ejemplo con el propósito de cambiar escenas sobre la marcha, o mostrar la misma escena en múltiples vistas.

Node {
    id: standAloneScene

    DirectionalLight {}

    Model {
        source: "#Sphere"
        materials: [ DefaultMaterial {} ]
    }

    PerspectiveCamera {
        z: 600
    }
}

View3D {
    importScene: standAloneScene
}

Documentación de propiedades

eulerRotation : vector3d

Esta propiedad contiene los valores de rotación para los ejes x, y, y z. Estos valores se almacenan como un vector3d. Se asume que el orden de rotación es ZXY.

Véase también QQuaternion::fromEulerAngles().

forward : vector3d [read-only]

Esta propiedad devuelve un vector normalizado de la dirección de avance de los nodos en el espacio de la escena.

Véase también up, right, y mapDirectionToScene.

layers : int

Esta propiedad define las capas de contenido a las que pertenece este nodo. Las capas pueden ser usadas para agrupar nodos que pertenecen juntos, por ejemplo para ser renderizados juntos o para ser filtrados de la renderización. Establecer esta propiedad en el Camera activo hará que la cámara sólo renderice nodos que pertenezcan a las capas especificadas. El valor es una máscara de bits, donde cada bit representa una capa.

Por defecto los nodos se asignan a la capa main, que es la Capa0.

Véase también ContentLayer.

opacity : real

Esta propiedad contiene el valor de opacidad local del Nodo. Dado que los objetos Nodo no son necesariamente visibles, este valor podría no tener ningún efecto, pero este valor es heredado por todos los hijos del Nodo, que podrían ser visibles.

pivot : vector3d

Esta propiedad contiene los valores de pivote para los ejes x, y, y z. Estos valores se utilizan como puntos de pivote al aplicar rotaciones al nodo.

position : vector3d

Esta propiedad contiene la traslación de la posición en el espacio de coordenadas local.

Véase también x, y, y z.

right : vector3d [read-only]

Esta propiedad devuelve un vector normalizado de la dirección derecha de los nodos en el espacio de la escena.

Véase también forward, up, y mapDirectionToScene.

rotation : quaternion

Esta propiedad contiene los valores de rotación del nodo. Estos valores se almacenan como un cuaternión.

scale : vector3d

Esta propiedad contiene los valores de escala para los ejes x, y, y z.

scenePosition : vector3d [read-only]

Esta propiedad devuelve la posición del nodo en el espacio de la escena.

Véase también mapPositionToScene.

sceneRotation : quaternion [read-only]

Esta propiedad devuelve la rotación del nodo en el espacio de la escena.

sceneScale : vector3d [read-only]

Esta propiedad devuelve la escala del nodo en el espacio de la escena.

sceneTransform : matrix4x4 [read-only]

Esta propiedad devuelve la matriz de transformación global para este nodo.

staticFlags : int

Esta propiedad define las banderas estáticas que se utilizan para evaluar cómo se renderiza el nodo. Actualmente no hace nada más que actuar como un marcador de posición para una futura implementación.

up : vector3d [read-only]

Esta propiedad devuelve un vector normalizado de la dirección hacia arriba de los nodos en el espacio de la escena.

Véase también forward, right, y mapDirectionToScene.

visible : bool

Cuando esta propiedad es verdadera, el Nodo (y sus hijos) pueden ser visibles.

x : real

Esta propiedad contiene el valor x de la traslación de la posición en el espacio de coordenadas local.

Véase también position.

y : real

Esta propiedad contiene el valor y de la traslación de la posición en el espacio de coordenadas local.

Véase también position.

z : real

Esta propiedad contiene el valor z de la traslación de la posición en el espacio de coordenadas local.

Véase también position.

Documentación del método

vector3d mapDirectionFromNode(QtQuick3D::Node node, vector3d localDirection)

Transforma localDirection del espacio local de node al espacio local de este nodo. El valor de retorno no se ve afectado por la escala (heredada) o la posición del nodo.

Véase también mapDirectionToNode, mapDirectionFromScene, y mapDirectionToScene.

vector3d mapDirectionFromScene(vector3d sceneDirection)

Transforma sceneDirection del espacio de escena al espacio local. El valor de retorno no se ve afectado por la escala (heredada) o la posición del nodo.

Véase también mapDirectionToScene, mapDirectionToNode, y mapDirectionFromNode.

vector3d mapDirectionToNode(QtQuick3D::Node node, vector3d localDirection)

Transforma localDirection desde el espacio local de este nodo al espacio local de node. El valor de retorno no se ve afectado por la escala (heredada) o la posición del nodo.

Véase también mapDirectionFromNode, mapDirectionFromScene, y mapDirectionToScene.

vector3d mapDirectionToScene(vector3d localDirection)

Transforma localDirection del espacio local al espacio de la escena. El valor de retorno no se ve afectado por la escala (heredada) o la posición del nodo.

Véase también mapDirectionFromScene, mapDirectionToNode, y mapDirectionFromNode.

vector3d mapPositionFromNode(QtQuick3D::Node node, vector3d localPosition)

Transforma localPosition desde el espacio local de node al espacio local de este nodo.

Ver también mapPositionToScene, mapPositionFromScene, y mapPositionToNode.

vector3d mapPositionFromScene(vector3d scenePosition)

Transforma scenePosition del espacio de la escena al espacio local.

Véase también mapPositionToScene, mapPositionToNode, y mapPositionFromNode.

vector3d mapPositionToNode(QtQuick3D::Node node, vector3d localPosition)

Transforma localPosition desde el espacio local de este nodo al espacio local de node.

Véase también mapPositionToScene, mapPositionFromScene, y mapPositionFromNode.

vector3d mapPositionToScene(vector3d localPosition)

Transforma localPosition del espacio local al espacio de escena.

Véase también mapPositionFromScene, mapPositionToNode, y mapPositionFromNode.

void rotate(real degrees, vector3d axis, enumeration space)

Rota este nodo alrededor de axis con el valor degrees. La rotación especificada se añadirá a la rotación actual del nodo. El eje puede especificarse en relación a diferentes spaces.