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 Kontur → Magenta 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

Weiche Matte statt 0/1-Alpha — Transluzenz/Glow bleiben erhalten.
Verwandte Features
- Magenta Sprite / Outline — für normale Sprites mit harter dunkler Kontur.
- Magenta FX / Water Plus — stärkere, nachbarfarbengestützte Reinigung für hartnäckige pinke Säume.