> 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/halo-visualization.md).

# ハロー可視化

画像内の検出オブジェクトの周囲にハローを描きます。

## v2

検出されたオブジェクトの周囲に、ぼかしと色付きマスクの重ね合わせによって、柔らかく光るハロー効果を作成し、滑らかで照らされた外観でオブジェクトの境界を強調する、独特の視覚スタイルを提供します。

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

このブロックは画像とインスタンスセグメンテーションの予測（マスク付き）を受け取り、各検出オブジェクトの周囲に光るハロー効果を作成します。このブロックは次の処理を行います:

1. 画像とインスタンスセグメンテーション予測（マスク付き）を入力として受け取る
2. 各検出オブジェクトのセグメンテーションマスクを抽出します（予測のマスクを使用するか、マスクが利用できない場合はバウンディングボックスのマスクを作成します）
3. 選択したカラーパレットに基づいて各マスクに色付けを適用し、色はクラス、インデックス、またはトラックIDによって割り当てられます
4. 各検出に対して色付きマスクのオーバーレイを作成し、マスクを面積の大きいものから小さいものへ順に合成します（重なり合うオブジェクトを正しく処理するため）
5. ぼかしフィルター（指定したカーネルサイズの平均プーリング）を色付きマスクに適用し、オブジェクトのエッジの周囲に柔らかく拡散したハロー効果を作成します
6. 指定した不透明度でぼかしたハローオーバーレイを元の画像とブレンドし、検出されたオブジェクトの周囲に光る見た目を作成します
7. 各検出オブジェクトの周囲に柔らかなハロー効果を重ねた注釈付き画像を返します

このブロックは、色付きマスクをぼかすことでハローを作成し、オブジェクトの境界を超えて広がる柔らかく光る効果を生み出します。バウンディングボックスやポリゴンのような輪郭の硬い可視化とは異なり、ハローは滑らかで照らされた外観を提供し、視覚的に魅力的な美しさを保ちながらオブジェクトを際立たせます。ぼかしカーネルのサイズは、ハローがオブジェクトの外側へどれだけ広がるかを制御し（カーネルが大きいほどハローは広くなります）、不透明度は光の強さを制御します。このブロックは、マスクの形状を使ってオブジェクトの輪郭の周囲にハロー効果を作成するため、マスク付きのインスタンスセグメンテーション予測を必要とします。

## 一般的な使用例

* **芸術的で審美的な可視化**: 芸術作品、デザイン用途、またはソフトで照らされたハローがモダンで洗練された印象を与えるユーザーインターフェース向けに、検出されたオブジェクトの周囲に見栄えの良い光る効果を作成します
* **ソフトなオブジェクト強調**: 硬いエッジが強すぎたり気を散らしたりする場合に、やわらかく拡散したハローで検出オブジェクトを強調します。プレゼンテーション、マーケティング資料、消費者向けアプリケーションに有用です
* **重なり合うオブジェクトの可視化**: 硬い境界線では視覚的な乱雑さが生じる重なり合った、または近接したオブジェクトを可視化するためにハローを使用し、視覚的な明瞭さを保ちながら複数のオブジェクトを区別できるようにします
* **ブランドとデザインの用途**: ブランドのビジュアル、販促素材、またはデザインシステムにハロー効果を組み込み、柔らかく光る注釈が角ばったバウンディングボックスよりもデザインの美学に合うようにします
* **視覚的な強調と注目**: 自然な視覚的フォーカスポイントを生み出す光るハローで検出オブジェクトに注意を引きます。ダッシュボード、監視インターフェース、対話型アプリケーションで有用です
* **マスクベースのオブジェクト強調表示**: 目立たないように画像の詳細を隠さずにオブジェクトの境界を示したい場合の、塗りつぶしマスクのオーバーレイに代わる方法として、柔らかなハロー効果でインスタンスセグメンテーションの結果を可視化します

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

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

