2D-Animation erstellen (EffectCraft + FilmCraft)
Allgemeine und wiederverwendbare Methode zum Entwerfen, Animieren und Zusammenstellen von Intros, Produktdemos, kurzen Szenen oder 2D-Kurzfilmen in EffectCraft (mit optionalem Schnitt/Export in FilmCraft), mit oder ohne Musikspur.
Referenz für CLI/MCP und gemeinsame Flatpak-Berechtigungen: ../craft-music-video/references/mcp-and-commands.md.
1. Visuelle Regie und Lesbarkeit der Szene
- Örtlichkeiten durch Farbe erkennbar: Beschränken Sie eine kurze Szene auf maximal 2 oder 3 Orte, jeder mit einem dominierenden Licht und einer eigenen Palette (z. B. warmer Korridor/Nacht, durch einen Bildschirm beleuchteter Arbeitsplatz, heller Raum mit einer einzigen Akzentfarbe, die Fehlern oder Alarmen vorbehalten ist).
- Volle Silhouetten statt dünne Konturen: Bauen Sie Charaktere und Hintergründe aus gefüllten geometrischen Formen (Bézierkurven oder abgerundete Rechtecke) mit minimalistischen Gesichtern (einfache Augen, Augenbrauen, Mund) und einer leichten Gegenlichtkante (
rim light) auf der Seite der Lichtquelle. - Silhouettenkontrast: Unterscheiden Sie jeden Charakter bereits in der Miniatur (z. B. abgerundete, geduckte Silhouette vs. aufrechte, breitschultrige Silhouette mit abgehackten Gesten).
- Überdimensionierte Hintergründe für Kamerabewegungen: Zeichnen Sie Hintergründe/Wände breiter als das Bild (
2200–2400 pxfür einen Zoom/Shake in1920×1080oder3600+ pxfür eine panoramische Kamerafahrt), um schwarze Ränder von 10–20 px an den Bildkanten zu vermeiden.
2. Bildausschnitte und visuelle Grammatik
Variieren Sie die Einstellungsgrößen, um die Handlung ohne überflüssigen Text zu erzählen:
| Einstellungsgröße | Narrative Rolle | Technische Best Practices |
|---|---|---|
| Totale (Establishing) | Ort, Beleuchtung und relative Position der Elemente vorstellen | Behalten Sie bei Rückkehr an denselben Ort einen fixen räumlichen Bezugspunkt bei (Schreibtisch, Bildschirm, Schild, Tür) |
| Über die Schulter (OTS) | Ziel der Figur und ihren Blickwinkel auf eine Oberfläche oder ein Objekt zeigen | Verwenden Sie zwischen dem ersten Versuch und dem endgültigen Erfolg exakt denselben OTS-Ausschnitt, um einen sofortigen visuellen Rückbezug zu schaffen |
| Halbtotale / Profil | Haltung, Bewegungen und physische Entwicklung einer Szene verfolgen | Ideal, um allmähliches Zusammensacken, Zurücklehnen auf einem Stuhl oder ausladende Gesten zu zeigen |
| Großaufnahme (Close-up) | Eine Absicht, ein Detail der Oberfläche, eine Hand auf einer Taste, einen Blick oder einen Gag isolieren | Halten Sie die Bewegungen kurz und lesbar; nutzen Sie die Großaufnahme, um saubere Negativflächen zu schaffen |
Berechnung des Kamerabildausschnitts (cam_focus)
Mit einer Null-Kamera als Anker [0, 0] gehorcht das Zentrieren eines Weltpunkts (tx, ty) in der Mitte eines Bildes W × H bei Maßstab sc % exakt:
pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty]
(direkt verfügbar über cam_focus(tx, ty, scale_pct, width, height) in ec_runtime.py).
3. Haltungswechsel, Gewicht und visueller Rhythmus
- Antizipation → Aktion → Nachgeben / Halten:
- Gehen Sie niemals linear von Pose A zu Pose B.
- Fügen Sie vor der Aktion eine kleine, gegenläufige Antizipation ein (z. B. Finger hebt sich und zögert, bevor er eine Taste drückt; Tür öffnet sich leicht, bevor sie zuschlägt; Körper stützt sich ab, bevor er zurückweicht).
- Beenden Sie mit einem leichten Überschwinger (
overshoot) oder einem lesbaren Halt (hold), um Gewicht zu verleihen (z. B. Figur macht einen Schritt zurück und hält inne, um ihre Arbeit zu bewundern).
- Allmähliche Haltungsstufen: Lassen Sie die Haltung während einer Warte- oder Spannungsphase in deutlichen Stufen zwischen zwei Einstellungen wechseln (Neigung des Oberkörpers, Senken des Kopfes, Entspannen der Arme), anstatt in einem ständigen Dahinwogen.
- Einstellungen zwischen Aktionen halten: Lassen Sie die Komposition zwischen den Akzenten atmen (Augenblinzeln, langsamer Mikro-Zoom, blinkender Cursor), anstatt alle Ebenen ununterbrochen zu bewegen.
- Obligatorischer Stummtest: Sehen Sie sich jede Actionszene, jedes Intro oder jede Demo ohne Ton an (oder über 3–5 Schlüsselbilder mit
render-frame). Das Ziel der Figur und der Fortschritt der Szene müssen zu 100 % aus dem Bild allein verständlich sein.
4. Anker von Charakteren, Kameras und Stapelreihenfolge (EffectCraft-Fallstricke)
Diese Regeln verhindern Verschiebungsfehler, abgetrennte Gliedmaßen oder versteckte Elemente in EffectCraft (kompatibel mit After Effects):
A. Nullen und Kameras
comp.layers.addNull()erstellt standardmäßig einen Anker bei[50, 50]und eine Position bei[960, 540]. Erzwingen Sie IMMERanchorPoint.setValue([0, 0]), bevor Sie die Null positionieren oder parenten (das tutmakeCamNullinec_runtime.py).- Weisen Sie IMMER
child.parent = parentVORchild.position.setValue(...)zu, damit die Koordinaten vonchilddirekt im lokalen Koordinatensystem des Parents interpretiert werden.
B. Absolute Regel für Parenting und Transformationen
- Hängen Sie ALLE Kinder an, während das Parent in neutraler Haltung ist (
rotation = 0°,scale = [100, 100]). - Wenden Sie anfängliche Rotationen, Kamerazooms oder Keyframes des Parents erst NACH vollständiger Erstellung der gesamten Kind-Hierarchie an.
- Warum: Das Ändern von
parent.rotationoderparent.scalevor dem Zuweisen vonchild.parent = parentlöst eine inverse AE-artige Kompensation aus, die den Kopf/die Arme aus dem Körper schleudert oder einen ganzen Hintergrund in einer Ecke des Bildes schrumpft.
C. Ankerhierarchie eines gegliederten 2D-Charakters
- Sitzender Charakter:
Rootan der Hüfte (hip_pos) →Chair,Legs,TorsoNull(Drehpunkt Taille[0, 0]) →BackUpperArm(Schulter) →BackForeArm(Ellbogen) →TorsoBody→Head(Halsansatz) →UpperArm→ForeArm. - Stehender Charakter:
Rootam Boden zwischen den Füßen (foot_pos), um die Schuhe bei einem Zoom oder Schritt rückwärts am Boden zu verankern →LegBack/LegFront(Drehpunkt Hüfte) +TorsoPivot(Drehpunkt Hüfte) →Arms,Blazer/Body,Head. - Hals-/Kragenanschluss: Fügen Sie immer eine gefüllte Kragen-/Halsform hinzu, die den oberen Teil des Oberkörpers und den unteren Teil des Kopfes überlappt, damit eine starke Neigung (
25°–35°) niemals eine Lücke zwischen Kinn und Schultern öffnet.
D. Stapelreihenfolge (Stacking Order)
- Innerhalb derselben Formebene (
ADBE Root Vectors Group): Die erste hinzugefügte Gruppe wird OBEN gezeichnet, die letzte UNTEN (Reihenfolge vorne → hinten). - Zwischen verschiedenen Ebenen einer Komposition: Jede neue Ebene wird an Index
1eingefügt (OBEN). Bauen Sie die Ebenen in der Reihenfolge hinten → vorne auf (Hintergrund → Leuchteffekt → Dekor → Charakter → Vordergrund).
5. Lesbarkeit von Text und Trennung diegetisch / Overlay
- Keine permanenten schwarzen Balken: Platzieren Sie Titel, Untertitel oder Legenden im freien Negativraum jeder Einstellung (über einem Bildschirm, in einer dunklen Ecke der Wand, unter einer Horizontlinie), ohne jemals ein Gesicht, eine Bildschirmkante oder ein Schild im Dekor zu überlappen.
- Kontrast und Sicherheitsabstände:
- Wenden Sie einen weichen Schlagschatten an (
ADBE Drop Shadow, Deckkraft190–230, Abstand4–6 px, Unschärfe14–18 px), um die Lesbarkeit auf hellem wie dunklem Hintergrund zu gewährleisten. - Halten Sie horizontale Sicherheitsabstände (
>= 70 pxin1920×1080) und eine lesbare Haltezeit (>= 0.35 snach Ende der Aktion oder des letzten Wortes, auch durch einen Einstellungsschnitt hinweg) ein.
- Wenden Sie einen weichen Schlagschatten an (
- Strikte Trennung Diegetischer Text (
V1) vs. Überlagerter Text (V2):- Text im Dekor (
V1): Schilder, Bildschirmoberflächen, Blätter, Tafeln, Tastaturtasten. Er ist Teil der animierten Welt und in allen Exporten vorhanden. - Überlagerter Text (
V2, ProRes 4444 RGBA): Titel, Einblendungen, Untertitel, Text oder UI-Anmerkungen. Platzieren Sie diese in separaten transparenten Kompositionen, um mit einem Klick eine Version mit Titeln und eine saubere Version exportieren zu können, die im Schnitt exakt identisch ist.
- Text im Dekor (
6. Visuelle Überprüfung und ressourcenschonendes Rendern
- Kontrolle durch Schlüsselbilder vor jedem Video-Render: Verwenden Sie
effectcraft-cli render-frame --max-side 960an 1 bis 2 Schlüsselmomenten pro Einstellung (und--transparentfür OverlaysV2), um Bildausschnitte, Gelenkanschlüsse und Textlesbarkeit in Sekundenschnelle zu überprüfen. - Sicheres sequenzielles Rendern (8 GB RAM / bescheidene CPU):
- Rendern Sie immer nur eine Komposition gleichzeitig (niemals parallele ProRes 4444 RGBA-Render auf 8 GB RAM).
- Begrenzen Sie die Threads (
RAYON_NUM_THREADS=2,OMP_NUM_THREADS=2), starten Sie mit niedriger Priorität (nice -n 15 ionice -c 3), vermeiden Sie--gpu, wenn der VRAM mit dem System-RAM geteilt wird, und lassen Sie 2 Sekunden zwischen zwei Rendervorgängen, um Speicher freizugeben.
7. Gemeinsame T3-Code-Werkzeuge und Abhängigkeiten
Die wiederverwendbaren Skripte befinden sich in ~/.t3/shared/craft-video/:
| Werkzeug | Pfad | Verwendung in der 2D-Animation |
|---|---|---|
| JSX-Runtime für EffectCraft | ~/.t3/shared/craft-video/ec_runtime.py | Importieren Sie JsxBuilder, cam_focus, hex_to_rgba, run_effectcraft_script, um sauber eine .ecproj-Datei zu erzeugen (Anker [0,0], Bézier, Glühen, geglättete/Hold-Keyframes) |
| Sequenzielles Batch-Rendering | ~/.t3/shared/craft-video/render_ec_batch.sh | Rendern Sie Szenen V* (ProRes HQ RGB) und Overlays L*/T* (ProRes 4444 RGBA) mit geringer Last und automatischer Fortsetzung via ffprobe |
| Zusammenstellung & Export FilmCraft | ~/.t3/shared/craft-video/assemble_filmcraft.py | Stellen Sie V1 (+ optional V2 Alpha und A1 Audio) in Rec.709 in einer .fcproj-Datei zusammen und exportieren Sie Master + Clean |
Benötigte Abhängigkeiten
- Python 3.9+ (nur Standardbibliothek)
ffmpegundffprobe- EffectCraft CLI (
effectcraft-clioder Flatpakai.storyteller.effectcraftmit--filesystem-Zugriff) - FilmCraft CLI (
filmcraft-clioder Flatpakai.storyteller.filmcraft) für den Multi-Track-Zusammenschnitt/Export - Optional unter Linux:
nice,ionice,taskset
Beispielbefehle
# Verfügbare Abhängigkeiten prüfen (kein Rendern)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env
# Vorschau des sequenziellen Renderplans mit geringer Last (Szene + Alpha-Titel)
~/.t3/shared/craft-video/render_ec_batch.sh \
--project ./projects/demo_2d.ecproj \
--out-dir ./renders_vfx \
--rgb V01_Intro,V02_Demo \
--rgba T01_Intro,T02_Demo \
--threads 2 --cores 0-3 --dry-run
# Vorschau des FilmCraft-Zusammenschnitts ohne Musik (stummes Intro/Demo, Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
--out-fcproj ./projects/demo_2d.fcproj \
--v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
--v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
--export-master ./exports/demo_2d_titles.mp4 \
--export-clean ./exports/demo_2d_clean.mp4 \
--dry-run