Fond Transparent
Un seul script, scripts/imgalpha.py, fait le travail. Exécutez-le via uv (sans installation globale) sur
macOS, Linux ou Windows. Définissez l'assistant ia une fois par session shell, depuis le dépôt. Il
résout un chemin absolu, donc un cd ultérieur ne pose pas de problème. Les exemples ci-dessous l'utilisent.
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 n'a pas de fonctions, utilisez donc PowerShell ou 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
Écrivez les couleurs au format r,g,b (ex. --bg 40,96,200). Cela ne nécessite aucun guillemet dans tous les shells. Le format #rrggbb fonctionne aussi, mais mettez-le entre guillemets : PowerShell traite un # nu comme un commentaire, et cmd conserve les guillemets simples.
Flux de travail
-
D'abord, inspectez. Lisez l'image. Ce script convient aux fonds unis ou quasi-unis. Pour les photos ou les fonds chargés, utilisez plutôt un modèle de matting IA (
rembg, voir references/troubleshooting.md). -
Ne touchez jamais à l'original. Écrivez dans un nouveau fichier. Avant de modifier un résultat sur place, copiez-le dans un dossier
backup/<aammjj-hhmm>/à côté. Le script refuse-o= fichier d'entrée sauf si--in-place. -
Supprimez le fond :
ia remove in.jpg -o out.png. La couleur du fond est la médiane de la bordure (--bg 255,255,255pour forcer). Il supprime le fond connecté aux bords ainsi que les poches fermées de la teinte du fond qui n'ont pas de trou, donc la peau, les rayures blanches et les détails en forme d'anneau sont préservés. -
Inspectez sur une couleur contrastée, en zoomant. La transparence cache les problèmes sur fond blanc :
ia preview out.png -o check.jpg --bg 40,96,200 --crop 600,140 --crop 260,1140,60Lisez
check.jpg. Vérifiez aussi sur un fond sombre. Recherchez les halos, les crénelures, les trous dans les détails clairs, le blanc résiduel. -
Corrigez ce que vous voyez, un problème à la fois, en ré-inspectant après chaque correction. Symptôme → table de correction : references/troubleshooting.md.
-
Extras optionnels : pixels résiduels (ci-dessous), recoloration (ci-dessous).
-
Rapportez le chemin de sortie, ce qui a changé, ce qui a été délibérément conservé, et l'emplacement de la sauvegarde.
Pixels résiduels (specks)
Fins filaments blancs entre les mèches de cheveux ou dans les contours sombres. Marquez toujours avant de remplir :
ia specks out.png --mark marked.jpg # entoure chaque candidat ; affiche le nombre
ia specks out.png -o fixed.png --keep 1237,1467 # remplit ; protège une étincelle intentionnelle
Lisez marked.jpg et vérifiez chaque cercle. Si l'un d'eux se trouve sur une partie artistique réelle (dentelle, reflet d'œil, étincelle), utilisez
--keep x,y ou une --region x0,y0,x1,y1. Comparez ensuite avant/après avec preview --crop. Les
paramètres par défaut sont adaptés aux zones sombres et neutres (cheveux noirs, contours). Pour les zones colorées, augmentez
--surround-max-sat.
Recoloration des formes (components, recolor)
ia components out.png # id, bbox, taille, couleur moyenne de chaque forme
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 échantillonne la couleur et la texture de la forme à --like-at dans une image de référence. Chaque
pixel conserve son écart de luminosité/obscurité, donc la texture du pinceau ou du crayon est préservée. Choisissez les formes avec --at
(un point à l'intérieur). C'est plus sûr que les ids, qui changent lorsque l'image change.
Règles
- Inspectez le résultat vous-même (lisez l'image d'aperçu) après chaque étape. Ne supposez pas que les valeurs par défaut ont fonctionné.
- Passez les chemins en arguments et exécutez Python avec
-I. Ne nommez jamais un fichier temporaire d'après un module stdlib (inspect.pya déjà masqué l'import de numpy). - Gardez les fichiers temporaires dans le dossier
tmp/de la tâche ou dans le dossier temporaire système, pas à côté des images de l'utilisateur.
Tests
Lorsque vous développez dans le dépôt du skill, exécutez la suite de tests Python avec 100 % de couverture de branches :
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