Back to Qt.io
Contact Us Blog Download Qt

Node QML Type

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

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

プロパティ

方法

詳細説明

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

Nodeから派生する型に加えて、他の型をNodeの親にすることも可能です。これには、QObject インスタンス（Node は単にQObject parent 、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
        }
    }
}

Node は、View3D の外部でシーンを作成する場合にも使用する必要があります。例えば、シーンをその場で切り替えたり、同じシーンを複数のビューに表示したりすることができます。

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 も参照して ください。


opacity : real

このプロパティには、Node のローカル不透明度が含まれます。Node オブジェクトは必ずしも可視ではないので、この値は何の効果も持たないかもしれませ んが、この値は Node のすべての子オブジェクトに継承されます。


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]

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

注： これはグローバル位置とも呼ばれることがあります。しかし、その場合は「3D世界におけるグローバル」という意味であり、「スクリーンやデスクトップに対するグローバル」という意味ではありません（他のQt APIでは通常このように解釈されます）。

注意： 位置はノードと同じ向きで報告されます。

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 のローカル空間からこのノードのローカル空間に変換します。戻り値は、ノードの（継承された）スケールや位置には影響されません。

注意： 戻り値はlocalDirection と同じ長さになる（つまり正規化されない）。

注： node が NULL の場合、localDirection はシーン空間座標として解釈されます。

mapDirectionToNode 、mapDirectionFromScene 、mapDirectionToSceneも参照 。


vector3d mapDirectionFromScene(vector3d sceneDirection)

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

注意： 戻り値はsceneDirection と同じ長さになります（つまり正規化されません）。

mapDirectionToScene,mapDirectionToNode,mapDirectionFromNodeも参照してください 。


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

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

注意： 戻り値はlocalDirection と同じ長さになります（つまり正規化されません）。

注意 ：node が NULL の場合、返される方向はシーン空間座標に変換されます。

mapDirectionFromNode 、mapDirectionFromScene 、mapDirectionToSceneも参照してください 。


vector3d mapDirectionToScene(vector3d localDirection)

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

注意： 戻り値はlocalDirection と同じ長さになります（つまり正規化されません）。

mapDirectionFromScene 、mapDirectionToNode 、およびmapDirectionFromNodeも参照してください 。


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

localPosition をnode の局所空間からこのノードの局所空間に変換する。

注： node が NULL の場合、localPosition はシーン空間座標として解釈されます。

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


vector3d mapPositionFromScene(vector3d scenePosition)

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

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


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

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

注： node が NULL の場合、localPosition はシーン空間座標に変換されます。

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


vector3d mapPositionToScene(vector3d localPosition)

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

注意： "シーン空間 "は "グローバル空間 "と呼ばれることもある。しかし、これは「3D世界におけるグローバル」という意味であり、「スクリーンやデスクトップにおけるグローバル」という意味ではありません（他のQt APIでは通常このように解釈されます）。

mapPositionFromScene,mapPositionToNode,mapPositionFromNodeも参照してください 。


rotate(real degrees, vector3d axis, enumeration space)

このノードをaxis を中心に、指定されたdegrees だけ回転させます。指定された回転は、ノードの現在の回転に追加されます。軸は、異なるspaceからの相対軸を指定できます。

定数説明
Node.LocalSpaceAxis は、このノードのローカル方向に対する相対値です。
Node.ParentSpaceAxis は、親ノードのローカルの向きに対する相対的なものです。
Node.SceneSpaceAxis はシーンに対する相対的なものです。

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