github sudoevolve/EUI-NEO v0.5.1

latest releases: v0.6.4, v0.6.3, v0.6.2...
4 months ago

EUI-NEO v0.5.1

⚡ 小版本加速日,Retained Layer Cache 正式上车啦;这次不只跑得更快,也把一路颠簸的 bug 顺手修平了!

  /\_/\
 ( •̀ᴗ•́ )و ̑̑ ⚡
  > ^ <

━━━ ✦ 本次重点 ✦ ━━━

🔸 加入自动 Retained Layer Cache,复杂静态 UI 可以复用离屏缓存
🔸 OpenGL / Vulkan 缓存路径继续对齐,dirty repaint 更细、更稳
🔸 最小化、窗口恢复、空 dirty frame、滚动顶部、输入框和字体 fallback 修复大量稳定性问题
🔸 Polygon / LineChart / Gallery / Serial Tool 继续打磨,图表和示例更适合真实测试
🔸 主要是性能和稳定性更新,不包含 v0.5.0 那种破坏性 API 迁移

━━━━━━━━━━━━━

性能更新

  • Runtime 支持保留多个 dirty rect,远距离的小脏区不再强行合并成一个大区域,减少中间空白区域的重绘。
  • dirty rect 策略更明确:full paint、空 UI tree、dirty 数量过多、dirty 总面积过大等路径都有更清晰的 fallback。
  • 新增渲染诊断计数:Dirty、draw counts、render pass、clear、cache blit、present、incremental present、layer hit/miss 等指标会进入 debug title,方便定位 CPU/GPU 成本。
  • Vulkan dirty-aware cache sync 会按 dirty region 和 swapchain cache generation 做更细的 render-cache 同步。
  • OpenGL 增加 dirty cache blit,局部交互时可以减少 render cache 到 backbuffer 的复制面积。
  • Runtime 会缓存 child paint order、subtree capability、paint bounds、hover target 等 traversal metadata,减少复杂静态页面反复排序、遍历、hit-test 和递归扫描。
  • dirty repaint 会按 retained subtree paint bounds 剪枝,dirty/scissor 不相交的子树会跳过 text preparation 和 render traversal。
  • 自动 Retained Layer Cache 加入 Runtime:稳定静态子树会自动缓存成 layer,复杂静态内容与小交互区域重叠时不再每次重画所有底层 primitive。
  • OpenGL 实现 texture-backed retained layer framebuffer 和 premultiplied layer compositing。
  • Vulkan 补齐 retained layer cache:增加 layer image/framebuffer、render target 切换、premultiplied layer 合成、backdrop source 处理和 swapchain-safe 生命周期。
  • retained layer 热路径优化:blocker 和 subtree animation 状态提前缓存,动画页和 leaf-heavy 页面不会被 layer 候选判断拖慢。
  • frame pacing 调整:Windows GLFW 使用更准确的刷新率检测和高精度等待,120Hz 动画不再因为轻微 deadline miss 被多睡一帧。
  • animation frame clock 修复后,高刷新率动画在小幅超时时能追回节奏,不会被额外节流。

渲染稳定性

  • 窗口 restore、refresh、content-scale、非零 framebuffer resize 后会请求 full paint,避免恢复窗口时复用缺失或过期 render cache 出黑帧。
  • zero-sized framebuffer 时释放 render cache,并在恢复后重新完整绘制。
  • OpenGL render cache release 会先绑定正确 backend context,避免多窗口/恢复场景资源释放不稳。
  • 空 dirty frame 现在会继续 blit 现有 render cache,避免滚动边界、hover 滚动等路径出现白屏/黑屏闪烁。
  • retained layer 新建或重建当帧先走普通 primitive 绘制,下一帧再采样 layer,避免首帧静态内容占位存在但画面未出现。
  • Vulkan retained layer 纹理修复 V 坐标翻转,layer texture 不再倒置。
  • macOS Vulkan 对 render-cache presentation 使用保守同步,并禁用 incremental present,避免 MoltenVK 小脏区 hover/control 闪黑。
  • Linux OpenGL 使用 full cache blit,规避部分窗口系统/驱动不可靠保存 backbuffer 导致的脏区闪烁。
  • retained layer rebuild 后的 repaint request 会保留到下一帧,保证 render cache 与 layer 状态同步。

