Surf commited on
Commit
b33d80e
·
1 Parent(s): 964f3df

文档:先行写入艺术字幕改造计划(推送 #10)

Browse files
Files changed (1) hide show
  1. README.md +64 -0
README.md CHANGED
@@ -8,6 +8,70 @@ app_file: index.html
8
  pinned: false
9
  ---
10
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
11
  # 奥德彪语录 · 极简版(v2)
12
 
13
  > 根据反馈改版:**只用原片《奥德彪.MP4》,只加语录字幕与配音**,追求简洁、克制的高级感。
 
8
  pinned: false
9
  ---
10
 
11
+ # 奥德彪语录 · 艺术字幕改造(v3)
12
+
13
+ > **本次需求:让语录字幕从“底部白字”升级为有设计、有节奏、有艺术性的电影字幕。**
14
+ >
15
+ > 按监督要求,以下计划、设计大纲、实施步骤、技术做法与验收标准在动工前写入本 README;每完成一个大动作即提交并同步到 Hugging Face Space。
16
+
17
+ ## v3 实现计划(先计划,后改代码)
18
+
19
+ ### 目标
20
+
21
+ 1. 保留原片、配音、英文译文、MP4 导出与合集能力,不改变现有内容资产与导出链路。
22
+ 2. 把中文语录字幕做成“编辑设计”:层级清楚、节奏有变化、与画面融合,不再是单一的底部居中白字。
23
+ 3. 让播放端与导出端共用同一套 `drawFilmFrame()` 渲染逻辑,确保所见即所得。
24
+ 4. 横屏与竖屏都具备安全区、可读性、无越界;弱网/无 WebGL 时仍能看到字幕。
25
+
26
+ ### 视觉大纲:四种字幕状态
27
+
28
+ | 状态 | 视觉语言 | 适用时机 |
29
+ |------|----------|----------|
30
+ | **引子 / chapter card** | 左侧竖线、编号、章节名、英文小标题;细衬线与等宽数字形成编辑感 | 片头 0–1.2 秒 |
31
+ | **叙事 / editorial subtitle** | 左下网格排版、中文主句 + 细英文副标题;金色关键词标记,按分句淡入 | 普通语句 |
32
+ | **金句 / quote lockup** | 金色细框、超大引号、关键词放大与轻微错位;不使用厚重色块 | 最后一分句或带关键词的句子 |
33
+ | **余韵 / afterglow** | 中文收束后,英文译文像片尾字幕一样延迟浮现;底部细线与编号收尾 | 配音结束后 |
34
+
35
+ **统一艺术方向:** 炭黑、暖白、香蕉金三色;思源宋体负责中文重量,Cormorant Garamond 负责英文呼吸感,Space Mono 负责编号与时间感。字幕不再“压住画面”,而是用留白、细线、字号对比、逐字落版制造高级感。
36
+
37
+ ### 技术方案
38
+
39
+ - 在 `src/film/core/renderer.ts` 重写字幕层:增加 `drawEditorialRule`、`drawQuoteMark`、`drawKeywordHighlight`、`drawTrackedText` 等小型绘制函数。
40
+ - 在 `src/film/core/film.ts` 为字符和分句补充 `key` / `isLastClause` 等视觉状态;关键字来自标点分句与语录关键词,不修改原文。
41
+ - 在 `src/film/core/typo.ts` 扩展安全排版工具:测量字宽、按安全区缩放、处理中英文混排与竖屏布局。
42
+ - 通过时间函数驱动所有动画:章节卡淡入、分句错峰、金句细框绘制、英文余韵延迟;不引入随机状态,播放和导出帧帧一致。
43
+ - 只用现有字体与原片,不新增版权素材;WebGL 后期保持克制,避免字幕被颗粒/暗角吞掉。
44
+ - 在 `src/film/core/renderer.ts` 增加横/竖屏与长短语录的边界保护;必要时让布局降级到安全的两行排版。
45
+ - 由于仓库只提交静态产物,完成源码后用 Vite/esbuild 重新构建 `assets/`,并用 `git diff --check`、TypeScript 构建、静态文件引用检查做验收。
46
+
47
+ ### 实施步骤与同步节点
48
+
49
+ | 节点 | 大动作 | 具体工作 | 同步方式 |
50
+ |------|--------|----------|----------|
51
+ | **#10** | 计划 | 本节写入 README,明确视觉系统、技术路径、验收标准 | 先提交并推送,再开始编码 |
52
+ | **#11** | 字幕视觉系统 | 重写排版与动画:章节卡、编辑式字幕、关键词层级、金句框、英文余韵 | 完成后提交并推送 |
53
+ | **#12** | 播放与导出接线 | 检查 `Player` / `Exporter` 共用渲染函数;修复横竖屏、合集、淡入淡出 | 完成后提交并推送 |
54
+ | **#13** | 构建与质检 | 安装临时构建依赖、生成静态 bundle;做类型/语法/资源/边界检查,更新使用说明 | 完成后提交并推送 |
55
+ | **#14** | 终检成品 | 复核改造前后差异、确认工作区干净、记录已知限制与最终效果 | 最终提交并推送 |
56
+
57
+ ### 验收标准
58
+
59
+ - 字幕不再只有单一的“底部白字”样式;至少同时具备编号层、中文层、英文层、金句层四个视觉层级。
60
+ - 关键字有明确但克制的金色强调;普通分句与最后金句的动画节奏可区分。
61
+ - 16:9、9:16、单条与合集均通过布局边界检查;长句不会越出安全区。
62
+ - 播放器可见字幕与本地 MP4 导出字幕一致;已有配音、背景音乐开关、封面、文案功能不回归。
63
+ - 每个大动作均有独立 commit,并推送到 `Ethscriptions/tz`。
64
+
65
+ ### v3 过程日志(本次改造)
66
+
67
+ - [x] **#10 计划**:完成本节 README,尚未改动渲染代码。
68
+ - [ ] **#11 字幕视觉系统**:待实施。
69
+ - [ ] **#12 播放与导出接线**:待实施。
70
+ - [ ] **#13 构建与质检**:待实施。
71
+ - [ ] **#14 终检成品**:待实施。
72
+
73
+ ---
74
+
75
  # 奥德彪语录 · 极简版(v2)
76
 
77
  > 根据反馈改版:**只用原片《奥德彪.MP4》,只加语录字幕与配音**,追求简洁、克制的高级感。