Частицы
ParticleBackdrop Фон с частицами
Плавные ленты, парящие точки и звёздное поле с волнами от курсора, цветами с учётом темы и настройками движения и плотности.
Пример
Не удалось загрузить предпросмотр свойств. Выберите предпросмотр свойств ещё раз для повтора.

Использование
Плавные ленты
Спокойный анимированный фон следует текущей теме и настройкам анимации.
#include <FluentQt/Particles.h>
using namespace fluent::particles;
auto* backdrop = new ParticleBackdrop(this);
backdrop->setEffect(ParticleBackdrop::FlowingRibbons);
backdrop->setBackgroundMode(ParticleBackdrop::Solid);
backdrop->setParticleCount(240);
backdrop->setMaximumFrameRate(30);
backdrop->setMinimumHeight(240);
backdrop->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Preferred);import fluentqt
from PySide6.QtWidgets import QSizePolicy
from fluentqt.particles import ParticleBackdrop
backdrop = ParticleBackdrop()
backdrop.setEffect(ParticleBackdrop.Effect.FlowingRibbons)
backdrop.setBackgroundMode(ParticleBackdrop.BackgroundMode.Solid)
backdrop.setParticleCount(240)
backdrop.setMaximumFrameRate(30)
backdrop.setMinimumHeight(240)
backdrop.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Preferred)API
ОбъявлениеНет подходящих элементов API.
fluent::particles::ParticleBackdrop
Наследует QWidget · FluentElement · QMLPlus
Анимированный фоновый виджет с частицами, по умолчанию отрисовываемый на CPU. Поддерживает обычные дочерние макеты поверх и автоматически ставится на паузу при скрытии или уменьшении анимации.
Конструкторы
Деструкторы
Перечисления
enum EffectВстроенные пресеты частиц.
FlowingRibbonsОрбитальные ленты и искры.FloatingDotsМягкие огни, плавно плывущие вверх.StarfieldЗвёзды, движущиеся навстречу наблюдателю.
enum BackgroundModeРежим заливки фона.
TransparentSolid
Методы
void setEffect(Effect effect)Переключает пресет частиц и сбрасывает фазу симуляции без возобновления приостановленного движения.
bool isAnimating() constЗапущена ли в данный момент анимация частиц.
bool isGpuAccelerationEnabled() constРазрешает переключение на GPU-отрисовку при работе со Spatial (по умолчанию false; автономные виджеты всегда используют CPU).
void setGpuAccelerationEnabled(bool enabled)Разрешает переключение на GPU-отрисовку при работе со Spatial (по умолчанию false; автономные виджеты всегда используют CPU).
void setSpeed(qreal speed)Задаёт множитель скорости симуляции в диапазоне [0, 4]; значение 0 ставит движение на паузу.
void setParticleCount(int count)Задаёт количество частиц в диапазоне [0, 960] (без учёта лент и искр FlowingRibbons).
void setMaximumFrameRate(int framesPerSecond)Задаёт максимальную частоту кадров анимации в диапазоне [1, 60] fps.
void setPauseWhenInactive(bool pause)Приостанавливать ли анимацию при переходе приложения в фоновый режим.
void setFadeMargins(const QMarginsF& margins)Задаёт неотрицательную ширину затухания краёв в логических пикселях.
void triggerRipple(const QPointF& position)Запускает декоративную волну (ripple) в локальных координатах, если анимация разрешена (до 3 активных).
Свойства
Effect effect- Чтение
effect()ЗаписьsetEffect()УведомлениеeffectChanged() bool animationEnabled- Чтение
isAnimationEnabled()ЗаписьsetAnimationEnabled()УведомлениеanimationEnabledChanged() bool animatingЗапущена ли в данный момент анимация частиц.
ЧтениеisAnimating()УведомлениеanimatingChanged()bool gpuAccelerationEnabledРазрешает переключение на GPU-отрисовку при работе со Spatial (по умолчанию false; автономные виджеты всегда используют CPU).
ЧтениеisGpuAccelerationEnabled()ЗаписьsetGpuAccelerationEnabled()УведомлениеgpuAccelerationEnabledChanged()qreal speed- Чтение
speed()ЗаписьsetSpeed()УведомлениеspeedChanged() int particleCount- Чтение
particleCount()ЗаписьsetParticleCount()УведомлениеparticleCountChanged() int maximumFrameRate- Чтение
maximumFrameRate()ЗаписьsetMaximumFrameRate()УведомлениеmaximumFrameRateChanged() bool interactive- Чтение
isInteractive()ЗаписьsetInteractive()УведомлениеinteractiveChanged() bool pauseWhenInactive- Чтение
isPauseWhenInactive()ЗаписьsetPauseWhenInactive()УведомлениеpauseWhenInactiveChanged() BackgroundMode backgroundMode- Чтение
backgroundMode()ЗаписьsetBackgroundMode()УведомлениеbackgroundModeChanged() QMarginsF fadeMargins- Чтение
fadeMargins()ЗаписьsetFadeMargins()УведомлениеfadeMarginsChanged()
Сигналы
void animatingChanged(bool animating)Запущена ли в данный момент анимация частиц.
void gpuAccelerationEnabledChanged(bool enabled)Разрешает переключение на GPU-отрисовку при работе со Spatial (по умолчанию false; автономные виджеты всегда используют CPU).
Защищённые члены
Методы
Унаследовано от fluent::FluentElement
Перечисления
enum ThemeГлобальная визуальная тема, используемая при разрешении дизайн-токенов.
Light = 0Dark = 1HighContrast = 2
Методы
static void setTheme(Theme theme)Обновляет глобальную тему и уведомляет активные экземпляры FluentElement.
static void setThemeDeferred(Theme theme)Планирует пакетное обновление темы с приоритетом видимых элементов без блокировки текущего взаимодействия.
static Theme currentTheme()Возвращает текущую активную глобальную тему.
static bool themeUsesDarkAppearance(Theme theme)Возвращает, использует ли тема токены тёмного оформления и материалов.
static void refreshTheme()Повторно рассылает текущую тему для перерисовки после изменения дизайн-токенов.
static int themeGeneration()Монотонный счётчик, увеличиваемый при каждом изменении темы для проверки актуальности.
Theme effectiveTheme() constОпределяет тему, используемую этим элементом, с учётом унаследованного переопределения QWidget.
bool effectiveThemeUsesDarkAppearance() constВозвращает, использует ли действующая тема этого элемента тёмную основу оформления.
bool setThemeOverrides(const QJsonObject& overrides)Заменяет разреженные переопределения токенов цвета, скругления и шрифта этого элемента.
QJsonObject themeOverrides() constВозвращает заданные переопределения этого элемента.
void clearThemeOverrides()Восстанавливает для всех полей токенов значения глобальной темы по умолчанию.
const Colors& themeColorsRef() constДоступ без копирования к активному набору цветов для горячих путей отрисовки.
Material::AcrylicToken themeAcrylic() constТокены материалов, возвышения и адаптивной компоновки.
QColor themeBackdrop(bool active) constЦвет фона рамки окна для заданного состояния активации.
virtual void onThemeUpdated()Вызывается после изменения глобальной темы.
Типы и псевдонимы
struct ColorsСнимки дизайн-токенов, возвращаемые компонентам.
Унаследовано от fluent::QMLPlus
Методы
AnchorLayout::Anchors* anchors()Возвращает изменяемые привязки для хоста QWidget.
void setState(const QString& name)Применяет зарегистрированное состояние по имени или восстанавливает состояние по умолчанию, если @p name пусто. Неизвестные имена игнорируются, а при выходе из состояния возобновляются прежние привязки.
void addState(const QMLState& state)Регистрирует или заменяет именованное определение состояния; замена активного состояния применяется немедленно.
void evaluateStates()Повторно вычисляет условия состояний в порядке регистрации и активирует первое совпадение или состояние по умолчанию, если совпадений нет. Также выполняется автоматически при уведомлениях свойств-зависимостей; производные состояния с extend наследуют изменения предков, если нет циклов или пропусков.
QMLPlusRuntime* runtime()Возвращает лениво создаваемый наблюдатель состояния, принадлежащий этому хосту.
void setAnchors(const AnchorLayout::Anchors& anchors)Заменяет все привязки хоста и инвалидирует родительскую компоновку.
void resetAnchors()Очищает все привязки хоста и делает родительский макет недействительным.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Связывает @p sourceProp объекта @p source со свойством @p targetProp этого хоста QWidget через PropertyBinder::bind().
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Устанавливает управляемую прямую привязку на этом хосте QWidget.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Устанавливает C++-выражение с явными зависимостями на этом хосте QWidget.
void addTransition(const StateTransition& transition)Регистрирует переход состояния в порядке приоритета.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Задаёт анимацию по умолчанию при записи @p propertyName через writeProperty() или привязку. Явные правила StateTransition имеют приоритет; прямые вызовы C++ сеттеров не анимируются.
void clearBehavior(const char* propertyName)Удаляет анимацию по умолчанию для последующих управляемых записей.
bool writeProperty(const char* propertyName, const QVariant& value)Записывает свойство хоста через Behavior без удаления его привязки.
Документация базового класса Qt: QWidget