> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ja/burokku/blocks/visualize-predictions/color-visualization.md).

# カラー可視化

画像内の検出オブジェクトに単色を塗ります。

カスタマイズ可能なカラーパレットを使用して、検出されたオブジェクトを単色で塗りつぶし、透明度のブレンドによって画像の詳細を保ちながら、異なるオブジェクトやクラスを識別する色分けオーバーレイを作成します。

## このブロックの仕組み

このブロックは画像と検出予測を受け取り、検出されたオブジェクト領域を単色で塗りつぶします。このブロックは、

1. 画像と予測を入力として受け取ります
2. バウンディングボックスまたはセグメンテーションマスクから検出領域を特定します
3. 選択したカラーパレットに基づいて色を適用し、クラス、インデックス、またはトラックIDごとに色を割り当てます
4. Supervision の ColorAnnotator を使用して、検出されたオブジェクト領域を単色で塗りつぶします
5. 透明度設定に基づいて、色付きオーバーレイを元の画像とブレンドします
6. 検出されたオブジェクトが色で塗りつぶされた注釈付き画像を返し、それ以外の画像部分は変更されません

このブロックは、オブジェクト検出予測（バウンディングボックスを使用）とインスタンスセグメンテーション予測（マスクを使用）の両方に対応しています。マスクが利用可能な場合は、検出されたオブジェクトの正確な形状を塗りつぶします。そうでない場合は、長方形のバウンディングボックス領域を塗りつぶします。色は、色軸の設定（クラス、インデックス、またはトラックID）に基づいて選択されたパレットから割り当てられ、異なるオブジェクトやクラスを色で区別できます。透明度パラメータは、色付きオーバーレイの透過度を制御し、元の画像の詳細が見える控えめな色付け（低い透明度）から、オブジェクトの見た目を完全に置き換える単色塗りつぶし（高い透明度）まで、さまざまな効果を作成できます。

## 一般的な使用例

* **色分けされたオブジェクト分類**: 直感的な色分け可視化を作成するために、クラス、カテゴリ、または分類結果に基づいて検出されたオブジェクトを異なる色で塗り分け、素早いオブジェクト識別と分類を可能にします
* **マルチオブジェクト追跡の可視化**: 追跡IDに基づいて検出対象に異なる色を割り当て、オブジェクトの軌跡、追跡の継続性、またはフレーム間で複数の追跡対象を区別できるように可視化します
* **視覚的なカテゴリ区別**: 車両、人、製品など、異なるオブジェクトカテゴリやタイプごとに別々の色を使い、監視、サーベイランス、在庫管理のワークフローで明確な視覚的区別を作成します
* **マスクベースのセグメンテーション表示**: セグメント化された領域を色で塗りつぶしてインスタンスセグメンテーションの結果を可視化し、セグメント化されたオブジェクトを強調表示したり、分析やプレゼンテーションのために色付きマスクオーバーレイを作成したりします
* **インタラクティブな可視化とUI**: ユーザーインターフェース、ダッシュボード、またはインタラクティブなアプリケーション向けに、色分けによって直感的な視覚フィードバックやオブジェクトのグルーピングを提供する色分け可視化を作成します
* **プレゼンテーションとレポート作成**: レポート、ドキュメント、またはプレゼンテーション向けに色で塗りつぶした可視化を生成し、色分けによってオブジェクトタイプの区別、特定カテゴリの強調、または見栄えのよい検出表示を作成します

## 他のブロックへの接続

このブロックの注釈付き画像は次に接続できます：

