透明背景化 は何をしますか?
1つのスクリプト、scripts/imgalpha.pyがすべての作業を行います。uvを使用して実行します(グローバルインストールは不要)。macOS、Linux、Windowsで動作します。リポジトリ内で、シェルコマンドごとにiaヘルパーを一度だけ定義してください。このヘルパーは絶対パスを解決するため、後でcdしても問題ありません。以下の例ではこれを使用しています。
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には関数がないため、PowerShellまたは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
色はr,g,b形式(--bg 40,96,200)で指定します。どのシェルでも引用符は必要ありません。#rrggbb形式も使用できますが、引用符で囲んでください。PowerShellでは裸の#はコメントとして扱われ、cmdはシングルクォートを保持します。
ワークフロー
-
最初に確認する。 画像を読み込みます。このスクリプトはフラットまたはほぼフラットな背景に適しています。写真や複雑な背景の場合は、代わりにAIマッティングモデル(
rembg、references/troubleshooting.mdを参照)を使用してください。 -
元の画像は絶対に変更しない。 新しいファイルに書き込みます。結果を直接編集する前に、その隣に
backup/<yymmdd-hhmm>/フォルダにコピーを作成してください。スクリプトは--in-placeが指定されていない限り、-oに入力ファイルを指定することを拒否します。 -
背景を除去する:
ia remove in.jpg -o out.png。背景色は境界の中央値です(--bg 255,255,255で強制指定できます)。エッジに接続された背景と、背景色の色合いで穴のない閉じた隙間を除去するため、肌色、白いストライプ、リング状のディテールは保持されます。 -
コントラストのある色で、ズームして確認する。 透明化の問題は白い背景では見えにくくなります。
ia preview out.png -o check.jpg --bg 40,96,200 --crop 600,140 --crop 260,1140,60check.jpgを読み込みます。暗い背景でも確認してください。ハロー、階段状のエッジ、明るいディテールの穴、白い残留物を探します。 -
見つけた問題を修正する、一度に1つずつ、各修正後に再確認します。症状→修正の表:references/troubleshooting.md。
-
オプションの追加機能: 残留ピクセル(後述)、再着色(後述)。
-
報告する: 出力パス、変更点、意図的に保持したもの、バックアップ場所。
残留背景ピクセル(specks)
髪の毛の間や暗い輪郭内部の白い細片。常に充填前にマークします。
ia specks out.png --mark marked.jpg # すべての候補を丸で囲みます。カウントを表示します。
ia specks out.png -o fixed.png --keep 1237,1467 # 充填; 意図的なスパークルを保護します。
marked.jpgを読み込み、すべての丸を確認します。丸が実際のアート(レース、目の輝き、スパークル)にかかっている場合は、--keep x,yまたは--region x0,y0,x1,y1を使用します。その後、preview --cropで前後を比較します。デフォルトは暗いニュートラルな領域(黒い髪、輪郭)向けに調整されています。色付きの領域の場合は--surround-max-satを上げてください。
形状の再着色(components、recolor)
ia components out.png # 各形状のID、バウンディングボックス、サイズ、平均色を表示
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は、参照画像の--like-atにある形状の色とテクスチャをサンプリングします。各ピクセルは明暗の偏差を保持するため、ブラシやクレヨンのテクスチャが維持されます。--at(形状内部の点)で形状を選択します。IDは画像が変更されると変わるため、IDよりも安全です。
ルール
- 各ステップの後に、結果を自分で確認してください(プレビュー画像を読み込んでください)。デフォルトが機能したと想定しないでください。
- パスは引数として渡し、Pythonは
-Iで実行してください。スクラッチファイルにstdlibモジュールの名前(inspect.pyがnumpyのインポートを影で隠したことがありました)を付けないでください。 - スクラッチ出力は、タスクの
tmp/またはシステムのテンポラリフォルダに保存し、ユーザーの画像の隣には保存しないでください。
テスト
スキルリポジトリ内で開発する場合は、100%のブランチカバレッジでPythonテストスイートを実行します。
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