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를 기준으로 변환되며, 즉 로컬 좌표계에서 변환됩니다. 여러 면에서 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 )에 이 속성을 설정하면, 카메라는 지정된 레이어에 속한 노드만 렌더링하게 됩니다. 값은 비트 마스크이며, 각 비트는 하나의 레이어를 나타냅니다.

기본적으로 노드는 ‘ 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)

이 노드를 지정된 각도( degrees)만큼 기준축( axis )을 중심으로 회전시킵니다. 지정된 회전 각도는 노드의 현재 회전 각도에 더해집니다. 축은 서로 다른 기준축( space)을 기준으로 지정할 수 있습니다.