Communitygithub.com

Lightning Emperor: Composite CG in Plate

Workflow und Werkzeuge für das Compositing von CG (Blender/Cycles) in Realfilmaufnahmen, insbesondere zum Ersetzen eines Blau- oder Greenscreens. Deckt Kameraabgleich, Beleuchtungsmatch, Keying, Tracking, Schatten, Körnung und Compositing im linearen Licht ab.

Was ist Lightning Emperor: Composite CG in Plate?

Diese Skill-Anleitung, basierend auf dem SKILL.md-Dokument, definiert einen vollständigen Arbeitsablauf zum Einfügen von computergenerierten Inhalten (CG) in Live-Action-Platten. Sie ist für Künstler und KI-Agenten konzipiert, die mit VFX-Aufgaben arbeiten, ohne dass manuelles Expertenwissen erforderlich ist. Die Anleitung unterstützt drei Implementierungen – einen MCP-Server, eine CLI und ein Blender-Add-on – die alle denselben Kerncode verwenden. Sie legt großen Wert auf präzise Messungen zur Vermeidung kostspieliger Fehler, z. B. die absolute Skalierung aus zwei unabhängigen Methoden (bekannte Objektgröße und Fokusentfernung) zu bestimmen, sowie auf die Analyse der realen Beleuchtung anhand der Aufnahme. Der Workflow ist in Schritte unterteilt: Kameraabgleich (Brennweite, Sensor, Entfernung), Beleuchtungsanalyse, Keying und Despill, Marker-Tracking, Schattenberechnung, Körnungsanpassung und Compositing im linearen Light. Jeder Schritt verfügt über eigene Werkzeuge zur Überprüfung. Die Anleitung enthält außerdem Verweise auf Referenzdokumente zu Fehlermodi, Skalierung, Beleuchtung, Compositing, Tracking und Blender-Scripting, die je nach Phase gelesen werden sollen. Die Einhaltung der neun Grundregen verhindert typische Fehler wie falsche Skalierung, übersehene Spill-Artefakte oder falsche Lichtquellen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LucidMach/LightningEmperor/tree/HEAD/skill/lightning-emperor

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Lightning Emperor: CG-into-plate-Compositing

Ein Workflow plus Werkzeuge, um CG hinter oder um Live-Action-Schauspieler zu platzieren. Die Werkzeuge gibt es in drei Varianten, die alle denselben Code ausführen: den MCP-Server (lightning-emperor-mcp), die CLI (lightning-emperor ...) und das Blender-Add-on. Bevorzugen Sie MCP-Werkzeuge, wenn diese verbunden sind; andernfalls verwenden Sie die CLI. Diese Datei ist das Urteil: was zu messen ist, was schiefgehen kann, wie man die eigene Arbeit überprüft.

Regeln, die die teuren Fehler verhindern

  1. Messen Sie die Platte, bevor Sie etwas entscheiden. Objektiv, Sensor, Belichtung, Weißabgleich, Bildschirmfarbe und -stärke, Rauschen, woher das Licht kommt. Zehn Sekunden Messen schlagen eine Stunde Raten.
  2. Stellen Sie zuerst den absoluten Maßstab richtig, und zwar auf zwei Arten. Der CG-Maßstab im Verhältnis zu den Schauspielern hängt direkt von der Kamera-Objekt-Entfernung ab. Messen Sie sie anhand der Pixelgröße eines bekannten Objekts (ein Kopf ist etwa 0,24 m von Scheitel bis Kinn) und anhand der Fokusentfernung des Objektivs in der Kameradatei. Wenn sie nicht übereinstimmen, halten Sie an und lösen Sie das Problem. Eine falsch gemessene Entfernung macht die gesamte CG-Szene in jedem Einzelbild falsch groß. Fügen Sie niemals einen Korrekturfaktor hinzu, um einen Skalierungsfehler zu verbergen.
  3. Finden Sie das Hauptlicht anhand der Schauspieler, nicht anhand eines Briefings oder Setfotos. Vergleichen Sie die beiden Gesichtsseiten im linearen Licht. Setfotos zeigen, welche Lichter vorhanden sind; die Platte zeigt, welches dominiert.
  4. Compositen Sie im linearen Licht und geben Sie an, was die Platte ist. Anzeigereferenziertes Video: linearisieren, mischen, neu kodieren. Gehen Sie nicht von Log aus, nur weil ein Bild flach aussieht.
  5. Betrachten Sie das Bild in voller Größe und in Ausschnitten. Thumbnails verstecken Spill, Löcher und Ränder. Öffnen Sie immer die Vorschau, die ein Werkzeug schreibt, bevor Sie einer Matte vertrauen.
  6. Ein Fix kann schlimmer sein als der Fehler. Überprüfen Sie nach jedem Fix das gesamte Bild erneut und messen Sie das nach, was Sie schützen wollten.
  7. Sie können kein Video ansehen. Messen Sie Bewegung mit Zahlen (Schrittweiten, Zittern) und sagen Sie klar, was nur die Augen des Benutzers beurteilen können.
  8. Überschreiben Sie niemals Originale. Überprüfen Sie Eingabegrößen/-dauern vor einem langen Render; lassen Sie Quelldateien unberührt.
  9. Seien Sie ehrlich bezüglich Grenzen. Wenn der Benutzer sagt, etwas sieht falsch aus, hat er fast immer recht: Untersuchen Sie, melden Sie Zahlen, sagen Sie, was Sie falsch gemacht haben.

