Optionale Module
3D-Perspektive (Spatial)
Bestehende QWidgets mit 3D-Neigung und Tiefe darstellen. Steht kein OpenGL zur Verfügung, nutzt SpatialView CPU-Rendering und behält den Perspektiveffekt bei.
3D-Ansicht erstellen
Verlinke FluentQt::Spatial, starte eine SpatialSession und erstelle eine SpatialView. SpatialView::addWidget() liefert ein SpatialItem zur Steuerung von Versatz, Drehung und Tiefe, während normale Maus- und Tastatureingaben weiter funktionieren.
#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)Renderer und 2D-Fallback
Mit setRenderMode() wählst du Auto, Raster oder OpenGL; fehlt OpenGL, wechselt die Ansicht auf CPU-Perspektive und nennt den Grund in activeBackend() und fallbackReason(). Ein Aufruf von setSpatialEnabled(false) schaltet auf ein flaches Spaltenlayout zurück — ebenso automatisch bei reduzierter Bewegung, hohem Kontrast, Tab oder Esc.