3D-Perspektive (Spatial)
SpatialItem Räumliches Element
Positioniert, dreht und skaliert ein Widget innerhalb von SpatialView.
Beispiel
Die Eigenschaftsvorschau konnte nicht geladen werden. Wählen Sie „Eigenschaftsvorschau“, um es erneut zu versuchen.

Verwendung
Kartenoberfläche und Pose
SpatialView::addWidget() gibt ein SpatialItem zurück, um das jeweilige Widget unabhängig zu positionieren, zu drehen und zu skalieren.
#include <FluentQt/Spatial.h>
using namespace fluent::spatial;
using namespace fluent;
// Keep the control card independent of the card it adjusts.
class WorkbenchView final : public spatial::SpatialView {
public:
using SpatialView::SpatialView;
void arrange()
{
if (itemCount() != 2)
return;
const bool stacked = width() < 720;
setFixedHeight(!isSpatialEnabled() ? 520 : (stacked ? 560 : 360));
auto* preview = items().first();
preview->setPosition(QVector3D(stacked ? 0 : -164, stacked ? -140 : 0,
preview->position().z()));
items().last()->setPosition(QVector3D(stacked ? 0 : 164, stacked ? 110 : 0, -50));
}
protected:
void resizeEvent(QResizeEvent* event) override
{
SpatialView::resizeEvent(event);
// Update the responsive height after the current layout pass.
QTimer::singleShot(0, this, [this] { arrange(); });
}
};
auto* panel = new SpatialPreviewPanel(parent);
auto* column = new QVBoxLayout(panel);
column->setContentsMargins(0, 0, 0, 0);
column->setSpacing(12);
auto* session = new spatial::SpatialSession(panel, panel);
const bool active = session->activate();
auto* view = new WorkbenchView(panel);
if (!active || !session->attachView(view)) {
view->setSpatialEnabled(false);
view->setRenderMode(spatial::SpatialView::RenderMode::Raster);
}
view->setObjectName("spatialPreviewView");
view->setCameraDistance(1400);
view->setZoom(0.92);
view->setMaximumTilt(QPointF(4, 6));
column->addWidget(view);
auto* card = new layout::Card;
card->setObjectName("spatialDemoCard");
card->setFixedSize(280, 180);
auto* content = new QVBoxLayout(card);
content->setContentsMargins(20, 16, 20, 16);
content->setSpacing(8);
auto* title = new textfields::Label("Activity", card);
title->setFluentTypography(Typography::FontRole::Subtitle);
title->setTextColorRole(textfields::Label::TextColorRole::Primary);
content->addWidget(title);
auto* chart = new charts::Sparkline(card);
chart->setAccessibleName("Activity trend, demo data");
auto* model = new charts::ChartModel(card);
model->setPoints({{0, 12}, {1, 24}, {2, 18}, {3, 38}, {4, 32}, {5, 54}});
chart->setModel(model);
content->addWidget(chart, 1);
auto* caption = new textfields::Label("Last 6 days · demo data", card);
caption->setTextColorRole(textfields::Label::TextColorRole::Secondary);
content->addWidget(caption);
spatial::SpatialItem* item = view->addWidget(card, WidgetOwnership::Owned);
item->setSurfaceIntensity(0.75);
item->setHoverLift(5);
item->setRotation(QVector3D(0, -18, 0));
// Scale, pivot and visibility retain their defaults; see SpatialItem.h.
auto* settings = new layout::Card;
settings->setObjectName("spatialParameterCard");
settings->setFixedSize(280, 260);
auto* controls = new QVBoxLayout(settings);
controls->setContentsMargins(20, 16, 20, 16);
controls->setSpacing(8);
auto* heading = new textfields::Label("Card", settings);
heading->setFluentTypography(Typography::FontRole::Subtitle);
heading->setTextColorRole(textfields::Label::TextColorRole::Primary);
controls->addWidget(heading);
const auto addSlider = [settings, controls](const QString& name, const QString& label,
const QString& unit, int minimum, int maximum,
int initial) {
auto* group = new QVBoxLayout;
group->setSpacing(4);
auto* text = new textfields::Label(settings);
text->setTextColorRole(textfields::Label::TextColorRole::Primary);
auto* slider = new basicinput::Slider(settings);
slider->setObjectName(name);
slider->setAccessibleName(label);
slider->setRange(minimum, maximum);
slider->setValue(initial);
const auto updateText = [text, label, unit](int value) {
text->setText(QString("%1: %2%3").arg(label).arg(value).arg(unit));
};
updateText(initial);
QObject::connect(slider, &basicinput::Slider::valueChanged, text, updateText);
group->addWidget(text);
group->addWidget(slider);
controls->addLayout(group);
return slider;
};
auto* finish = addSlider("spatialItemSurfaceIntensity", "Surface", "%", 0, 100, 75);
auto* angle = addSlider("spatialItemRotation", "Rotation", "°", -35, 35, -18);
auto* depth = addSlider("spatialItemDepth", "Depth", " px", -120, 120, 0);
QObject::connect(finish, &basicinput::Slider::valueChanged, item,
[item](int value) { item->setSurfaceIntensity(value / 100.0); });
QObject::connect(angle, &basicinput::Slider::valueChanged, item,
[item](int value) { item->setRotation(QVector3D(0, value, 0)); });
QObject::connect(depth, &basicinput::Slider::valueChanged, item, [item](int value) {
auto position = item->position();
position.setZ(value);
item->setPosition(position);
});
auto* controlItem = view->addWidget(settings, WidgetOwnership::Owned);
controlItem->setSurfaceIntensity(0.75);
controlItem->setRotation(QVector3D(0, -6, 0));
// No hover lift for the parameter card: keep its drag targets steady.
QObject::connect(view, &spatial::SpatialView::spatialEnabledChanged,
view, [view] { view->arrange(); });
view->arrange();import fluentqt
from PySide6.QtCore import QEvent, QPointF, QTimer
from PySide6.QtGui import QVector3D
from PySide6.QtWidgets import QGridLayout, QVBoxLayout, QWidget
from fluentqt.spatial import SpatialSession, SpatialView
class SpatialPreviewPanel(QWidget):
def stop_spatial(self):
session = self.findChild(SpatialSession)
if session is not None:
session.deactivate()
def event(self, event):
# Stop before deleteLater dismantles this panel's widgets.
# Also call stop_spatial before disposing an enclosing window.
if event.type() == QEvent.DeferredDelete:
self.stop_spatial()
return super().event(event)
class WorkbenchView(SpatialView):
def __init__(self, parent=None):
super().__init__(parent)
self.arrange_timer = QTimer(self)
self.arrange_timer.setSingleShot(True)
self.arrange_timer.timeout.connect(self.arrange)
def arrange(self):
if self.itemCount() != 2:
return
stacked = self.width() < 720
self.setFixedHeight(
520 if not self.isSpatialEnabled() else (560 if stacked else 360)
)
item = self.items()[0]
item.setPosition(
QVector3D(
0 if stacked else -164,
-140 if stacked else 0,
item.position().z()
)
)
self.items()[-1].setPosition(
QVector3D(0 if stacked else 164, 110 if stacked else 0, -50)
)
def resizeEvent(self, event):
super().resizeEvent(event)
self.arrange_timer.start(0)
panel = SpatialPreviewPanel()
column = QVBoxLayout(panel)
column.setContentsMargins(0, 0, 0, 0)
column.setSpacing(12)
session = SpatialSession(panel, panel)
spatial_attached = session.activate()
view = WorkbenchView(panel)
spatial_attached = spatial_attached and session.attachView(view)
if not spatial_attached:
view.setRenderMode(SpatialView.RenderMode.Raster)
view.setSpatialEnabled(False)
view.setObjectName("spatialPreviewView")
view.setFixedHeight(360)
view.setCameraDistance(1400)
view.setMaximumTilt(QPointF(4, 6))
column.addWidget(view)
card = fluentqt.Card()
card.setFixedSize(280, 180)
content = QVBoxLayout(card)
content.setContentsMargins(20, 16, 20, 16)
content.setSpacing(8)
def add_slider(parent, layout, name, label, unit, minimum, maximum, initial):
in_grid = isinstance(layout, QGridLayout)
group = QWidget(parent) if in_grid else parent
column = QVBoxLayout(group) if in_grid else QVBoxLayout()
column.setContentsMargins(0, 0, 0, 0)
column.setSpacing(4)
text = fluentqt.Label(f"{label}: {initial}{unit}", group)
slider = fluentqt.Slider(group)
slider.setObjectName(name)
slider.setAccessibleName(label)
slider.setRange(minimum, maximum)
slider.setValue(initial)
slider.valueChanged.connect(
lambda value: text.setText(f"{label}: {value}{unit}")
)
column.addWidget(text)
column.addWidget(slider)
if isinstance(layout, QGridLayout):
layout.addWidget(group, 0, layout.count())
else:
layout.addLayout(column)
return slider
view.setZoom(0.92)
card.setObjectName("spatialDemoCard")
title = fluentqt.Label("Activity", card)
title.setFluentTypography(fluentqt.FontRole.Subtitle)
title.setTextColorRole(fluentqt.Label.TextColorRole.Primary)
content.addWidget(title)
chart = fluentqt.Sparkline(card)
chart.setAccessibleName("Activity trend, demo data")
model = fluentqt.ChartModel(card)
model.setPoints([QPointF(x, y) for x, y in enumerate([12, 24, 18, 38, 32, 54])])
chart.setModel(model)
content.addWidget(chart, 1)
caption = fluentqt.Label("Last 6 days · demo data", card)
caption.setTextColorRole(fluentqt.Label.TextColorRole.Secondary)
content.addWidget(caption)
item = view.addOwnedWidget(card)
item.setSurfaceIntensity(0.75)
item.setHoverLift(5)
item.setRotation(QVector3D(0, -18, 0))
settings = fluentqt.Card()
settings.setObjectName("spatialParameterCard")
settings.setFixedSize(280, 260)
controls = QVBoxLayout(settings)
controls.setContentsMargins(20, 16, 20, 16)
controls.setSpacing(8)
heading = fluentqt.Label("Card", settings)
heading.setFluentTypography(fluentqt.FontRole.Subtitle)
controls.addWidget(heading)
finish = add_slider(
settings,
controls,
"spatialItemSurfaceIntensity",
"Surface",
"%",
0,
100,
75
)
angle = add_slider(
settings,
controls,
"spatialItemRotation",
"Rotation",
"°",
-35,
35,
-18
)
depth = add_slider(
settings,
controls,
"spatialItemDepth",
"Depth",
" px",
-120,
120,
0
)
finish.valueChanged.connect(lambda value: item.setSurfaceIntensity(value / 100.0))
angle.valueChanged.connect(lambda value: item.setRotation(QVector3D(0, value, 0)))
def change_depth(value):
position = item.position()
position.setZ(value)
item.setPosition(position)
depth.valueChanged.connect(change_depth)
control_item = view.addOwnedWidget(settings)
control_item.setSurfaceIntensity(0.75)
control_item.setRotation(QVector3D(0, -6, 0))
view.spatialEnabledChanged.connect(view.arrange)
view.arrange()API
DeklarationKeine passenden API-Elemente.
fluent::spatial::SpatialItem
Erbt von QObject
Steuert 3D-Position, Drehung (Grad) und Skalierung (0.05–8) eines Widgets in SpatialView, wobei +Z zum Betrachter zeigt. Beim Entfernen oder Zerstören des Elements wird dessen Widget gemäß dem gewählten WidgetOwnership-Modus behandelt.
Destruktoren
Methoden
QVector3D position() constDrehpunktversatz zur Ansichtsmitte in logischen Pixeln (+Z zum Betrachter); Standard (0, 0, 0).
void setPosition(const QVector3D& position)Drehpunktversatz zur Ansichtsmitte in logischen Pixeln (+Z zum Betrachter); Standard (0, 0, 0).
QVector3D rotation() constX/Y/Z-Rotation um den Drehpunkt in Grad; Standard ist (0, 0, 0).
void setRotation(const QVector3D& rotation)X/Y/Z-Rotation um den Drehpunkt in Grad; Standard ist (0, 0, 0).
qreal scale() constGleichmäßiger Skalierungsfaktor, begrenzt auf [0.05, 8]; Standardwert 1.
void setScale(qreal scale)Gleichmäßiger Skalierungsfaktor, begrenzt auf [0.05, 8]; Standardwert 1.
QPointF pivot() constNormalisierter Transformationsursprung in [0, 1]; Standardmitte (0.5, 0.5).
void setPivot(const QPointF& pivot)Normalisierter Transformationsursprung in [0, 1]; Standardmitte (0.5, 0.5).
bool isVisible() constElementsichtbarkeit in 3D- und 2D-Layouts; Standard ist true. Verwenden Sie dies, statt das Widget direkt auszublenden.
void setVisible(bool visible)Elementsichtbarkeit in 3D- und 2D-Layouts; Standard ist true. Verwenden Sie dies, statt das Widget direkt auszublenden.
qreal surfaceIntensity() constStärke von Schatten und Kantenhervorhebung [0, 1] für Karten im 3D-Modus; Standard 0.
void setSurfaceIntensity(qreal intensity)Stärke von Schatten und Kantenhervorhebung [0, 1] für Karten im 3D-Modus; Standard 0.
qreal hoverLift() constAufwärtsversatz beim Hovern in logischen Pixeln [0, 16] im 3D-Modus; Standard: 0.
void setHoverLift(qreal pixels)Aufwärtsversatz beim Hovern in logischen Pixeln [0, 16] im 3D-Modus; Standard: 0.
QPolygonF projectedPolygon() constProjizierte Ecken in SpatialView-Koordinaten oder leer, falls nicht verfügbar.
Eigenschaften
QVector3D positionDrehpunktversatz zur Ansichtsmitte in logischen Pixeln (+Z zum Betrachter); Standard (0, 0, 0).
Lesenposition()SchreibensetPosition()BenachrichtigungpositionChanged()QVector3D rotationX/Y/Z-Rotation um den Drehpunkt in Grad; Standard ist (0, 0, 0).
Lesenrotation()SchreibensetRotation()BenachrichtigungrotationChanged()qreal scaleGleichmäßiger Skalierungsfaktor, begrenzt auf [0.05, 8]; Standardwert 1.
Lesenscale()SchreibensetScale()BenachrichtigungscaleChanged()QPointF pivotNormalisierter Transformationsursprung in [0, 1]; Standardmitte (0.5, 0.5).
Lesenpivot()SchreibensetPivot()BenachrichtigungpivotChanged()bool visibleElementsichtbarkeit in 3D- und 2D-Layouts; Standard ist true. Verwenden Sie dies, statt das Widget direkt auszublenden.
LesenisVisible()SchreibensetVisible()BenachrichtigungvisibleChanged()qreal surfaceIntensityStärke von Schatten und Kantenhervorhebung [0, 1] für Karten im 3D-Modus; Standard 0.
LesensurfaceIntensity()SchreibensetSurfaceIntensity()BenachrichtigungsurfaceIntensityChanged()qreal hoverLiftAufwärtsversatz beim Hovern in logischen Pixeln [0, 16] im 3D-Modus; Standard: 0.
LesenhoverLift()SchreibensetHoverLift()BenachrichtigunghoverLiftChanged()
Signale
void positionChanged(const QVector3D& position)Drehpunktversatz zur Ansichtsmitte in logischen Pixeln (+Z zum Betrachter); Standard (0, 0, 0).
void rotationChanged(const QVector3D& rotation)X/Y/Z-Rotation um den Drehpunkt in Grad; Standard ist (0, 0, 0).
void scaleChanged(qreal scale)Gleichmäßiger Skalierungsfaktor, begrenzt auf [0.05, 8]; Standardwert 1.
void pivotChanged(const QPointF& pivot)Normalisierter Transformationsursprung in [0, 1]; Standardmitte (0.5, 0.5).
void visibleChanged(bool visible)Elementsichtbarkeit in 3D- und 2D-Layouts; Standard ist true. Verwenden Sie dies, statt das Widget direkt auszublenden.
void surfaceIntensityChanged(qreal intensity)Stärke von Schatten und Kantenhervorhebung [0, 1] für Karten im 3D-Modus; Standard 0.
void hoverLiftChanged(qreal pixels)Aufwärtsversatz beim Hovern in logischen Pixeln [0, 16] im 3D-Modus; Standard: 0.
Qt-Basisklassendokumentation: QObject