Тип QML ParticleSystem3D
Система, включающая типы частиц, эмиттеров и модификаторов. Подробнее...
| Оператор импорта: | import QtQuick3D.Particles3D |
| С момента: | Qt 6.2 |
| Наследует: |
Свойства
- 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
Это свойство определяет, приостановлена ли система в данный момент. Если paused установлено в значение true, система частиц не будет выполнять симуляцию. При повторной установке paused в значение false, симуляция возобновится с той же точки, на которой она была приостановлена.
Значение по умолчанию равно false.
running : bool
Это свойство определяет, работает ли система в данный момент. Если running установлено в значение false, система частиц остановит симуляцию. Все частицы будут уничтожены, когда система будет запущена снова.
Свойство running должно быть установлено в false при ручном изменении/анимировании свойства time.
Значение по умолчанию равно true.
seed : int
Это свойство определяет значение семени, используемое для случайного выбора частиц. При одинаковом семени эффект частиц будет идентичным при каждом запуске. Это полезно, когда требуется детерминированное поведение вместо случайного.
Значение по умолчанию равно 0 при useRandomSeed установлено в false, и что-то между 1..INT32_MAX при useRandomSeed установлено в true.
Примечание: Это свойство не следует изменять во время анимации частиц.
См. также useRandomSeed.
startTime : int
Это свойство определяет время в миллисекундах, с которого система запускается. Это может быть полезно для разогрева системы, чтобы определенное количество частиц уже было выпущено. Например, если startTime установлен в 2000, а свойство time анимируется от 0 до 1000, на самом деле анимация покажет частицы с 2000 до 3000 мс.
Значение по умолчанию равно 0.
time : int
Это свойство определяет время в миллисекундах для системы.
Примечание: При изменении свойства time, 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, системе нужно указать, когда следует сбрасывать систему.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtquick3d-particles3d-particlesystem3d.html