Workflow

0. Aufnahme. Überprüfen Sie jede Datei. Lesen Sie Kamerametadaten, wenn das Format es erlaubt (read_camera_metadata / lightning-emperor metadata): Brennweite (wurde gezoomt?), Fokusentfernung, ISO, Weißabgleich. Fragen Sie nur, was die Arbeit ändert: wo das CG relativ zu den Schauspielern sitzt, Kamerahöhe, Ausgabeformat.

1. Kamera. solve_camera_distance anhand einer bekannten Größe in der Platte und des Objektivfokus; erfordern agree: true. Dann plan_camera (Position, Overscan-Größe, Pixel pro Meter). Rendern Sie mit Overscan (ca. 1,25), sodass getrackte Bewegungen nie den Renderrand zeigen.

2. Beleuchtung. Finden Sie die Hauptlichtseite anhand der Gesichter. plan_lights liefert Startpositionen und -farben (Azimut 0 = von der Kamera, +90 = Kamera-rechts, Kelvin-Farben). Kalibrieren Sie die CG-Belichtung anhand einer Messung in der Platte (Hautstelle, Hintergrund), nicht nach Augenmaß. Blinkende Praktikables: practical_states liefert die Einzelbilder zum Rendern (an/aus).

3. Key. key_frame und öffnen Sie preview_on_grey.png. Der Key kalibriert sich selbst auf den Bildschirm, aber lesen Sie references/keying.md für das, was zu prüfen ist (Löcher in dunkler Kleidung, Spill-Farbstiche, als Inseln zurückgelassene Markierungen).

4. Track (nur wenn sich die Kamera bewegt und der Hintergrund ersetzt wird). track_markers folgt einer Markierungskonstellation mit einer Homographie pro Einzelbild. Lesen Sie references/tracking.md: Einzelbilder mit wenigen Markierungen sind verrauscht, ein flacher Hintergrund ist eine Ebene (eine Homographie ist das richtige Modell), keine Markierungen im Bild bedeutet, Sie halten oder interpolieren.

5. Schatten. shadow_offset berechnet, wo der Schatten eines Schauspielers auf einen Hintergrund fällt, basierend auf der Lichtgeometrie und dem Abstand Schauspieler-Wand. Siehe references/shadows-and-grain.md.

6. Körnung. measure_grain aus dem flachen Bildschirmbereich; auf das CG anwenden, damit es nicht aufgeklebt aussieht. Messen Sie in der endgültigen Auflösung.

7. Composite. composite_frame zuerst auf einem einzelnen Einzelbild. Überprüfen Sie die Wandgröße im Verhältnis zu den Schauspielern, die Schattenseite, Kanten, Schwarzpegel, dann skalieren Sie hoch. Rendern Sie lange Aufträge in Blöcken und überprüfen Sie die Einzelbildzahlen.

8. Übergabe. Wenn das Tracking über einen Abschnitt nicht vertrauenswürdig ist, geben Sie einem Künstler geschichtete Durchläufe und ein ehrliches Qualitätsflag pro Einzelbild, keine vorgeblich fertige Komposition.

Tool-Übersicht

BedarfMCP-ToolCLIAdd-on
Objektiv/Belichtung aus Kameradateiread_camera_metadatametadataPlatten-Panel
Export mit Kameradatei abgleichenalign_clipalign
Objektentfernungsolve_camera_distancedistanceObjekt + Kamera
Kameraposition, Rendergrößeplan_camera, build_shot_sceneAufnahmekamera erstellen
Licht-Rigplan_lightsLichter
Praktikable Ein/Aus-Bilderpractical_statesBlinken
CG-Zustände rendernrender_statesCG rendern
Matte + Despillkey_framekeyPlatten-Werkzeuge
Marker-Trackingtrack_markerstrackPlatten-Werkzeuge
Schattenversatzshadow_offsetshadow-offset
Körnungmeasure_graingrainPlatten-Werkzeuge
Ein-Bild-Compcomposite_framecomp

Tool-Fehler kommen als {"error": "..."} mit dem Grund zurück; korrigieren Sie die Eingabe und wiederholen Sie den Vorgang. Blender läuft als Headless-Jobs. Versuchen Sie nie, einen Socket zu öffnen, der Code in einem laufenden Blender-Fenster ausführt.

Referenzen (lesen Sie sie in dem Schritt, in dem sie relevant sind)

  • references/failure-modes.md - was schiefgeht, warum und die Behebung. Zuerst überfliegen.
  • references/scale-and-distance.md - der Kamera-Entfernungs-Fehler und die Regeln, die ihn verhindern.
  • references/lighting.md - das echte Hauptlicht finden, das Rig aufbauen und kalibrieren.
  • references/compositing.md - Matte, vier Arten von Spill, Pedestal, Weichheit, Licht-Wrap, Prüfungen.
  • references/camera-metadata.md - was Kameradateien Ihnen sagen und wie Sie einen Export darauf abgleichen.
  • references/review.md - wie Sie Kritik-Agents nutzen, ohne sich selbst zu täuschen.
  • references/keying.md - Matte, Despill, Kantenbehandlung und was echtes Filmmaterial uns gelehrt hat.
  • references/tracking.md - Marker-Tracking, Stabilisierung, Lücken.
  • references/shadows-and-grain.md - Schattengeometrie, Körnungsmessung und -abgleich.
  • references/blender-notes.md - Blender 4.2-5.x Scripting-Notizen für Headless-Arbeit.

Verwandte Skills