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

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

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

import QtQuick.Particles 2.13

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

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