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.11),僅 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 秒影片(1440 幀,兩個進程) | 適用時機 |
|---|---|---|---|
| Cycles, 160 samples | 70-90 秒 | 28-36 小時 | 主要靜幀、封面、短預告片 |
| Cycles, 16 samples, 40% 尺寸 | 11 秒 | 2 小時(較柔和:用於預覽,非最終交付) | 檢查剪輯 |
| EEVEE, 64 samples, 全尺寸, 僅載入該鏡頭自身的 set | 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 將其視為不透明,因此透過窗戶或罐子的光線會中斷。 - 僅載入該鏡頭自身的 set 來渲染每個鏡頭(
--sets):每個載入的 set 都會在每幀被評估(例如實例欄位、雨)。在 Negara Angin 專案中,這將時間減半。兩個 worker 可以同時處理同一個任務列表;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 - 簡報(建置腳本頂部的 docstring)
- 一句話紀錄:一個句子,包含一個慾望和一個代價。
- 結構:一個逐漸縮短的循環(規則出現一次,然後加速重複)或一個鏈條(每個場景的結束物件,成為下個場景的開始物件)。
- 關鍵物品:一個小型、帶有臉或數字在上面的物品(照片、帳單、票據)。攝影機會推近拍攝它。
- 每個場景的色板:一種主光色、一種陰影色、一種強調色。每個場景都不同。
- 聲音:音樂曲目、其 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;FAIL 則必須修正。「峰值低於 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 或 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:neutral、smirk、grin、angry、shout、shock、sad、shut、talk_a、talk_o、talk_m、side。僅切換,從不變形 |
| 在繪製臉上的歌唱 | 一次: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"}](來自音樂曲目的轉錄文字,使用更快-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 是光圈值,如同角色是一個 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放置攝影機。目測放置的微距攝影機最終距離只需 0.5 studs 的物體卻需要 2 studs。 - Roblox 的手是大方塊。 握在「手中」的手機會被埋住;請將道具沿著螢幕法線方向握在手的前方。
- 不要將道具設置為骨骼父級然後再設定其世界矩陣(它會落在原點)。在姿勢保持期間,保持道具世界固定,或使用運算子進行父級綁定。
- 靜幀會忽略剪輯標記。 綁定到攝影機的標記會覆蓋該幀的
scene.camera:請為靜幀清除它們。 - 鉤子是一個影像和一個事件。 第 1 幀必須已經很美(Negara Angin:一滴雨滴以極致微距滑落窗戶,房間的燈光在其中折射),而第一個節拍必須改變它(鼓點將焦點穿過雨滴拉動)。
- 轉場是設計出來的,而非事後添加: 讓攝影機穿過一個螢幕進入它所顯示的世界(將下一個鏡頭的第一幀作為螢幕影像渲染),從一個鏡頭甩出並進入下一個鏡頭。
...