fframes CLI 命令实战手册render、frame、strip、onion、inspect 与 audio analyze 完整指南【免费下载链接】fframesprogrammatic video rendering framework that is actually fast项目地址: https://gitcode.com/gh_mirrors/ff/fframesfframes是一个用 Rust SVG 编写视频、由 GPU 加速渲染的程序化视频渲染框架而它的 CLI 命令行是整套工具链中最实用的部分render导出成片、frame/strip/onion让你不用播放就能看到每一帧、inspect自动检查画面问题、audio analyze输出响度报告。本文带你逐一实战这 6 组核心命令。5 分钟上手每个项目自带一套命令行安装好项目模板后cargo fframes new my-video在任意 fframes 项目里所有命令都通过cargo run --release -- 命令执行。建议先定义一个 shell 函数缩短输入R() { cargo run --release -- $; }之后$R render、$R inspect即可。注意保持--releasedebug 构建的渲染速度会慢很多。render 命令导出最终成片render是默认命令直接运行cargo run --release --或显式写出render都会把整个视频编码成out.mp4。常用用法$R render— 渲染完整视频$R render Intro -o intro.mp4— 只渲染Intro场景输出到指定文件$R render 10s..20s— 只渲染 10 秒到 20 秒的区间$R render --draft— 快速草稿半分辨率 最快编码参数约 1 秒出片--draft是迭代神器改完代码先跑草稿看大方向确认没问题再正式渲染。音频会自动裁剪到与视频区间匹配。完成后会打印输出文件、帧数区间和耗时。frame 命令导出任意时刻的高清 PNG想检查某个精确时刻的细节字体、对齐、色彩用frame把那一帧写成全尺寸 PNG$R frame Introend,Outro50%时间用逗号分隔可一次导出多帧PNG 默认写入frames/目录加--svg会同时导出该帧转换后的 SVG 文本方便查看排版结果命令会顺带打印这一帧发现的问题缺字体、文字溢出画布等strip 命令一张联系表审看整个运动节奏strip把一个范围内均匀间隔的帧拼成一张带标签的联系表contact sheet是判断布局、节奏、运动最快的方式$R strip Intro -n 12 # Intro 场景取 12 帧 $R strip all -n 16 --columns 4 # 全片 16 帧、4 列 $R strip --width 640 # 每格宽度 640 像素默认 480输出的strip.png中每个格子都标注了秒数、帧号和所属场景。经验法则优先用 strip 代替连续调用多次 frame需要看构图时再加--scale 0.5。onion 命令洋葱皮叠加看清运动轨迹onion把一个范围内多帧叠加成一张图后面的帧更亮专门用来观察一个运动的路径与缓动——提前量、回弹、间隔是否均匀$R onion Intro0..Intro1s -n 6输出的onion.png里元素运动的轨迹会像曝光叠加一样清晰可见。调转场和入场动画时这张图比反复播放有用得多。inspect 命令不渲染像素就能查出画面问题inspect逐帧扫描默认每 0.25 秒一帧外加每个场景的首尾帧检查缺失的字体、图片或字形被画布边缘裁掉的文字非法 SVG零尺寸矩形、坏掉的 transform渲染中的 panic每条发现都附带时间点与场景名发现问题时以退出码 2 结束$R inspect # 全片扫描 $R inspect Intro --every 0.1s # 指定场景、更密的扫描间隔 $R inspect --all-frames # 逐帧检查 $R inspect --fail-on warning # 出现 warning 即视为失败CI 推荐它不输出像素速度极快适合作为每次改动后的第一道检查。比如文字用了错误字体时inspect会直接报No match for ... font-family。audio analyze 命令响度、峰值与波形图audio是一组子命令analyze输出完整响度报告积分响度LUFS、真峰、削波采样、静音区间以及每个场景的独立响度$R audio analyze $R audio analyze --waveform w.png加--waveform会额外生成一张波形 PNG蓝色是波形、粉色是瞬时响度曲线、紫色竖线是场景边界、黄色是音频触发点——一张图看完全片的声音结构。配套还有$R audio at 3.1s— 查某一时刻正在播放哪些音轨、各自音量与闪避ducking状态$R audio render Intro -o intro.wav— 把某个场景的混音导出成 WAV 试听Web 端视频的参考标准积分响度约-14 LUFS真峰低于-1 dBTP无意外静音。时间表示法速查表所有命令的时间参数通用这套语法记熟它就能自由组合写法含义120/120f第 120 帧3.2s/500ms/1:05.5时间戳50%/start/end比例 / 首帧 / 末帧Intro场景名不区分大小写Intro1.2s/12/50%/end场景内部偏移a..b右开/a../..b/all区间命令细节可在 fframes/src/renderer/cli.rs 中查看完整工作流参考 skills/fframes-video/SKILL.md 与 skills/fframes-video/references/audio.md。推荐工作流改动后的标准检查循环$R timeline— 先看场景结构与音轨确认结构没问题$R inspect— 自动排雷修掉所有报错$R strip 场景 -n 12— 联系表审看布局与节奏$R onion 场景0..场景1s -n 6— 检查关键运动$R audio analyze— 确认响度达标$R render --draft→$R render -o out.mp4— 出片掌握这 6 组命令你就不需要看视频也能确认质量——这正是 fframes CLI 的设计初衷。【免费下载链接】fframesprogrammatic video rendering framework that is actually fast项目地址: https://gitcode.com/gh_mirrors/ff/fframes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
