# Ripple 1.2 · 动态标识

## 故事

一滴落进水面：图形先聚成一点，再从偏心留白处打开；三圈涟漪散开，字标一笔一笔写成，然后安静下来。名字「Ripple / 回环」就是动作本身。

## 部件

`tools/build-motion.py` 把母版拆成可以单独运动、终态仍是母版的部件：

| 部件 | class | 说明 |
| --- | --- | --- |
| 轮廓 | `.rpl__symbol` | 以留白中心为原点等比缩放（`transform-origin: 48.6% 53.4%`） |
| 留白 | `.rpl__counter` | 作为 mask 里的黑色路径缩放，镂空始终是真透明 |
| 涟漪 | `.rpl__ring--0..2` | 以留白中心为圆心的三个圆，`non-scaling-stroke` |
| 字标 | `.rpl__glyph` ×6 | `pathLength=1` 的描边，按 dash 写出 |

## 时间线（Signature，1600 ms）

| 进度 | 动作 |
| --- | --- |
| 0–14% | 图形从 0.2 倍浮现 |
| 14–38% | 放大到 1.06（越过一点） |
| 16–80% | 留白打开：0 → 1.08 → 0.97 → 1 |
| 16–92% | 三圈涟漪依次散开（间隔 10%，0.22 → 1.55 倍，透明度 0.55 递减） |
| 40–92% | 六笔字标依次写出（间隔 4.5%，每笔 30%） |
| 72–100% | 静止，回到母版 |

缓动：`out (.22,1,.36,1)`，`in-out (.65,0,.35,1)`，`draw (.45,0,.2,1)`，`ring (.1,.6,.3,1)`。

## 其他动作

- **Reveal 760 ms**：0.82 → 1.025 → 1，留白 0.5 → 1，一圈涟漪，字标快速写出。
- **Feedback 560 ms**：留白 1 → 0.86 → 1，一圈涟漪。主动画播放中不打断。
- **Pending 1800 ms 循环**：图形静止，三圈涟漪错开三分之一周期。
- **Resolve 560 ms**：图形 1.03 → 1，留白 0.9 → 1，一圈涟漪散去。

## 接入

```html
<link rel="stylesheet" href="brand-system/motion/ripple-motion.css">
<script src="brand-system/motion/ripple-motion.js" defer></script>
<a class="rpl-trigger" href="/"><span data-ripple-logo="lockup" data-ripple-motion="signature" data-ripple-trigger="visible">…内联 lockup-static.svg…</span></a>
```

- `data-ripple-logo="mark|lockup"`：自动挂载；内联静态 SVG 可在无 JS 时显示。
- `data-ripple-trigger="visible"`：第一次进入视口时播放 `data-ripple-motion`。
- 外层 `.rpl-trigger`：悬停时播放 Feedback。
- `data-ripple-tone="white|ink|blue"`，或 CSS 变量 `--ripple-color`、`--ripple-word`。

```js
const c = NotelyRipple.mount(el);
c.play('signature'); c.play('pending'); c.stop();
c.seek(0.5); c.setPlaybackRate(0.5); c.setReducedMotion(true); c.destroy();
NotelyRipple.plan('signature');          // 轨道与关键帧，供其他渲染器使用
NotelyRipple.setBackdropProgress(el, p); // 辅助图形随滚动延展
```

每个控制器会给自己的 mask 换唯一 id，同一页面放多个 Logo 不冲突。离屏和后台暂停；系统「减弱动态效果」时只做 160 ms 透明度变化。

## 其他渲染器

宣传片（`video/`）用 `motion/geometry.json` 和同一组时间参数在 Remotion 里逐帧绘制，所以片头片尾与官网的 Logo 动作一致。