窗口、最小化和事件修复

  • 修复 GLFW 最小化窗口自唤醒导致 CPU 空转的问题。
  • 最小化路径不再反复 release render cache / request full paint / reset timing。
  • GLFW iconified 等待改为 timeout wait,async 空事件不会让 minimized 主循环持续 spin。
  • child window 最小化时不会被当作 active animation window 继续驱动。
  • tray app 最小化行为调整:最小化保留在任务栏,不再直接隐藏到托盘;关闭仍可走托盘隐藏。
  • ESC 不再作为 app 层全局关闭/隐藏快捷键,按键会正常交给 Runtime 和组件处理。
  • Windows 进程 CPU 统计改用 PDH process counter,并按物理核心数归一,debug title 中的 CPU 读数更接近任务管理器。

滚动、输入和文本修复

  • 修复 scrollContentFrom() 在 offset 回到 0 时 transform 变成 identity,导致滚动内容切换 retained layer cache 策略、顶部可能空白或残缺的问题。
  • 实际可滚动内容在接近顶部时保持极小有效 offset,让滚动 transform 路径稳定,不 broad disable retained layer cache。
  • 新增复杂滚动压力测试 fixture,覆盖大量组件混排、滚动、hover 和输入区域的组合场景。
  • input 只有多行且内容确实可内部滚动时才消费滚轮;普通单行 input 或未溢出的多行 input 不会阻断父级 scrollView。
  • 修复 input 在 transformed / scrolled 容器内点击定位不准的问题,交互回调改用 transformed interaction bounds。
  • 修复多行 input 点击后续行时 caret 可能落到第一行尾部的问题。
  • 修复 IME composition 期间 caret 和候选窗口锚点停在组合串开头的问题,现在跟随组合文本末尾。
  • 移除 input hover styling,避免输入框 hover 视觉和外层滚动/交互状态互相干扰。
  • Text 启用 FreeType light hinting,小字号文本在 100% scale 下更清晰。
  • 字体 fallback 修复:默认 UI/icon/emoji/monospace 字体会查系统字体,primary 字体加载失败不会让整个文本栈为空。
  • input 仍默认使用跨平台 monospace;Linux 某些系统缺少旧硬编码等宽字体路径时,会继续走默认 UI 字体和系统 UI 字体兜底。
  • 单 exe 没带 assets 时,普通文本不再因为找不到内置字体而整段不可见;FontAwesome 图标仍建议随发布包带 assets 或显式 .iconFont(...)。

图形和图表

  • 新增独立 Polygon draw path,OpenGL / Vulkan 都不再复用 rounded-rect shader 处理 polygon。
  • Vulkan 增加 polygon vertex/fragment shader 和生成的 SPIR-V header,shader 生成脚本同步更新。
  • Polygon fragment shader 使用 dedicated edge coverage,改善 tooltip arrow、pie slice、chart segment 等图元边缘锯齿。
  • 修复 Vulkan polygon edge buffer offset/count,避免动画或多 polygon 场景中读取错边数据导致图形拆开。
  • LineChart 线段改用 animated capsule polygon segment,折线边缘更平滑。
  • LineChart 新增 LineStyle:linear、curve、step,API 更短,不再需要冗长的 LineChartLineStyle。
  • curve 通过 Catmull-Rom 采样近似,step 使用阶梯 segment,Serial Tool 和 Gallery 都可以切换展示。
  • Serial Tool 的 mock 数据变化改为真实 payload size 变化,图表波动来自实际模拟数据而不是人为抖线。

组件和状态 API

  • 新增 eui::Signal<T> 和 controlled component bind helpers,方便页面状态与组件值做显式双向绑定。
  • 标准化 open state 回调,例如 onOpenChange 和 scroll state id。
  • controlled component 文档补充状态归属、runtime binding 和 signal 用法。
  • Signal 已接入 eui_neo.h,并新增 unit test。
  • 多个组件补充 bind/bindOpen/bindVisible 等受控状态入口:carousel、checkbox、colorPicker、contextMenu、datePicker、dialog、dropdown、input、radio、scroll、scrollView、segmented、sidebar、slider、stepper、switch、tabs、timePicker、toast 等。

