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

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

Для использования типов из модуля частиц импортируйте модуль с помощью следующей строки:

import QtQuick.Particles 2.14

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

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

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

Вы можете иметь любое количество систем ParticleSystem, подчиняясь этому ограничению, поэтому логическое разделение заключается в том, чтобы иметь одну систему 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 (по умолчанию). В противном случае вы можете использовать типы фигур для задания области, чтобы результат мог использовать случайную точку, выбранную из этой области.