Was macht cinematicanimation?
Die Premium-Spur neben robloxmaxxing. Jene Fähigkeit erstellt Spiel-Assets und helle, belebte Erklärwelten. Diese hier macht einen Film: wenige Charaktere, dunkle Räume, eine Lampe, eine Geschichte, der man auch ohne Ton folgen kann, gerendert in Cycles (der Referenz-Look) oder EEVEE (derselbe Look in einem Bruchteil der Zeit, mit den Regeln unter „Engine“ unten).
SKILL = dieser Ordner. B = /Applications/Blender.app/Contents/MacOS/Blender (5.1). BP = Blenders Python (/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3.13), nur für beatgrid.py benötigt. Andere Skripte: python3 -I.
Einmal pro Sitzung lesen: references/craft.md (Geschichte, Einstellungen, Schnitt, Animation, Ton) und references/look.md (Licht, Materialien, Objektiv, Grading, Renderzeit). references/reference-films.md ist der Beleg: beide Filme Einstellung für Einstellung gemessen. Lies es, bevor du mit einer Zahl in dieser Datei argumentierst.
Der Look in sechs Zeilen
- Spielzeug-Charaktere, echte Welt. Blöcke mit gemalten Gesichtern; alles um sie herum fotorealistisch, abgenutzt und im kleinen Maßstab.
- Dunkel. Mittlere Bildhelligkeit 0,10-0,26 des vollen Bereichs. Eine sichtbare Lampe ist das Hauptlicht. Kein Fülllicht, kein Himmel.
- Prop-Höhe. Die Kamera sitzt auf Tischhöhe, nah, mit geringer Schärfentiefe und etwas Weichem im Vordergrund.
- Einstellungen tragen die Geschichte. Hände, Objekte, lesbare Requisiten. Etwa die Hälfte der Einstellungen zeigt kein Gesicht.
- Schnitt auf dem Raster. Einstellungslängen sind ganze oder halbe Taktschläge der Musik. Das Tempo ändert sich mit der Geschichte.
- Stille ist eine Einstellung. Die Musik stoppt einmal, am Wendepunkt. Das Ende ist ein Gesicht oder ein Objekt, dann Schwarz.
Engine: Cycles oder EEVEE
K.setup(..., engine="CYCLES" | "EEVEE"). Gemessen auf einem M4 bei 1080x1920:
| Engine | pro Bild | eine 60 s Sequenz (1.440 Bilder, zwei Prozesse) | verwenden, wenn |
|---|---|---|---|
| Cycles, 160 Samples | 70-90 s | 28-36 h | ein Helden-Still, ein Cover, ein kurzer Teaser |
| Cycles, 16 Samples, 40 % Größe | 11 s | 2 h (weich: eine Vorschau, keine Auslieferung) | zum Überprüfen eines Schnitts |
| EEVEE, 64 Samples, volle Größe, nur der eigene Set geladen | 6-8 s | 1-1,5 h | die Auslieferung von etwas länger als ~15 s |
EEVEE hält den Look (Dunst, Bokeh, hinterleuchteter Kunststoff, AgX) wenn diese Regeln eingehalten werden. Jede kostete eine Runde auf Negara Angin:
- Rufe
K.eevee_lights(keep=(...))auf, nachdem die Szene gebaut ist. Nur die großen motivierten Lichter werfen Schatten; viele kleine Schattenlichter überlaufen den Schatten-Pool und flackern von Bild zu Bild. - Eine Fensterscheibe ist Alpha, kein Glas. Transmissionsglas in EEVEE bricht den Bildschirmraum (was dahinter ist, verschmiert) und gemischte Transmission rendert schwarz. Verwende Principled Alpha ~0,14,
surface_render_method = "BLENDED", fällt durch Reflection + Bump. - EEVEE kann nicht durch eine Scheibe fokussieren. Die Schärfentiefe liest die Tiefe der nächstgelegenen Oberfläche, also wird alles hinter dem Glas so unscharf, als wäre es am Glas. Zeige die Scheibe nur, während sie das Motiv ist (
K.visible), verstecke sie, sobald der Fokus daran vorbeigeht. - Glas wirft keinen Schatten (
eevee_lightsregelt das): EEVEE behandelt es als undurchsichtig, also würde Licht durch ein Fenster oder ein Glas stoppen. - Rendere jede Einstellung nur mit ihrem eigenen Set geladen (
--sets): Jedes geladene Set wird in jedem Bild ausgewertet (instanziierte Felder, Regen). Auf Negara Angin hat das die Zeit halbiert. Zwei Worker können dieselbe Jobliste abarbeiten;render_rangebeansprucht Bilder mit Sperrdateien. - Bewegungsunschärfe und Volumenkachelgröße kosten wenig; Samples über 64 bringen nichts, was ein Körnungsdurchgang versteckt.
- Cycles hat Kaustiken ausgeschaltet: Licht hinter Fensterglas erreicht nie den Raum. Setze das „Fensterlicht“ in die Scheibe.
Pipeline
| Stufe | Aktion | Gate |
|---|---|---|
| 0. Kurzbeschreibung | Logline, die Schleife oder Kette, der Einsatzgegenstand, Palette pro Ort, der Track und sein BPM (beatgrid.py) | GATE B: Jede Zeile der Kurzbeschreibung ist ein beobachtbares Ding |
| 1. Einstellungsplan | Einstellungen als Zeilen: Größe, Objektiv, was sich bewegt, Länge in Taktschlägen; eine Master pro Szene | GATE S: Regeln in craft.md gelten auf dem Papier |
| 2. Welt + Besetzung | cine_kit: Raum/Straße, Requisiten, Lampen, Dunst; K.Char-Figuren | Stills des Masters, jedes in einem Satz beschreiben |
| 3. Licht | Hauptlicht von einer sichtbaren Lampe, Akzente, Kante; still jede Kamera in Vorschau-Größe | GATE L auf dem Still jeder Einstellung (look_gate.py) |
| 4. Performance | Posen auf Taktschlägen (hit, pose, face, talk), Kamerafahrten, life() | Ein Kontaktbogen liest sich wie die Geschichte ohne Ton |
| 5. Rendern | render_range in 2-3 Prozessen, 16-Bit-PNG, existierende überspringen | Bildanzahl = Filmlänge |
| 6. Fertigstellung | finish.py (Glühen, Grading, Weichheit, Vignette, Korn) + Tonmischung | GATE L auf dem Film, GATE E (shotlist.py --bpm), -14 LUFS |
Ein Gate, das durchfällt, wird auf seiner eigenen Stufe behoben: Ein helles Bild ist ein Beleuchtungsproblem, nie ein Grading-Problem.
GATE B - die Kurzbeschreibung (ein Docstring am Anfang des Build-Skripts)
- Logline in einem Satz mit einem Wunsch und einem Preis.
- Form: Eine Schleife, die kürzer wird (eine Regel wird einmal gezeigt, dann schneller wiederholt) oder eine Kette (jede Szene endet mit dem Objekt, das die nächste beginnt).
- Der Einsatzgegenstand: Ein kleines Ding mit einem Gesicht oder einer Zahl darauf (ein Foto, eine Rechnung, ein Ticket). Wo die Kamera darauf zufährt.
- Palette pro Ort: Eine dominante Lichtfarbe, eine Schattenfarbe, eine Akzentfarbe. Unterschiedlich für jeden Ort.
- Ton: Der Track, sein BPM, wo die Musik einsetzt, die 3-8 s, wo sie stoppt.
- Ende: Das letzte Bild (ein Gesicht oder ein Objekt) und das eine oder zwei Wörter auf Schwarz danach.
- Ausschlüsse: Wie dieser Film nicht aussehen darf.
GATE L - der Look (Zahlen aus den Referenzen; scripts/look_gate.py)
| Messung (0-1 des vollen Bereichs) | Bestehen | Referenzen |
|---|---|---|
| Mittlere Bildhelligkeit | 0,10-0,26 | 0,20; 0,17 |
| Schattenpegel (10. Perzentil-Pixel) | unter 0,09 | 0,06; 0,04 |
| Helle-Pegel (90. Perzentil-Pixel) | 0,22-0,56 | 0,46; 0,36 |
| Spitze (hellstes Pixel) | über 0,85 | 0,91; 0,98 |
| Schwarzboden | unter 0,05 | 0,02; 0,02 |
| Sättigung | Amber 0,10-0,30, Noir 0,03-0,14 | 0,18; 0,07 |
Führe es auf dem fertigen Still jeder Einstellung aus, dann auf dem gesamten Film. Eine einzelne helle Einstellung kann WARNen; ein FAIL wird behoben. „Spitze unter 0,85" bedeutet, dass es kein echtes Highlight im Bild gibt: Setze eine Lampe, einen Glanzpunkt oder eine Neonröhre, wo das Objektiv sie sehen kann.
GATE E - der Schnitt (scripts/shotlist.py film.mp4 --bpm N)
Jede Einstellungslänge ist eine ganze oder halbe Anzahl von Taktschlägen. Durchschnittliche Einstellung 1-3,5 s. Die ersten beiden Einstellungen sind die längsten ihrer Szene. Keine zwei aufeinanderfolgenden Einstellungen haben dieselbe Größe und denselben Winkel. Ein Abschnitt von 3-8 s hat keine Musik. Der Film endet innerhalb einer Sekunde nach Schwarz.
Eine Szene bauen
"$B" -b --factory-startup -P build.py -- --out out --stills # ein Still pro Einstellung, halbe Größe, etwa 10 s pro
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 & # starte es 2-3 Mal: vorhandene Bilder werden übersprungen
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" für ein Reel; preview=False für die Auslieferung
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 ist die vollständige, getestete Version (4 Einstellungen, 7,2 s): kopiere sie als Ausgangspunkt eines neuen Films.
cine_kit in einer Tabelle
| Bedarf | Aufruf |
|---|---|
| Szene | setup(aspect, height, samples, preview), world(), room(), haze(size, loc, density) |
| Oberflächen | plastic (Spielzeughaut, leuchtet bei Gegenlicht), cloth(kind=weave/knit/leather), wood(planks=), brick, asphalt(wet=), flat (Filz, Putz, Metall), glass, emit (Neon, Glühbirnen, Bildschirme) |
| Formen | box (immer abgeschrägt), cyl, torus(arc=), text (3D-Buchstaben, Neon-Wörter), paper (Poster / Rechnung / Karte mit lesbaren Zeilen), round_table, chair |
| Lampen | pendant (sichtbarer Schirm + Birne + Spot), neon (Röhre + passendes Fülllicht), bokeh_lights, light(kind, loc, power, color=Kelvin oder Hex, target, size) |
| Besetzung | 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, ...) (schnappen + halten), .face(frame, expr), .talk(f0, f1), .sit, .walk, .life() |
| mitgelieferte Charaktere | Rigged("bugis_man" / "bugis_woman" / path.blend, at, yaw): ein Charaktermodell aus einer Datei, in Char-Höhe, mit denselben Pose-Kanälen wie Char (arm_l, head, torso, leg_l, .hit, .sit, .walk, .life, .head). Gemalte Gesichter: kein Wechsel, also kommt Emotion von Kopf, Armen und dem Schnitt. Ein neues einteiliges Modell wird einmal mit scripts/rig_block.py geriggt (zuerst Hals, Hüfte und Arm-Grenze aus Schnitten messen) und zu K.CAST hinzugefügt; das Rig ist starr, außer dem Hals, den neck_blend.py weicher macht (siehe „Halsnaht") |
| der Avatar des Benutzers | Avatar(at, yaw, pose): Aksas geriggter Roblox-Charakter (Roblox/blender/hero_face.blend) in Char-Höhe. .pose(frame, "table" / "stand" / "relax" / "reach" / "chin" / "hips", head=(nod, tilt, turn), arm_L=...), .hit, .sit, .life(), .head (Kameraziel), .face.expr(f, eyes, brows, mouth) / .face.lipsync(words, vo_frame, fps=24) / .face.blink, dann einmal .finish(). Der Benutzer ist der Held seiner eigenen Filme: Verwende Avatar für die Hauptrolle, es sei denn, er sagt etwas anderes, Char für alle anderen |
| Gesichter | K.EXPRESSIONS: neutral, smirk, grin, angry, shout, shock, sad, shut, talk_a, talk_o, talk_m, side. Nur Austausch, nie Morphs |
| Singen auf einem gemalten Gesicht | einmal: Blender -b cast/x.blend -P scripts/prep_mouth.py -- cast/x_sing.blend (findet den gemalten Mund auf einer orthografischen Front-Render, zeichnet einen 10-Formen-Mund-Atlas in seinen Farben über seine eigene Haut, legt eine Platte auf das Gesicht, die auf den Kopf-Knochen geskinnt ist; Zelle 0 = das Gemälde, also ist es im Ruhezustand unsichtbar; dann wird der Hals neu geblendet, sodass alles unter der Platte auf dem Kopf reitet). In der Szene: K.Rigged(".../x_sing.blend").sing(words, f0, f1) mit words = [{"word","start","end"}] aus einem Transkript des Tracks (faster-whisper Wortzeiten). Drehe den Kopf zur Linse, während sie singt: ein Profil verbirgt den Mund |
| Kamera | 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) = wie weit man stehen muss, um das Bild mit einem Motiv dieser Höhe zu füllen (platzieren Sie Nahkameras nach Größe, nie nach Schätzung); .clip_follow(f0, f1, subject) = getastete Nah-Clip, um über einen Kopf in das Telefon in seinen Händen zu tauchen |
| Sichtbarkeit | K.visible(ob, [(f0, f1), ...]): nur in diesen Bereichen rendern-sichtbar; berührt nur die Ausblendkurve (setze niemals jede Kurve eines Objekts auf CONSTANT: seine Bewegung wird zu Stufen) |
| Schnitt | beats(bpm) -> Bild von Takt n; cut_list([(name, cam, beats), ...], bpm) bindet Kameras an Marker und gibt die Bilder jeder Einstellung zurück |
| Ausgabe | still(path, frame), render_range(dir, f0, f1) |
stop ist die Blendenzahl, als ob die Figur ein 40 cm Sammlerstück wäre: 2-2,8 für Einstellungen, 4 für Gesichter, 5,6-8 für Masters. Kleiner = unschärfer.
Passform mit den anderen Fähigkeiten des Benutzers
- Script:
scriptmaxxingfür jeden indonesischen Voice-Over. Halte es kurz; die Referenz mit 13,7 Mio. Aufrufen hat keine. - Musik und Effekte:
~/Ngonten/Maxxing/audio-lib(CC0). Führebeatgrid.pyauf dem Track aus, bevor du die Einstellungen planst. - Der eigene Avatar des Benutzers:
K.Avatar()lädt ihn mit seinem Gesichts-Rig (Blinzeln, Brauen, wortgenaue indonesische Lippenbewegung vonRoblox/blender/face/face_rig.py).K.Char.talk()ist limitierte Animation nur für andere Sprecher. Probiere es aus:build.py -- --avatar --stills. - Requisiten und Sets:
robloxmaxxing/blender/rbx_kit.pybaut im gleichen Stud-Maßstab; Poly Haven (MCP für Blendersearch_assets, oder das 3d-assets MCP) für CC0-PBR-Texturen und reale Requisiten; Meshy für eine Helden-Requisite. Realistische Requisiten sind der Punkt. - Vertikale Reels:
--aspect 9:16. Alles hier gilt; Masters gehen auf 24-28 mm und die Tiefe wird entlang der Linsenachse gestapelt.
Hart erkämpfte Regeln für die Nahaufnahme (Negara Angin, 2026-11-21)
- Messen, dann einrahmen. Gib die ausgewerteten Positionen von Kopf, Händen und Requisite in den Bildern der Einstellung aus, dann platziere die Kamera mit
Cam.distance_for. Mit bloßem Auge platzierte Makro-Kameras endeten 0,5 Studs von Objekten entfernt, die 2 brauchten. - Roblox-Hände sind große Blöcke. Ein Telefon, das „in" ihnen gehalten wird, ist vergraben; halte Requisiten vor den Händen entlang der Bildschirm-Normalen.
- Bone-parentere keine Requisite und setze dann ihre Welt-Matrix (sie landet am Ursprung). Halte die Requisite welt-fest, während die Pose hält, oder parente mit dem Operator.
- Stills ignorieren die Schnittmarker. Ein an eine Kamera gebundener Marker überschreibt
scene.cameraauf diesem Bild: lösche sie für Stills. - Der Haken ist ein Bild und ein Ereignis. Bild 1 muss bereits schön sein (Negara Angin: ein Regentropfen, der im extremen Makro das Fenster hinunterläuft, die Lichter des Raums darin gebrochen), und der erste Takt muss es verändern (der Kick zieht den Fokus durch den Tropfen).
- Übergänge werden entworfen, nicht hinzugefügt: Durchstoße einen Bildschirm in die Welt, die er zeigt (rendere das erste Bild der nächsten Einstellung als das Bildschirmbild), peitsche aus einer Einstellung heraus und in die nächste hinein.