Gallery、示例和网站

  • Gallery layout scroll viewport overlap 修复,布局页不再和下方内容重叠。
  • Gallery responsive navbar 稳定化:抽出复用的 components::navbar,Gallery 和 starter app 共用同一套导航组件。
  • 修复 page switch crash:navbar item callback 使用 value capture,避免悬垂引用。
  • Gallery scroll root 改为 wrap-content 测量,多个页面的响应式 grid、row/column breakpoint 和 scroll measurement 更稳定。
  • Gallery 控件视觉微调:checkbox/radio/switch 增加两侧 inset,hover 不再贴边。
  • DatePicker / TimePicker / ColorPicker 的 Done 字体加大。
  • Gallery 按钮示例在窄宽度下保留最小宽度,不再挤压出不自然布局。
  • Gallery 右上 more label 字号加大,icon-only button 居中修复。
  • Gallery About 页面滚动、Animation 页面布局、Controls 页面按钮/图表/选择器区域继续修正。
  • 新增 apps/sidebar_starter 用户 app starter,并用 navbar 替换手写 sidebar start 示例。
  • 新增 apps/masonry_browser,用于验证 retained layer rebuild、静态 rail、async image content 等组合场景。
  • 静态网站更新:内容、docs index、组件列表、预览图显示、Markdown table 渲染和分阶段滚动动效同步当前能力。
  • 网站预览图改为 contain,避免图片两侧显示不全。
  • 删除 stale Slint 对比文档引用,README 和 site docs 卡片对齐当前真实 docs 文件。

构建、集成和调试

  • Debug 构建不再套 release-style optimization、dead stripping、section GC、strip symbol,也不再隐藏警告,方便调试源码和发现问题。
  • MSVC app link options 按配置区分,Debug 保留 incremental linking 和可调试性。
  • Windows public umbrella header 调整 include 顺序,避免 APIENTRY redefinition warning。
  • EUI-NEO 作为 CMake 子目录接入时,会优先复用父项目已有的 GLFW / glad target,避免重复 vendoring。
  • auto dependency mode 下才尝试 package 查找,EUI 自己创建的 target 才参与 install/export。
  • subdirectory usage 默认不安装 EUI 自有依赖,降低父项目集成干扰。
  • build_*/ 和 .github/skills/ 加入 .gitignore。
  • README、README.zh-CN、集成指南、开发与发布文档同步 build/debug/subdirectory/docs path 行为。
  • UI skill 更新:强调用户开发路径是 apps/,补充响应式布局、Flow/scrollView、input wheel、retained cache 等规避建议。

测试和诊断工具

  • 新增 dirty_rects unit test,覆盖多 dirty rect 合并/回退策略。
  • 新增 signal unit test。
  • 新增 input_model unit test,覆盖多行 input 点击定位。
  • 新增 dirty_repaint_complexity_viewer,用于比较 baseline、远处静态内容、重叠静态层、重叠 text-heavy scene 下同一按钮的成本。
  • 新增 shadow_button_gpu_viewer,用于比较普通按钮和 shadow button 的 GPU 计数。
  • 新增 complex_scroll_stress_viewer,用于复杂滚动和组件混排压力测试。
  • 新增 hover_scroll_repro_viewer,用于复现 hover 控件上滚动到边界时的 cache blit/空 dirty frame 闪烁问题。
  • 曾加入 DXGI dirty present probes 用于验证 Windows dirty present 和 bridge 能力,后续已移除,避免保留未成型的平台专用 probe 路径。
  • 开发文档补充 fixture 构建和 CMake GUI 中 EUI_BUILD_TEST_FIXTURES 的说明。

