Magenta Sprite / Outline

Magenta-gekeyte Sprites mit harter dunkler Kontur freistellen — nur der Hintergrund weg, eingeschlossenes Magenta im Motiv bleibt.

Kurzbeschreibung

Magenta Sprite / Outline stellt Sprites mit harter dunkler Kontur auf magenta gekeytem Hintergrund frei. Es entfernt nur das vom Bildrand verbundene Magenta und lässt eingeschlossenes Magenta/Violett/Pink im Motiv stehen. Anschließend räumt ein Edge-Cleanup magenta-kontaminierte Outline-Pixel auf eine saubere dunkle Kante (#12091f).

Wofür / Wann

Dein Sprite ist auf Magenta gekeyt und hat eine harte, dunkle Outline (klassische Pixel-Art-Kontur).
Das Motiv enthält eigenes Magenta/Pink/Violett, das erhalten bleiben soll.
Der Hintergrund ist nicht exakt #FF00FF — reale Keys variieren (z. B. (242,5,236), (234,12,199)); ein reiner Distanzvergleich gegen #FF00FF reicht nicht.

Wann nicht dieses Profil:

Wasser-/Licht-/Nebel-/Energy-FX, bei denen eine schwarze Outline-Neutralisierung falsch wäre → Magenta FX / Water.
Pinke Säume bleiben nach der FX-Reinigung übrig → Magenta FX / Water Plus.
Transluzente Glow-Effekte mit weichem Alpha → FX / Glow (Soft-Matte).

So funktioniert's

Der Hintergrund wird über eine magentaartige Erkennung gefunden — Rot und Blau dominant, Grün deutlich niedriger (grob R>140, B>140, G<150, R>G+45, B>G+45). Entfernt werden nur magentaartige Pixel, die vom Bildrand aus verbunden erreichbar sind (randverbundenes Fluten) — isolierte Magenta-Details im Sprite bleiben dadurch erhalten.

Nach dem Keying prüft das Edge-Cleanup verbleibende opake Pixel im Abstand von 1–2 px zur Transparenz: dunkle, magenta-kontaminierte Outline-Pixel (R>G+8, B>G+8, Luminanz <120) werden zur sauberen dunklen Kontur #12091f neutralisiert. Die Kante bleibt hart (Pixel-Art-Invariante).

Einstellungen

Regler	Wirkung
Key-Farbe	Die Magenta-Keyfarbe. Schnellbutton #FF00FF; per Pipette aus dem Bild wählbar (reale Keys weichen oft ab).
Kanten-Cleanup	An (Default) neutralisiert kontaminierte Outline-Pixel zu `#12091f`; 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 Kanten-Korrektur.

Empfohlene Einstellungen je Anwendungsfall:

Asset-Typ	Empfehlung
Magenta-Sprite mit dunkler Outline	Default (Kanten-Cleanup an)
Harte Kante exakt erhalten, nur Hintergrund weg	Kanten-Cleanup Aus
Pinker Saum bleibt sichtbar	→ Magenta FX / Water Plus

CLI / Automatisierung

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

Relevante Flags: --key-color (Magenta-Key, Default #FF00FF; reale Keys weichen oft ab), --edge-cleanup {on,off} (neutralisiert kontaminierte Outline-Pixel zu #12091f) sowie --spill-radius / --spill-strength.

Beispiel:

clean_sprite_chromakey.py sprite.png sprite_out.png --profile magenta_sprite --key-color #FF00FF

FAQ

Warum bleibt Magenta im Inneren des Sprites stehen? Das ist gewollt: nur randverbundenes Hintergrund-Magenta wird entfernt. Eingeschlossene Magenta-/Pink-Details gehören zum Motiv und bleiben erhalten.

Mein Key ist nicht exakt #FF00FF — funktioniert das trotzdem? Ja. Die Erkennung läuft über die Magenta-Dominanz (R/B hoch, G niedrig), nicht über reine Distanz zu #FF00FF. Picke die echte BG-Farbe per Pipette für ein präzises Ergebnis.

Die Outline sieht nach dem Keying noch pink/kontaminiert aus. Das Kanten-Cleanup (an) neutralisiert dunkle, kontaminierte Outline-Pixel zu #12091f. Bleibt ein heller pinker Saum, ist Magenta FX / Water Plus das richtige Profil.

Grenzen

Schwarze Outline-Neutralisierung ist für FX-Assets falsch — dort Wasser-/Licht-Kanten nicht nach Schwarz ziehen; nimm Magenta FX / Water.
Hartes Alpha (0/255) — für weiche, transluzente Effekte ist FX / Glow zuständig.
Kein Skalieren / kein Resampling.

Beispiele

Magenta-Hintergrund entfernt — harte Pixel-Art-Kanten, Inhalt bleibt.