Repository navigation
Releases: jwu/vgpu-render
Release list
v0.3.1
维护版本：侧栏示例分组支持折叠，并移除 2D 矩阵页画布内的标题文字。引擎 API 无变更。
当前仍为 partial parity：与参考实现的视觉对照状态见 docs/reference-parity.md，不代表像素级等价。
新功能
- 侧栏示例分组支持折叠
重构与性能
- 去掉 2D 矩阵页画布内的标题文字
包含内容
vgpu-render-0.3.1-dist.tar.gz：bun run build:lib产物（dist/的 JS 与.d.ts，归档根部即dist/内容），已按发布规则清洗品牌词。- 源码：https://github.com/jwu/vgpu-render/tree/v0.3.1
v0.3.0
本版重做 2D 图元 API：按 3D 的命名把图元拆成「默认 / _d（虚线）/ _s（填充）」三态，由方法名决定虚实与填充；2D 网格支持 rotation、skew 与 outer 边界，并新增 Arrows 页面与逐 shape 示例页。
当前仍为 partial parity：与参考实现的视觉对照状态见 docs/reference-parity.md，不代表像素级等价。
Breaking：
FrameDrawList2D不再用options.fill/options.dash切换填充与虚线，改用方法名。shape（rect/rect_r/circle/ellipse/arc/annulus/capsule/polygon/triangle/rhombus/sector/segment）与线（line/ray/lineStrip/polyline/lineLoop/grid）各有_d变体，shape 另有_s；箭头为arrow（开放 V 头）/arrow_s（实心三角头）/arrow_d/arrow_s_d。
新功能
- 2D 图元按「默认 /
_d/_s」拆分，_d沿周长做弧长参数化（ellipse 用 Simpson 积分近似） - 新增
Curve2D、sampleCurve2D、placeCurvePoint2D与curve/curve_d - 2D
grid接受Grid2DOptions：逆时针 rotation、x/y skew、outer x/y 边界；与 3DgridLines共用 cells/skew/outer 语义 - 新增 2D Arrows 页面，统一 filled / line 两种头型
- 按 3D grid 参数表重做 2d-grid 页面
- 2D WASD 平移支持 Shift 加速
修复
- 修正
sd_sector补集楔形把圆盘半径混入、导致 arc / sector 缺口被绘制的问题 - rounded-rect 的右侧直边基址补上一个圆角弧长
- 2D axes 配色改用 x 红、y 绿
- 2D filled 箭头简化为纯三角形
重构与性能
- 2d-shapes / 2d-fill / 2d-outlines 由 12 个逐 shape 页替代，2d-gizmos 改为 2d-index 索引网格；矩阵页统一「normal 列在前、
_d、_s」 - 形状页各自持有绘制循环
文档
- 同步 2D 图元变体与页面布局说明
包含内容
vgpu-render-0.3.0-dist.tar.gz：bun run build:lib产物（dist/的 JS 与.d.ts，归档根部即dist/内容），已按发布规则清洗品牌词。- 源码：https://github.com/jwu/vgpu-render/tree/v0.3.0
v0.2.0
本版将仓库拆分为引擎 src/、示例 examples/、浏览器壳层 gallery/ 三层，库入口只导出引擎公共 API；2D 示例改为按 API 家族的矩阵页，文本渲染增加多字体面与自定义平面朝向。
当前仍为 partial parity：与参考实现的视觉对照状态见 docs/reference-parity.md，不代表像素级等价。
Breaking：npm 包内容只含引擎（
src/→dist/），示例与 gallery 不再随包分发。原本从包内导入示例、场景或 gallery 模块的代码，请改用 examples/ 中的实现，或直接使用src/index.ts暴露的引擎 API。
新功能
- 文本渲染支持 weight / style / width 字体面
- world-plane 文本块支持自定义平面朝向
- 2D 示例拆成按 API 家族的矩阵页
- 2D Lines 页补齐 strip / loop 的虚线列，并展示闭合 loop 接头
- 2D Lines 的虚线随时间的流动
- 新增 text-font-query 页面，接入真实多字重字体
- 2D 页面支持 WASD 平移
- 3D 示例补上参考的列/行标签，增强 index 与 world_space_width 的 line_list 样例
修复
- 屏幕空间命令按 CSS 像素换算
重构与性能
- 分离引擎、示例与 gallery 层，公共 API 收敛到
src/index.ts
文档
- 记录 3D 列/行标签已对齐及其残差
包含内容
vgpu-render-0.2.0-dist.tar.gz：bun run build:lib产物（dist/的 JS 与.d.ts，归档根部即dist/内容），已按发布规则清洗品牌词。- 源码：https://github.com/jwu/vgpu-render/tree/v0.2.0
v0.1.0
vgpu-render 的首个公开版本：基于 WebGPU 的 3D/2D debug-draw 渲染层，提供录制式帧命令 API、实例化 GPU 管线与示例 gallery。
当前为 partial parity：与参考实现的视觉对照状态见 docs/reference-parity.md，不代表像素级等价。
新功能
- 2D 示例分组、相机控件与网格面板
- 增加 2D 绘制层、SDF 形状与无限网格
- 右键自由飞行按住 shift 冲刺
- 显示配置按样例存储
- 控制侧栏分三组可折叠，重做滚动与分组配色
- 2D 文本示例拆成六页，相机预设改为 gallery / 斜 45° / 正 45°
- 默认源按屏幕尺寸取档，补 CJK 断行与图集降级
- alpha 携带真距离并支持逐块描边
- atlas 多页、页面回收与增量上传
- 文字对比矩阵与屏幕空间 HUD 示例
- 文字渲染，含 bitmap/sdf/msdf 三种 atlas 编码
- 参考法向、形状线框移植与相机速度模型
- 补齐 curve 构造区控制点标记
- 按参考移植 round/bevel/miter 接头几何
- 改用线性离屏渲染并编码输出 sRGB
- 页面文案中文化并放宽控制面板间距
- 接入参考网格参数并在面板暴露
- 按参考实现重写 InfiniteGrid3D
- rebuild gallery chrome with base-ui + shadcn
- add joint controls sidebar
- initialize vgpu debug draw renderer and visual parity baselines
修复
- 在构建期清洗预览源码，避免规则本身泄漏品牌
- 修正 capture 脚本的浏览器解析与 ozone 参数
- 按 bevy 对齐换行、行高与块尺寸语义
- mip 在覆盖率域下采样，并修正烘焙切片宽度
- 距离场边缘过渡还原为整像素，msdf 源支持超采样
- 用精确形状距离校正 MSDF median
- 修正侧栏横向溢出与滚动条样式，补齐 index 源码预览
- 补齐布局修正遗漏的实现、清单、测试与文档
- enable 4x MSAA
- implement ghost camera controls
- 反转中键平移上下方向
- 反转中键平移方向
重构与性能
- 中性化示例场景命名并清理对外演示文案
- 文字示例收敛为 text-compare 与 text-hud
- 全部场景重写回参考布局并修正列结构
- show direct gizmo API examples
文档
- 中性化 README 品牌叙述并重命名 parity 文档
- 记录 2D 绘制层、2D 无限网格与 bevy 2D 对照
- 补充 gallery 演示链接
- 记录对比复现前提与已知缺口
- 加入 Godot / vgpu 的裁剪并排对比图
- 记录文字渲染的编码、抗锯齿与已知取舍
- 记录速度模型、逐顶点法向与列基向量修正
- 记录 infinite grid 移植范围与残差
构建、测试与工具链
- 增加 npm 库构建与发布配置
- 生产构建切换到项目页基路径
- 加入以 bevy 为参照的文字布局对照
- 添加 GitHub Pages 自动部署工作流
- 参考产物整体移出版本控制
- 视觉基线截图移出版本控制
- 以本机环境重捕获 circle/line 基线并记录捕获条件
- 重新烘焙 MSDF atlas 以携带真距离
- drop the per-example parity label
- refresh examples gallery
包含内容
vgpu-render-0.1.0-dist.tar.gz：bun run build:lib产物（dist/，含 JS 与 .d.ts），已按发布规则清洗品牌词。- 源码：https://github.com/jwu/vgpu-render/tree/v0.1.0