Использование системы частиц Qt Quick

Документацию по всем типам систем частиц можно найти на странице модуля QtQuick.Particles.

Чтобы использовать типы из модуля particles, импортируйте модуль с помощью следующей строки:

import QtQuick.Particles 2.15

Система частиц

Эта система частиц содержит четыре основных типа QML: ParticleSystem, Рисовальщики, Источники и Влияния.

Тип ParticleSystem связывает все остальные типы и управляет общей шкалой времени. Рисовальщики, Источники и Влияния должны иметь одинаковую систему ParticleSystem, чтобы взаимодействовать друг с другом.

Вы можете иметь столько систем ParticleSystems, сколько хотите, при этом соблюдая данное ограничение, поэтому логичным разделением является использование одной системы ParticleSystem для всех типов, которые вы хотите задействовать, или просто одной, если количество типов невелико и их легко контролировать.

Логические частицы

Все типы систем частиц действуют на «логические частицы». Каждая частица имеет логическое представление внутри системы частиц, и именно на это воздействуют типы. Не каждая логическая частица должна быть визуализирована, и некоторые логические частицы могут привести к отображению на экране нескольких визуальных частиц.

Группы частиц

Каждая логическая частица является членом группы частиц, и каждая группа идентифицируется именем. Если не указана другая группа, логическая частица принадлежит группе с именем "" (пустая строка), которая работает так же, как и любая другая группа. Группы используются для двух целей: управления частицами и потому что они могут иметь стохастические переходы состояний.

Группы управляют частицами, потому что вы никогда не можете получить доступ к отдельной частице с помощью любого из типов систем частиц. Все типы действуют на группы в целом, поэтому любые частицы, которые должны вести себя по-разному (кроме обычного стохастического изменения параметров), должны находиться в разных группах.

Частицы также могут динамически изменять свои группы. В этом случае траектория частиц не изменяется, но на нее могут воздействовать разные ParticlePainters или Влияния. Частицы могут либо изменить свою группу с помощью Влияния, либо стохастические переходы состояний могут быть определены в типе ParticleGroup.

В общем случае, группы следует определять только в ParticleGroup, если они требуют стохастических переходов состояний. В противном случае достаточно просто определить группы с помощью строк, используемых в свойствах particle/particles типов.

Источники

Источники генерируют логические частицы в систему. У этих частиц есть траектория и срок службы, но нет визуализации. Эти частицы испускаются из местоположения Источника.

TrailEmitters — это особый тип источника, который испускает частицы из местоположения других логических частиц. Любая логическая частица заданного типа в пределах TrailEmitter вызовет испускание частиц из её местоположения, как если бы там был Источник с такими же свойствами, как у TrailEmitter.

Рисовальщики частиц

Рисовальщики — это типы, которые визуализируют логические частицы. Для каждой логической частицы в группах, назначенных ему, которые находятся в пределах его границ (или вне границ, если вы не задаёте свойство clip для типа), она будет визуализирована способом, зависящим от типа ParticlePainter. Базовый тип ParticlePainter ничего не рисует. ImageParticle отображает изображение в месте расположения частицы. CustomParticle позволяет вам написать свои собственные шейдеры для визуализации частиц, передавая состояние логической частицы в качестве данных вершин. ItemParticle позволяет вам визуализировать логические частицы с помощью произвольных делегатов QML. ModelParticle аналогичен, но координирует данные модели среди делегатов аналогично классам просмотра.

Поскольку ParticlePainter — это QML-тип, визуализирующий частицы на сцене, важным является его значение Z при попытке разместить частицы над или под другими типами визуально.

Влияния

Влияния — это необязательная компонента системы частиц. Они могут выполнять различные манипуляции с моделированием, например, изменять траекторию частиц или преждевременно завершать их существование в моделировании. По соображениям производительности рекомендуется не использовать Влияния в системах частиц с высокой производительностью.

Стохастические параметры

Поскольку системы частиц выигрывают от стохастического управления параметрами большого количества экземпляров, система частиц использует несколько стохастических вспомогательных типов. Если вы не хотите иметь никакого стохастического изменения в этих параметрах, не указывайте никаких изменений в этих типах.

Направления

Направления могут быть заданы углом и величиной или компонентами x и y. Хотя любое направление можно задать любым из этих методов, существует существенная разница между изменением компонентов x и y и изменением угла и величины. Изменение компонентов x и y приведёт к прямоугольной области вокруг заданной точки, в то время как изменение угла приведёт к дуге, центрированной в заданной точке.

Фигуры

Система частиц содержит несколько типов, представляющих фигуры. Эти типы не визуализируют фигуры и используются для выбора случайной точки внутри фигуры. Если вам нужна конкретная точка без случайности, используйте фигуру с шириной 0 и высотой 0 (что является значением по умолчанию). В противном случае вы можете использовать типы фигур для задания области, чтобы результат мог использовать случайную точку, выбранную из этой области.