模板:CGSSCardSpine/doc

用法

{{CGSSCardSpine|100612}}

模板本体只有一行 —— 输出一个 class 为 `cgss-card` 的 div（内含一个 `.cgss-status` 占位）， 由 `MediaWiki:Gadget-CGSSCardSpine.js` 找到并渲染。

• • 不要在这个 div 里或后面直接加空行**：MediaWiki 遇到空行会结束 HTML 块，其后的标签会被转义成

纯文本显示给读者（`wiki/conn-test.html` 第一次贴上去就是这样）。要加说明文字，放在本 `/doc` 子页或整段 HTML 之后另起一段。

• 只有一个位置参数：卡牌 id（对应游戏资源里的 `SP3S<id>`）。资源缺失时该处显示一行提示，不会报错。

可选参数：

参数	默认	说明
`时间`	0	起始时间（秒），0–8 之间；配合 `播放=0` 用来出静态帧
`时长`	自动	单次循环秒数。**默认留空**：加载器读卡片 manifest 里的 `duration`，那是各层时长的最小公倍数（100612 是 8 秒，101313 是 16 秒），保证没有哪一层被从中间截断。只有想给单个实例改节奏时才填
`播放`	1	`0` = 只画一帧不循环
`取景`	cover	`cover` = 背景铺满整个画幅（与官方卡面一致）；`contain` = 完整放下背景，左右留黑边
`缩放`	自动	画布倍率，0.5–2；默认按 **设备像素比** 自动取（手机 2 倍屏更清晰）
`粒子淡出`	0–0.99 或 `off`。**默认 `off` = 不动资源的透明度曲线**（游戏的做法：羽毛几乎全程实心，最后约 15% 寿命才化掉）。填 0–0.99 会把渐隐提前到寿命的那个位置开始——那是**偏离游戏**的做法，除非你就是想要更早变虚
`粒子寿命`	1.5	粒子存活时间的倍率。1.5 表示比资源标注的寿命长一半，大羽毛因此能飘出画面；调小会让粒子更快消失
`粒子密度`	1	每秒生成数量的倍率。**1 = 资源里写的原始速率（和游戏一致）**，默认不动它；`0` 可以完全关掉新粒子（只剩第一帧已经生成的那些），用来确认"你看到的确实是这一层"
`版本`	空	追加到资源 URL 的查询串；资源换过一版之后填个新值以绕过浏览器缓存
`命名空间`	自动	数据页所在命名空间。**默认留空即可**：脚本会依次尝试 `MediaWiki:` 与 `Data:`，取能读到 manifest.json 的那个

说明

画幅 750×483，8 秒循环。渲染器是官方 Spine 3.6 的 WebGL 实现，图层顺序 `bg → eff2 → chara → eff1 → fg`，羽毛与光点是按 Unity ParticleSystem 参数重放的粒子层。

依赖两个 gadget（见 `MediaWiki:Gadgets-definition`）：引擎 `CGSSCardSpine-lib` 与引导 `CGSSCardSpine`，后者通过 `dependencies=ext.gadget.CGSSCardSpine-lib` 保证顺序。

数据页在 `MediaWiki:SP3S<id>/…` 下，贴图在 `File:` 下。