变更记录

2.4.5 · 材质模板

新增 Morden、LiquidGlass、Normal 三个精确参数模板，在每页的 LiquidGlass 设置中直接选择。一次操作更新八项材质和所有数值编辑器，不改配色、字体、圆角、背景或动画。设置布局按窗口宽度换行，保留原有四个预设。新增 MaterialPreset API、MaterialPresets 示例及参数/窗口回归测试。原 native、shader 与六个应用场景源码保持不变。

2.4.4 — 组合场景示例

新增独立的“场景示例”展示分类：外卖点餐、即时聊天、外挂风格客户端、音乐播放、系统设置与虚拟文件管理。使用已有的按钮、卡片、输入、滑块、开关、树、表格、菜单、模态与滚动容器组装，不引入另一套渲染后端。六个场景有独立本地状态，切换页面保留；小窗口按场景堆叠布局并通过滚动访问。

新增 --scene 参数、命令面板场景跳转、七个可单独启动的示例入口，以及 samples 包源码/Javadoc。展示右上角的材质与网格设置继续可用。保留68个原控件类及所有已有示例。

本次没有修改任何 shader、native 或控件核心算法；UI核心中仅更新DesktopWindow版本日志。没有引入支付、网络聊天、真实音频、游戏功能或磁盘文件管理。真实窗口交互、场景模型、布局和原有材质/裁剪回归结果见当前 TEST-REPORT.md，不把模拟场景说成在线服务。

2.4.3 — 边缘光学修复

修复高光过弱、浅色缺少反射对比、色散默认/预设归零，以及强模糊把色散同时抹掉的问题。默认 shine=.82、dispersion=.85；单通道直接按逻辑像素偏移，使用清晰来源的色度差，保留柔化背景。全部材质预设保留非零色散，低反光独立于恢复默认。

保留 68 类控件、现有间距/动画/字体/曲线/圆角内容裁剪、黑白配色与 WGL 后端。新增 OpticsComparison 完整示例和 51 项针对性检查；旧版 500 项检查在更新与默认值相关的三条预期后重新执行。发布 Java 8 和 Java 21 双目标开发包。

2.4.2 — 实时材质设置与网格

• 在所有展示页面右上角接回完整 LiquidGlass 设置；提供可嵌入的 GlassSettingsPanel 和非模态 GlassSettingsDialog。
• sigma、混合比例、折射、高光、色散、tint、不透明度、选中 tint 均绑定实际模型；支持连续拖动与精确横向数值编辑。
• 网格开关实际改变 GPU 背景；旧菜单回调不再只记录日志。背景暂停不跳回零帧。
• 折射由提前硬限幅改为连续的有界响应，解决滑杆后半段不改变像素的问题。
• 切换分类/深浅色保留材质参数；关闭模糊后再次开启恢复上次 sigma。
• 保留 2.4.1 间距/曲线裁剪、字体、AA、动画与默认低反光材质；native 协议 24164 和 WGL 代码未改动。
• 增加 MaterialControls 完整示例及新的模型、实际窗口和 GPU 回读测试。

2.4.1 — 列表间距和圆角裁剪修复

• Sidebar 默认移除重复底板；ListBox 增加 glass 开关与共享 padding/行范围接口。
• 列表左右/首尾留白一致，滚动条通道只在溢出时占位，GridView 同步修正旧硬编码间距。
• Panel 子内容采用与表面相同的圆角/四角贝塞尔裁剪；文字和所有内置图元均受约束。
• 新增成对 pushShapeClip/popShapeClip，32 层交集、异常校验；宿主不需要 stencil 附件。
• 修复动画错误缩放继承 viewport 的问题；列表、树、表格和滚动视图作用域能正确恢复。
• 展示页面不再重复增加末尾空白高度；短内容不产生假滚动条。
• 两个 Java 目标和 native 同步构建，协议 24164；原有材质、字体、抗锯齿、配色和动效保留。

2.4.0

在真实 2.3 SDK 上修改，保留 68 类控件、现有事件、布局、WGL 修复、黑白低反光材质、模糊强度、横向微调器和动画，不是另做一个只有展示的替代项目。

新增全局 OFF / ANALYTIC / HIGH AA；新增目标 DPI 原生字形缓存、真实单通道 SDF 字体路径、像素起点/基线对齐、字体配置和 tracking；普通控件改为四角独立三次贝塞尔距离轮廓，圆形控件默认仍为圆形；新增主题颜色 setter、高光和边缘阴影 shader 颜色。

新增第九个“绘制与配色”展示页、三个完整示例、新 API/距离场/GPU/真实窗口测试。Windows native 指令和 shader uniform 桥接随功能更新，WGL context 生命周期平台文件保持不变。

Java 8 / Java 21 双目标一同构建和交付，分别为 class major 52 / 65。公开 API 和源码一致，不增加虚构的独立 JDK 21 线程或 record 优化。

没有引入 MSDF、全功能文本 shaping、任意路径 hit testing 或 Apple 官方实现；具体算法与限制在文档中明确列出。