* **他の可視化ブロック** (例: ラベル可視化、ドット可視化、バウンディングボックス可視化) を使用して、ハロー効果を追加の注釈と組み合わせ、包括的な可視化を行います
* **データ保存ブロック** (例: ローカルファイルシンク、CSVフォーマッタ、Roboflowデータセットアップロード) を使用して、ドキュメント作成、レポート、分析のためにハロー効果付きの画像を保存します
* **Webhook ブロック** ハロー効果付きの可視化結果を外部システム、API、またはウェブアプリケーションに送信し、ダッシュボードや監視ツールで表示します
* **通知ブロック** (例: メール通知、Slack通知) を使用して、アラートやレポートの視覚的証拠としてハロー効果付きの注釈画像を送信します
* **動画出力ブロック** ライブ監視、芸術的な可視化、または後処理分析のために、ハロー効果付きの注釈付き動画ストリームや録画を作成します

### タイプ識別子

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

### プロパティ

| **名前**          | **型**       | **説明**                                                                                                                                                                                        | 参照 |
| --------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `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.5〜0.9の値が適しています。                                             | ✅  |
| `カーネルサイズ`       | `int`       | ハロー効果を作成するために使用するぼかしカーネルのサイズ（ピクセル単位）です。これにより、ハローがオブジェクトの境界からどれだけ広がるかと、光がどれだけ柔らかく拡散して見えるかが決まります。大きい値ほど、より広く広がった滑らかなグラデーションのハローになり、小さい値ほど、より狭く集中した光になります。値は通常20〜80ピクセルの範囲で、40は多くの用途で適したデフォルトです。 | ✅  |

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

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

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

<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)*,* [*`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.5〜0.9の値が適しています。
  * `カーネルサイズ` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)ハロー効果を作成するために使用するぼかしカーネルのサイズ（ピクセル単位）です。これにより、ハローがオブジェクトの境界からどれだけ広がるかと、光がどれだけ柔らかく拡散して見えるかが決まります。大きい値ほど、より広く広がった滑らかなグラデーションのハローになり、小さい値ほど、より狭く集中した光になります。値は通常20〜80ピクセルの範囲で、40は多くの用途で適したデフォルトです。
* 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/halo_visualization@v2",
	    "image": "$inputs.image",
	    "copy_image": true,
	    "predictions": "$steps.instance_segmentation_model.predictions",
	    "color_palette": "DEFAULT",
	    "palette_size": 10,
	    "custom_colors": [
	        "#FF0000",
	        "#00FF00",
	        "#0000FF"
	    ],
	    "color_axis": "CLASS",
	    "opacity": 0.8,
	    "kernel_size": 40
	}
