ParticleSystem3D QML 类型

包含粒子、发射器、影响器类型的系统。更多...

导入声明	import QtQuick3D.Particles3D
自	Qt 6.2
继承	Node

包含所有成员，包括继承成员的列表

属性

logging : bool
loggingData : ParticleSystem3DLogging
paused : bool
running : bool
seed : int
startTime : int
time : int
useRandomSeed : bool

方法

reset()

详细描述

此元素是粒子系统的根，用于处理系统时间并共同管理其他相关元素，如粒子、发射器和影响器。要将系统元素分组，它们要么像这样是 ParticleSystem3D 的直接子元素

ParticleSystem3D {
    ParticleEmitter3D {
        ...
    }
    SpriteParticle3D {
        ...
    }
}

或者，如果系统元素不是直接子元素，它们需要使用 system 属性来指定它们属于哪个 ParticleSystem3D。如下所示

ParticleSystem3D {
    id: psystem
}
ParticleEmitter3D {
    system: psystem
    ...
}
SpriteParticle3D {
    system: psystem
    ...
}

属性文档

logging : bool

将此设置为 true 以收集 loggingData。

注意：此属性会对性能产生一些影响，因此在发布不应启用。

默认值为 false。

另请参阅：loggingData。

loggingData : ParticleSystem3DLogging [只读]

此属性包含用于在开发和优化粒子效果时很有用的日志数据。

注意：只有当 logging 设置为 true 且粒子系统正在运行时，此属性才包含正确数据。

另请参阅：logging。

paused : bool

此属性定义系统当前是否处于暂停状态。如果暂停设置为 true，则粒子系统不会推进模拟。当暂停再次设置为 false 时，模拟将从暂停点继续。

默认值为 false。

running : bool

此属性定义系统是否当前正在运行。如果 running 设置为 false，则粒子系统会停止模拟。当 system 设置为 running 时，所有粒子将被销毁。

在手动修改/动画 time 属性时，应将 running 设置为 false。

默认值为 true。

seed : int

此属性定义用于粒子随机的种子值。具有相同的种子，每运行一次粒子的效果都应相同。当需要确定性行为而不是随机行为时很有用。

当 useRandomSeed 设置为 false 时，默认值为 0，当 useRandomSeed 设置为 true 时，为介于 1..INT32_MAX 之间的某个值。

注意：应在此粒子动画期间修改此属性。

另请参阅：useRandomSeed。

startTime : int

此属性定义系统开始时间的毫秒数。这可以用来使系统预热，使一组粒子已经发射。例如，如果 startTime 设置为 2000，且系统 time 正在从 0 到 1000 动画，则实际动画显示粒子从 2000 到 3000 毫秒。

默认值为 0。

time : int

此属性定义系统的毫秒时间。

注意：在修改时间属性时，通常应将 running 设置为 false。

以下是一个示例，说明如何手动循环以半速动画系统 3 秒。

ParticleSystem3D {
    running: false
    NumberAnimation on time {
        loops: Animation.Infinite
        from: 0
        to: 3000
        duration: 6000
    }
}

useRandomSeed : bool

此属性定义粒子系统种子是随机生成还是用户定义。当 true 时，每次启动粒子系统时都会为 seed 生成一个新的随机值。

默认值为 true。

注意：应在此粒子动画期间修改此属性。

另请参阅：seed。

方法文档

reset()

此方法将粒子系统的内部状态重置为其初始状态。当 running 属性设置为 false 时，可以使用此方法重置系统。当 running 为 true 时，不需要调用此方法，因为系统正在管理内部状态，但当它为 false 时，系统需要知道何时应重置系统。