Community画像github.com

透明背景化

フラットまたはほぼフラットな背景(イラスト、ステッカー、ロゴ、スキャン画像、白背景の商品写真)を持つ画像を、クリーンな透明PNGに変換し、さらに白色のハローやギザギザのエッジ、髪の毛の間や輪郭内部に残った背景ピクセルを修正、さらに必要に応じて個別の形状(マーク、テキスト、アイコン)を指定またはサンプリングした色に再着色します。

透明背景化 とは?

このスキルは、フラットまたはほぼフラットな背景を持つ画像から背景を除去し、透明なPNG画像に変換するためのツールです。主にイラスト、ステッカー、ロゴ、スキャン画像、白背景の商品写真などに適しています。単に背景を除去するだけでなく、白色のハローやギザギザのエッジ、髪の毛の間や輪郭内部に残った背景ピクセル(specks)を検出・修正する機能や、個々の形状(マーク、テキスト、アイコンなど)を特定の色に再着色する機能も備えています。macOS、Linux、Windowsで動作し、Pythonとuvを使用してスクリプトを実行します(グローバルインストール不要)。ワークフローは、画像の確認、背景除去、プレビューによる確認、問題の修正、出力と変更点の報告という手順で構成されています。修正手順は症状に応じて詳細なトラブルシューティングガイドが提供されており、開発者はこのガイドに従って透明化の品質を高めることができます。

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

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

透明背景化 は何をしますか?

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はシングルクォートを保持します。

ワークフロー

  1. 最初に確認する。 画像を読み込みます。このスクリプトはフラットまたはほぼフラットな背景に適しています。写真や複雑な背景の場合は、代わりにAIマッティングモデル(rembg、references/troubleshooting.mdを参照)を使用してください。

  2. 元の画像は絶対に変更しない。 新しいファイルに書き込みます。結果を直接編集する前に、その隣にbackup/<yymmdd-hhmm>/フォルダにコピーを作成してください。スクリプトは--in-placeが指定されていない限り、-oに入力ファイルを指定することを拒否します。

  3. 背景を除去する: ia remove in.jpg -o out.png。背景色は境界の中央値です(--bg 255,255,255で強制指定できます)。エッジに接続された背景と、背景色の色合いで穴のない閉じた隙間を除去するため、肌色、白いストライプ、リング状のディテールは保持されます。

  4. コントラストのある色で、ズームして確認する。 透明化の問題は白い背景では見えにくくなります。

    ia preview out.png -o check.jpg --bg 40,96,200 --crop 600,140 --crop 260,1140,60
    

    check.jpgを読み込みます。暗い背景でも確認してください。ハロー、階段状のエッジ、明るいディテールの穴、白い残留物を探します。

  5. 見つけた問題を修正する、一度に1つずつ、各修正後に再確認します。症状→修正の表:references/troubleshooting.md。

  6. オプションの追加機能: 残留ピクセル(後述)、再着色(後述)。

  7. 報告する: 出力パス、変更点、意図的に保持したもの、バックアップ場所。

残留背景ピクセル(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

関連スキル