Back to Qt.io
Contact Us Blog Download Qt

Node QML Type

Die Basiskomponente für ein Objekt, das in einer 3D-Szene existiert. Mehr...

Import Statement: import QtQuick3D
Inherits:

Object3D

Inherited By:
20 types

Affector3D, AxisHelper, Camera, Joint, Light, Loader3D, LodManager, LookAtNode, Model, ParticleEmitter3D, ParticleSystem3D, ReflectionProbe, Repeater3D, RuntimeLoader, Skeleton, XrCamera, XrController, XrItem, XrOrigin, and XrView

Eigenschaften

Methoden

Detaillierte Beschreibung

Der Typ Node dient als Basisklasse für andere räumliche Typen, wie Model, Camera, Light. Diese Objekte stellen eine Entität dar, die in der 3D-Szene existiert, da sie eine Position und andere Eigenschaften in der 3D-Welt haben. Mit Ausnahme des Wurzelknotens/der Wurzelknoten werden alle Knotentypen relativ zu ihrem übergeordneten Knoten transformiert, d. h. in lokalen Koordinaten. In vielerlei Hinsicht erfüllt der Node-Typ in Qt Quick 3D -Szenen denselben Zweck wie Item für Qt Quick -Szenen.

Zusätzlich zu den Typen, die sich von Node ableiten, ist es auch möglich, andere Typen einem Node zuzuordnen. Dazu gehören QObject Instanzen, bei denen der Node lediglich als QObject parent dient, und Qt Quick Elemente.

Das Umhüllen von anderen Objekten, um sie in Komponenten oder Unterbäumen zu gruppieren, kann eine bequeme Methode sein, um z. B. eine Gruppe von Knoten als Ganzes zu animieren. Dieser Ausschnitt zeigt, wie man Node verwendet, um eine Kamera zu animieren:

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

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

Node muss auch verwendet werden, wenn eine Szene außerhalb von View3D erstellt wird, z.B. um die Szene während des laufenden Betriebs zu wechseln oder um dieselbe Szene in mehreren Ansichten zu zeigen.

Node {
    id: standAloneScene

    DirectionalLight {}

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

    PerspectiveCamera {
        z: 600
    }
}

View3D {
    importScene: standAloneScene
}

Eigenschaft Dokumentation

eulerRotation : vector3d

Diese Eigenschaft enthält die Rotationswerte für die x-, y- und z-Achse. Diese Werte werden als vector3d gespeichert. Es wird angenommen, dass die Rotationsreihenfolge ZXY ist.

Siehe auch QQuaternion::fromEulerAngles().


forward : vector3d [read-only]

Diese Eigenschaft gibt einen normalisierten Vektor der Vorwärtsrichtung des Knotens im Szenenraum zurück.

Siehe auch up, right, und mapDirectionToScene.


opacity : real

Diese Eigenschaft enthält den lokalen Opazitätswert des Knotens. Da Knotenobjekte nicht notwendigerweise sichtbar sind, hat dieser Wert möglicherweise keine Auswirkungen, aber dieser Wert wird an alle Kinder des Knotens vererbt, die möglicherweise sichtbar sind.


pivot : vector3d

Diese Eigenschaft enthält die Pivot-Werte für die x-, y- und z-Achse. Diese Werte werden als Drehpunkte verwendet, wenn Rotationen auf den Knoten angewendet werden.


position : vector3d

Diese Eigenschaft enthält die Positionsverschiebung im lokalen Koordinatenraum.

Siehe auch x, y, und z.


right : vector3d [read-only]

Diese Eigenschaft gibt einen normalisierten Vektor der rechten Richtung des Knotens im Szenenraum zurück.

Siehe auch forward, up, und mapDirectionToScene.


rotation : quaternion

Diese Eigenschaft enthält die Rotationswerte für den Knoten. Diese Werte werden als Quaternion gespeichert.


scale : vector3d

Diese Eigenschaft enthält die Skalierungswerte für die x-, y- und z-Achse.


scenePosition : vector3d [read-only]

Diese Eigenschaft gibt die Position des Knotens im Szenenraum zurück.

Hinweis: Dies wird manchmal auch als globale Position bezeichnet. Dann aber in der Bedeutung "global in der 3D-Welt" und nicht "global auf dem Bildschirm oder Desktop" (was normalerweise die Interpretation in anderen Qt APIs ist).

Hinweis: Die Position wird in der gleichen Ausrichtung wie der Knoten gemeldet.

Siehe auch mapPositionToScene.


sceneRotation : quaternion [read-only]

Diese Eigenschaft gibt die Rotation des Knotens im Szenenraum zurück.


sceneScale : vector3d [read-only]

Diese Eigenschaft gibt die Skalierung des Knotens im Szenenraum zurück.


sceneTransform : matrix4x4 [read-only]

Diese Eigenschaft gibt die globale Transformationsmatrix für diesen Knoten zurück.

Hinweis: Der Rückgabewert ist in rechtshändigen Koordinaten.


staticFlags : int

