Skip to content

feat: 轨迹压缩通道化,x/y/自转独立分段(CSS 产物体积 -16~27%) - #32

Merged
flycran merged 10 commits into
mainfrom
worktree/channel-trajectory
Nov 5, 2026
Merged

flycran merged 10 commits into
mainfrom
worktree/channel-trajectory

Conversation

@flycran

@flycran flycran commented Nov 4, 2026 •

Copy link
Copy Markdown
Owner

摘要

轨迹压缩改为通道化架构:x、y、自转各自独立分段。CSS 引擎按通道生成动画,产物体积较 main 缩小 16~27%;SMIL 产物与 main 逐字节一致。

变更

  • 数据结构:Trajectory 由点数组改为标量通道 { x, y, rotation? },每个通道持有独立的关键帧与 span 时间轴;CSS 引擎可以按通道独立插值
  • 压缩算法:DP/RDP/Greedy 抽取为通道无关的分段骨架;x、y 各自按单轴容差压缩,自转按角度误差独立压缩。快速自转不再迫使位置通道加密
  • CSS 引擎:每方块三套 @Keyframes(g{N}x / g{N}y / g{N}r),恒定通道折叠为静态变量并把动画名置为 none(避免未定义 var() 使整条 animation 声明失效);自定义 animation 值按通道复制,var(--n) 替换为各轴动画名变量
  • SMIL 引擎:translate 消费联合位置表达(欧氏容差,帧数最少),rotate 使用自转通道自己的 keyTimes。分轴折点错开时联合表达比并集重采样少帧,因此 SMIL 不回退
  • 修复:channelTimeline 首帧 span 错位导致 keyTimes 整体左移一格(旧实现同样存在,新测试暴露)
  • 合并 main:接受 refactor: gensvg 改用 @kitajs/html JSX 模板 #31 的 JSX 模板改造(三通道逻辑移植到 gensvg.tsx)、calendarList 调试参数、#b>* 播放器选择器

体积(真实数据 Orta,361 方块,对比 main)

产物 main 本 PR 变化
圆形 SMIL 227848 227848 逐字节一致
方形 SMIL 385797 306173 -20.6%
圆形 CSS 274485 229675 -16.3%
方形 CSS 360330 264211 -26.7%

圆形 SMIL 哈希一致,说明 SMIL 路径零回退;方形 SMIL 的收益全部来自自转通道分离。

动画效果对比(同数据逐帧采样):圆形两版完全一致;方形位置偏差最大 0.5 SVG 单位(= 容差承诺)、角度最大 3°(= 自转误差上界),肉眼不可辨。

容差语义

  • CSS 引擎:每轴插值偏差 ≤ compression-tolerance
  • SMIL 引擎:合成位移(欧氏)≤ compression-tolerance,与旧行为一致

README 双语与 action.yml 的输入描述已同步更新。

- Trajectory 由点数组改为通道结构:position 与 rotation 各自持有
  关键帧序列与 span 时间轴,为后续 x/y 拆分预留骨架
- DP/RDP/Greedy 抽取为通道无关的分段骨架,位置/标量通道各挂度量
  独立压缩,旋转剧变不再迫使位置加密,旋转恒定时收缩为两帧
- SMIL translate/rotate 各用自己的 keyTimes;CSS 引擎压缩旋转走
  独立 @Keyframes,恒定旋转折叠为静态变量,未压缩时保持单 keyframes
- 等量数据下 SMIL 输出缩小约 22%,CSS 约 14%
- Trajectory 的 x、y 各成标量通道,与自转一起按各自容差独立分段;
  CSS 引擎按通道生成 keyframes,恒定通道折叠为静态变量(--nx:none)
- 分轴折点错开时并集帧数会多于联合帧,SMIL 改用联合位置表达
  (joint,欧氏容差),产物与旧版逐字节一致,不回退
- 修复恒定通道未绑定动画名导致整条 animation 声明失效的 bug
- 修复 channelTimeline 首帧 span 错位(keyTimes 整体左移一格)
- 真实数据实测:圆形 SMIL 一致、方形 SMIL -21%、
  圆形 CSS -16%、方形 CSS -25%
- gensvg 已由模板字符串改为 @kitajs/html JSX(renderSmilBlocks /
  renderCssBlocks 双引擎),旧 gensvg.ts 删除,三通道消费逻辑按新结构重写
- CSS 引擎沿用 class 绑定(.g{index})与几何/fill 公共规则,原 --n
  单动画名改为 --nx/--ny/--nr 三通道,恒定通道绑定 none
- SMIL 引擎 translate 用联合位置表达、rotate 用自转通道自己的 keyTimes
- 接受 main 的 calendarList 调试参数、#b>* 播放器选择器与测试基建
- 合并集成测试并更新通道断言(新增折叠、自转通道、按通道切换 animation 用例)
- 真实数据复测:圆形 SMIL 与 main 逐字节一致,方形 SMIL -20.6%、
  圆形 CSS -16.3%、方形 CSS -26.7%
- 新增 RawTrajectory:记录端逐帧 push 数值,不再每采样分配 {value} 对象
- joint 压缩改收 x/y 两条数值序列,不必为两轴配对分配对象
- 未压缩调试路径统一包装为无 span 关键帧,消费端类型保持单一
- 产物与改动前逐字节一致(四种引擎/形状组合哈希全同)
- Node 实测:方形 SMIL -13.3%,圆形 SMIL -5.2%,CSS 引擎 -8~9%
@flycran
flycran merged commit 95c7309 into main Nov 5, 2026
4 checks passed
@flycran
flycran deleted the worktree/channel-trajectory branch November 5, 2026 01:37
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.

1 participant