Build XCEditor viewport shell contract foundation

This commit is contained in:
2026-04-07 05:33:27 +08:00
parent a53f47e561
commit 044240d2f1
11 changed files with 1141 additions and 1 deletions

View File

@@ -13,3 +13,6 @@ endif()
if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/viewport_slot_basic/CMakeLists.txt")
add_subdirectory(viewport_slot_basic)
endif()
if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/viewport_shell_basic/CMakeLists.txt")
add_subdirectory(viewport_shell_basic)
endif()

View File

@@ -0,0 +1,30 @@
add_executable(editor_ui_viewport_shell_basic_validation WIN32
main.cpp
)
target_include_directories(editor_ui_viewport_shell_basic_validation PRIVATE
${CMAKE_SOURCE_DIR}/new_editor/include
${CMAKE_SOURCE_DIR}/new_editor/app
${CMAKE_SOURCE_DIR}/engine/include
)
target_compile_definitions(editor_ui_viewport_shell_basic_validation PRIVATE
UNICODE
_UNICODE
XCENGINE_EDITOR_UI_TESTS_REPO_ROOT="${XCENGINE_EDITOR_UI_TESTS_REPO_ROOT_PATH}"
)
if(MSVC)
target_compile_options(editor_ui_viewport_shell_basic_validation PRIVATE /utf-8 /FS)
set_property(TARGET editor_ui_viewport_shell_basic_validation PROPERTY
MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>DLL")
endif()
target_link_libraries(editor_ui_viewport_shell_basic_validation PRIVATE
XCUIEditorLib
XCUIEditorHost
)
set_target_properties(editor_ui_viewport_shell_basic_validation PROPERTIES
OUTPUT_NAME "XCUIEditorViewportShellBasicValidation"
)

View File

@@ -0,0 +1,827 @@
#ifndef NOMINMAX
#define NOMINMAX
#endif
#include <XCEditor/Core/UIEditorViewportShell.h>
#include <XCEditor/Widgets/UIEditorViewportSlot.h>
#include "Host/AutoScreenshot.h"
#include "Host/InputModifierTracker.h"
#include "Host/NativeRenderer.h"
#include <XCEngine/UI/DrawData.h>
#include <windows.h>
#include <windowsx.h>
#include <algorithm>
#include <filesystem>
#include <sstream>
#include <string>
#include <string_view>
#include <utility>
#include <vector>
#ifndef XCENGINE_EDITOR_UI_TESTS_REPO_ROOT
#define XCENGINE_EDITOR_UI_TESTS_REPO_ROOT "."
#endif
namespace {
using XCEngine::UI::UIColor;
using XCEngine::UI::UIDrawData;
using XCEngine::UI::UIDrawList;
using XCEngine::UI::UIInputEvent;
using XCEngine::UI::UIInputEventType;
using XCEngine::UI::UIPoint;
using XCEngine::UI::UIPointerButton;
using XCEngine::UI::UIRect;
using XCEngine::UI::UISize;
using XCEngine::UI::Editor::ResolveUIEditorViewportShellRequest;
using XCEngine::UI::Editor::UIEditorViewportShellFrame;
using XCEngine::UI::Editor::UIEditorViewportShellModel;
using XCEngine::UI::Editor::UIEditorViewportShellRequest;
using XCEngine::UI::Editor::UIEditorViewportShellSpec;
using XCEngine::UI::Editor::UIEditorViewportShellState;
using XCEngine::UI::Editor::UpdateUIEditorViewportShell;
using XCEngine::UI::Editor::Host::AutoScreenshotController;
using XCEngine::UI::Editor::Host::InputModifierTracker;
using XCEngine::UI::Editor::Host::NativeRenderer;
using XCEngine::UI::Editor::Widgets::AppendUIEditorViewportSlotBackground;
using XCEngine::UI::Editor::Widgets::AppendUIEditorViewportSlotForeground;
using XCEngine::UI::Editor::Widgets::HitTestUIEditorViewportSlot;
using XCEngine::UI::Editor::Widgets::UIEditorStatusBarSegment;
using XCEngine::UI::Editor::Widgets::UIEditorStatusBarSlot;
using XCEngine::UI::Editor::Widgets::UIEditorViewportSlotFrame;
using XCEngine::UI::Editor::Widgets::UIEditorViewportSlotHitTarget;
using XCEngine::UI::Editor::Widgets::UIEditorViewportSlotHitTargetKind;
using XCEngine::UI::Editor::Widgets::UIEditorViewportSlotToolItem;
using XCEngine::UI::Editor::Widgets::UIEditorViewportSlotToolSlot;
constexpr const wchar_t* kWindowClassName = L"XCUIEditorViewportShellBasicValidation";
constexpr const wchar_t* kWindowTitle = L"XCUI Editor | ViewportShell Basic";
constexpr UIColor kWindowBg(0.12f, 0.12f, 0.12f, 1.0f);
constexpr UIColor kCardBg(0.18f, 0.18f, 0.18f, 1.0f);
constexpr UIColor kCardBorder(0.29f, 0.29f, 0.29f, 1.0f);
constexpr UIColor kTextPrimary(0.94f, 0.94f, 0.94f, 1.0f);
constexpr UIColor kTextMuted(0.72f, 0.72f, 0.72f, 1.0f);
constexpr UIColor kTextWeak(0.56f, 0.56f, 0.56f, 1.0f);
constexpr UIColor kButtonBg(0.25f, 0.25f, 0.25f, 1.0f);
constexpr UIColor kButtonOnBg(0.39f, 0.39f, 0.39f, 1.0f);
constexpr UIColor kButtonBorder(0.47f, 0.47f, 0.47f, 1.0f);
constexpr UIColor kPreviewBg(0.15f, 0.15f, 0.15f, 1.0f);
enum class ActionId : unsigned char {
ToggleTopBar = 0,
ToggleBottomBar,
ToggleTexture,
Reset,
Capture
};
struct ButtonState {
ActionId action = ActionId::ToggleTopBar;
std::string label = {};
UIRect rect = {};
bool selected = false;
};
std::filesystem::path ResolveRepoRootPath() {
std::string root = XCENGINE_EDITOR_UI_TESTS_REPO_ROOT;
if (root.size() >= 2u && root.front() == '"' && root.back() == '"') {
root = root.substr(1u, root.size() - 2u);
}
return std::filesystem::path(root).lexically_normal();
}
bool ContainsPoint(const UIRect& rect, float x, float y) {
return x >= rect.x &&
x <= rect.x + rect.width &&
y >= rect.y &&
y <= rect.y + rect.height;
}
std::string BoolText(bool value) {
return value ? "On" : "Off";
}
std::string FormatFloat(float value) {
std::ostringstream stream = {};
stream.setf(std::ios::fixed, std::ios::floatfield);
stream.precision(1);
stream << value;
return stream.str();
}
std::string FormatSize(const UISize& size) {
return FormatFloat(size.width) + " x " + FormatFloat(size.height);
}
std::string FormatRect(const UIRect& rect) {
return "x=" + FormatFloat(rect.x) +
" y=" + FormatFloat(rect.y) +
" w=" + FormatFloat(rect.width) +
" h=" + FormatFloat(rect.height);
}
std::string DescribeHitTarget(const UIEditorViewportSlotHitTarget& hit) {
switch (hit.kind) {
case UIEditorViewportSlotHitTargetKind::TopBar:
return "TopBar";
case UIEditorViewportSlotHitTargetKind::Title:
return "Title";
case UIEditorViewportSlotHitTargetKind::ToolItem:
return "ToolItem[" + std::to_string(hit.index) + "]";
case UIEditorViewportSlotHitTargetKind::Surface:
return "Surface";
case UIEditorViewportSlotHitTargetKind::BottomBar:
return "BottomBar";
case UIEditorViewportSlotHitTargetKind::StatusSegment:
return "StatusSegment[" + std::to_string(hit.index) + "]";
case UIEditorViewportSlotHitTargetKind::StatusSeparator:
return "StatusSeparator[" + std::to_string(hit.index) + "]";
case UIEditorViewportSlotHitTargetKind::None:
default:
return "None";
}
}
void DrawCard(
UIDrawList& drawList,
const UIRect& rect,
std::string_view title,
std::string_view subtitle = {}) {
drawList.AddFilledRect(rect, kCardBg, 10.0f);
drawList.AddRectOutline(rect, kCardBorder, 1.0f, 10.0f);
drawList.AddText(
UIPoint(rect.x + 16.0f, rect.y + 14.0f),
std::string(title),
kTextPrimary,
17.0f);
if (!subtitle.empty()) {
drawList.AddText(
UIPoint(rect.x + 16.0f, rect.y + 38.0f),
std::string(subtitle),
kTextMuted,
12.0f);
}
}
void DrawButton(UIDrawList& drawList, const ButtonState& button) {
drawList.AddFilledRect(
button.rect,
button.selected ? kButtonOnBg : kButtonBg,
8.0f);
drawList.AddRectOutline(button.rect, kButtonBorder, 1.0f, 8.0f);
drawList.AddText(
UIPoint(button.rect.x + 12.0f, button.rect.y + 10.0f),
button.label,
kTextPrimary,
12.0f);
}
class ScenarioApp {
public:
int Run(HINSTANCE hInstance, int nCmdShow) {
if (!Initialize(hInstance, nCmdShow)) {
Shutdown();
return 1;
}
MSG message = {};
while (message.message != WM_QUIT) {
if (PeekMessageW(&message, nullptr, 0U, 0U, PM_REMOVE)) {
TranslateMessage(&message);
DispatchMessageW(&message);
continue;
}
RenderFrame();
Sleep(8);
}
Shutdown();
return static_cast<int>(message.wParam);
}
private:
static LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam) {
if (message == WM_NCCREATE) {
const auto* createStruct = reinterpret_cast<CREATESTRUCTW*>(lParam);
auto* app = reinterpret_cast<ScenarioApp*>(createStruct->lpCreateParams);
SetWindowLongPtrW(hwnd, GWLP_USERDATA, reinterpret_cast<LONG_PTR>(app));
return TRUE;
}
auto* app = reinterpret_cast<ScenarioApp*>(GetWindowLongPtrW(hwnd, GWLP_USERDATA));
switch (message) {
case WM_SIZE:
if (app != nullptr && wParam != SIZE_MINIMIZED) {
app->m_renderer.Resize(static_cast<UINT>(LOWORD(lParam)), static_cast<UINT>(HIWORD(lParam)));
}
return 0;
case WM_MOUSEMOVE:
if (app != nullptr) {
app->QueuePointerEvent(UIInputEventType::PointerMove, UIPointerButton::None, wParam, lParam);
TRACKMOUSEEVENT event = {};
event.cbSize = sizeof(event);
event.dwFlags = TME_LEAVE;
event.hwndTrack = hwnd;
TrackMouseEvent(&event);
return 0;
}
break;
case WM_MOUSELEAVE:
if (app != nullptr) {
app->QueuePointerLeaveEvent();
return 0;
}
break;
case WM_LBUTTONDOWN:
if (app != nullptr) {
SetFocus(hwnd);
app->HandlePointerDown(UIPointerButton::Left, wParam, lParam);
return 0;
}
break;
case WM_LBUTTONUP:
if (app != nullptr) {
app->HandlePointerUp(UIPointerButton::Left, wParam, lParam);
return 0;
}
break;
case WM_MOUSEWHEEL:
if (app != nullptr) {
app->QueuePointerWheelEvent(GET_WHEEL_DELTA_WPARAM(wParam), wParam, lParam);
return 0;
}
break;
case WM_SETFOCUS:
if (app != nullptr) {
app->m_inputModifierTracker.SyncFromSystemState();
app->QueueFocusEvent(UIInputEventType::FocusGained);
return 0;
}
break;
case WM_KILLFOCUS:
if (app != nullptr) {
if (GetCapture() == hwnd) {
ReleaseCapture();
}
app->m_inputModifierTracker.Reset();
app->QueueFocusEvent(UIInputEventType::FocusLost);
return 0;
}
break;
case WM_KEYDOWN:
case WM_SYSKEYDOWN:
if (app != nullptr && wParam == VK_F12) {
app->m_autoScreenshot.RequestCapture("manual_f12");
InvalidateRect(hwnd, nullptr, FALSE);
UpdateWindow(hwnd);
return 0;
}
break;
case WM_PAINT:
if (app != nullptr) {
PAINTSTRUCT paintStruct = {};
BeginPaint(hwnd, &paintStruct);
app->RenderFrame();
EndPaint(hwnd, &paintStruct);
return 0;
}
break;
case WM_ERASEBKGND:
return 1;
case WM_DESTROY:
PostQuitMessage(0);
return 0;
default:
break;
}
return DefWindowProcW(hwnd, message, wParam, lParam);
}
bool Initialize(HINSTANCE hInstance, int nCmdShow) {
m_captureRoot =
ResolveRepoRootPath() / "tests/UI/Editor/integration/shell/viewport_shell_basic/captures";
m_autoScreenshot.Initialize(m_captureRoot);
WNDCLASSEXW windowClass = {};
windowClass.cbSize = sizeof(windowClass);
windowClass.style = CS_HREDRAW | CS_VREDRAW;
windowClass.lpfnWndProc = &ScenarioApp::WndProc;
windowClass.hInstance = hInstance;
windowClass.hCursor = LoadCursorW(nullptr, IDC_ARROW);
windowClass.lpszClassName = kWindowClassName;
m_windowClassAtom = RegisterClassExW(&windowClass);
if (m_windowClassAtom == 0) {
return false;
}
m_hwnd = CreateWindowExW(
0,
kWindowClassName,
kWindowTitle,
WS_OVERLAPPEDWINDOW | WS_VISIBLE,
CW_USEDEFAULT,
CW_USEDEFAULT,
1520,
940,
nullptr,
nullptr,
hInstance,
this);
if (m_hwnd == nullptr) {
return false;
}
if (!m_renderer.Initialize(m_hwnd)) {
return false;
}
ShowWindow(m_hwnd, nCmdShow);
ResetScenario();
return true;
}
void Shutdown() {
m_autoScreenshot.Shutdown();
m_renderer.Shutdown();
if (m_hwnd != nullptr && IsWindow(m_hwnd)) {
DestroyWindow(m_hwnd);
}
m_hwnd = nullptr;
if (m_windowClassAtom != 0) {
UnregisterClassW(kWindowClassName, GetModuleHandleW(nullptr));
m_windowClassAtom = 0;
}
}
void ResetScenario() {
m_showTopBar = true;
m_showBottomBar = true;
m_textureEnabled = true;
m_inputModifierTracker.Reset();
m_shellState = {};
m_shellRequest = {};
m_shellFrame = {};
m_shellSpec = {};
m_shellModel = {};
m_hoverHit = {};
m_pendingEvents.clear();
m_lastResult = "Ready";
m_hasSnapshot = false;
}
void QueuePointerEvent(UIInputEventType type, UIPointerButton button, WPARAM wParam, LPARAM lParam) {
UIInputEvent event = {};
event.type = type;
event.pointerButton = button;
event.position = UIPoint(
static_cast<float>(GET_X_LPARAM(lParam)),
static_cast<float>(GET_Y_LPARAM(lParam)));
event.modifiers = m_inputModifierTracker.BuildPointerModifiers(static_cast<std::size_t>(wParam));
m_pendingEvents.push_back(event);
m_mousePosition = event.position;
}
void QueuePointerLeaveEvent() {
UIInputEvent event = {};
event.type = UIInputEventType::PointerLeave;
if (m_hwnd != nullptr) {
POINT clientPoint = {};
GetCursorPos(&clientPoint);
ScreenToClient(m_hwnd, &clientPoint);
event.position = UIPoint(static_cast<float>(clientPoint.x), static_cast<float>(clientPoint.y));
m_mousePosition = event.position;
}
m_pendingEvents.push_back(event);
}
void QueuePointerWheelEvent(short wheelDelta, WPARAM wParam, LPARAM lParam) {
if (m_hwnd == nullptr) {
return;
}
POINT screenPoint = {
GET_X_LPARAM(lParam),
GET_Y_LPARAM(lParam)
};
ScreenToClient(m_hwnd, &screenPoint);
UIInputEvent event = {};
event.type = UIInputEventType::PointerWheel;
event.position = UIPoint(static_cast<float>(screenPoint.x), static_cast<float>(screenPoint.y));
event.wheelDelta = static_cast<float>(wheelDelta);
event.modifiers = m_inputModifierTracker.BuildPointerModifiers(static_cast<std::size_t>(wParam));
m_pendingEvents.push_back(event);
m_mousePosition = event.position;
}
void QueueFocusEvent(UIInputEventType type) {
UIInputEvent event = {};
event.type = type;
event.modifiers = m_inputModifierTracker.GetCurrentModifiers();
m_pendingEvents.push_back(event);
}
void HandlePointerDown(UIPointerButton button, WPARAM wParam, LPARAM lParam) {
QueuePointerEvent(UIInputEventType::PointerButtonDown, button, wParam, lParam);
const UIPoint point(
static_cast<float>(GET_X_LPARAM(lParam)),
static_cast<float>(GET_Y_LPARAM(lParam)));
if (ContainsPoint(m_slotRect, point.x, point.y) &&
ContainsPoint(m_shellFrame.slotLayout.inputRect, point.x, point.y)) {
SetCapture(m_hwnd);
}
}
void HandlePointerUp(UIPointerButton button, WPARAM wParam, LPARAM lParam) {
QueuePointerEvent(UIInputEventType::PointerButtonUp, button, wParam, lParam);
const UIPoint point(
static_cast<float>(GET_X_LPARAM(lParam)),
static_cast<float>(GET_Y_LPARAM(lParam)));
if (GetCapture() == m_hwnd) {
ReleaseCapture();
}
for (const ButtonState& buttonState : m_buttons) {
if (!ContainsPoint(buttonState.rect, point.x, point.y)) {
continue;
}
ExecuteAction(buttonState.action);
break;
}
}
std::vector<UIEditorViewportSlotToolItem> BuildToolItems() const {
return {
{ "mode", "Perspective", UIEditorViewportSlotToolSlot::Leading, true, true, 98.0f },
{ "focus", "ViewportShell", UIEditorViewportSlotToolSlot::Trailing, true, false, 108.0f }
};
}
std::vector<UIEditorStatusBarSegment> BuildStatusSegments() const {
return {
{
"chrome-top",
std::string("TopBar ") + BoolText(m_showTopBar),
UIEditorStatusBarSlot::Leading,
{},
true,
true,
96.0f
},
{
"chrome-bottom",
std::string("BottomBar ") + BoolText(m_showBottomBar),
UIEditorStatusBarSlot::Leading,
{},
true,
false,
120.0f
},
{
"frame",
m_textureEnabled ? "Texture On" : "Fallback",
UIEditorStatusBarSlot::Trailing,
{},
true,
true,
108.0f
}
};
}
UIEditorViewportShellSpec BuildShellSpec() const {
UIEditorViewportShellSpec spec = {};
spec.chrome.title = "Scene View";
spec.chrome.subtitle = "ViewportShell 基础层";
spec.chrome.showTopBar = m_showTopBar;
spec.chrome.showBottomBar = m_showBottomBar;
spec.chrome.topBarHeight = 40.0f;
spec.chrome.bottomBarHeight = 28.0f;
spec.toolItems = BuildToolItems();
spec.statusSegments = BuildStatusSegments();
return spec;
}
UIEditorViewportSlotFrame BuildViewportFrame(const UISize& requestedSize) const {
UIEditorViewportSlotFrame frame = {};
frame.requestedSize = requestedSize;
if (m_textureEnabled) {
frame.hasTexture = true;
frame.texture = { 1u, 1280u, 720u };
frame.presentedSize = UISize(1280.0f, 720.0f);
frame.statusText = "Fake viewport frame";
} else {
frame.hasTexture = false;
frame.statusText = "这里只验证 ViewportShell contract不接 Scene/Game 业务。";
}
return frame;
}
void UpdateLayoutForCurrentWindow() {
if (m_hwnd == nullptr) {
return;
}
RECT clientRect = {};
GetClientRect(m_hwnd, &clientRect);
const float width = static_cast<float>((std::max)(1L, clientRect.right - clientRect.left));
const float height = static_cast<float>((std::max)(1L, clientRect.bottom - clientRect.top));
const float leftColumnWidth = 460.0f;
const float outerPadding = 20.0f;
m_introRect = UIRect(outerPadding, outerPadding, leftColumnWidth, 246.0f);
m_controlsRect = UIRect(outerPadding, 286.0f, leftColumnWidth, 246.0f);
m_stateRect = UIRect(outerPadding, 552.0f, leftColumnWidth, height - 572.0f);
m_previewRect = UIRect(
leftColumnWidth + outerPadding * 2.0f,
outerPadding,
width - leftColumnWidth - outerPadding * 3.0f,
height - outerPadding * 2.0f);
m_slotRect = UIRect(
m_previewRect.x + 18.0f,
m_previewRect.y + 18.0f,
m_previewRect.width - 36.0f,
m_previewRect.height - 36.0f);
const float buttonHeight = 34.0f;
const float gap = 10.0f;
const float left = m_controlsRect.x + 16.0f;
const float top = m_controlsRect.y + 54.0f;
const float widthAvailable = m_controlsRect.width - 32.0f;
m_buttons = {
{
ActionId::ToggleTopBar,
std::string("TopBar: ") + (m_showTopBar ? "" : ""),
UIRect(left, top, widthAvailable, buttonHeight),
m_showTopBar
},
{
ActionId::ToggleBottomBar,
std::string("BottomBar: ") + (m_showBottomBar ? "" : ""),
UIRect(left, top + (buttonHeight + gap), widthAvailable, buttonHeight),
m_showBottomBar
},
{
ActionId::ToggleTexture,
std::string("Texture: ") + (m_textureEnabled ? "" : ""),
UIRect(left, top + (buttonHeight + gap) * 2.0f, widthAvailable, buttonHeight),
m_textureEnabled
},
{
ActionId::Reset,
"Reset",
UIRect(left, top + (buttonHeight + gap) * 3.0f, widthAvailable, buttonHeight),
false
},
{
ActionId::Capture,
"截图",
UIRect(left, top + (buttonHeight + gap) * 4.0f, widthAvailable, buttonHeight),
false
}
};
}
void ExecuteAction(ActionId action) {
switch (action) {
case ActionId::ToggleTopBar:
m_showTopBar = !m_showTopBar;
m_lastResult = m_showTopBar ? "TopBar 已打开" : "TopBar 已关闭";
break;
case ActionId::ToggleBottomBar:
m_showBottomBar = !m_showBottomBar;
m_lastResult = m_showBottomBar ? "BottomBar 已打开" : "BottomBar 已关闭";
break;
case ActionId::ToggleTexture:
m_textureEnabled = !m_textureEnabled;
m_lastResult = m_textureEnabled ? "切到 Texture 分支" : "切到 Fallback 分支";
break;
case ActionId::Reset:
ResetScenario();
m_lastResult = "状态已重置";
break;
case ActionId::Capture:
m_autoScreenshot.RequestCapture("manual_button");
InvalidateRect(m_hwnd, nullptr, FALSE);
UpdateWindow(m_hwnd);
m_lastResult = "截图已排队";
break;
}
}
void UpdateLastResult() {
const auto& inputFrame = m_shellFrame.inputFrame;
if (inputFrame.captureStarted) {
m_lastResult = "CaptureStarted";
} else if (inputFrame.captureEnded) {
m_lastResult = "CaptureEnded";
} else if (inputFrame.focusLost) {
m_lastResult = "FocusLost";
} else if (inputFrame.focusGained) {
m_lastResult = "FocusGained";
} else if (inputFrame.pointerPressedInside) {
m_lastResult = "PointerDownInside";
} else if (inputFrame.pointerReleasedInside) {
m_lastResult = "PointerUpInside";
} else if (inputFrame.wheelDelta != 0.0f) {
m_lastResult = "Wheel " + FormatFloat(inputFrame.wheelDelta);
} else if (m_hasSnapshot && m_previousHovered != inputFrame.hovered) {
m_lastResult = std::string("Hover ") + BoolText(inputFrame.hovered);
}
m_previousHovered = inputFrame.hovered;
m_previousFocused = inputFrame.focused;
m_previousCaptured = inputFrame.captured;
m_hasSnapshot = true;
}
void UpdateScenarioFrame() {
m_shellSpec = BuildShellSpec();
m_shellRequest = ResolveUIEditorViewportShellRequest(m_slotRect, m_shellSpec);
m_shellModel = {};
m_shellModel.spec = m_shellSpec;
m_shellModel.frame = BuildViewportFrame(m_shellRequest.requestedViewportSize);
std::vector<UIInputEvent> frameEvents = std::move(m_pendingEvents);
m_pendingEvents.clear();
m_shellFrame = UpdateUIEditorViewportShell(
m_shellState,
m_slotRect,
m_shellModel,
frameEvents);
m_hoverHit = HitTestUIEditorViewportSlot(m_shellFrame.slotLayout, m_mousePosition);
UpdateLastResult();
}
void RenderFrame() {
if (m_hwnd == nullptr) {
return;
}
RECT clientRect = {};
GetClientRect(m_hwnd, &clientRect);
const float width = static_cast<float>((std::max)(1L, clientRect.right - clientRect.left));
const float height = static_cast<float>((std::max)(1L, clientRect.bottom - clientRect.top));
UpdateLayoutForCurrentWindow();
UpdateScenarioFrame();
UIDrawData drawData = {};
UIDrawList& drawList = drawData.EmplaceDrawList("ViewportShellBasic");
drawList.AddFilledRect(UIRect(0.0f, 0.0f, width, height), kWindowBg);
DrawCard(
drawList,
m_introRect,
"测试功能ViewportShell 基础 contract",
"只验证 Resolve + Update不接 Scene/Game 业务面板。");
drawList.AddText(
UIPoint(m_introRect.x + 16.0f, m_introRect.y + 66.0f),
"重点检查:切换 TopBar / BottomBar 后Request Size 与 Input Rect 要同步变化。",
kTextMuted,
11.0f);
drawList.AddText(
UIPoint(m_introRect.x + 16.0f, m_introRect.y + 88.0f),
"重点检查Hover / Focus / Capture 要和右侧 surface 边框状态一致。",
kTextMuted,
11.0f);
drawList.AddText(
UIPoint(m_introRect.x + 16.0f, m_introRect.y + 110.0f),
"重点检查Texture 与 Fallback 只影响 frame 分支,不应破坏 shell 输入边界。",
kTextMuted,
11.0f);
drawList.AddText(
UIPoint(m_introRect.x + 16.0f, m_introRect.y + 132.0f),
"操作hover Surfaceclick 获取 Focus按住拖出再松开检查 Capture。",
kTextMuted,
11.0f);
drawList.AddText(
UIPoint(m_introRect.x + 16.0f, m_introRect.y + 154.0f),
"操作:点击左侧 TopBar / BottomBar / Texture观察左侧状态与右侧布局。",
kTextMuted,
11.0f);
drawList.AddText(
UIPoint(m_introRect.x + 16.0f, m_introRect.y + 176.0f),
"操作:需要保留当前画面时点“截图”,或直接按 F12。",
kTextMuted,
11.0f);
drawList.AddText(
UIPoint(m_introRect.x + 16.0f, m_introRect.y + 204.0f),
"结果判定:左侧 Request / Input / HoverHit / Hover / Focus / Capture 必须一致。",
kTextWeak,
11.0f);
DrawCard(drawList, m_controlsRect, "操作", "只保留当前测试真正需要检查的 5 个控件。");
for (const ButtonState& button : m_buttons) {
DrawButton(drawList, button);
}
DrawCard(drawList, m_stateRect, "状态", "重点看 request、input rect、hover 命中与输入桥同步。");
float stateY = m_stateRect.y + 66.0f;
auto addStateLine = [&](std::string text, const UIColor& color, float fontSize = 12.0f) {
drawList.AddText(UIPoint(m_stateRect.x + 16.0f, stateY), std::move(text), color, fontSize);
stateY += 22.0f;
};
addStateLine("TopBar: " + BoolText(m_showTopBar), kTextPrimary);
addStateLine("BottomBar: " + BoolText(m_showBottomBar), kTextPrimary);
addStateLine("Texture: " + BoolText(m_textureEnabled), kTextPrimary);
addStateLine("Request Size: " + FormatSize(m_shellRequest.requestedViewportSize), kTextPrimary);
addStateLine("Input Rect: " + FormatRect(m_shellFrame.slotLayout.inputRect), kTextMuted, 11.0f);
addStateLine("Hover Hit: " + DescribeHitTarget(m_hoverHit), kTextPrimary);
addStateLine("Hover: " + BoolText(m_shellFrame.inputFrame.hovered), kTextPrimary);
addStateLine("Focus: " + BoolText(m_shellFrame.inputFrame.focused), kTextPrimary);
addStateLine("Capture: " + BoolText(m_shellFrame.inputFrame.captured), kTextPrimary);
addStateLine("Result: " + m_lastResult, kTextMuted);
const std::string captureSummary =
m_autoScreenshot.HasPendingCapture()
? "截图排队中..."
: (m_autoScreenshot.GetLastCaptureSummary().empty()
? std::string("截图F12 或按钮 -> viewport_shell_basic/captures/")
: m_autoScreenshot.GetLastCaptureSummary());
addStateLine(captureSummary, kTextWeak, 11.0f);
DrawCard(drawList, m_previewRect, "Preview", "这里只有一个 ViewportShell用来检验 Editor 基础层 compose。");
drawList.AddFilledRect(
UIRect(
m_previewRect.x + 12.0f,
m_previewRect.y + 44.0f,
m_previewRect.width - 24.0f,
m_previewRect.height - 56.0f),
kPreviewBg,
10.0f);
AppendUIEditorViewportSlotBackground(
drawList,
m_shellFrame.slotLayout,
m_shellModel.spec.toolItems,
m_shellModel.spec.statusSegments,
m_shellFrame.slotState);
AppendUIEditorViewportSlotForeground(
drawList,
m_shellFrame.slotLayout,
m_shellModel.spec.chrome,
m_shellModel.frame,
m_shellModel.spec.toolItems,
m_shellModel.spec.statusSegments,
m_shellFrame.slotState);
const bool framePresented = m_renderer.Render(drawData);
m_autoScreenshot.CaptureIfRequested(
m_renderer,
drawData,
static_cast<unsigned int>(width),
static_cast<unsigned int>(height),
framePresented);
}
HWND m_hwnd = nullptr;
ATOM m_windowClassAtom = 0;
NativeRenderer m_renderer = {};
AutoScreenshotController m_autoScreenshot = {};
InputModifierTracker m_inputModifierTracker = {};
std::filesystem::path m_captureRoot = {};
std::vector<UIInputEvent> m_pendingEvents = {};
std::vector<ButtonState> m_buttons = {};
UIEditorViewportShellState m_shellState = {};
UIEditorViewportShellRequest m_shellRequest = {};
UIEditorViewportShellFrame m_shellFrame = {};
UIEditorViewportShellSpec m_shellSpec = {};
UIEditorViewportShellModel m_shellModel = {};
UIEditorViewportSlotHitTarget m_hoverHit = {};
UIRect m_introRect = {};
UIRect m_controlsRect = {};
UIRect m_stateRect = {};
UIRect m_previewRect = {};
UIRect m_slotRect = {};
UIPoint m_mousePosition = UIPoint(-1000.0f, -1000.0f);
bool m_showTopBar = true;
bool m_showBottomBar = true;
bool m_textureEnabled = true;
bool m_previousHovered = false;
bool m_previousFocused = false;
bool m_previousCaptured = false;
bool m_hasSnapshot = false;
std::string m_lastResult = {};
};
} // namespace
int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE, LPWSTR, int nCmdShow) {
return ScenarioApp().Run(hInstance, nCmdShow);
}