```

</details>

## v1

検出されたオブジェクトの周囲に、ぼかしと色付きマスクの重ね合わせによって、柔らかく光るハロー効果を作成し、滑らかで照らされた外観でオブジェクトの境界を強調する、独特の視覚スタイルを提供します。

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

このブロックは画像とインスタンスセグメンテーションの予測（マスク付き）を受け取り、各検出オブジェクトの周囲に光るハロー効果を作成します。このブロックは次の処理を行います:

1. 画像とインスタンスセグメンテーション予測（マスク付き）を入力として受け取る
2. 各検出オブジェクトのセグメンテーションマスクを抽出します（予測のマスクを使用するか、マスクが利用できない場合はバウンディングボックスのマスクを作成します）
3. 選択したカラーパレットに基づいて各マスクに色付けを適用し、色はクラス、インデックス、またはトラックIDによって割り当てられます
4. 各検出に対して色付きマスクのオーバーレイを作成し、マスクを面積の大きいものから小さいものへ順に合成します（重なり合うオブジェクトを正しく処理するため）
5. ぼかしフィルター（指定したカーネルサイズの平均プーリング）を色付きマスクに適用し、オブジェクトのエッジの周囲に柔らかく拡散したハロー効果を作成します
6. 指定した不透明度でぼかしたハローオーバーレイを元の画像とブレンドし、検出されたオブジェクトの周囲に光る見た目を作成します
7. 各検出オブジェクトの周囲に柔らかなハロー効果を重ねた注釈付き画像を返します

このブロックは、色付きマスクをぼかすことでハローを作成し、オブジェクトの境界を超えて広がる柔らかく光る効果を生み出します。バウンディングボックスやポリゴンのような輪郭の硬い可視化とは異なり、ハローは滑らかで照らされた外観を提供し、視覚的に魅力的な美しさを保ちながらオブジェクトを際立たせます。ぼかしカーネルのサイズは、ハローがオブジェクトの外側へどれだけ広がるかを制御し（カーネルが大きいほどハローは広くなります）、不透明度は光の強さを制御します。このブロックは、マスクの形状を使ってオブジェクトの輪郭の周囲にハロー効果を作成するため、マスク付きのインスタンスセグメンテーション予測を必要とします。

## 一般的な使用例

* **芸術的で審美的な可視化**: 芸術作品、デザイン用途、またはソフトで照らされたハローがモダンで洗練された印象を与えるユーザーインターフェース向けに、検出されたオブジェクトの周囲に見栄えの良い光る効果を作成します
* **ソフトなオブジェクト強調**: 硬いエッジが強すぎたり気を散らしたりする場合に、やわらかく拡散したハローで検出オブジェクトを強調します。プレゼンテーション、マーケティング資料、消費者向けアプリケーションに有用です
* **重なり合うオブジェクトの可視化**: 硬い境界線では視覚的な乱雑さが生じる重なり合った、または近接したオブジェクトを可視化するためにハローを使用し、視覚的な明瞭さを保ちながら複数のオブジェクトを区別できるようにします
* **ブランドとデザインの用途**: ブランドのビジュアル、販促素材、またはデザインシステムにハロー効果を組み込み、柔らかく光る注釈が角ばったバウンディングボックスよりもデザインの美学に合うようにします
* **視覚的な強調と注目**: 自然な視覚的フォーカスポイントを生み出す光るハローで検出オブジェクトに注意を引きます。ダッシュボード、監視インターフェース、対話型アプリケーションで有用です
* **マスクベースのオブジェクト強調表示**: 目立たないように画像の詳細を隠さずにオブジェクトの境界を示したい場合の、塗りつぶしマスクのオーバーレイに代わる方法として、柔らかなハロー効果でインスタンスセグメンテーションの結果を可視化します

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

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

* **他の可視化ブロック** (例: ラベル可視化、ドット可視化、バウンディングボックス可視化) を使用して、ハロー効果を追加の注釈と組み合わせ、包括的な可視化を行います
* **データ保存ブロック** (例: ローカルファイルシンク、CSVフォーマッタ、Roboflowデータセットアップロード) を使用して、ドキュメント作成、レポート、分析のためにハロー効果付きの画像を保存します
* **Webhook ブロック** ハロー効果付きの可視化結果を外部システム、API、またはウェブアプリケーションに送信し、ダッシュボードや監視ツールで表示します
* **通知ブロック** (例: メール通知、Slack通知) を使用して、アラートやレポートの視覚的証拠としてハロー効果付きの注釈画像を送信します
* **動画出力ブロック** ライブ監視、芸術的な可視化、または後処理分析のために、ハロー効果付きの注釈付き動画ストリームや録画を作成します

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/halo_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.5〜0.9の値が適しています。                                             | ✅  |
| `カーネルサイズ`       | `int`       | ハロー効果を作成するために使用するぼかしカーネルのサイズ（ピクセル単位）です。これにより、ハローがオブジェクトの境界からどれだけ広がるかと、光がどれだけ柔らかく拡散して見えるかが決まります。大きい値ほど、より広く広がった滑らかなグラデーションのハローになり、小さい値ほど、より狭く集中した光になります。値は通常20〜80ピクセルの範囲で、40は多くの用途で適したデフォルトです。 | ✅  |

この **参照** この列は、 `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)*,* [*`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.5〜0.9の値が適しています。
  * `カーネルサイズ` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)ハロー効果を作成するために使用するぼかしカーネルのサイズ（ピクセル単位）です。これにより、ハローがオブジェクトの境界からどれだけ広がるかと、光がどれだけ柔らかく拡散して見えるかが決まります。大きい値ほど、より広く広がった滑らかなグラデーションのハローになり、小さい値ほど、より狭く集中した光になります。値は通常20〜80ピクセルの範囲で、40は多くの用途で適したデフォルトです。
* 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/halo_visualization@v1",
	    "image": "$inputs.image",
	    "copy_image": true,
	    "predictions": "$steps.instance_segmentation_model.predictions",
	    "color_palette": "DEFAULT",
	    "palette_size": 10,
	    "custom_colors": [
	        "#FF0000",
	        "#00FF00",
	        "#0000FF"
	    ],
	    "color_axis": "CLASS",
	    "opacity": 0.8,
	    "kernel_size": 40
	}
```

</details>
