Auto

Key pro Bild messen und mit einer weichen Matte freistellen — ideal für gemischte Grün/Magenta-Batch-Ordner.

Kurzbeschreibung

Auto misst die Chroma-Keyfarbe pro Bild und stellt es mit derselben weichen Soft-Matte wie FX / Glow frei — egal ob grün, magenta oder custom. Bilder ohne erkennbaren Key reicht es unverändert durch. Das macht Auto zur richtigen Wahl für gemischte Batch-Ordner, in denen verschiedene Keyfarben durcheinander liegen.

Wofür / Wann

Du hast einen Batch-Ordner mit gemischten Keys (grün und magenta) und willst nicht pro Bild ein Profil wählen.
Manche Bilder im Ordner haben gar keinen Key und sollen unangetastet bleiben.
Du willst eine weiche, saubere Matte statt einer harten Kante.

Wann nicht Auto:

Du brauchst knackige, harte Pixel-Art-Kanten → ein Sprite-Profil (Green/Magenta Sprite). Auto rät nicht Sprite-vs-FX.
Du willst nur transluzente Effekte sauber lösen und kennst den Fall → FX / Glow (Soft-Matte).

So funktioniert's

Auto misst den Key aus dem Bildrand (gemessen pro Bild, nicht fest vorgegeben) und prüft, ob überhaupt ein Key vorhanden ist (Sättigungs-Gate plus ausreichender Key-Anteil global oder am Rand).

Key erkannt → es wird dieselbe FX-Soft-Matte angewendet (fraktionales Alpha + Despill).
Kein Key → das Bild wird unverändert durchgereicht.

Auto rät bewusst nicht Sprite-vs-FX: eine Messreihe über 41 gelabelte Assets hat gezeigt, dass sich Soft-Fläche und Kantendicke vollständig überlappen — die beste Trennschwelle wäre ein Münzwurf. Die ehrliche Lösung ist daher: Key messen + universelle Soft-Matte + Schutz für Bilder ohne Key. Für harte Pixel-Art-Kanten wählst du selbst ein Sprite-Profil.

Einstellungen

Auto teilt sich die Regler mit FX / Glow (der Key wird gemessen, nicht per Pipette gesetzt):

Regler	Wirkung
Matte-Modus	Weich (Glow) (Default) oder Hart (0/255) — der Despill bleibt in beiden aktiv.
Matte-Härte	Key-relative Hintergrund-Schwelle (Default 82, Bereich 60–95).
Soft-Band	Vordergrund-Anker unterhalb des Keys (Default 10, Bereich 0–60).
Despill-Stärke	Aus / Sanft / Normal (Default) / Stark — entfernt den Key-Tint.
Farb-Recovery	Unmultiply für kräftigeres Ergebnis (Default an).

CLI / Automatisierung

Headless für gemischte Batch-Schleifen — Aufruf und gemeinsame Flags in der CLI-Übersicht. Dieses Profil wählst du mit --profile auto; der Key wird pro Bild gemessen (keine --key-color).

Relevante Flags (teilt sich die Soft-Matte mit FX / Glow): --fx-matte-mode {soft,hard}, --fx-hardness 60–95 (Default 82), --fx-softband 0–60 (Default 10), --fx-despill {off,max,mean,min} und --fx-recover / --no-fx-recover (Farb-Recovery). --key-tolerance greift nur beim Auto-Custom-Key.

Beispiel:

clean_sprite_chromakey.py mixed.png mixed_out.png --profile auto

FAQ

Was passiert mit Bildern ohne Key im Batch? Sie werden unverändert durchgereicht — Auto erkennt das Fehlen eines Keys und tastet das Bild nicht an.

Bekomme ich damit harte Pixel-Art-Kanten? Nein — Auto liefert eine weiche Matte. Für knackige harte Kanten wähle ein Sprite-Profil; Auto rät bewusst nicht zwischen Sprite und FX.

Worin unterscheidet sich Auto von „FX / Glow"? Technisch nutzen beide dieselbe Soft-Matte. Auto misst den Key pro Bild und hat einen Kein-Key-Passthrough — gedacht für gemischte Batch-Ordner. FX / Glow ist das gezielte Einzel-Profil für transluzente Effekte.

Grenzen

Rät nicht Sprite-vs-FX (per Messreihe als nicht trennbar belegt).
Kein manueller Key-Override (Pipette) — der Key wird gemessen.
Weiches Alpha — keine harten Pixel-Art-Kanten (dafür Sprite-Profile).

Beispiele

Auto: Key automatisch erkannt und entfernt.

Auto misst den Key pro Bild und stellt frei — robust für gemischte Ordner.