Green Sprite (Grünscreen-Keying)

Der klassische Greenscreen-Entferner für Pixel-Art-Sprites: grüner Hintergrund raus, harte Kanten rein — ohne Skalieren.

Kurzbeschreibung

Green Sprite ist das Standard-Profil zum Freistellen grün-gekeyter Pixel-Art-Sprites: Es entfernt den grünen Hintergrund global und liefert eine saubere, harte Pixel-Art-Kante (Alpha 0/255, kein Resampling). Es ist das erste und einfachste Chroma-Key-Profil der App und der richtige Startpunkt, wenn Grün nur der Hintergrund ist und nicht Teil des Motivs.

Wofür / Wann

Du hast ein Sprite oder Sprite-Sheet auf reinem grünen Hintergrund (#00FF00 oder eine ähnliche Keyfarbe) und willst es freistellen.
Das Motiv selbst enthält kein Grün, das erhalten bleiben soll — der globale Grün-Test darf alles Grüne entfernen.
Du brauchst harte Pixel-Art-Kanten ohne weiche Halbtransparenz.

Wann nicht dieses Profil:

Grün ist auch Motivfarbe (z. B. grüne Pixel-Schrift auf grünem Key) → Green Sprite (hart, inhalt-sicher), das nur randverbundenes Grün entfernt.
Bereits freigestellt, nur noch Grün-Reste am Rand → Reste entfernen.
Transluzente Leucht-Effekte (Glow/Smoke/Sparkles) → FX / Glow (Soft-Matte).

So funktioniert's

Green Sprite erkennt den Hintergrund über die Grün-Dominanz (Grün ist der stärkste Kanal) und entfernt diese Pixel im ganzen Bild — unabhängig davon, ob sie am Rand oder im Inneren liegen. Das macht es einfach und robust für klassische Sprites, ist aber genau der Grund, warum es Motiv-Grün mitnimmt (dafür gibt es das harte, inhalt-sichere Profil).

Optional räumt ein Kanten-Cleanup den schmalen Saum auf, der nach dem Keying zurückbleibt:

Green Black Outline Repair repariert dunkle/olivgrüne Outline-Pixel, die durch den grünen Hintergrund kontaminiert wurden — distanzbegrenzt, damit es die inneren Sprite-Farben nicht erreicht.
Green Magic Outline Repair entfernt kleine grün/cyanfarbene Reste an Magie-/Effekt-Rändern, ohne größere türkise Motivflächen anzutasten.

Einstellungen

Regler	Wirkung
Key-Farbe	Die zu entfernende Hintergrundfarbe. Default #00FF00; per Pipette aus dem Bild wählbar (optional 3×3-Durchschnitt).
Kanten-Cleanup	An (Default) korrigiert den Saum; Aus entfernt nur den Hintergrund und lässt die Kante unangetastet.
Spill-Radius	Wie breit das Kantenband behandelt wird (1–4, Default 2).
Spill-Stärke	Sanft / Normal / Stark / Maximal — wie aggressiv der Grünstich aus der Kante gezogen wird.
Green-Reparatur	Aus / Sanft / Normal / Stark — schaltet Black-/Magic-Outline-Repair für kontaminierte Kanten zu.

Empfohlene Einstellungen je Anwendungsfall:

Asset-Typ	Empfehlung
Klassisches Pixel-Art-Sprite, reiner grüner Key	Default (Kanten-Cleanup an, Spill 2, Normal)
Dunkle/olivgrüne Outline kontaminiert	Green-Reparatur Normal/Stark
Harte Kante exakt erhalten, nichts am Saum ändern	Kanten-Cleanup Aus

CLI / Automatisierung

Dasselbe Freistellen läuft headless für Skripte und Batch-Schleifen — Aufruf, Positional-Argumente input output und die gemeinsamen Key-Flags erklärt die CLI-Übersicht. Dieses Profil wählst du mit --profile green (Operation chromakey ist Default).

Relevante Flags (entsprechen den Reglern oben): --key-color (Key-Farbe), --edge-cleanup {on,off} (Kanten-Cleanup), --spill-radius 1–4, --spill-strength {conservative,normal,strong,maximum} sowie --green-repair {off,soft,normal,strong} (Green-Reparatur).

Beispiel:

clean_sprite_chromakey.py sprite.png sprite_out.png --profile green --green-repair normal

FAQ

Warum verschwindet auch grünes Motiv (Schrift, Pflanzen)? Green Sprite arbeitet global über die Grün-Dominanz und unterscheidet nicht zwischen Hintergrund- und Motiv-Grün. Wenn Grün Teil des Motivs ist, nimm Green Sprite (hart, inhalt-sicher) — es entfernt nur den randverbundenen Hintergrund und lässt eingeschlossenes Innen-Grün stehen.

Skaliert das Profil mein Sprite? Nein. Chroma-Key arbeitet pixelgenau und ändert die Auflösung nie. Verkleinern/Vergrößern sind eigene Operationen (UnDetail, Pixelize, Asset Slice).

Mein freigestelltes Sprite hat noch grüne Spritzer — hilft Green Sprite? Nein, dafür ist Reste entfernen gedacht (es arbeitet auf dem bereits transparenten Bild). Green Sprite keyt einen vorhandenen Hintergrund, repariert aber keine fertigen Freisteller.

Grenzen

Motiv-Grün wird mitentfernt — das ist gewollt (globaler Key). Für gemischtes Grün ist das harte Profil zuständig.
Weiche Verläufe / Anti-Aliasing: Green Sprite liefert harte Kanten (0/255). Für transluzente Glow-/Rauch-Effekte mit weichem Alpha ist FX / Glow das richtige Profil.
Kein Skalieren / kein Resampling — bewusste Invariante des Chroma-Key-Flows.

Beispiele

Green-Keying: links Sprites auf Greenscreen, rechts freigestellt auf Transparenz-Karo.

Greenscreen-Hintergrund entfernt — der Inhalt bleibt, Transparenz als Karo dargestellt.