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

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

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

import QtQuick.Particles 2.12

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

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