本页内容

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.