Fluent-Qt

拡張モジュール

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
}

レンダラーと 2D フォールバック

setRenderMode() で Auto・Raster・OpenGL を選択できます。OpenGL が利用できない場合は CPU パースへ切り替わり、activeBackend() と fallbackReason() で理由を確認できます。setSpatialEnabled(false) を呼ぶと通常の縦並び 2D レイアウトへ切り替わります(視差効果の軽減、ハイコントラスト、Tab、Esc でも自動的に切り替わります)。

API リファレンス