Object3D QML Type

모든 3D 노드 및 리소스의 추상적 기본 유형입니다. 더 보기...

속성

자세한 설명

Object3D는 모든 Qt Quick 3D 유형의 기본 클래스입니다. 여기에는 다음이 포함됩니다:

  • 3D 씬에서 객체를 나타내는 공간 유형으로, 일반적으로 위치 및/또는 방향을 갖습니다. 예: Model, Camera, Light. 이러한 유형은 Node 에서 상속되며, 이는 다시 Object3D 에서 상속됩니다.
  • 리소스 유형은 그 자체로 3D 월드의 객체를 나타내지는 않지만 Node 서브클래스의 컴포넌트 역할을 하며 일종의 데이터를 제공합니다. 여기에는 Material, Geometry, Texture 등이 포함됩니다.

위의 유형 외에도 Object3D는 또한 Qt Quick items와 임의의 QObject 인스턴스의 부모 역할을 할 수도 있습니다. 3D 씬에 2D 항목을 추가하는 방법에 대한 자세한 내용은 Qt Quick 2D 콘텐츠가 있는 3D 씬을 참조하십시오.

Node도 참조하십시오 .

속성 문서

children : list<Object3D>

resources : list<Object>

children 속성에는 이 객체의 시각적 자식 목록이 포함됩니다. resources 속성에는 이름으로 참조하려는 비시각적 리소스가 포함되어 있습니다.

기본 data 속성은 childrenresources 속성에 자식 개체를 적절하게 자동으로 할당하므로 일반적으로 자식 개체 또는 리소스를 추가할 때 이러한 속성을 참조할 필요는 없습니다. 자세한 내용은 QtQuick3D::Object3D::data 문서를 참조하십시오.

참고: QtQuick3D::Object3D::resources는 이름과 상관없이 3D 리소스 목록을 반환하지 않습니다. 이름은 QQuickItem 의 의미에서 따온 것입니다. 3D 리소스는 QQuickObjec3D의 서브 클래스이므로 QtQuick3D::Objec3D::자식 목록으로 반환됩니다.


data : list<Object> [default]

데이터 속성을 사용하면 객체에서 Object3D 자손과 리소스를 자유롭게 혼합할 수 있습니다. 데이터 목록에 Object3D 을 할당하면 자식이 되고 다른 객체 유형을 할당하면 리소스로 추가됩니다.

따라서 다음과 같이 작성할 수 있습니다:

대신

Item {
    children: [
        Node {},
        DirectionalLight {}
    ]
    resources: [
        Timer {}
    ]
}

data 속성은 Object3D 의 기본 속성이므로 모든 하위 개체가 자동으로 이 속성에 할당되므로 일반적으로 속성을 참조할 필요가 없습니다.


parent : Object3D

이 프로퍼티는 3D 씬에서 Object3D 의 부모를 보유합니다.

참고: Object3D 의 부모가 반드시 해당 오브젝트 부모와 동일하지 않을 수 있습니다. 이는 객체 부모가 Object3D 유형이 아닌 항목(예: 씬의 루트 객체)일 수 있기 때문에 필요합니다.


state : string

이 속성은 객체의 현재 상태 이름을 보유합니다.

항목이 기본 상태인 경우, 즉 명시적인 상태가 설정되지 않은 경우 이 속성은 빈 문자열을 보유합니다. 마찬가지로 이 속성을 빈 문자열로 설정하여 항목을 기본 상태로 되돌릴 수 있습니다.

Qt Quick 상태를참조하세요 .


states : list<State>

이 속성에는 이 객체의 가능한 상태 목록이 저장됩니다. 이 개체의 상태를 변경하려면 state 속성을 이러한 상태 중 하나로 설정하거나 state 속성을 빈 문자열로 설정하여 개체를 기본 상태로 되돌립니다.

이 속성은 State 객체의 목록으로 지정됩니다. 예를 들어, 아래는 "above_state" 및 "below_state" 상태를 가진 QtQuick3D::노드입니다:

import QtQuick
import QtQuick3D

Node {
    id: root
    y: 0

    states: [
        State {
            name: "above_state"
            PropertyChanges { target: root; y: 100 }
        },
        State {
            name: "below_state"
            PropertyChanges { target: root; y: -100 }
        }
    ]
}

상태 및 전환 사용에 대한 자세한 내용은 Qt Quick Qt Quick 상태와 애니메이션 및 전환을 참조하십시오.

참고: 이 프로퍼티는 QtQuick::Item::상태와 동일하게 작동하지만 QtQuick3D::Object3D가 QtQuick::Item 서브클래스가 아니기 때문에 필요합니다.

QtQuick3D::Object3D::transitions참조하십시오 .


transitions : list<Transition>

이 프로퍼티는 이 객체에 대한 트랜지션 목록을 보유합니다. 이는 개체가 state 을 변경할 때마다 개체에 적용될 전환을 정의합니다.

이 속성은 Transition 객체의 목록으로 지정됩니다. 예시:

import QtQuick
import QtQuick3D

Node {
    transitions: [
        Transition {
            //...
        },
        Transition {
            //...
        }
    ]
}

상태 및 전환 사용에 대한 자세한 내용은 Qt Quick Qt Quick 상태애니메이션과 전환을 참조하세요.

참고: 이 프로퍼티는 QtQuick::Item::트랜지션과 동일하게 작동하지만 QtQuick3D::Object3D가 QtQuick::Item 서브클래스가 아니기 때문에 필요합니다.

QtQuick3D::Object3D::states참조하십시오 .


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