パーティクル
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() constSpatial と併用する際に GPU レンダリングへの切り替えを許可します(デフォルトは false、スタンドアロンウィジェットでは常に CPU を使用)。
void setGpuAccelerationEnabled(bool enabled)Spatial と併用する際に GPU レンダリングへの切り替えを許可します(デフォルトは 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)モーションが許可されている場合、ローカル座標に装飾用のリップルエフェクトを発生させます(同時に最大 3 つまで)。
プロパティ
Effect effect- 読み取り
effect()書き込みsetEffect()通知シグナルeffectChanged() bool animationEnabled- 読み取り
isAnimationEnabled()書き込みsetAnimationEnabled()通知シグナルanimationEnabledChanged() bool animatingパーティクルアニメーションが現在実行中かどうか。
読み取りisAnimating()通知シグナルanimatingChanged()bool gpuAccelerationEnabledSpatial と併用する際に GPU レンダリングへの切り替えを許可します(デフォルトは 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)Spatial と併用する際に GPU レンダリングへの切り替えを許可します(デフォルトは false、スタンドアロンウィジェットでは常に CPU を使用)。
protected メンバー
メソッド
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指定されたアクティブ状態に対するウィンドウ chrome の背景色。
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)PropertyBinder::bind() を介して、@p source の @p sourceProp をこの QWidget ホストの @p targetProp にバインドします。
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 = {})この QWidget ホストに明示的依存関係を持つ C++ 式を設定します。
void addTransition(const StateTransition& transition)優先順位順に状態遷移を登録します。
void setBehavior(const char* propertyName, const PropertyAnimation& animation)writeProperty() またはバインディング経由で @p propertyName が書き込まれた際に使用されるデフォルトアニメーションを設定します。明示的な StateTransition ルールが優先され、C++ のセッターを直接呼び出した場合はアニメーションしません。
void clearBehavior(const char* propertyName)今後のマネージド書き込みに使用するデフォルトアニメーションを削除します。
bool writeProperty(const char* propertyName, const QVariant& value)バインディングを削除せずに Behavior 経由でホストプロパティに書き込みます。
Qt 基底クラスドキュメント:QWidget