SuperAPI AI 工具集

camera-3d-captions

通用与其它

查看项目

更新于 10-15 22:13

技能介绍

用途:把 After Effects 式的 3D 相机字幕(3D 相机、景深、路径文字、15fps 海报化、动态模糊)重建为 HyperFrames 的逐帧确定性绘制。适用于静态机位的口播素材(虚拟人或真人)、横屏、中景或更宽、单段 5–20 秒,让文字在说话人周围产生纵深表演。不适用于普通字幕、移动或手持机位、极端特写,以及人像抠像模型无法分离的主体。

主要能力:镜头语法包括甩入推近、纵深字幕组(D 1250/1500/2200)、头部后方英雄字、视差卡车、身体擦除转场、说话人前方环绕字环、穿越镜头与楼梯式收尾。文字按 15fps 海报化,模糊为 7 个残影,字幕比人声提前 0.2 秒并对齐 15fps 网格(fr(t) = 2·round((t − 0.2)·15))。每组独立景深、景深阴影与 DOF;环绕字环始终绘制在说话人前方;字幕置于画面暗侧,文字跨皮肤或浅色衣物时加暗色描边。

用法:需 Node 22+、ffmpeg、Python 3(fonttools、brotli、numpy、pillow)。使用固定版本 npx hyperframes@0.8.62;抠像用 npx hyperframes@0.8.62 remove-background 在本地运行,首次会下载约 170 MB 的人像分割模型到 ~/.cache/hyperframes/。声音时钟使用用户本地已有的词级转写工具,起始精度重要,普通 Whisper 起点偏晚。字体由用户提供并确认可嵌入许可。准备阶段运行 bash scripts/prep-take.sh <take.mp4> <start_s> <dur_s> <project>/assets 生成 portion.mp4、plate-tall.mp4 与 person.webm,并校验尺寸、帧率与帧数。构建时复制 assets/kit/{cam3d.js,tables.js,finish.js} 与 metrics.js,并用 python3 scripts/font-metrics.py 生成字体度量;可变字体需在度量和 CSS 中同时固定轴,否则字重会随字号变化而重叠。校验用 npx hyperframes@0.8.62 check . --no-contrast、frame-bounds.js 与 glyph-gaps.js,渲染用 npx hyperframes@0.8.62 render . --crf 12。手绘风格为可选,需先安装 p5-paint-animation 技能。

限制:细发边缘的遮像会闪烁;甩镜时镜像补边会短暂露出;说话人占满画面时后方余地不足;snapshot --at 共用页面导致颗粒不重滚;带调色和大量残影层的渲染约为普通渲染的 2 倍耗时。除上述外不上传内容、无凭据与付费调用,文件只写入项目目录。