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

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

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

import QtQuick.Particles

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

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

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

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

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

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

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

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

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

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

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

Эмиттеры

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

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

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

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

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

Влиятели

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

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

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

Направления

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

Фигуры

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