cinematicanimation 是做什么的?
与 robloxmaxxing 并行的优质赛道。该技能用于制作游戏资产和明亮、繁忙的说明世界。而本技能用于制作一部电影:少量角色、昏暗的房间、一盏灯、一个即使静音也能看懂的故事,使用 Cycles(参考外观)或 EEVEE(在极短时间内达到相同外观,需遵守下方“引擎”中的规则)渲染。
SKILL = 此文件夹。B = /Applications/Blender.app/Contents/MacOS/Blender (5.1)。BP = Blender 的 Python (/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3.13),仅 beatgrid.py 需要。其他脚本:python3 -I。
每次会话阅读一次:references/craft.md(故事、镜头、剪辑、动画、声音)和 references/look.md(灯光、材质、镜头、调色、渲染时间)。references/reference-films.md 是证据:两部电影逐镜头测量。在质疑本文件中的任何数字之前请先阅读它。
六线外观
- 玩具角色,真实世界。 带绘制面孔的方块;周围一切逼真、破旧且小比例。
- 暗调。 中位帧亮度为全范围的 0.10-0.26。一个可见的灯是主光源。无补光,无天空。
- 道具高度。 相机位于桌面水平,靠近,浅景深,前景有柔和物体。
- 特写镜头承载故事。 手部、物体、可读道具。约一半镜头没有面孔。
- 按节拍剪辑。 镜头长度是音乐节拍的整数或半整数拍。速度随故事变化。
- 静默也是一个镜头。 音乐在转折处停止一次。结尾是一个面孔或一个物体,然后是黑场。
引擎:Cycles 或 EEVEE
K.setup(..., engine="CYCLES" | "EEVEE")。在 M4 上以 1080x1920 测量:
| 引擎 | 每帧 | 60 秒卷 (1,440 帧,两个进程) | 使用时机 |
|---|---|---|---|
| Cycles, 160 样本 | 70-90 秒 | 28-36 小时 | 英雄静态帧、封面、短预告片 |
| Cycles, 16 样本, 40 % 大小 | 11 秒 | 2 小时(软:预览,非交付) | 检查剪辑 |
| EEVEE, 64 样本, 全尺寸, 仅加载镜头自身场景 | 6-8 秒 | 1-1.5 小时 | 任何长度超过 ~15 秒的交付 |
EEVEE 保持外观(雾、散景、背光塑料、AgX),若遵守以下规则。每条规则都在 Negara Angin 上经过一轮迭代:
- 场景构建后调用
K.eevee_lights(keep=(...))。 只有大型有动机的光源投射阴影;许多小型阴影灯会溢出阴影池并导致帧间闪烁。 - 窗格使用 Alpha,而非玻璃。 EEVEE 中的透射玻璃会折射屏幕空间(其后的内容会模糊),混合透射渲染为黑色。使用 Principled alpha ~0.14,
surface_render_method = "BLENDED",从反射 + 凹凸中去除。 - EEVEE 无法透过窗格对焦。 景深读取最近表面的深度,因此玻璃后的所有内容都会模糊,仿佛就在玻璃上。仅在窗格是主体时显示它(
K.visible),一旦焦点移过它,就隐藏它。 - 玻璃不投射阴影(
eevee_lights处理):EEVEE 将其视为不透明,因此通过窗户或罐子的光会停止。 - 仅加载镜头的场景进行渲染(
--sets):每个加载的场景都会在每一帧被评估(实例化字段、雨)。在 Negara Angin 上这使时间减半。两个工作进程可以运行同一个任务列表;render_range使用锁文件声明帧。 - 运动模糊和体积块大小成本很低;64 以上的样本不会带来任何颗粒通道无法隐藏的好处。
- Cycles 关闭焦散:窗户玻璃后面的光永远不会到达房间。将“窗户光”放入窗格内部。
流水线
| 阶段 | 操作 | 关卡 |
|---|---|---|
| 0. 简报 | 一句话梗概、循环或链条、赌注对象、每个地点的调色板、音轨及其 BPM (beatgrid.py) | GATE B:简报的每一行都是可观察的事物 |
| 1. 镜头规划 | 镜头作为行:景别、焦距、移动内容、节拍长度;每个场景一个主镜头 | GATE S:craft.md 中的规则在纸面上成立 |
| 2. 世界 + 演员 | cine_kit:房间/街道、道具、灯具、雾;K.Char 角色 | 主镜头的静态帧,用一句话描述每个 |
| 3. 灯光 | 从可见灯、点缀、边缘来的主光;still 每个相机以预览大小 | GATE L 对每个镜头的静态帧(look_gate.py) |
| 4. 表演 | 节拍上的姿势(hit, pose, face, talk)、相机移动、life() | 小样应像无声电影般讲述故事 |
| 5. 渲染 | 2-3 个进程中的 render_range,16-bit PNG,跳过现有 | 帧数 = 电影长度 |
| 6. 后期 | finish.py(发光、调色、柔化、暗角、颗粒)+ 音频混音 | GATE L 对整部电影,GATE E(shotlist.py --bpm),-14 LUFS |
失败的关卡在其自身阶段修复:过亮的帧是灯光问题,绝非调色问题。
GATE B - 简报(构建脚本顶部的文档字符串)
- 一句话梗概 包含一个愿望和一个代价。
- 结构: 变短的循环(规则展示一次,然后重复更快)或链条(每个场景结束于开始下一个场景的对象)。
- 赌注对象: 一个带有面孔或数字的小东西(照片、账单、票)。相机推近它。
- 每个地点的调色板: 一种主光色、一种阴影色、一种点缀色。不同地方不同。
- 声音: 音轨、其 BPM、音乐落下的位置、音乐停止的 3-8 秒。
- 结尾: 最后一个图像(面孔或物体)以及黑屏后的一个或两个单词。
- 排除项: 这部电影不得像什么。
GATE L - 外观(来自参考的数字;scripts/look_gate.py)
| 度量(全范围 0-1) | 通过 | 参考 |
|---|---|---|
| 中位帧亮度 | 0.10-0.26 | 0.20, 0.17 |
| 阴影级别(第 10 百分位像素) | 低于 0.09 | 0.06, 0.04 |
| 亮部级别(第 90 百分位像素) | 0.22-0.56 | 0.46, 0.36 |
| 峰值(最亮像素) | 超过 0.85 | 0.91, 0.98 |
| 黑色下限 | 低于 0.05 | 0.02, 0.02 |
| 饱和度 | 琥珀色 0.10-0.30,黑色电影 0.03-0.14 | 0.18, 0.07 |
对每个镜头的已完成静态帧运行,然后对整个电影运行。单个明亮特写镜头可能 WARN;失败必须修复。“峰值低于 0.85”意味着画面中没有真正的高光:在镜头可见的地方放置一盏灯、一道闪光或一根霓虹管。
GATE E - 剪辑(scripts/shotlist.py film.mp4 --bpm N)
每个镜头的长度是节拍的整数或半整数拍。平均镜头 1-3.5 秒。前两个镜头是其场景中最长的。没有两个连续镜头具有相同的景别和角度。一个 3-8 秒的段落没有音乐。电影在黑屏的一秒内结束。
构建场景
"$B" -b --factory-startup -P build.py -- --out out --stills # 每个镜头一个静态帧,半尺寸,每帧约 10 秒
python3 -I "$SKILL/scripts/finish.py" out/still_master.png --out out/fin_master.jpg --look amber
python3 -I "$SKILL/scripts/look_gate.py" out/fin_master.jpg --look amber
"$B" -b --factory-startup -P build.py -- --out out --frames --final & # 启动 2-3 次:已存在的帧会被跳过
python3 -I "$SKILL/scripts/finish.py" out/frames --out out/film.mp4 --look amber --audio mix.wav
import sys; sys.path.insert(0, SKILL + "/blender"); import cine_kit as K
K.setup(aspect="16:9", height=1080, preview=True) # "9:16" 用于短视频;preview=False 用于交付
K.room(26, 22, 10); K.round_table("Table", 3.2, 2.9); K.pendant("Lamp", (0, 0, 6.5), power=2600, spot=125)
K.neon("Ring", (0, 10.8, 5.6), radius=1.7, color="#FFB020"); K.bokeh_lights("Shelf", ((-11, 10.2, 2.5), (11, 10.6, 8)))
K.light("TableBounce", "AREA", (0, 0, 3.05), 260, 2300, target=(0, 0, 9), size=4); K.haze((26, 22, 10), (0, 0, 5), 0.006)
hero = K.Char("Hero", skin="#F2C230", shirt="#20242C", hat="hair", at=(-4.5, 0, 0), yaw=90); hero.sit(1)
master = K.Cam("Master", (-2.2, -9.6, 3.1), (0.2, 0, 4.3), lens=28, stop=5.6)
cu = K.Cam("HeroCU", (-1.6, -6.2, 4.1), (-4.4, 0, 4.4), lens=50, stop=4, focus=hero.head)
S = K.cut_list([("master", master, 4), ("hero", cu, 2.5)], bpm=100); B = K.beats(100)
hero.hit(B(4.5), 3, head=(2, -60, -5)).face(B(4.5), "smirk"); cu.push(*S["hero"], 0.06).handheld(0.3); hero.life()
examples/standoff/build.py 是完整、测试过的版本(4 个镜头,7.2 秒):复制它作为新电影的起点。
cine_kit 一览表
| 需求 | 调用 |
|---|---|
| 场景 | setup(aspect, height, samples, preview), world(), room(), haze(size, loc, density) |
| 表面 | plastic(玩具皮肤,背光发光), cloth(kind=weave/knit/leather), wood(planks=), brick, asphalt(wet=), flat(毛毡、石膏、金属), glass, emit(霓虹灯、灯泡、屏幕) |
| 形状 | box(始终倒角), cyl, torus(arc=), text(3D 字母、霓虹文字), paper(海报/账单/带有可读文字的卡片), round_table, chair |
| 灯具 | pendant(可见灯罩 + 灯泡 + 聚光), neon(灯管 + 匹配补光), bokeh_lights, light(kind, loc, power, color=kelvin or hex, target, size) |
| 演员 | Char(name, skin, shirt, pants, hat=hair/cap/fedora/beanie):.pose(frame, arm_l=(fwd, out, twist), head=(nod, turn, tilt), torso, leg_l, at, yaw), .hit(frame, dur, ...)(快照 + 保持), .face(frame, expr), .talk(f0, f1), .sit, .walk, .life() |
| 提供的角色 | Rigged("bugis_man" / "bugis_woman" / path.blend, at, yaw):来自文件的角色模型,与 Char 同一高度,具有与 Char 相同的姿势通道(arm_l, head, torso, leg_l, .hit, .sit, .walk, .life, .head)。绘制面孔:不可互换,因此情感来自头部、手臂和剪辑。新的整体模型使用 scripts/rig_block.py 进行一次绑定(先通过切片测量颈部、臀部和手臂边界),并添加到 K.CAST;绑定是刚性的,除了颈部,由 neck_blend.py 柔化(参见“颈部接缝”) |
| 用户的化身 | Avatar(at, yaw, pose):Aksa 的绑定 Roblox 角色(Roblox/blender/hero_face.blend)与 Char 同一高度。.pose(frame, "table" / "stand" / "relax" / "reach" / "chin" / "hips", head=(nod, tilt, turn), arm_L=...), .hit, .sit, .life(), .head(相机目标), .face.expr(f, eyes, brows, mouth) / .face.lipsync(words, vo_frame, fps=24) / .face.blink,然后执行一次 .finish()。用户是他自己电影的英雄:除非另有说明,否则对主角使用 Avatar,对其他所有人使用 Char |
| 面孔 | K.EXPRESSIONS:中性、假笑、咧嘴笑、生气、喊叫、震惊、悲伤、闭上、说话_a、说话_o、说话_m、侧面。仅可互换,从不变形 |
| 在绘制面孔上歌唱 | 一次:Blender -b cast/x.blend -P scripts/prep_mouth.py -- cast/x_sing.blend(在正交正面渲染上找到绘制的嘴巴,在其自身皮肤颜色上绘制一个 10 形状的嘴部图谱,放置一个绑定到头部骨骼的面板;单元格 0 = 绘画,因此静止时不可见;然后重新混合颈部,使面板下的所有内容随头部运动)。场景中:K.Rigged(".../x_sing.blend").sing(words, f0, f1),其中 words = [{"word","start","end"}] 来自音轨的转录(使用 faster-whisper 单词时间)。当她唱歌时将头部转向镜头:侧面会隐藏嘴巴 |
| 相机 | Cam(name, loc, target, lens, stop, focus, roll):.at(frame, loc, target, focus, roll), .push(f0, f1, 0.06), .handheld(amount);Cam.distance_for(lens, height) = 站多远才能让一个给定高度的主体填满画面(按景别放置近景相机,从不猜测);.clip_follow(f0, f1, subject) = 键控近裁面,以便越过头部俯冲进入他们手中的手机 |
| 可见性 | K.visible(ob, [(f0, f1), ...]):仅在这些范围内渲染可见;仅影响隐藏曲线(切勿将对象的每条曲线设置为 CONSTANT:其运动会变得阶梯状) |
| 剪辑 | beats(bpm) -> 节拍 n 的帧;cut_list([(name, cam, beats), ...], bpm) 将相机绑定到标记,并返回每个镜头的帧 |
| 输出 | still(path, frame), render_range(dir, f0, f1) |
stop 是 f 值,仿佛角色是 40 厘米的收藏品:特写 2-2.8,面孔 4,主镜头 5.6-8。数值越小越模糊。
与用户其他技能的配合
- 剧本: 使用
scriptmaxxing处理任何印度尼西亚语画外音。保持简短;一个拥有 1370 万次观看的参考视频没有任何画外音。 - 音乐和音效:
~/Ngonten/Maxxing/audio-lib(CC0)。在规划镜头之前对音轨运行beatgrid.py。 - 用户自己的化身:
K.Avatar()加载它及其面部绑定(眨眼、眉毛、逐词准确的印度尼西亚语唇形同步,来自Roblox/blender/face/face_rig.py)。K.Char.talk()仅适用于其他说话者的有限动画。试试看:build.py -- --avatar --stills。 - 道具和布景:
robloxmaxxing/blender/rbx_kit.py以相同的 stud 比例构建;Poly Haven(Blender 的 MCPsearch_assets,或 3d-assets MCP)用于 CC0 PBR 纹理和真实世界道具;Meshy 用于一个英雄道具。写实道具是关键。 - 竖版短视频:
--aspect 9:16。这里的所有内容都适用;主镜头使用 24-28 mm,深度沿镜头轴堆叠。
精细工作的硬规则 (Negara Angin, 2026-11-21)
- 先测量,再构图。 打印头部、手部和道具在镜头帧上的评估位置,然后使用
Cam.distance_for放置相机。通过肉眼放置的微距相机最终距离需要 2 个单位的物体只有 0.5 个单位。 - Roblox 的手是大方块。 握在其中的手机被埋没;将道具握在双手前方,沿屏幕法线方向。
- 不要将一个道具骨绑定到骨骼然后设置其世界矩阵(它会落在原点)。在姿势保持期间保持道具世界固定,或者使用运算符进行父级绑定。
- 静态帧忽略剪辑标记。 绑定到相机的标记会覆盖该帧上的
scene.camera:清除它们以进行静态帧渲染。 - 钩子是一个图像和一个事件。 第 1 帧必须已经美丽(Negara Angin:雨滴以极端微距滑落窗户,房间的灯光在其中折射),并且第一个节拍必须改变它(鼓点将焦点穿过雨滴拉回)。
- 转场是设计的,而非添加的: 推过一个屏幕进入其显示的世界(将下一个镜头的第一帧渲染为屏幕图像),从一个镜头甩出并进入下一个。
[截断,因为原始内容已在此处结束]