擴充模組
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 時也會自動觸發)。