# 海上渔火 · 动态图画与制作手记

本站入口 `/boat-fire/`，从「造物手记 → 制作海上渔火」进入。参考互动珠帘画 `/poem/` 的深色画框与翻页阅读方式，包含一屏动态画作和七页制作手记。当前版本保留已调好的冷白碎浪、1.7 倍粗细和降低约 36% 的水滴起跳高度。

## 使用

- `index.html`：赏画与制作手记。滚动、触屏纵向滑动、方向键、空格、Page Up/Down、底部按钮均可翻页。
- `artwork.html`：独立离线动画。图片、Three.js 与许可证均内嵌，双击即可运行。
- `boat-fire-source.zip`：本目录完整源码、单页动画与预览；解压后可直接使用。

本站页在阅读其他页或标签隐藏时暂停画作；回来后继续。系统启用「减少动态效果」时默认暂停，可以按「播放画面」主动观看。全屏功能由浏览器提供，不支持时隐藏按钮。

## 制作方法与技术栈

1. **定位原图**：以 1536 × 864 的 JPEG 为底图，在原图像素坐标中标记船体、柴火和八处船边水线。
2. **叠加火焰**：用 Three.js r160 / WebGL 搭建正交场景。GLSL 噪声驱动透明火焰，另叠光晕和上升火星。
3. **驱动海浪**：叠加四组不同方向的 Gerstner 波，波长为 18、7、3.2、1.4 米。GPU 将波场投影为背景纹理重采样，保留天空主体。
4. **连接船和火**：CPU 使用同一波场，在船底中心与左右两侧采样，得到升降和平移、倾斜。火焰、光晕与火星在同一个船体组中变换，避免滑离柴火。
5. **触发碎浪**：比较水线与海面相对位置、上升速度，撞击时喷发。水线跟随速度转向，端部带水滴，重力让其落下；断裂泡沫贴水展开、淡出。当前水滴起跳速度为前版的 80%，同等重力下最高点约为前版的 64%。
6. **等比装框**：所有图层共用原图坐标，由 ResizeObserver 跟随画框尺寸缩放。HTML/CSS 负责 16:9 画框、分页教程和手机布局。
7. **离线打包**：Python 标准库把 JPEG 转成 data URI，并将 Three.js 和许可证写入 HTML，避免 file:// 背景加载限制；网站构建复制完整目录。

这是 **Gerstner 波场驱动的 2.5D 照片动效**，并未重建完整的三维海洋或几何遮挡。原图已包含静态火焰与反光，动态火焰是在原有位置叠加。

## 文件与维护

`public/boat-fire/` 是唯一维护目录，不依赖先前 Codex 输出目录、`/mnt/data`、外部 CDN 或本地服务器端口。

- `index.html`：制作手记的正文、样式与翻页/播放控制。
- `page.template.html`：动态画作源码模板。直接打开会显示进入完整动画的按钮。
- `generate.py`：生成 `artwork.html` 与 `boat-fire-source.zip`。
- `assets/boat.jpg`：原始背景照片。
- `vendor/`：Three.js 和两份 MIT 许可证。
- `SOURCES.md`：Gerstner 波公式与开源出处。
- `preview.png`、`motion-preview.mp4`：实际浏览器预览。
- `验证记录.txt`：原动效迭代与迁移验证记录。

修改模板、教程或素材后，在仓库根目录运行：

```sh
python3 public/boat-fire/generate.py
node scripts/build-site.mjs
python3 -m http.server 18784 --bind 127.0.0.1 --directory dist
```

访问 `http://127.0.0.1:18784/boat-fire/`。`dist/boat-fire/` 是生成的发布副本，不要直接编辑。

模板支持 `?embed=1`，用于教程页画框内展示。父页通过消息控制暂停与恢复，子页只接收父窗口消息。独立打开时保留原来的居中画框。站点版仅增加嵌入、播放控制和暂停期间的时间处理，波场、火焰、碎浪造型参数保持迁移前版本。

出处和许可证见 [SOURCES.md](SOURCES.md)。
