Node QML Type
El componente básico de un objeto que se encuentra en una escena 3D. Más...
| Import Statement: | import QtQuick3D |
| Inherits: | |
| Inherited By: | 36 typesAffector3D, Attractor3D, AxisHelper, Camera, CustomCamera, DirectionalLight, FrustumCamera, Gravity3D, InstanceRepeater, Joint, Light, Loader3D, LodManager, LookAtNode, Model, OrthographicCamera, ParticleEmitter3D, ParticleSystem3D, PerspectiveCamera, PointLight, PointRotator3D, ReflectionProbe, Repeater3D, Repeller3D, RuntimeLoader, ScaleAffector3D, Skeleton, SpotLight, TrailEmitter3D, Wander3D, XrCamera, XrController, XrHandModel, XrItem, XrOrigin, and XrView |
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 «Node» sirve como clase base para otros tipos espaciales, tales como « Model », « Camera » y « Light ». Estos objetos representan una entidad que existe en la escena 3D, ya que tienen una posición y otras propiedades en el mundo 3D. A excepción de los nodos raíz, todos los tipos «Node» se transforman en relación con su nodo padre, es decir, en coordenadas locales. En muchos aspectos, el tipo «Node» 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 establecer otros tipos como padres de un `Node`. Esto incluye las instancias de ` QObject `, en las que el `Node` actúa simplemente como ` QObject parent`, y los elementos de `Qt Quick `.
Envolver otros objetos con el fin de agruparlos en componentes o subárboles puede ser una forma práctica de, por ejemplo, animar un grupo de nodos en su conjunto. Este fragmento de código 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 también debe utilizarse si se crea una escena fuera de View3D, por ejemplo, con el fin de cambiar de escena sobre la marcha o mostrar la misma escena en varias 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 supone 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 se pueden utilizar para agrupar nodos que deben ir juntos, por ejemplo, para renderizarlos juntos o para excluirlos del renderizado. Al establecer esta propiedad en la capa « Camera » activa, la cámara solo renderizará los nodos que pertenezcan a las capas especificadas. El valor es una máscara de bits, en la que cada bit representa una capa.
Por defecto, los nodos se asignan a la capa « main », que es « ContentLayer.Layer0 ».
Nota: La propiedad «layers» no se hereda; al establecerla en un nodo, el valor no se propaga de padre a hijo. Cada nodo conserva su propia asignación de capa y debe configurarse individualmente.
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, es posible que este valor no tenga ningún efecto; sin embargo, todos los elementos hijos del nodo, que sí pueden ser visibles, heredan este valor.
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 posición en el espacio de coordenadas local.
right : vector3d [read-only]
Esta propiedad devuelve un vector normalizado que representa la dirección hacia la 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 de los ejes x, y y z.
scenePosition : vector3d [read-only]
Esta propiedad devuelve la posición del nodo en el espacio de la escena.
Nota: A veces tambiénse denomina «posición global». Sin embargo, en este caso se refiere a «global en el mundo 3D», y no a «global respecto a la pantalla o el escritorio» (que suele ser la interpretación habitual en otras API de Qt).
Nota: la posición se indicará con la misma orientación que el nodo.
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 de este nodo.
Nota: el valor devuelto estará en coordenadas de mano derecha.
staticFlags : int
Esta propiedad define los indicadores estáticos que se utilizan para determinar cómo se representa el nodo. Por el momento no realiza ninguna acción, sino que actúa como 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 tiene el valor «true», el nodo (y sus elementos secundarios) pueden ser visibles.
x : real
Esta propiedad contiene el valor x de la traslación de posición en el espacio de coordenadas locales.
Véase también position.
y : real
Esta propiedad contiene el valor y de la traslación de posición en el espacio de coordenadas locales.
Véase también position.
z : real
Esta propiedad contiene el valor z de la traslación de posición en el espacio de coordenadas locales.
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 devuelto no se ve afectado por la escala ni la posición (heredadas) del nodo.
Nota: el valor devuelto tendrá la misma longitud que localDirection (es decir, no estará normalizado).
Nota: Si node es nulo, entonces localDirection se interpreta tal y como está en coordenadas del espacio de la escena.
Véanse también mapDirectionToNode, mapDirectionFromScene y mapDirectionToScene.
vector3d mapDirectionFromScene(vector3d sceneDirection)
Transforma « sceneDirection » del espacio de escena al espacio local. El valor devuelto no se ve afectado por la escala ni la posición (heredadas) del nodo.
Nota: el valor devuelto tendrá la misma longitud que sceneDirection (es decir, no estará normalizado).
Véase también « mapDirectionToScene », « mapDirectionToNode » y « mapDirectionFromNode ».
vector3d mapDirectionToNode(QtQuick3D::Node node, vector3d localDirection)
Transforma ` localDirection ` del espacio local de este nodo al espacio local de ` node`. El valor devuelto no se ve afectado por la escala ni la posición (heredadas) del nodo.
Nota: el valor devuelto tendrá la misma longitud que localDirection (es decir, no estará normalizado).
Nota: si node es nulo, la dirección devuelta se transformará a coordenadas del espacio de la escena.
Véase también mapDirectionFromNode, mapDirectionFromScene y mapDirectionToScene.
vector3d mapDirectionToScene(vector3d localDirection)
Transforma « localDirection » del espacio local al espacio de la escena. El valor devuelto no se ve afectado por la escala o la posición (heredadas) del nodo.
Nota: el valor devuelto tendrá la misma longitud que localDirection (es decir, no estará normalizado).
Véase también mapDirectionFromScene, mapDirectionToNode y mapDirectionFromNode.
vector3d mapPositionFromNode(QtQuick3D::Node node, vector3d localPosition)
Transforma localPosition del espacio local de node al espacio local de este nodo.
Nota: Si node es nulo, entonces localPosition se interpreta tal y como está en coordenadas del espacio de escena.
Véase 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 del espacio local de este nodo al espacio local de node.
Nota: Si ` node ` es nulo, entonces ` localPosition ` se transformará a coordenadas del espacio de la escena.
Véanse también mapPositionToScene, mapPositionFromScene y mapPositionFromNode.
vector3d mapPositionToScene(vector3d localPosition)
Transforma « localPosition » del espacio local al espacio de la escena.
Nota: El « espacio de escena» también se denomina a veces «espacio global». Pero en este caso se refiere a «global en el mundo 3D», y no a «global respecto a la pantalla o el escritorio» (que suele ser la interpretación en otras API de Qt).
Véase también mapPositionFromScene, mapPositionToNode y mapPositionFromNode.
void rotate(real degrees, vector3d axis, enumeration space)
Gira este nodo alrededor de un « axis » según el « degrees » indicado. La rotación especificada se sumará a la rotación actual del nodo. El eje se puede especificar en relación con diferentes « spaces».
| Constante | Descripción |
|---|---|
Node.LocalSpace | El eje es relativo a la orientación local de este nodo. |
Node.ParentSpace | El eje es relativo a la orientación local del nodo padre. |
Node.SceneSpace | El eje es relativo a la escena. |
© 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.