이 페이지에서

ParticleSceneShape3D QML Type

이미터 및 어펙터에 사용할 수 있도록 씬 내 입자 모양을 제공합니다. 더 보기...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.11
Inherits:

ParticleAbstractShape3D

속성

상세 설명

ParticleSceneShape3D 요소는 3D 씬에서 파티클의 모양을 가져오는 데 사용할 수 있습니다. 이 모양은 씬에 포함된 모델을 기반으로 씬을 하나의 모양으로 감싸줍니다.

예를 들어,

ParticleEmitter3D {
    id: emitter
    particle: particle

    ...

    shape: ParticleSceneShape3D {
        id: sceneShape
        scene: sceneRoot
        sceneCenter: node.scenePosition
        sceneExtents: Qt.vector3d(1000, 500, 1000)
    }

    ...
}

속성 설명서

excludedNodes : list<Node>

이 속성은 도형을 생성할 때 제외되는 노드 목록을 포함합니다. 노드나 그 자식 노드 중 하나인 경우, 해당 노드는 도형에서 제외됩니다.

geometry : Node

이 속성은 생성된 도형의 기하학적 정보를 담고 있습니다. 이 속성을 사용하여 도형을 렌더링하고 시각화할 수 있습니다.

scene : Node

이 속성은 씬의 루트 노드를 포함합니다. 씬의 모양은 씬의 자식 모델들을 기반으로 동적으로 계산됩니다. 씬이 변경되면 모양이 재계산됩니다. 씬에서 모델이 보이지 않는 경우, 해당 모델은 모양에 포함되지 않습니다. 구현에서는 노드의 가시성만 확인합니다. 머티리얼이 완전히 투명하거나 노드가 필터링되어 제외되더라도, 수동으로 제외하지 않는 한 해당 노드는 여전히 형상에 포함됩니다.

sceneCenter : Node

이 속성은 도형의 계산 기준이 되는 중심점을 지정합니다.

기본값은 Qt.vector3(0, 0, 0) 입니다.

sceneExtents : Node

이 속성은 도형 계산에 사용되는 범위를 지정합니다. 이 범위는 씬의 중심을 기준으로 추가되며, 이 영역 밖에 있는 모든 다각형은 도형 계산에서 제외됩니다. 이 값이 비어 있으면 모든 다각형이 포함됩니다.

기본값은 Qt.vector3(0, 0, 0) 입니다.

shapeResolution : real [default: 10.0;]

이 속성은 도형의 해상도를 나타냅니다. 값이 높을수록 도형이 개별 모델을 더 정확하게 재현합니다.

최소값은 1.0이고, 최대값은 100.0입니다.

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