Skip to content

fix(window): prepare the first frame and revalidate drawable metrics - #94

Merged
sudoevolve merged 3 commits into
sudoevolve:devfrom
Linductor-alkaid:fix/window-frame-presentation
Oct 10, 2026
Merged

sudoevolve merged 3 commits into
sudoevolve:devfrom
Linductor-alkaid:fix/window-frame-presentation

Conversation

@Linductor-alkaid

@Linductor-alkaid Linductor-alkaid commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

问题

修复 #93。Mirage 的持续拖拽整窗黑闪还有应用侧逐帧直接设置尺寸的因素:上游修复单独接入后,真实 XWayland/合成器测试仍捕获频闪;应用改用已有 beginWindowResize 后维护者实测频闪消失。该 PR 只修复已独立复现的 EUI 首帧与尺寸失效问题,不能将它单独宣称为 Mirage 拖拽频闪的完整修复。

自绘窗口在输入回调中调整原生尺寸后,入口仍按输入前的尺寸绘制并交换缓冲;冷启动则在渲染初始化和首次绘制之前就显示窗口。结果是缩放时提交内容不完整的帧,以及启动时暴露尚未绘制的窗口。

最小复现:320×240 的窗口在 MainWindowRuntime 更新后的回调中改为 480×360。修复前探针稳定报告 presented old-size frame after resize during update 和 resize lost pending repaint。

修改

  • 应用主窗口和 DSL 子窗口隐藏创建。首帧绘制完成后显示,紧接着交换已准备的缓冲;映射后请求完整重绘。避免隐藏状态先交换再显示可能丢失内容的路径。
  • 帧节拍等待后重新读取 drawable/DPI/指针比例。更新回调改变它们时,以零时间推进一次新尺寸布局,不重放已消费的输入;如果尺寸再次变化或无效,则保留重绘并显式唤醒下一帧。每帧最多一次重试,持续缩放仍能绘制新尺寸内容。
  • 子窗口同样检查更新后的尺寸,防止旧尺寸提交。
  • 新增 frame_presentation_probe:真实窗口更新期缩放、新尺寸提交、首帧显示回调时序及仅执行一次、再次变化/DPI/指针比例失效、零尺寸及恢复、空闲不提交。更新集成文档,明确 onStart 仍隐藏,初次显示由入口负责。

复用已有布局、缓存、重绘和唤醒机制,没有延时猜测、持续强制重绘或新的并发设施。默认底层 WindowCreateRequest 仍可见,现有直接窗口消费者保持原行为;变更入口的初次显示时序。

影响

  • 修改/新增/删除文件:6 / 1 / 0。
  • 代码行数:278 行新增、21 行删除,净增 257 行(含文档及回归探针)。
  • 仓库追踪内容净增:11,161 bytes。
  • 新增依赖、资源、生成物:无。构建/截图/日志均在源码树外。
  • 不改变 DSL 公共 Builder、输入事件结构、渲染缓存算法或后端选择;MainWindowRuntime 属于内部入口实现。

本机环境

  • OS:Ubuntu 24.04.5 LTS,x86_64。
  • CPU:Intel Core Ultra 5 225H,14 逻辑 CPU。
  • GPU:Intel Arrow Lake-P;回归在私有 Xvfb/X11 下执行,属于 headless 软件驱动验证,不代表该硬件或 Windows/Wayland 真机验收。
  • 编译器:GCC 13.3.0,CMake + Ninja;独立 Release 构建目录。

验证

四组合均从本 PR 分支配置并构建全部测试 fixtures,随后执行全部 ctest:

窗口/渲染 独立目录 Release 配置/构建 ctest
GLFW / OpenGL /tmp/eui-frame-glfw-opengl 通过 34/34
SDL2 / OpenGL /tmp/eui-frame-sdl2-opengl 通过 34/34
GLFW / Vulkan /tmp/eui-frame-glfw-vulkan 通过 34/34
SDL2 / Vulkan /tmp/eui-frame-sdl2-vulkan 通过 34/34

命令(各目录替换对应 backend):

cmake -S . -B /tmp/eui-frame-glfw-opengl -G Ninja -DCMAKE_BUILD_TYPE=Release \
  -DEUI_WINDOW_BACKEND=glfw -DEUI_RENDER_BACKEND=opengl \
  -DEUI_BUILD_TEST_FIXTURES=ON -DEUI_BUILD_APPS=OFF -DEUI_BUILD_USER_APPS=OFF
cmake --build /tmp/eui-frame-glfw-opengl --parallel 3
xvfb-run -a env -u WAYLAND_DISPLAY XDG_SESSION_TYPE=x11 SDL_VIDEODRIVER=x11 \
  ctest --test-dir /tmp/eui-frame-glfw-opengl --output-on-failure
  • GLFW + OpenGL:Release 构建和测试通过。
  • SDL2 + OpenGL:Release 构建和测试通过。
  • GLFW + Vulkan:Release 构建和测试通过。
  • SDL2 + Vulkan:Release 构建和测试通过。
  • 四组合均运行 empty_window fixture 并检查像素/截图;新增探针真实调用原生 resize。
  • 回归探针在 Debug + ASAN/UBSAN(-fsanitize=address,undefined)通过。
  • Mirage 实际 Release 前端:独立 XDG/DBus/X11,38 次启动采样、60 次旧应用 grip 拖拽采样及最终边缘检查无黑色像素;窗口复用及整体关闭通过,无模型调用。
  • 无性能优化声明,不需要性能前后对比。

验收边界:自动探针保证绘制/提交使用有效尺寸和准备后的显示时序;私有 Xvfb 直接读取原生窗口时,映射与首个 swap 之间仍可能读到窗口系统的短暂空表面,不宣称窗口系统 map/swap 原子化或所有平台绝对无黑帧。没有提交以 clear-only 黑帧替代应用内容。后续真实 GNOME/XWayland 上,框架修复单独接入仍有 149/300 黑色中心样本;Mirage 改用既有 beginWindowResize 后,维护者物理拖拽确认顺畅无黑闪。该应用修复不包含在本 PR。Windows、macOS、原生 Wayland 和其他合成器仍需维护者在对应环境验收。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants