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 シーンにおいて、Item と同じ役割を果たします。

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
        }
    }
}

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.LocalSpace軸は、このノードのローカルな方向に対する相対的なものです。
Node.ParentSpaceAxisは親ノードのローカルな方向に対する相対的なものです。
Node.SceneSpaceAxis はシーンに対する相対的なものです。

©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。