拡張モジュール
3D パース表示 (Spatial)
既存の QWidget に 3D の傾きと奥行きを与えます。OpenGL が利用できない環境では SpatialView が CPU レンダリングでパース効果を維持します。
3D ビューの作成
FluentQt::Spatial をリンクし、SpatialSession を開始して SpatialView を作成します。SpatialView::addWidget() は SpatialItem を返し、通常のマウス・キーボード入力を保ったままオフセット・回転・奥行きを制御できます。
#include <FluentQt/Spatial.h>
// The session manages its own PluginManager; window stays caller-owned.
auto* session = new fluent::spatial::SpatialSession(window, window);
if (session->activate()) {
auto* view = session->createView(parentWidget);
fluent::spatial::SpatialItem* item = view->addWidget(card); // non-owning by default
}from fluentqt.spatial import SpatialSession
# The session manages its own PluginManager; window stays caller-owned.
session = SpatialSession(window, window)
if session.activate():
view = session.createView(parent_widget)
item = view.addBorrowedWidget(card)レンダラーと 2D フォールバック
setRenderMode() で Auto・Raster・OpenGL を選択できます。OpenGL が利用できない場合は CPU パースへ切り替わり、activeBackend() と fallbackReason() で理由を確認できます。setSpatialEnabled(false) を呼ぶと通常の縦並び 2D レイアウトへ切り替わります(視差効果の軽減、ハイコントラスト、Tab、Esc でも自動的に切り替わります)。