Fluent-Qt

확장 모듈

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
}

렌더러와 2D 폴백

setRenderMode()로 Auto, Raster, OpenGL 중 하나를 선택할 수 있으며, OpenGL을 쓸 수 없으면 CPU 원근으로 전환하고 activeBackend()와 fallbackReason()에서 이유를 알려 줍니다. setSpatialEnabled(false)를 호출하면 평면 세로 2D 레이아웃으로 전환됩니다(동작 줄이기, 고대비, Tab, Esc 시에도 자동 전환).

API 레퍼런스