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

# コーナー可視化

画像内の検出オブジェクトの角を描画します。

検出されたオブジェクトのバウンディングボックスの四隅にコーナーマーカーを描画し、バウンディングボックス全体の輪郭を描かずにオブジェクトの位置を示す、最小限でクリーンな可視化スタイルを提供します。

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

このブロックは画像と検出予測を受け取り、各検出オブジェクトのバウンディングボックスの四隅にコーナーマーカーを描画します。このブロックは、

1. 画像と予測を入力として受け取ります
2. 各検出オブジェクトのバウンディングボックス座標を特定します
3. 各バウンディングボックスの4つのコーナー位置（左上、右上、左下、右下）を計算します
4. 選択したカラーパレットに基づいて色を適用し、クラス、インデックス、またはトラックIDごとに色を割り当てます
5. Supervision の BoxCornerAnnotator を使用して、各コーナー位置にコーナーマーカー（通常はL字形の線またはコーナー指示子）を描画します
6. 指定された太さとコーナー長を適用して、コーナーマーカーの見た目を制御します
7. 元の画像の上にコーナーマーカーを重ねた注釈付き画像を返します

このブロックは、フルサイズのバウンディングボックスではなく最小限のコーナーマーカーを描画し、クリーンで目立ちすぎない可視化スタイルを作成します。このアプローチは、画像を全面的な矩形の輪郭で埋め尽くすことなく、最小限の美しさを保ちながらオブジェクトの位置を明確に示します。コーナーマーカーは、太さや長さの値を変えてカスタマイズでき、オブジェクトのクラス、インデックス、またはトラッキングIDに基づいて色を割り当てることもできるため、異なるオブジェクトやオブジェクトタイプを簡単に区別できます。

## 一般的な使用例

* **最小限のオブジェクトマーキング**: 完全なバウンディングボックスではなくコーナー指示子で検出されたオブジェクトをマークし、画像の見やすさを保ちながらオブジェクトの位置を示す、クリーンで目立ちすぎない可視化スタイルを実現します
* **美的な可視化デザイン**: フルのバウンディングボックスが視覚的に煩わしすぎる一方で、コーナーマーカーであれば位置を十分に示せる、プレゼンテーション、ダッシュボード、またはユーザーインターフェース向けに、視覚的に最小限の注釈を作成します
* **密集シーンの可視化**: 多数の検出オブジェクトがあり、フルのバウンディングボックスが過度に重なって視覚的な散らかりを生むような密集シーンでは、コーナーマーカーを使用します
* **デザイン志向のアプリケーション**: 伝統的なバウンディングボックスの輪郭よりも、最小限でモダンな美しさが好まれるデザインワークフロー、芸術的な可視化、またはクリエイティブなアプリケーションにコーナーマーカーを適用します
* **控えめなオブジェクト強調**: メインの画像コンテンツから注意をそらさないように、オブジェクトの位置を控えめに示します。背景注釈や、視覚的に目立たせずにオブジェクト位置を示したい場合に便利です
* **UI とダッシュボードへの統合**: より良いユーザー体験と視覚的ノイズの低減のために、最小限の視覚インジケーターが好まれるユーザーインターフェース、ダッシュボード、またはインタラクティブアプリケーションにコーナーマーカーを統合します

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

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

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

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/corner_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 ラベル）は、中立的なグレーで描画されます.. | ✅  |
| `thickness`     | `int`       | コーナーマーカーの線の太さ（ピクセル単位）。値が大きいほど、より太く、より目立つコーナーマーカーになります。。                                                    | ✅  |
| `corner_length` | `int`       | 各コーナーマーカーの線分の長さ（ピクセル単位）。これは、コーナー指示子が各コーナー点からどれだけ伸びるかを制御します。値が大きいほど、より長く、より目立つコーナーマーカーになります。。               | ✅  |

この **参照** この列は、 `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 ラベル）は、中立的なグレーで描画されます..
  * `thickness` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): コーナーマーカーの線の太さ（ピクセル単位）。値が大きいほど、より太く、より目立つコーナーマーカーになります。。
  * `corner_length` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): 各コーナーマーカーの線分の長さ（ピクセル単位）。これは、コーナー指示子が各コーナー点からどれだけ伸びるかを制御します。値が大きいほど、より長く、より目立つコーナーマーカーになります。。
* 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/corner_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",
	    "thickness": 4,
	    "corner_length": 15
	}
```

</details>
