Was macht transparenter Hintergrund?
Ein Skript, scripts/imgalpha.py, erledigt die Arbeit. Führe es über uv aus (keine globalen Installationen) auf
macOS, Linux oder Windows. Definiere den Helfer ia einmal pro Shell-Befehl, innerhalb des Repos. Er
löst einen absoluten Pfad auf, sodass ein späteres cd kein Problem ist. Die Beispiele unten verwenden ihn.
bash / zsh / Git Bash:
IA_PY="$(git rev-parse --show-toplevel)/.agents/skills/transparent-background/scripts/imgalpha.py"
ia() { uv run --quiet --python 3.12 --with pillow --with numpy --with scipy python -I "$IA_PY" "$@"; }
ia remove in.jpg -o out.png
PowerShell (cmd.exe hat keine Funktionen, verwende daher PowerShell oder Git Bash):
$IA_PY = Join-Path (git rev-parse --show-toplevel) '.agents/skills/transparent-background/scripts/imgalpha.py'
function ia { uv run --quiet --python 3.12 --with pillow --with numpy --with scipy python -I $IA_PY @args }
ia remove in.jpg -o out.png
Schreibe Farben als r,g,b (--bg 40,96,200). Es benötigt keine Anführungszeichen in einer Shell. #rrggbb funktioniert
ebenso, aber setze es in Anführungszeichen: PowerShell behandelt ein bloßes # als Kommentar, und cmd behält einfache Anführungszeichen.
Arbeitsablauf
-
Zuerst ansehen. Das Bild lesen. Dieses Skript eignet sich für flache oder nahezu flache Hintergründe. Bei Fotos oder unruhigen Hintergründen stattdessen ein KI-Matting-Modell verwenden (
rembg, siehe references/troubleshooting.md). -
Das Original niemals berühren. In eine neue Datei schreiben. Vor dem Bearbeiten eines Ergebnisses an Ort und Stelle eine Kopie in einem
backup/<yymmdd-hhmm>/-Ordner daneben erstellen. Das Skript verweigert-o= Eingabe, außer bei--in-place. -
Hintergrund entfernen:
ia remove in.jpg -o out.png. Die Hintergrundfarbe ist der Median des Randes (--bg 255,255,255zum Erzwingen). Es entfernt den Hintergrund, der mit den Kanten verbunden ist, sowie eingeschlossene Lücken desselben Farbtons, die kein Loch haben, sodass Haut, weiße Streifen und ringförmige Details erhalten bleiben. -
Auf einer kontrastierenden Farbe und vergrößert inspizieren. Transparenz versteckt Probleme auf Weiß:
ia preview out.png -o check.jpg --bg 40,96,200 --crop 600,140 --crop 260,1140,60check.jpglesen. Auch auf dunklem Hintergrund prüfen. Nach Halos, Treppeneffekten, Löchern in hellen Details, übrigem Weiß suchen. -
Beheben, was du siehst, ein Problem nach dem anderen, nach jedem erneut inspizieren. Symptom → Korrektur-Tabelle: references/troubleshooting.md.
-
Optionale Extras: übrige Pixel (unten), Umfärben (unten).
-
Berichten des Ausgabepfads, was geändert wurde, was bewusst erhalten blieb und des Speicherorts des Backups.
Übrige Hintergrundpixel (specks)
Weiße Splitter zwischen Haarsträhnen oder in dunklen Umrissen. Immer vor dem Füllen markieren:
ia specks out.png --mark marked.jpg # kreist jeden Kandidaten ein; gibt die Anzahl aus
ia specks out.png -o fixed.png --keep 1237,1467 # füllen; einen gewünschten Glanzpunkt schützen
marked.jpg lesen und jeden Kreis überprüfen. Wenn einer auf echter Kunst sitzt (Spitze, Augenglanz, Glitzer), verwende
--keep x,y oder eine --region x0,y0,x1,y1. Dann Vorher und Nachher mit preview --crop vergleichen. Die
Standardeinstellungen sind auf dunkle, neutrale Bereiche (schwarze Haare, Umrisse) abgestimmt. Für farbige Bereiche
--surround-max-sat erhöhen.
Formen umfärben (components, recolor)
ia components out.png # ID, BBox, Größe, mittlere Farbe jeder Form
ia recolor out.png -o red.png --at 200,640 --at 1400,500 --like other.png --like-at 1350,880
ia recolor out.png -o red.png --ids 2,3 --color 228,100,91
--like sampelt die Farbe und Textur der Form an --like-at in einem Referenzbild. Jeder
Pixel behält seine Helligkeits-/Dunkelheitsabweichung, sodass Pinsel- oder Kreidetextur erhalten bleibt. Wähle Formen mit --at
(einem Punkt innerhalb von ihnen). Das ist sicherer als IDs, die sich ändern, wenn sich das Bild ändert.
Regeln
- Das Ergebnis selbst inspizieren (das Vorschaubild lesen) nach jedem Schritt. Nicht annehmen, dass die Standardeinstellungen funktioniert haben.
- Pfade als Argumente übergeben und Python mit
-Iausführen. Niemals eine temporäre Datei nach einem Stdlib-Modul benennen (inspect.pyhat einmal den Import von numpy überschattet). - Temporäre Ausgaben im
tmp/-Ordner der Aufgabe oder im System-Temp-Ordner halten, nicht neben den Bildern des Benutzers.
Tests
Bei der Entwicklung innerhalb des Skill-Repositorys die Python-Testsuite mit 100% Branch-Coverage ausführen:
uv run --quiet --python 3.12 --with pytest --with pytest-cov --with pillow --with numpy --with scipy python -I -B -m pytest -q -p no:cacheprovider skills/transparent-background/scripts --cov=imgalpha --cov-branch --cov-fail-under=100