> 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. 検出されたオブジェクトが色で塗りつぶされ、画像の残りの部分は変更されない注釈付き画像を返します
このブロックは、オブジェクト検出予測（バウンディングボックス使用）とインスタンスセグメンテーション予測（マスク使用）の両方に対応しています。マスクが利用可能な場合は検出されたオブジェクトの正確な形状を塗りつぶし、利用できない場合は長方形のバウンディングボックス領域を塗りつぶします。色は、選択されたパレットから color axis 設定（class、index、または track ID）に基づいて割り当てられ、異なるオブジェクトやクラスを色で区別できます。不透明度パラメータは色付きオーバーレイの透明度を制御し、元の画像のディテールが見える控えめな色付け（低い不透明度）から、オブジェクトの外観を完全に置き換える単色の塗りつぶし（高い不透明度）まで、さまざまな効果を作成できます。
## 一般的な使用例
* **色分けされたオブジェクト分類**: 検出されたオブジェクトを、そのクラス、カテゴリ、または分類結果に基づいて異なる色で塗りつぶし、直感的な色分け可視化を作成して、オブジェクトの迅速な識別と分類を可能にします
* **マルチオブジェクト追跡の可視化**: 追跡中のオブジェクトを追跡 ID に基づいてそれぞれ異なる色で色分けし、オブジェクトの軌跡、追跡の継続性、または複数の追跡対象をフレーム間で区別できるようにします
* **視覚的なカテゴリの区別**: 異なるオブジェクトのカテゴリや種類（例：車両、人、製品）に異なる色を使用して、監視、モニタリング、在庫管理のワークフローで明確な視覚的区別を作成します
* **マスクベースのセグメンテーション表示**: セグメント化された領域を色で塗りつぶして、インスタンスセグメンテーションの結果を可視化したり、セグメント化されたオブジェクトを強調表示したり、分析や発表用の色付きマスクオーバーレイを作成したりします
* **インタラクティブな可視化と UI**: ユーザーインターフェース、ダッシュボード、インタラクティブアプリケーション向けに色分け可視化を作成し、色分けによる直感的な視覚フィードバックやオブジェクトのグルーピングを提供します
* **プレゼンテーションとレポート**: レポート、ドキュメント、プレゼンテーション向けに色で塗りつぶした可視化を生成し、色分けによってオブジェクトの種類を区別したり、特定のカテゴリを強調したり、見栄えのよい検出表示を作成できます
## 他のブロックへの接続
このブロックの注釈付き画像は次に接続できます:
* **他の可視化ブロック** （例：ラベル可視化、バウンディングボックス可視化、ポリゴン可視化）を使用して、色の塗りつぶしに追加の注釈（ラベル、輪郭）を組み合わせ、包括的な可視化を行います
* **データ保存ブロック** （例：ローカルファイル出力、CSV フォーマッタ、Roboflow データセットへのアップロード）を使用して、ドキュメント化、レポート、分析用に色分け画像を保存します
* **Webhookブロック** 色分け可視化を外部システム、API、または Web アプリケーションに送信し、ダッシュボードや監視ツールに表示します
* **通知ブロック** （例：メール通知、Slack 通知）を使用して、アラートやレポートの視覚的な証拠として色分け画像を送信します
* **動画出力ブロック** ライブ監視、追跡可視化、または後処理分析のために、色分けされたビデオストリームや録画を作成します
### 型識別子
ステップで次の識別子を使用してください `"type"` フィールド： `roboflow_core/color_visualization@v1` ワークフローにこのブロックをステップとして追加するには。
### プロパティ
| **名前** | **型** | **説明** | 参照 |
| ------------ | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name` | `str` | このステップの一意の識別子を入力してください。 | ❌ |
| `copy_image` | `bool` | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。 | ✅ |
| `カラーパレット` | `str` | 可視化要素のカラーパレットを選択します。 | ✅ |
| `パレットサイズ` | `整数` | パレット内の色数を指定します。これはカスタムまたはMatplotlibのパレットを使用する場合に適用されます。 | ✅ |
| `カスタムカラー` | `List[str]` | バウンディングボックス用のカスタムカラーの一覧をHEX形式で定義します。 | ✅ |
| `色の割り当て` | `str` | バウンディングボックスの色をどのように割り当てるかを選択します。 | ✅ |
| `opacity` | `float` | 色付きオーバーレイの不透明度。0.0（完全に透明、元のオブジェクトの外観が見える）から 1.0（完全に不透明、単色の塗りつぶし）までの範囲です。0.0 と 1.0 の間の値は、元の画像と色付きオーバーレイのブレンドを作成します。低い値ではオブジェクトのディテールが見える控えめな色付けになり、高い値では元のオブジェクトの外観を隠すより強い色の塗りつぶしになります。。 | ✅ |
この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。
### 入力と出力のバインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `色の可視化` のバージョン `v1` あるか確認してください。
入力と出力のバインディング
* 入力
* `image` ([*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)): 可視化対象の画像。
* `copy_image` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)): このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。
* `predictions` (*Union\[*[*`rle_instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/rle-instance-segmentation-prediction.md)*,* [*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`keypoint_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/keypoint-detection-prediction.md)*]*): 可視化するモデル予測。
* `カラーパレット` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：可視化要素のカラーパレットを選択します。
* `パレットサイズ` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：パレット内の色数を指定します。これはカスタムまたはMatplotlibのパレットを使用する場合に適用されます。
* `カスタムカラー` ([*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)）：バウンディングボックス用のカスタムカラーの一覧をHEX形式で定義します。
* `色の割り当て` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：バウンディングボックスの色をどのように割り当てるかを選択します。
* `opacity` ([*`float_zero_to_one`*](/workflows/ja/gaido/developer-guide/kinds/float-zero-to-one.md))：色付きオーバーレイの不透明度。0.0（完全に透明、元のオブジェクトの外観が見える）から 1.0（完全に不透明、単色の塗りつぶし）までの範囲です。0.0 と 1.0 の間の値は、元の画像と色付きオーバーレイのブレンドを作成します。低い値ではオブジェクトのディテールが見える控えめな色付けになり、高い値では元のオブジェクトの外観を隠すより強い色の塗りつぶしになります。。
* 出力
* `image` ([`image`](/workflows/ja/gaido/developer-guide/kinds/image.md)): ワークフロー内の画像。
JSON 定義の例
```json
{
"name": "",
"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
}
```