Node QML Type

3Dシーン内に存在するオブジェクトの基本コンポーネント。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• 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

方法

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

詳細な説明

Node型は、Model 、Camera 、Light などの他の空間型に対する基底クラスとして機能します。これらのオブジェクトは、3D空間内で位置やその他のプロパティを持つことにより、3Dシーン内に存在するエンティティを表します。 ルートノードを除き、すべてのNode型は親ノードを基準として、つまりローカル座標系で変形されます。多くの点で、Node型はQt Quick の3Dシーンにおいて、Item がQt Quick のシーンで果たすのと同じ役割を果たします。

Nodeから派生したタイプに加え、他のタイプをNodeの子として設定することも可能です。これには、Nodeが単にQObject parent として機能するQObject インスタンスや、Qt Quick アイテムなどが含まれます。

他のオブジェクトをラップしてコンポーネントやサブツリーにグループ化することは、例えばノードのグループ全体をまとめてアニメーションさせるなど、便利な方法となります。以下のスニペットは、Nodeを使用してカメラをアニメーションさせる方法を示しています：

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

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

また、View3D の外でシーンを作成する場合（例えば、実行中にシーンを切り替えたり、複数のビューで同じシーンを表示したりする場合など）にも、Nodeを使用する必要があります。

Node {
    id: standAloneScene

    DirectionalLight {}

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

    PerspectiveCamera {
        z: 600
    }
}

View3D {
    importScene: standAloneScene
}

プロパティのドキュメント

eulerRotation : vector3d

このプロパティには、x、y、z軸の回転値が含まれています。これらの値はvector3dとして格納されます。回転順序はZXYとみなされます。

QQuaternion::fromEulerAngles()も参照してください 。

forward : vector3d [read-only]

このプロパティは、シーン空間におけるノードの進行方向を表す正規化されたベクトルを返します。

up 、right 、およびmapDirectionToSceneも参照してください 。

layers : int

このプロパティは、このノードが属するコンテンツレイヤーを定義します。レイヤーを使用すると、関連するノードをグループ化できます。例えば、一緒にレンダリングしたり、レンダリングから除外したりする場合などに利用できます。アクティブなCamera にこのプロパティを設定すると、カメラは指定されたレイヤーに属するノードのみをレンダリングするようになります。値はビットマスクであり、各ビットが1つのレイヤーを表します。

デフォルトでは、ノードは「main 」レイヤー（ContentLayer.Layer0 ）に割り当てられます。

「ContentLayer」も参照してください 。

opacity : real

このプロパティには、ノードのローカル不透明度値が格納されています。ノードオブジェクトは必ずしも表示されるとは限らないため、この値は効果を持たない場合もありますが、この値はノードのすべての子要素に継承され、それらの要素は表示される可能性があります。

pivot : vector3d

このプロパティには、x軸、y軸、z軸のピボット値が含まれています。これらの値は、ノードに回転を適用する際のピボットポイントとして使用されます。

position : vector3d

このプロパティには、ローカル座標系における位置の並進が含まれています。

x 、y 、およびzも参照してください 。

right : vector3d [read-only]

このプロパティは、シーン空間におけるノードの右方向を表す正規化されたベクトルを返します。

forward 、up 、およびmapDirectionToSceneも参照してください 。

rotation : quaternion

このプロパティには、ノードの回転値が含まれています。これらの値はクォータニオンとして格納されています。

scale : vector3d

このプロパティには、x軸、y軸、z軸のスケール値が含まれています。

scenePosition : vector3d [read-only]

このプロパティは、シーン空間におけるノードの位置を返します。

関連項目: mapPositionToScene 。

sceneRotation : quaternion [read-only]

このプロパティは、シーン空間におけるノードの回転を返します。

sceneScale : vector3d [read-only]

このプロパティは、シーン空間におけるノードのスケールを返します。

sceneTransform : matrix4x4 [read-only]

このプロパティは、このノードのグローバル変換行列を返します。

staticFlags : int

このプロパティは、ノードのレンダリング方法を決定するために使用される静的フラグを定義します。現時点では何も行いませんが、将来の実装に向けたプレースホルダーとして機能します。

up : vector3d [read-only]

このプロパティは、シーン空間におけるノードの上方向を表す正規化されたベクトルを返します。

forward 、right 、およびmapDirectionToSceneも参照してください 。

visible : bool

このプロパティが true の場合、そのノード（およびその子ノード）は表示可能になります。

x : real

このプロパティには、ローカル座標系における位置の並進のx座標が格納されています。

「position」も参照してください 。

y : real

このプロパティには、ローカル座標系における位置の平行移動の y 座標が含まれます。

「position」も参照してください 。

z : real

このプロパティには、ローカル座標系における位置の並進のz値が格納されます。

positionも参照してください 。

メソッドのドキュメント

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

`localDirection ` を、node の局所空間から、このノードの局所空間へ変換します。戻り値は、ノードの（継承された）スケールや位置の影響を受けません。

関連項目： mapDirectionToNode 、mapDirectionFromScene 、およびmapDirectionToScene 。

vector3d mapDirectionFromScene(vector3d sceneDirection)

sceneDirection をシーン空間からローカル空間に変換します。戻り値は、ノードの（継承された）スケールや位置の影響を受けません。

関連項目： mapDirectionToScene 、mapDirectionToNode 、およびmapDirectionFromNode 。

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

localDirection を、このノードのローカル空間からnode のローカル空間へ変換します。戻り値は、ノードの（継承された）スケールや位置の影響を受けません。

関連項目： mapDirectionFromNode 、mapDirectionFromScene 、およびmapDirectionToScene 。

vector3d mapDirectionToScene(vector3d localDirection)

localDirection をローカル空間からシーン空間に変換します。戻り値は、ノードの（継承された）スケールや位置の影響を受けません。

関連項目： mapDirectionFromScene 、mapDirectionToNode 、mapDirectionFromNode 。

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

localPosition を、node のローカル空間から、このノードのローカル空間へ変換します。

関連項目： mapPositionToScene 、mapPositionFromScene 、およびmapPositionToNode 。

vector3d mapPositionFromScene(vector3d scenePosition)

scenePosition をシーン空間からローカル空間に変換します。

mapPositionToScene 、mapPositionToNode 、およびmapPositionFromNodeも参照してください 。

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

localPosition を、このノードのローカル座標系からnode のローカル座標系へ変換します。

関連項目： mapPositionToScene 、mapPositionFromScene 、およびmapPositionFromNode 。

vector3d mapPositionToScene(vector3d localPosition)

localPosition をローカル空間からシーン空間に変換します。

mapPositionFromScene 、mapPositionToNode 、およびmapPositionFromNodeも参照してください 。

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

このノードを、axis を中心に、指定されたdegrees 分だけ回転させます。指定された回転量は、ノードの現在の回転量に加算されます。軸は、さまざまなspaceを基準として指定することができます。