Fluent-Qt

3D パース表示 (Spatial)

SpatialItem 空間アイテム

SpatialView 内のウィジェットの位置、回転、拡大縮小を制御します。

サンプル

SpatialItem 空間アイテム: カードの質感と姿勢

使い方

カードの質感と姿勢

SpatialView::addWidget() は SpatialItem を返し、そのウィジェットの位置・回転・拡大縮小を個別に設定できます。

#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

継承元 QObject

SpatialView 内のウィジェットの 3D 位置、回転(度)、およびスケール(0.05〜8)を制御します(+Z が手前方向)。アイテムを削除または破棄すると、選択された WidgetOwnership モードに従ってそのウィジェットが処理されます。

デストラクタ

メソッド

QVector3D position() const

ビュー中心からの論理ピクセル単位のピボットオフセット(+Z は手前方向、既定値は (0, 0, 0))。

void setPosition(const QVector3D& position)

ビュー中心からの論理ピクセル単位のピボットオフセット(+Z は手前方向、既定値は (0, 0, 0))。

QVector3D rotation() const

ピボットを中心とした X/Y/Z 回転角度(度単位)。デフォルトは (0, 0, 0) です。

void setRotation(const QVector3D& rotation)

ピボットを中心とした X/Y/Z 回転角度(度単位)。デフォルトは (0, 0, 0) です。

qreal scale() const

均一なスケール係数です([0.05, 8] にクランプされ、デフォルトは 1 です)。

void setScale(qreal scale)

均一なスケール係数です([0.05, 8] にクランプされ、デフォルトは 1 です)。

QPointF pivot() const

[0, 1] の範囲に正規化された変換原点。既定値は中央(0.5, 0.5)です。

void setPivot(const QPointF& pivot)

[0, 1] の範囲に正規化された変換原点。既定値は中央(0.5, 0.5)です。

bool isVisible() const

3D および 2D レイアウトの両方におけるアイテムの表示状態です(既定値は true)。ウィジェットを直接非表示にする代わりにこれを使用してください。

void setVisible(bool visible)

3D および 2D レイアウトの両方におけるアイテムの表示状態です(既定値は true)。ウィジェットを直接非表示にする代わりにこれを使用してください。

qreal surfaceIntensity() const

3D モードのカードにおける影とリムハイライトの強度 [0, 1] です(デフォルトは 0)。

void setSurfaceIntensity(qreal intensity)

3D モードのカードにおける影とリムハイライトの強度 [0, 1] です(デフォルトは 0)。

qreal hoverLift() const

3D モードでのホバー時の上方向オフセット(論理ピクセル [0, 16])です。デフォルトは 0 です。

void setHoverLift(qreal pixels)

3D モードでのホバー時の上方向オフセット(論理ピクセル [0, 16])です。デフォルトは 0 です。

QPolygonF projectedPolygon() const

SpatialView 座標系に投影された四隅の座標。利用できない場合は空になります。

プロパティ

QVector3D position

ビュー中心からの論理ピクセル単位のピボットオフセット(+Z は手前方向、既定値は (0, 0, 0))。

読み取り position()書き込み setPosition()通知シグナル positionChanged()
QVector3D rotation

ピボットを中心とした X/Y/Z 回転角度(度単位)。デフォルトは (0, 0, 0) です。

読み取り rotation()書き込み setRotation()通知シグナル rotationChanged()
qreal scale

均一なスケール係数です([0.05, 8] にクランプされ、デフォルトは 1 です)。

読み取り scale()書き込み setScale()通知シグナル scaleChanged()
QPointF pivot

[0, 1] の範囲に正規化された変換原点。既定値は中央(0.5, 0.5)です。

読み取り pivot()書き込み setPivot()通知シグナル pivotChanged()
bool visible

3D および 2D レイアウトの両方におけるアイテムの表示状態です(既定値は true)。ウィジェットを直接非表示にする代わりにこれを使用してください。

読み取り isVisible()書き込み setVisible()通知シグナル visibleChanged()
qreal surfaceIntensity

3D モードのカードにおける影とリムハイライトの強度 [0, 1] です(デフォルトは 0)。

読み取り surfaceIntensity()書き込み setSurfaceIntensity()通知シグナル surfaceIntensityChanged()
qreal hoverLift

3D モードでのホバー時の上方向オフセット(論理ピクセル [0, 16])です。デフォルトは 0 です。

読み取り hoverLift()書き込み setHoverLift()通知シグナル hoverLiftChanged()

シグナル

void positionChanged(const QVector3D& position)

ビュー中心からの論理ピクセル単位のピボットオフセット(+Z は手前方向、既定値は (0, 0, 0))。

void rotationChanged(const QVector3D& rotation)

ピボットを中心とした X/Y/Z 回転角度(度単位)。デフォルトは (0, 0, 0) です。

void scaleChanged(qreal scale)

均一なスケール係数です([0.05, 8] にクランプされ、デフォルトは 1 です)。

void pivotChanged(const QPointF& pivot)

[0, 1] の範囲に正規化された変換原点。既定値は中央(0.5, 0.5)です。

void visibleChanged(bool visible)

3D および 2D レイアウトの両方におけるアイテムの表示状態です(既定値は true)。ウィジェットを直接非表示にする代わりにこれを使用してください。

void surfaceIntensityChanged(qreal intensity)

3D モードのカードにおける影とリムハイライトの強度 [0, 1] です(デフォルトは 0)。

void hoverLiftChanged(qreal pixels)

3D モードでのホバー時の上方向オフセット(論理ピクセル [0, 16])です。デフォルトは 0 です。

Qt 基底クラスドキュメント:QObject