Shuery
eb56efbd9e
取景（issue 04） - 新增 viewport-fitter.js：让立绘层缩放跟随背景图的 cover 缩放——背景放大多少倍、 特效就放大多少倍。原先背景走 cover、立绘层走 contain，比例一变两者就分叉。 16:9 下与作者设定逐像素一致（kv37 为 0 差异）。实测证伪了"contain 会裁掉作者视口" 这个最初的判断：contain 在任何比例下都完整含住作者视口。 - 应用方式为原地改写 config.viewport 字段后调 setViewport()，不重建播放器； 维护挂在 config.frame 上按画布比例增量进行（config.success 早于 setViewport，拿不到视口）。 WE 属性（issue 05） - project.json 新增 bgm combo（所有壁纸音源的并集 + 「随预设」）；所选项不属于当前壁纸时 音频回落该壁纸默认，选择本身保留。 - fps 限流包裹实例 drawFrame 并接管排程。修掉两个实测缺陷：朴素丢帧会把 rAF 抖动放大成 整拍丢失（目标 30fps 实测只有 22.5fps）；fps:0 被真值判断吞掉导致无法取消限流。 打包（issue 06） - project.json version 升至 3 并更新描述；preset 的 combo 取值保持 xilian/kv37 不变。 - preview.gif 821 KB → 347 KB（每 2 帧取 1 帧 + 128 色不抖动，逐帧与源帧像素完全相同）。 - index.html 加内联 favicon，消除 CEF 自动请求 /favicon.ico 造成的 404 报错。 其它 - dist/scripts/wallpaper-engine.js 移到 tools/：它没有任何入口引用，且环境判据依赖真实 WE 并不存在的 wallpaperRegisterListener，一旦按它自己的说明挂进 index.html 会在生产环境自我激活。 - 修正死文件检查：原检查会拿文件名匹配到文件自身的内容，使这类文件漏网。 - 新增离线算式验证与 resize / 属性 / 全量验收三套浏览器测试脚本。
37 lines
2.2 KiB
Markdown
37 lines
2.2 KiB
Markdown
# 立绘层取景跟随背景图的 cover 缩放
|
||
|
||
立绘层（spine 特效层）的可见世界矩形不再按"含住作者视口"（contain）映射，
|
||
而是让它与背景图 `background-size: cover` 的缩放**同步**：背景放大多少倍，立绘层就放大多少倍。
|
||
|
||
## 问题
|
||
|
||
背景走 CSS `cover`（铺满、按需裁切），立绘层走播放器自带的 contain 映射。
|
||
两者只在作者调参的那个比例下一致，比例一变缩放就分叉。以 1080×1920 竖屏为例，
|
||
背景被放大约 1.78 倍，立绘层的世界高度却纹丝不动——特效与背景插画脱节。
|
||
|
||
需要说明的是：contain 本身**不会**裁掉作者视口。可见矩形是宽高比等于画布、
|
||
且恰好含住作者视口的最小矩形，所以作者视口在任何比例下都完整可见。
|
||
"负内边距在其它比例下会裁掉主体"这个最初的判断经实测证伪。
|
||
|
||
## 决定
|
||
|
||
- 参考比例取 `16/9`。该比例下取景与作者设定**逐像素一致**，保证已发布的观感不被改动。
|
||
- 其它比例：`V.h = V0.h × coverScale(参考比例) / coverScale(当前比例)`，中心不变，
|
||
其中 `V0` 是作者视口换算到参考比例后的可见矩形。等价于"立绘层相对背景插画永远 cover"。
|
||
- 应用方式是原地改写 `config.viewport` 字段后调 `player.setViewport(动画名)`，
|
||
绝不整体替换该对象：`setViewport()` 会无条件读 `config.viewport.animations[name]`，
|
||
换掉整个对象会在 `spine-player.js` 第 14973 行崩溃。
|
||
- 维护时机挂在 `config.frame` 回调（每帧相机计算之前），以画布比例作键。
|
||
`config.success` 不可用：它在 `setViewport` 之前触发，那时 `currentViewport` 还不存在。
|
||
- 预设可声明 `framing: "author"` 退回 contain 行为。
|
||
|
||
## 代价
|
||
|
||
21:9 与 9:16 下立绘层的可见范围会明显收窄（竖屏约收窄到 1/4 宽度），
|
||
因为要让特效跟着被放大 1.78 倍的背景走。这是刻意的：不这样做，特效就会与背景插画对不上。
|
||
16:9 不受影响。若某档壁纸不适合这个策略，用 `framing: "author"` 单独退回。
|
||
|
||
## 背景图比例从哪来
|
||
|
||
运行时读图片的 `naturalWidth / naturalHeight`，不在预设里重复写一个容易写错的数字。
|