Fluent-Qt

Perspective 3D (Spatial)

SpatialItem Élément spatial

Positionnez, pivotez et redimensionnez un widget dans SpatialView.

Exemple

SpatialItem Élément spatial: Finition et pose de la carte

Utilisation

Finition et pose de la carte

SpatialView::addWidget() renvoie un SpatialItem permettant de positionner, pivoter et redimensionner ce widget indépendamment.

#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();

fluent::spatial::SpatialItem

Hérite de QObject

Contrôle la position 3D, la rotation (en degrés) et l'échelle (0.05-8) d'un widget dans SpatialView, avec +Z orienté vers l'utilisateur. La suppression ou la destruction de l'élément gère son widget selon le mode WidgetOwnership choisi.

Destructeurs

Méthodes

QVector3D position() const

Décalage du pivot par rapport au centre de la vue en pixels logiques (+Z vers le spectateur) ; (0, 0, 0) par défaut.

void setPosition(const QVector3D& position)

Décalage du pivot par rapport au centre de la vue en pixels logiques (+Z vers le spectateur) ; (0, 0, 0) par défaut.

QVector3D rotation() const

Rotation X/Y/Z autour du pivot en degrés ; (0, 0, 0) par défaut.

void setRotation(const QVector3D& rotation)

Rotation X/Y/Z autour du pivot en degrés ; (0, 0, 0) par défaut.

qreal scale() const

Facteur d'échelle uniforme borné à [0.05, 8] ; 1 par défaut.

void setScale(qreal scale)

Facteur d'échelle uniforme borné à [0.05, 8] ; 1 par défaut.

QPointF pivot() const

Origine de transformation normalisée dans [0, 1] ; centre par défaut (0.5, 0.5).

void setPivot(const QPointF& pivot)

Origine de transformation normalisée dans [0, 1] ; centre par défaut (0.5, 0.5).

bool isVisible() const

Visibilité de l'élément dans les dispositions 3D et 2D ; par défaut true. Utilisez cette propriété plutôt que de masquer directement le widget.

void setVisible(bool visible)

Visibilité de l'élément dans les dispositions 3D et 2D ; par défaut true. Utilisez cette propriété plutôt que de masquer directement le widget.

qreal surfaceIntensity() const

Intensité de l'ombre et du reflet de bord [0, 1] pour les cartes en mode 3D ; 0 par défaut.

void setSurfaceIntensity(qreal intensity)

Intensité de l'ombre et du reflet de bord [0, 1] pour les cartes en mode 3D ; 0 par défaut.

qreal hoverLift() const

Décalage vers le haut au survol en pixels logiques [0, 16] en mode 3D ; 0 par défaut.

void setHoverLift(qreal pixels)

Décalage vers le haut au survol en pixels logiques [0, 16] en mode 3D ; 0 par défaut.

QPolygonF projectedPolygon() const

Coins projetés dans les coordonnées de SpatialView, ou vide si indisponible.

Propriétés

QVector3D position

Décalage du pivot par rapport au centre de la vue en pixels logiques (+Z vers le spectateur) ; (0, 0, 0) par défaut.

Lecture position()Écriture setPosition()Notification positionChanged()
QVector3D rotation

Rotation X/Y/Z autour du pivot en degrés ; (0, 0, 0) par défaut.

Lecture rotation()Écriture setRotation()Notification rotationChanged()
qreal scale

Facteur d'échelle uniforme borné à [0.05, 8] ; 1 par défaut.

Lecture scale()Écriture setScale()Notification scaleChanged()
QPointF pivot

Origine de transformation normalisée dans [0, 1] ; centre par défaut (0.5, 0.5).

Lecture pivot()Écriture setPivot()Notification pivotChanged()
bool visible

Visibilité de l'élément dans les dispositions 3D et 2D ; par défaut true. Utilisez cette propriété plutôt que de masquer directement le widget.

Lecture isVisible()Écriture setVisible()Notification visibleChanged()
qreal surfaceIntensity

Intensité de l'ombre et du reflet de bord [0, 1] pour les cartes en mode 3D ; 0 par défaut.

Lecture surfaceIntensity()Écriture setSurfaceIntensity()Notification surfaceIntensityChanged()
qreal hoverLift

Décalage vers le haut au survol en pixels logiques [0, 16] en mode 3D ; 0 par défaut.

Lecture hoverLift()Écriture setHoverLift()Notification hoverLiftChanged()

Signaux

void positionChanged(const QVector3D& position)

Décalage du pivot par rapport au centre de la vue en pixels logiques (+Z vers le spectateur) ; (0, 0, 0) par défaut.

void rotationChanged(const QVector3D& rotation)

Rotation X/Y/Z autour du pivot en degrés ; (0, 0, 0) par défaut.

void scaleChanged(qreal scale)

Facteur d'échelle uniforme borné à [0.05, 8] ; 1 par défaut.

void pivotChanged(const QPointF& pivot)

Origine de transformation normalisée dans [0, 1] ; centre par défaut (0.5, 0.5).

void visibleChanged(bool visible)

Visibilité de l'élément dans les dispositions 3D et 2D ; par défaut true. Utilisez cette propriété plutôt que de masquer directement le widget.

void surfaceIntensityChanged(qreal intensity)

Intensité de l'ombre et du reflet de bord [0, 1] pour les cartes en mode 3D ; 0 par défaut.

void hoverLiftChanged(qreal pixels)

Décalage vers le haut au survol en pixels logiques [0, 16] en mode 3D ; 0 par défaut.

Documentation de la classe de base Qt : QObject