LiveMutaSprite ist live. Jetzt auf Gumroad und itch.io — ab sofort kaufen und laden.
Handbuch/ Chroma-Key-Profile/ Magenta FX / Water

Magenta FX / Water

Magenta-gekeyte Wasser-, Licht- und Energy-FX freistellen — Kanten werden gekühlt statt nach Schwarz neutralisiert.

Kurzbeschreibung

Magenta FX / Water stellt Wasser-, Licht-, Nebel- und Energy-Effekte auf magenta gekeytem Hintergrund frei. Es nutzt dieselbe randverbundene Magenta-Erkennung wie das Sprite-Profil, verzichtet aber bewusst auf die schwarze Outline-Neutralisierung — die wäre bei FX falsch. Stattdessen werden kontaminierte Randpixel gekühlt/entsättigt Richtung Cyan/Weiß.

Wofür / Wann

  • Dein Asset ist ein transluzenter oder farbiger Effekt (Wasser, Licht, Nebel, Energie) auf Magenta-Key.
  • Eine dunkle Outline-Korrektur (wie beim Sprite-Profil) würde die Effekt-Kanten verfälschen — sie sollen nicht nach Schwarz, sondern Richtung Cyan/Weiß gehen.

Wann nicht dieses Profil:

  • Normales Sprite mit harter dunkler KonturMagenta Sprite / Outline.
  • Pinke Säume bleiben nach dieser Reinigung übrig → Magenta FX / Water Plus.
  • Weiches, fraktionales Alpha für Glow/Funken nötig → FX / Glow (Soft-Matte).

So funktioniert's

Die Hintergrund-Erkennung ist identisch zum Sprite-Profil: magentaartige, randverbundene Key-Flächen werden entfernt, eingeschlossenes Motiv-Magenta bleibt.

Beim Edge-Cleanup gibt es keine schwarze Outline-Neutralisierung. Magenta-kontaminierte Randpixel werden nur dann behandelt, wenn sie klar pinken Spill zeigen (konservativ: R>G+12, B>G+12, R>120, B>120). Dann wird der Rotanteil reduziert, Grün leicht angehoben und Blau erhalten oder leicht gestärkt — das Alpha bleibt 255. Ziel: Wasser-/ Lichtkanten Richtung Cyan/Weiß schieben statt nach Schwarz.

Einstellungen

Regler Wirkung
Key-Farbe Die Magenta-Keyfarbe. Schnellbutton #FF00FF; per Pipette wählbar (reale Keys variieren).
Kanten-Cleanup An (Default) kühlt pinke Randkontamination Richtung Cyan/Weiß; Aus entfernt nur den Hintergrund.
Spill-Radius Breite des behandelten Kantenbands (1–4, Default 2).
Spill-Stärke Sanft / Normal / Stark / Maximal — Aggressivität der Kühlung.

Empfohlene Einstellungen je Anwendungsfall:

Asset-Typ Empfehlung
Magenta-Wasser/-Licht/-Energie Default (konservatives Kühlen)
Pinker Saum bleibt sichtbar Magenta FX / Water Plus
Nur Hintergrund weg, Kante unangetastet Kanten-Cleanup Aus

CLI / Automatisierung

Headless dasselbe FX-Keying — Aufruf und gemeinsame Flags in der CLI-Übersicht. Dieses Profil wählst du mit --profile magenta_fx.

Relevante Flags: --key-color (Magenta-Key, Default #FF00FF), --edge-cleanup {on,off} (kühlt pinke Randkontamination Richtung Cyan/Weiß) sowie --spill-radius / --spill-strength.

Beispiel:

clean_sprite_chromakey.py water.png water_out.png --profile magenta_fx

FAQ

Worin unterscheidet es sich vom Sprite-Profil? Die Hintergrund-Erkennung ist gleich, das Edge-Cleanup nicht: Das Sprite-Profil neutralisiert dunkle Outline-Pixel nach Schwarz (#12091f); FX / Water kühlt Randpixel Richtung Cyan/Weiß und behält Alpha 255. Für FX wäre eine schwarze Kante falsch.

Es bleibt ein heller pinker Saum übrig. Die FX-Reinigung ist bewusst konservativ. Für hartnäckige pinke/lavendelfarbene Säume nimm Magenta FX / Water Plus — es zieht Randpixel mithilfe passender Nachbarfarben weiter sauber.

Brauche ich für weiches Glow dieses Profil? Für transluzentes Glow mit fraktionalem Alpha ist FX / Glow (Soft-Matte) besser — es erzeugt weiches Alpha statt einer harten Kante.

Grenzen

  • Konservativ by design — lässt im Zweifel lieber einen Rest stehen (dafür gibt es das Plus-Profil).
  • Hartes Alpha — für weiche Wisps/Funken ist FX / Glow zuständig.
  • Kein Skalieren / kein Resampling.

Beispiele

Magenta FX: links FX auf Magenta, rechts Soft-Matte auf dunklem Hintergrund.

Weiche Matte statt 0/1-Alpha — Transluzenz/Glow bleiben erhalten.

Verwandte Features