文档同步

  • docs/DSL.md 补充 dirty render diagnostics、retained layer cache、Runtime binding、text fallback、polygon shader、LineChart style 等说明。
  • docs/渲染后端架构.md 补充 dirty repaint、render-cache blit、present、incremental present、retained layer cache、Vulkan/macOS 和 OpenGL/Linux 保守路径说明。
  • 新增 docs/retained_layer_cache.md,记录 retained layer cache 行为、限制和调试计数。
  • docs/组件.md 补充 Signal、input wheel、LineChart style、picker/controls 等新行为。
  • docs/状态.md 补充业务状态、组件私有状态、Runtime 交互状态、渲染缓存状态的分层说明。
  • docs/集成指南.md 补充 CMake 子目录复用依赖、assets/font fallback 和发布包资源建议。
  • docs/开发与发布.md 补充 Debug 构建、fixture、release 和本地验证约定。

验证记录

  • 本地已编译并打开四套 Gallery:
    • GLFW + OpenGL
    • GLFW + Vulkan
    • SDL2 + OpenGL
    • SDL2 + Vulkan
  • 字体 fallback 修复后已验证:
    • cmake --build build --target gallery --config Debug
    • cmake --build build-vulkan --target eui_neo --config Debug
  • 最近四套 Gallery 打开前已重新构建:
    • build-vulkan-gallery --target gallery --config Debug
    • build-sdl2-vcpkg --target gallery --config Debug
    • build-sdl2-vulkan --target gallery --config Debug
  • SDL2 和 Vulkan Debug 构建期间仍可能输出 bundled FreeType 第三方转换 warning;这是第三方源码 warning,不是本次 EUI 项目代码新增 warning。

新增 App 预览

Masonry Browser EUI Starter App
Masonry Browser EUI Starter App

Commit 对照清单

  • 4ada739 perf: retain multiple dirty rects
  • 35e3614 perf: add render diagnostics counters
  • a584896 perf: add dirty-aware cache diagnostics
  • a516a20 docs: explain dirty render diagnostics
  • 7e650ae test: add dxgi dirty present probes
  • 550d4fd perf: add OpenGL dirty cache blits
  • 3b9884d Fix gallery layout scroll viewport overlap
  • df2d472 fix: repaint after window restore
  • f3d2b61 fix: correct Windows process CPU stats
  • f1563a4 perf: prune dirty repaint subtrees
  • d0f6ade test: add dirty repaint complexity viewer
  • 6ef4b31 chore: remove DXGI probes
  • fa29b11 perf: cache runtime traversal metadata
  • a632483 test: scale dirty repaint viewer button
  • e83b250 feat: add signal bindings for controlled components
  • fb29565 perf: add automatic retained layer cache
  • d00a80e perf: tune retained layers and frame pacing
  • e3072b4 fix: stop glfw minimized windows from self-waking
  • 97f155a fix: keep animation frames from over-throttling
  • eb97e78 feat: add vulkan retained layer cache
  • cb6b14b feat: refresh site content and scroll motion
  • edabf91 fix(build): quiet msvc debug warnings
  • 224653c fix: keep tray apps visible when minimized
  • ecb1b6a fix: keep scroll content transform active at top
  • 84e0292 test: add complex scroll stress fixture
  • bffa455 fix: reduce minimized window cpu usage with timeout wait
  • 5b3ee2e fix: add .github/skills/ to .gitignore
  • 1113055 feat: add user app starter and UI skill
  • 4ea9cdd fix: remove input hover styling
  • a756619 fix: sync retained layer rebuild paints
  • b89b6a8 fix: flip retained layer textures in vulkan
  • 8971fd0 fix: blit render cache for empty dirty frames
  • 4e5ea07 fix: correct input caret positioning
  • 6b14ba1 fix: stop escape from closing apps
  • 56f33d7 style: refine gallery control spacing
  • e2a9ce6 feat: add independent polygon shader path
  • 5ac1473 feat: add line chart style modes
  • 54f19d6 fix: enable hinted text rendering
  • 5e06a0e fix(vulkan): stabilize macOS cache presentation
  • 6239752 fix(opengl): use full cache blits on Linux
  • 61f699d fix: reuse parent glfw and glad targets
  • d9a4547 fix: keep debug builds debuggable
  • 46b1d1c fix: stabilize gallery responsive navbar
  • 8387ba2 fix: add runtime font fallbacks

Don't miss a new EUI-NEO release

NewReleases is sending notifications on new releases.