* **他の可視化ブロック** (例: ラベル可視化、バウンディングボックス可視化、ポリゴン可視化) により、色塗りと追加の注釈（ラベル、輪郭）を組み合わせて包括的な可視化を実現します
* **データ保存ブロック** (例: Local File Sink、CSV Formatter、Roboflow Dataset Upload) により、ドキュメント作成、レポート作成、または分析のために色分けされた画像を保存します
* **Webhook ブロック** 色分けされた可視化を外部システム、API、またはWebアプリケーションに送信して、ダッシュボードや監視ツールに表示します
* **通知ブロック** (例: Email Notification、Slack Notification) により、アラートやレポートの視覚的証拠として色分けされた画像を送信します
* **動画出力ブロック** ライブ監視、追跡可視化、または後処理分析のために、色分けされた動画ストリームまたは録画を作成します

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/color_visualization@v1` を、ワークフローにステップとして追加します。

### プロパティ

| **名前**          | **型**       | **説明**                                                                                                                                                                      | 参照 |
| --------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name`          | `str`       | このステップの一意の識別子を入力してください。                                                                                                                                                     | ❌  |
| `copy_image`    | `bool`      | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用してください..                                                                                                          | ✅  |
| `color_palette` | `str`       | 可視化要素のカラーパレットを選択します..                                                                                                                                                       | ✅  |
| `palette_size`  | `int`       | パレット内の色数を指定します。カスタムまたは Matplotlib のパレットを使用する場合に適用されます..                                                                                                                     | ✅  |
| `custom_colors` | `List[str]` | HEX形式でバウンディングボックス用のカスタムカラーのリストを定義します..                                                                                                                                      | ✅  |
| `color_axis`    | `str`       | バウンディングボックスの色をどのように割り当てるかを選択します。負のクラスまたはトラッカーIDを持つ検出結果（たとえば、class\_id = -1 の未一致 VLM ラベル）は、中立的なグレーで描画されます..                                                                  | ✅  |
| `不透明度`          | `float`     | 0.0（完全に透明で、元のオブジェクトの見た目が見える）から1.0（完全に不透明で、単色塗りつぶし）までの範囲の色付きオーバーレイの不透明度。0.0から1.0の間の値は、元の画像と色付きオーバーレイをブレンドします。低い値ではオブジェクトの詳細が見える控えめな色付けになり、高い値では元のオブジェクトの見た目を覆い隠す強い色塗りになります。。 | ✅  |

この **参照** この列は、 `workflow` の実行時に利用可能な動的値でプロパティをパラメータ化できる可能性を示します。 *バインディング* の詳細を参照してください。

### 入力および出力バインディング

利用可能な接続は、そのバインディング種別に依存します。 `色の可視化` バージョン `v1` に、どのバインディング種別があるか確認してください。

<details>

<summary>入力と出力のバインディング</summary>

* input
  * `image` ([*`image`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)）：可視化する画像..
  * `copy_image` ([*`boolean`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/boolean.md)）：このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用してください..
  * `predictions` (*Union\[*[*`instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`keypoint_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/keypoint-detection-prediction.md)*,* [*`object_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`rle_instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/rle-instance-segmentation-prediction.md)*]*): 可視化するモデル予測..
  * `color_palette` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)）：可視化要素のカラーパレットを選択します..
  * `palette_size` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)）：パレット内の色数を指定します。カスタムまたは Matplotlib のパレットを使用する場合に適用されます..
  * `custom_colors` ([*`list_of_values`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)）：HEX形式でバウンディングボックス用のカスタムカラーのリストを定義します..
  * `color_axis` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)）：バウンディングボックスの色をどのように割り当てるかを選択します。負のクラスまたはトラッカーIDを持つ検出結果（たとえば、class\_id = -1 の未一致 VLM ラベル）は、中立的なグレーで描画されます..
  * `不透明度` ([*`0から1の浮動小数`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float-zero-to-one.md)): 0.0（完全に透明で、元のオブジェクトの見た目が見える）から1.0（完全に不透明で、単色塗りつぶし）までの範囲の色付きオーバーレイの不透明度。0.0から1.0の間の値は、元の画像と色付きオーバーレイをブレンドします。低い値ではオブジェクトの詳細が見える控えめな色付けになり、高い値では元のオブジェクトの見た目を覆い隠す強い色塗りになります。。
* output
  * `image` ([`image`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)）：ワークフロー内の画像。

</details>

<details>

<summary>JSON定義の例</summary>

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/color_visualization@v1",
	    "image": "$inputs.image",
	    "copy_image": true,
	    "predictions": "$steps.object_detection_model.predictions",
	    "color_palette": "DEFAULT",
	    "palette_size": 10,
	    "custom_colors": [
	        "#FF0000",
	        "#00FF00",
	        "#0000FF"
	    ],
	    "color_axis": "CLASS",
	    "opacity": 0.5
	}
```

</details>
