FX / Glow (Soft-Matte)

Transluzente Leucht-Effekte — Glow, Rauch, Funken, Energie — sauber freistellen, mit weichem Alpha statt hartem 0/255-Schnitt.

Kurzbeschreibung

FX / Glow (Soft-Matte) stellt transluzente, leuchtende Effekt-Assets (Glow, Rauch, Funken, Energie) sauber von jedem Chroma-Key frei — grün, magenta oder custom. Statt eines harten 0/255-Schnitts erzeugt es ein weiches, fraktionales Alpha und einen flächigen Despill, sodass weiche Wisps und Halos erhalten bleiben und kein Key-Tint als Farbschmutz zurückbleibt.

Wofür / Wann

Dein Asset ist ein transluzenter Effekt mit weichen Übergängen — die harten Sprite-Profile schneiden dir die Funken/Wisps ab und hinterlassen einen Saum.
Der Key-Tint (Grün-/Magenta-Stich) bleibt bei normalen Profilen in den durchscheinenden Flächen als Farbmatsch stehen.
Du arbeitest mit gemischten Keys (grün und magenta) und willst ein Profil, das beide misst.

Wann nicht FX / Glow:

Du brauchst knackige, harte Pixel-Art-Kanten → ein Sprite-Profil (Green Sprite / Magenta Sprite). FX rät bewusst nicht Sprite-vs-FX.
Du hast einen klassischen, opaken Greenscreen → Green Sprite.

So funktioniert's

FX / Glow ist key-agnostisch und misst die Keyfarbe aus dem Bildrand (Median der gesättigten Randpixel). Die Schwellen skalieren auf die echte Key-Differenz — das funktioniert robust auch dann, wenn der Key 95 % des Bildes füllt (kein Perzentil-Anker, der kippt).

Aus dieser Messung entsteht eine weiche Chroma-Matte: das Alpha ist fraktional (alpha = clip((t_bg − diff)/(t_bg − t_fg), 0, 1)), die Schwellen sind key-relativ. Ein flächiger Despill zieht den Key-Tint aus den durchscheinenden Flächen (nicht nur im Kantenband), und eine optionale Farb-Recovery (Unmultiply) macht das Glow wieder kräftiger.

Einstellungen

Regler	Wirkung
Matte-Modus	Weich (Glow) (Default) erhält fraktionales Alpha; Hart (0/255) schwellt bei 0.5 — der Despill bleibt aktiv.
Matte-Härte	Key-relative Hintergrund-Schwelle. Default 82 (Bereich 60–95).
Soft-Band	Wie weit unterhalb des Keys der Vordergrund-Anker sitzt. Default 10 (Bereich 0–60).
Despill-Stärke	Aus · Sanft · Normal (Default) · Stark — entfernt den Key-Tint aus den Vordergrundfarben.
Farb-Recovery	Unmultiply für kräftigeres Glow. Default an (`--no-fx-recover` schaltet ab).

Die Defaults treffen die Härtefälle out-of-the-box (Normal-Despill / Härte 82 / Soft-Band 10 / Recovery an / weich) — über 13 reale Assets validiert.

Empfohlene Einstellungen je Anwendungsfall:

Asset-Typ	Empfehlung
Glow/Rauch/Funken, weiche Wisps	Default (Weich, Despill Normal)
Key-Tint stark in der Fläche	Despill Stark
Glow wirkt blass	Farb-Recovery an (Default)
Effekt mit klar definierter Kante gewünscht	Hart (0/255) (Despill bleibt aktiv)

CLI / Automatisierung

Headless dasselbe Soft-Matte-Freistellen — Aufruf und gemeinsame Flags in der CLI-Übersicht. Dieses Profil wählst du mit --profile fx_glow; der Key wird aus dem Bildrand gemessen (keine --key-color).

Relevante Flags (entsprechen den Reglern oben): --fx-matte-mode {soft,hard}, --fx-hardness 60–95 (Matte-Härte, Default 82), --fx-softband 0–60 (Soft-Band, Default 10), --fx-despill {off,max,mean,min} (Despill-Stärke) und --fx-recover / --no-fx-recover (Farb-Recovery, Default an).

Beispiel:

clean_sprite_chromakey.py glow.png glow_out.png --profile fx_glow

FAQ

Muss ich die Keyfarbe per Pipette wählen? Nein — FX / Glow misst den Key aus dem Bildrand. Ein manueller Key-Override per Pipette ist für dieses Profil bewusst nicht vorgesehen.

Wie hängt FX / Glow mit dem „Auto"-Profil zusammen? Auto misst den Key pro Bild und wendet dieselbe Soft-Matte an — ideal für gemischte Grün/Magenta-Batch-Ordner; Bilder ohne Key reicht es unverändert durch. Auto rät nicht Sprite-vs-FX (per Messreihe als nicht zuverlässig trennbar belegt) — für harte Pixel-Art-Kanten wählst du selbst ein Sprite-Profil.

Mein Magenta-Hintergrund wurde vorher gar nicht entfernt. Ältere Magenta-Profile entfernten still 0 Pixel, wenn der Key den Bildrand nicht berührte. Ein globaler Magenta-Fallback keyt den Hintergrund jetzt auch dann — bewusst konservativ, damit innenliegende Magenta-Details normaler Sprites geschützt bleiben.

Grenzen

Rät nicht Sprite-vs-FX — knackige Pixel-Art-Kanten bleiben eine manuelle Sprite-Wahl.
Kein manueller Key-Override (Pipette) für FX — der Key wird gemessen.
Kein Denoise-Floor für feinsten Rest-Rausch und kein Rand-Trim für den ~1 px hellen Bildsaum mancher Assets.

Beispiele

FX/Glow: links transluzente FX auf Greenscreen, rechts Soft-Matte auf dunklem Hintergrund mit erhaltenem Glow.

Soft-Matte statt 0/1-Alpha: der Greenscreen ist weg, der weiche Glow/die Transluzenz bleiben erhalten.