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

속성

방법

상세 설명

노드 유형은 Model, Camera, Light 와 같은 다른 공간 유형의 기본 클래스 역할을 합니다. 이러한 오브젝트는 3D 월드에 위치 및 기타 속성을 가지고 있어 3D 씬에 존재하는 엔티티를 나타냅니다. 루트 노드를 제외한 모든 노드 유형은 부모 노드를 기준으로, 즉 로컬 좌표로 변환됩니다. Qt Quick 3D 여러 면에서 노드 유형은 Item 장면에서 Qt Quick 장면과 동일한 용도로 사용됩니다.

노드에서 파생된 유형 외에도 다른 유형을 노드에 부모로 지정할 수도 있습니다. 여기에는 노드가 QObject parent 및 Qt Quick 항목의 역할만 하는 QObject 인스턴스가 포함됩니다.

다른 객체를 컴포넌트나 하위 트리로 그룹화할 목적으로 다른 객체를 래핑하면 예를 들어 노드 그룹 전체에 애니메이션을 적용하는 데 편리할 수 있습니다. 이 스니펫은 노드를 사용하여 카메라에 애니메이션을 적용하는 방법을 보여줍니다:

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

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

즉석에서 장면을 전환하거나 여러 보기에 동일한 장면을 표시하는 등의 목적으로 View3D 외부에서 장면을 만드는 경우에도 노드를 사용해야 합니다.

Node {
    id: standAloneScene

    DirectionalLight {}

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

    PerspectiveCamera {
        z: 600
    }
}

View3D {
    importScene: standAloneScene
}

프로퍼티 문서

eulerRotation : vector3d

이 프로퍼티에는 x, y 및 z 축의 회전 값이 포함됩니다. 이 값은 벡터3d로 저장됩니다. 회전 순서는 ZXY로 가정합니다.

QQuaternion::fromEulerAngles()도 참조하세요 .


forward : vector3d [read-only]

이 프로퍼티는 씬 공간에서 노드 전진 방향의 정규화된 벡터를 반환합니다.

up, right, mapDirectionToScene 를참조하십시오 .


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]

이 프로퍼티는 씬 공간에서 노드의 위치를 반환합니다.

참고: 이를 전역 위치라고도 합니다. 하지만 "화면이나 데스크톱에 대한 전역"이 아니라 "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

이 프로퍼티가 참이면 노드(및 그 자식)를 표시할 수 있습니다.


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)

주어진 degrees 에 의해 이 노드를 axis 중심으로 회전시킵니다. 지정된 회전이 노드의 현재 회전에 추가됩니다. 축은 다른 space초를 기준으로 지정할 수 있습니다.

상수설명
Node.LocalSpace축은 이 노드의 로컬 방향에 상대적입니다.
Node.ParentSpace축은 부모 노드의 로컬 방향에 상대적입니다.
Node.SceneSpace축은 씬을 기준으로 합니다.

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