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 タイプはQt Quick 3D のシーンでItem がQt Quick のシーンで行うのと同じ役割を果たします。

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

layers : int

このプロパティは、このノードが属するコンテンツレイヤーを定義する。レイヤーは、一緒にレンダリングされたり、レンダリングからフィルタリングされるなど、一緒に属するノードをグループ化するために使用できます。アクティブなCamera にこのプロパティを設定すると、カメラは指定されたレイヤーに属するノードのみをレンダリングします。値はビットマスクで、各ビットはレイヤーを表します。

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

ContentLayerも参照して ください。

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]

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

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からの相対軸を指定できます。