CommunityBildgithub.com

transparenter Hintergrund

Wandle ein Bild mit einem flachen oder nahezu flachen Hintergrund (Illustration, Aufkleber, Logo, Scan, Produktfoto auf Weiß) in ein sauberes transparentes PNG um und behebe anschließend verbleibende Fehler – weiße Ränder, ausgefranste Kanten, übrige Hintergrundpixel zwischen Haarsträhnen oder in Umrissen – und färbe bei Bedarf einzelne Formen (Markierungen, Text, Symbole) in eine vorgegebene oder ausgesampelte Farbe um.

Was ist transparenter Hintergrund?

Diese Fähigkeit wandelt Bilder mit flachem oder nahezu flachem Hintergrund in transparente PNGs um und bietet Werkzeuge zur Nachbearbeitung. Ein einzelnes Python-Skript (`imgalpha.py`) wird über `uv` ausgeführt – ohne globale Installationen – und ist somit plattformunabhängig (macOS, Linux, Windows) und isoliert. Der Arbeitsablauf umfasst: Hintergrundentfernung (über den Median der Randpixel), Inspektion auf kontrastierendem Hintergrund (Check auf Halos, Treppeneffekte, weiße Überreste), Entfernung von Hintergrundpixeln („specks“) mit Schutz für gewünschte Bilddetails und optionales Umfärben von Formen (IDs oder Punktauswahl) unter Erhalt von Textur und Helligkeit. Die Fähigkeit betont strikte Sicherheitsregeln (nie das Original überschreiben, Backups anlegen, Ergebnis nach jedem Schritt selbst prüfen) und bietet eine ausführliche Referenz für häufige Probleme und deren Lösungen. Unterstützte Plattformen: Claude Code, Cursor, Codex oder jedes System, das `uv` und Python ausführen kann.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shino369/kyoten-skills/tree/HEAD/skills/transparent-background

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

  1. 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).

  2. 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.

  3. Hintergrund entfernen: ia remove in.jpg -o out.png. Die Hintergrundfarbe ist der Median des Randes (--bg 255,255,255 zum 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.

  4. 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,60
    

    check.jpg lesen. Auch auf dunklem Hintergrund prüfen. Nach Halos, Treppeneffekten, Löchern in hellen Details, übrigem Weiß suchen.

  5. Beheben, was du siehst, ein Problem nach dem anderen, nach jedem erneut inspizieren. Symptom → Korrektur-Tabelle: references/troubleshooting.md.

  6. Optionale Extras: übrige Pixel (unten), Umfärben (unten).

  7. 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 -I ausführen. Niemals eine temporäre Datei nach einem Stdlib-Modul benennen (inspect.py hat 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

Verwandte Skills