Node QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• 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

Methoden

• 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)

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 dient der Node-Typ in Qt Quick 3D-Szenen demselben Zweck wie Item für Qt Quick Szenen.

Zusätzlich zu den von Node abgeleiteten Typen 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.

Andere Objekte zu umhüllen, um sie in Komponenten oder Unterbäume 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 die gleiche Szene in mehreren Ansichten zu zeigen.

Node {
    id: standAloneScene

    DirectionalLight {}

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

    PerspectiveCamera {
        z: 600
    }
}

View3D {
    importScene: standAloneScene
}

Dokumentation der Eigenschaften

eulerRotation : vector3d

Diese Eigenschaft enthält die Rotationswerte für die x-, y- und z-Achse. Diese Werte werden als vector3d gespeichert. Die Reihenfolge der Drehung wird als ZXY angenommen.

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.

layers : int

Diese Eigenschaft definiert die Inhaltsebenen, zu denen dieser Knoten gehört. Die Ebenen können verwendet werden, um zusammengehörende Knoten zu gruppieren, damit sie z. B. gemeinsam gerendert oder aus dem Rendering herausgefiltert werden können. Das Setzen dieser Eigenschaft auf der aktiven Camera bewirkt, dass die Kamera nur Knoten rendert, die zu den angegebenen Ebenen gehören. Der Wert ist eine Bitmaske, wobei jedes Bit für eine Ebene steht.

Standardmäßig werden die Knoten der Ebene main zugewiesen, d. h. Ebene0.

Siehe auch ContentLayer.

opacity : real

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

pivot : vector3d

Diese Eigenschaft enthält die Drehpunktwerte für die x-, y- und z-Achse. Diese Werte werden als Drehpunkte verwendet, wenn Drehungen 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 Skalenwerte für die x-, y- und z-Achse.

scenePosition : vector3d [read-only]

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

Siehe auch mapPositionToScene.

sceneRotation : quaternion [read-only]

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

sceneScale : vector3d [read-only]

Diese Eigenschaft gibt den Maßstab des Knotens im Szenenraum zurück.

sceneTransform : matrix4x4 [read-only]

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

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 wahr ist, können 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 von der (geerbten) Skalierung oder Position des Knotens beeinflusst.

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.

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 von der (geerbten) Skalierung oder Position des Knotens beeinflusst.

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.

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.

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.

Siehe auch mapPositionToScene, mapPositionFromScene, und mapPositionFromNode.

vector3d mapPositionToScene(vector3d localPosition)

Transformiert localPosition vom lokalen Raum in den Szenenraum.

Siehe auch mapPositionFromScene, mapPositionToNode, und mapPositionFromNode.

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

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