Diese Eigenschaft definiert die statischen Flags, die verwendet werden, um zu bewerten, wie der Knoten gerendert wird. Sie dient derzeit nur als Platzhalter für eine zukünftige Implementierung.


up : vector3d [read-only]

Diese Eigenschaft gibt einen normalisierten Vektor der Aufwärtsrichtung des Knotens im Szenenraum zurück.

Siehe auch forward, right, und mapDirectionToScene.


visible : bool

Wenn diese Eigenschaft true ist, kann der Knoten (und seine Kinder) sichtbar sein.


x : real

Diese Eigenschaft enthält den x-Wert der Positionsverschiebung im lokalen Koordinatenraum.

Siehe auch position.


y : real

Diese Eigenschaft enthält den y-Wert der Positionsverschiebung im lokalen Koordinatenraum.

Siehe auch position.


z : real

Diese Eigenschaft enthält den z-Wert der Positionsverschiebung im lokalen Koordinatenraum.

Siehe auch position.


Dokumentation der Methode

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

Transformiert localDirection aus dem lokalen Raum von node in den lokalen Raum dieses Knotens. Der Rückgabewert wird nicht durch den (geerbten) Maßstab oder die Position des Knotens beeinflusst.

Hinweis: Der Rückgabewert hat die gleiche Länge wie localDirection (d.h. nicht normalisiert).

Hinweis: Wenn node null ist, wird localDirection so interpretiert, wie es in den Koordinaten des Szenenraums ist.

Siehe auch mapDirectionToNode, mapDirectionFromScene, und mapDirectionToScene.


vector3d mapDirectionFromScene(vector3d sceneDirection)

Transformiert sceneDirection vom Szenenraum in den lokalen Raum. Der Rückgabewert wird nicht von der (geerbten) Skalierung oder Position des Knotens beeinflusst.

Hinweis: Der Rückgabewert hat die gleiche Länge wie sceneDirection (d.h. nicht normalisiert).

Siehe auch mapDirectionToScene, mapDirectionToNode, und mapDirectionFromNode.


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

Transformiert localDirection aus dem lokalen Raum dieses Knotens in den lokalen Raum von node. Der Rückgabewert wird nicht durch den (geerbten) Maßstab oder die Position des Knotens beeinflusst.

Hinweis: Der Rückgabewert hat die gleiche Länge wie localDirection (d.h. nicht normalisiert).

Hinweis: Wenn node null ist, wird die zurückgegebene Richtung in Koordinaten des Szenenraums transformiert.

Siehe auch mapDirectionFromNode, mapDirectionFromScene, und mapDirectionToScene.


vector3d mapDirectionToScene(vector3d localDirection)

Transformiert localDirection vom lokalen Raum in den Szenenraum. Der Rückgabewert wird nicht von der (geerbten) Skalierung oder Position des Knotens beeinflusst.

Hinweis: Der Rückgabewert hat die gleiche Länge wie localDirection (d.h. nicht normalisiert).

Siehe auch mapDirectionFromScene, mapDirectionToNode, und mapDirectionFromNode.


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

Transformiert localPosition aus dem lokalen Raum von node in den lokalen Raum dieses Knotens.

Hinweis: Wenn node Null ist, wird localPosition so interpretiert, wie es in den Koordinaten des Szenenraums ist.

Siehe auch mapPositionToScene, mapPositionFromScene, und mapPositionToNode.


vector3d mapPositionFromScene(vector3d scenePosition)

Transformiert scenePosition vom Szenenraum in den lokalen Raum.

Siehe auch mapPositionToScene, mapPositionToNode, und mapPositionFromNode.


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

Transformiert localPosition aus dem lokalen Raum dieses Knotens in den lokalen Raum von node.

Hinweis: Wenn node gleich Null ist, wird localPosition in die Koordinaten des Szenenraums transformiert.

Siehe auch mapPositionToScene, mapPositionFromScene, und mapPositionFromNode.


vector3d mapPositionToScene(vector3d localPosition)

Transformiert localPosition vom lokalen Raum in den Szenenraum.

Hinweis: Der "Szenenraum" wird manchmal auch als "globaler Raum" bezeichnet. Dann aber in der Bedeutung "global in der 3D-Welt" und nicht "global auf dem Bildschirm oder Desktop" (was normalerweise die Interpretation in anderen Qt APIs ist).

Siehe auch mapPositionFromScene, mapPositionToNode, und mapPositionFromNode.


rotate(real degrees, vector3d axis, enumeration space)

Dreht diesen Knoten um ein axis um die angegebene degrees. Die angegebene Drehung wird zur aktuellen Drehung des Knotens addiert. Die Achse kann relativ zu verschiedenen spaces angegeben werden.

KonstanteBeschreibung
Node.LocalSpaceAchse ist relativ zur lokalen Ausrichtung dieses Knotens.
Node.ParentSpaceAchse ist relativ zur lokalen Ausrichtung des übergeordneten Knotens.
Node.SceneSpaceAchse ist relativ zur Szene.

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