画像輪郭抽出Unityスクリプト(C#のみで実装)
- ダウンロード商品¥ 2,000




テクスチャから輪郭(アウトライン)を一発抽出。 ネイティブプラグイン不要、C# のみでそのまま使えます。 外側と穴の輪郭を両方抽出できます。 抽出した輪郭画素(ピクセル)をドット絵に向けて輪郭頂点(バーテックス)にも変換できます。 「画像の形をプログラムで扱いたい」 そんな用途にそのまま使える実用ライブラリです。 インポート後すぐに利用可能です。サンプル付きで導入もスムーズです。 輪郭抽出を自分で実装する必要はもうありません。
■ できること
・テクスチャの輪郭(外側と穴含め)を自動取得 ・輪郭の親子関係を自動構築 ・ドット絵に向けて輪郭画素を頂点に変換 ・輪郭を描画
■ ドット絵の輪郭頂点について
FindContours() が返す輪郭は輪郭を構成するピクセル座標の列です。 しかしスプライトとして表示された画像では、 各ピクセルは実際には正方形として描画されます。 ピクセル座標だけでは、「どの角が本当の輪郭なのか」という情報は含まれていません。 ToPixelArtVertices() は、輪郭ピクセルをもとに、精密な輪郭を表す頂点列へ変換します(各ピクセルを正方形として扱います)。 • 頂点はピクセル中心ではなく「角」に対応 • 出力は連続した閉ループになり、描画やジオメトリ生成に利用可能 これはドット絵、特に8x8や16x16といった非常に小さなサイズのスプライトを扱う際に役立ちます。こうしたサイズでは、輪郭のピクセルだけでは、目に見える形状を表現するのに不十分な場合があるからです。
■ 特徴
・完全C#実装 ネイティブプラグイン不要。すべてのUnityプラットフォームで動作します。 ・外側輪郭+穴輪郭+階層構造を自動取得 外側と内側を区別し、親子関係も自動で構築されます。 ・ドット絵の輪郭頂点に対応 輪郭ピクセルから頂点を取得可能。ドット絵の用途に最適です。 ・柔軟なピクセル判定 アルファ値によるしきい値判定、または任意の前景判定(Predicate)に対応。 ・4連結 / 8連結の切り替えが可能 ・実用レベルの品質 単体テスト完備、エッジケースも検証済み。
■ 主な用途
・画像のアウトライン表示 ・ドット絵の輪郭描画 ・ポリゴン生成 ・メッシュ生成 ・選択ツールや編集ツールの開発 ・当たり判定やパス生成 ・AI やナビゲーション補助 ・画像ベースのゲームロジック
■ 同梱内容
・輪郭抽出コアライブラリ ・可視化サンプル - LineRenderer版 - ピクセル描画版 - ドット絵の輪郭頂点描画版 ・サンプルシーン ・フルソースコード ・XMLドキュメント ・NUnitテスト一式
■ 主なAPI
• ContourDetector.FindContoursOpaque(): 不透明ピクセルから輪郭を検出 • ContourDetector.FindContoursByAlpha(): アルファ閾値による検出 • ContourDetector.FindContours(): カスタム条件による検出 • Contour.Pixels: 輪郭ピクセル座標(順序付き) • Contour.ToPixelArtVertices(): ドット絵の画像を想定し、輪郭ピクセル列を輪郭頂点列に変換 • Contour.BoundingBox: バウンディングボックス取得 • Contour.IsHole: 穴かどうかの判定 • Contour.Parent: 親輪郭への参照
■ 可視化サンプルについて
• ContourLineDrawer - LineRendererを使った輪郭描画 - ピクセル中心 / ドット絵頂点モード切替対応 • ContourPixelDrawer - テクスチャへの直接描画 • PixelArtVerticesDrawer - ドット絵の輪郭頂点を点として描画 • 穴輪郭のフィルタリング対応 • 外輪郭と穴輪郭の色が別々調整可能 • Unity Editor上でのパラメータ調整が可能
■ こんな方におすすめ
・Unityで画像処理を扱いたい方 ・ネイティブプラグインを使いたくない方 ・軽量で拡張しやすいライブラリを探している方 ・ツール開発やエディタ拡張を行っている方
サポートとフィードバック
利用中に不明点、不具合、またはご意見等がある場合は、ショップ経由または下記のメールアドレス宛にお気軽にお問合せください。 zhixiang-service@outlook.com 皆様のフィードバックをもとに、さらなる改善を行っていきます。
利用規約
1. 著作権:本内容物の著作権は販売者に帰属します。 2. 利用許諾: ・内容物は、購入者が自由に編集・改変し、個人・非営利活動・商用利用を含めた目的で利用できます。 ・内容物を組み込んだ成果物の公開・販売も自由です。 3. 禁止事項:以下の行為を厳禁とします。 ・本商品の内容物を、有償・無償を問わず、第三者へ再配布、転売、譲渡、または公開すること。 ・本商品を利用して、政治的・反社会的なメッセージを含む成果物を作成・公開すること。 4. 免責事項:本プログラムは動作保証、特定目的への適合を保証しません。利用により生じたいかなる損害についても、販売者は一切責任を負いません。
■ アップデート履歴
[2026-08-09: v1.2.0] • 1.1.0 の ToPixelBoundary() を ToPixelArtVertices() に変更 • ToPixelArtVertices() のラッパーとして、廃止予定の ToPixelBoundary() メソッドを追加 • ToPixelArtVertices() のアルゴリズムを説明するためのコメントを追加 • サンプルスクリプトに PixelArtVerticesDrawer を追加 • ContourDrawer を ContoursDrawer に変更 • ContourLineDrawer を ContourLinesDrawer に変更 • ContourPixelDrawer を ContourPixelsDrawer に変更 [2026-06-09: v1.1.0] • ToPixelBoundary() メソッドおよびテストコードを追加 • 日本語ドキュメントとサンプルシーンを追加 • Contour Drawers サンプルを更新し、ドット絵のピクセル境界表示に対応 [2026-04-11: v1.0.0] • Contour クラスおよびテストコードを追加 • ContourDetector.FindContours メソッド群およびテストコードを追加 • Contour Drawers サンプルを追加



