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 はエビデンスです:両方の映画をショットごとに測定したものです。このファイルの数値について議論する前に読んでください。
ルックを6行で
- おもちゃのキャラクター、現実世界。 顔が描かれたブロック。その周りのすべてはフォトリアルで、使い古され、小さなスケールです。
- 暗い。 フレームの中央輝度はフルレンジの0.10〜0.26。見えるランプが一つキーライトです。フィルライトなし、空なし。
- プロップの高さ。 カメラはテーブルレベルに近づけて配置し、被写界深度を浅くし、前景に柔らかいものを配置します。
- インサートがストーリーを運ぶ。 手、オブジェクト、読み取れるプロップ。約半数のショットに顔はありません。
- グリッドに合わせてカット。 ショットの長さは音楽のビートの整数倍または半拍です。テンポはストーリーに合わせて変化します。
- 沈黙もショットの一部。 音楽は転換点で一度だけ止まります。エンディングは顔か物体、そしてブラックアウトです。
エンジン: Cycles または EEVEE
K.setup(..., engine="CYCLES" | "EEVEE")。M4で1080x1920で計測:
| エンジン | 1フレームあたり | 60秒のリール (1,440フレーム、2プロセス) | 使用するタイミング |
|---|---|---|---|
| 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=(...))を呼び出すこと。 主要な動機付けられたライトのみが影を落とします。多数の小さな影用ライトは影プールをオーバーフローさせ、フレーム間でちらつきます。 - 窓ガラスはアルファ、ガラスではありません。 EEVEEでの透過ガラスはスクリーンスペースを屈折させ(背後にあるものがぼやける)、ブレンド透過は黒くレンダリングされます。Principledのアルファ約0.14、
surface_render_method = "BLENDED"を使用し、反射+バンプからのドロップを使用します。 - EEVEEはガラス越しにピントを合わせることができません。 被写界深度は最も近いサーフェスの深度を読み取るため、ガラスの後ろにあるものはすべてガラス上にあるかのようにぼやけます。ガラスが被写体である間だけ表示し (
K.visible)、ピントがガラスを通り過ぎたら非表示にします。 - ガラスは影を落としません (
eevee_lightsが行います): EEVEEはガラスを不透明として扱うため、窓や瓶を通る光は止まります。 - 各ショットは、そのセットのみをロードしてレンダリングすること (
--sets): ロードされたすべてのセットは毎フレーム評価されます(インスタンス化フィールド、雨)。Negara Anginではこれにより時間が半分になりました。2つのワーカーが同じジョブリストを処理できます。render_rangeはロックファイルでフレームを要求します。 - モーションブラーとボリュームタイルサイズのコストはわずかです。64を超えるサンプルは、グレインパスで隠せる以上の効果はありません。
- Cyclesはコースティクスがオフ:窓ガラスの後ろのライトは部屋に届きません。「窓の光」はガラスパネルの内側に配置します。
パイプライン
| ステージ | 作業内容 | ゲート |
|---|---|---|
| 0. ブリーフ | ログライン、ループまたはチェーン、ステークオブジェクト、ロケーションごとのパレット、トラックとそのBPM (beatgrid.py) | GATE B: ブリーフのすべての行が観察可能なものであること |
| 1. ショット計画 | ショットを行として:サイズ、レンズ、動くもの、ビート単位の長さ;シーンごとに1つのマスター | GATE S: craft.mdのルールが紙面上で成立すること |
| 2. ワールド+キャスト | cine_kit: 部屋/通り、プロップ、ランプ、ヘイズ;K.Charフィギュア | マスターのスチル、それぞれを一文で説明 |
| 3. ライト | 見えるランプからのキー、アクセント、エッジ;プレビューサイズで各カメラのstill | すべてのショットのスチルに対するGATE L (look_gate.py) |
| 4. パフォーマンス | ビート上のポーズ (hit, pose, face, talk)、カメラ移動、life() | コンタクトシートが音なしでストーリーとして読めること |
| 5. レンダリング | render_rangeを2〜3プロセス、16ビットPNG、既存ファイルはスキップ | フレーム数 = フィルムの長さ |
| 6. 仕上げ | finish.py (グロー、グレーディング、ソフトネス、ビネット、グレイン) + サウンドミックス | フィルムに対するGATE L、GATE E (shotlist.py --bpm)、-14 LUFS |
失敗したゲートは、そのステージで修正します:明るいフレームはグレーディングの問題ではなく、照明の問題です。
GATE B - ブリーフ (ビルドスクリプトの先頭のdocstring)
- ログライン:欲求と代償を含む一文。
- 形状:短くなるループ(ルールを一度示し、その後より速く繰り返す)またはチェーン(各シーンが次のシーンを開始するオブジェクトで終わる)。
- ステークオブジェクト:顔や数字が付いた小さなもの(写真、請求書、チケット)。カメラがそれに寄るところ。
- ロケーションごとのパレット:支配的な光の色1つ、影の色1つ、アクセント色1つ。場所ごとに異なる。
- サウンド:トラック、そのBPM、音楽が入る場所、音楽が止まる3〜8秒間。
- エンディング:最後のイメージ(顔または物体)と、その後のブラックの上に表示される1〜2語。
- 除外事項:この映画が似てはいけないもの。
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秒。最初の2つのショットは、そのシーンで最も長いものです。同じサイズとアングルのショットが2つ連続することはありません。3〜8秒の区間で音楽がありません。フィルムはブラックアウトの1秒以内に終了します。
シーンの構築
"$B" -b --factory-startup -P build.py -- --out out --stills # 各ショット1スチル、半サイズ、各約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=ケルビンまたは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"}] はトラックの文字起こしから (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 は、被写体が40cmのコレクタブルであると仮定した場合のF値: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は同じスタッドスケールで構築;CC0 PBRテクスチャと現実世界のプロップには Poly Haven (Blender用MCPsearch_assets、または3d-assets MCP);1つのヒーロープロップには Meshy。リアルなプロップが重要です。 - 縦型リール:
--aspect 9:16。ここでのすべては有効;マスターは24〜28mmになり、奥行きはレンズ軸に沿って積み重なります。
クローズアップ作業のための苦労して得たルール (Negara Angin, 2026-11-21)
- 測定してからフレーミング。 ショットのフレームにおける頭、手、プロップの評価位置をプリントし、
Cam.distance_forでカメラを配置します。目検討で配置したマクロカメラは、2スタッド必要なオブジェクトから0.5スタッドの距離になってしまいました。 - Robloxの手は大きなブロック。 手の中に「持たせた」電話は埋もれます;スクリーンの法線に沿って手の前にプロップを保持します。
- プロップをボーンペアレントしてからワールド行列を設定してはいけません (原点に配置されます)。ポーズが保持されている間はプロップをワールド固定にするか、オペレーターでペアレントします。
- スチルはカットマーカーを無視します。 カメラにバインドされたマーカーはそのフレームの
scene.cameraをオーバーライドします:スチルのためにマーカーをクリアします。 - フックは1つのイメージと1つのイベントです。 フレーム1はすでに美しくなければならず (Negara Angin: 極限マクロで窓を滑り落ちる雨粒、その内部で屈折する部屋の光)、最初のビートでそれを変えなければなりません (キックがドロップを通してピントを移動させる)。
- トランジションは後付けではなく設計する: スクリーンを通り抜けてそれが表示する世界へ (次のショットの最初のフレームをスクリーンイメージとしてレンダリング)、ショットから次のショットへ鞭のように振り抜くなど。
[以降の翻訳は省略]