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 參考