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

# 三角形可視化

提供された検出結果に基づいて、画像上の特定座標に三角形マーカーを描画します。

画像上に三角形のマーカーを描画し、検出されたオブジェクトの特定の点を印付けします。位置、サイズ、色、輪郭スタイルをカスタマイズでき、視覚的注釈のための方向指示や幾何学的マーカーを提供します。

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

このブロックは画像と検出予測を受け取り、各検出オブジェクトの指定されたアンカー位置に三角形のマーカーを描画します。このブロックは:

1. 画像と予測を入力として受け取ります
2. 選択したアンカーポイント（中心、四隅、辺の中点、または重心）に基づいて、各検出の三角形の位置を決定します
3. 選択したカラーパレットに基づいて色を適用し、クラス、インデックス、またはトラックIDごとに色を割り当てます
4. Supervision の TriangleAnnotator を使用して、指定された底辺幅と高さの寸法、および必要に応じた輪郭の太さで三角形マーカーを描画します
5. 元の画像の上に三角形マーカーを重ねた注釈付き画像を返します

このブロックは、バウンディングボックスの中心、四隅、辺の中点、重心（不規則な形状のオブジェクトに有用）など、さまざまな位置オプションをサポートします。三角形は、異なるサイズ（底辺幅と高さ）、視認性向上のための任意の輪郭、さまざまなカラーパレットでカスタマイズできます。三角形マーカーは、方向指示（特定の方向を指す）や幾何学的マーカーとして機能できる独特な幾何学形状を提供し、円形の点や四角いマーカーの代替となります。これにより、検出位置を方向的または幾何学的に強調するすっきりとした可視化スタイルが実現し、方向指示子、幾何学的マーカー、または特徴的なポイントマーカーを必要とするアプリケーションに最適です。

## 一般的な使用例

* **方向性のあるオブジェクトのマーキング**: 三角形マーカーで検出されたオブジェクトに印を付け、方向や向きを示せるようにします。追跡アプリケーション、動作解析、または三角形の先端形状が方向情報を提供する方向性のあるワークフローに有用です
* **幾何学的マーカーの可視化**: 三角形マーカーを特徴的な幾何学形状として用いて検出位置に印を付け、デザイン用途や幾何学的強調のために、円形の点や長方形のバウンディングボックスと比べて視覚的な変化を提供します
* **最小限のオブジェクトマーキング**: 密集したシーンや多数の検出を扱う際に、バウンディングボックスの代わりに小さな三角形マーカーで検出オブジェクトに印を付け、よりすっきりして雑然としない可視化を実現します。三角形の形状が視覚的な区別を与えます
* **追跡の可視化**: 三角形マーカーを使って、時間経過に伴うオブジェクトの軌跡や追跡 ID を可視化し、追跡ワークフローにおけるバウンディングボックスのよりすっきりした代替手段を作ります。三角形は移動方向を示すこともあります
* **注目点の強調表示**: オブジェクト追跡、空間解析、幾何学的注釈ワークフローなどの用途で、検出されたオブジェクト上の特定のアンカーポイント（角、中心、重心）に三角形マーカーで印を付けます
* **デザインと美的用途**: 幾何学形状が独特な視覚スタイルや美的魅力をもたらす、デザイン目的、ユーザーインターフェース、ダッシュボード、または芸術的な可視化のために三角形マーカーを作成します

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

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

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

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/triangle_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 ラベル）は、中立的なグレーで描画されます..                                                                                                                     | ✅  |
| `位置`                | `str`       | 検出のバウンディングボックスに対する相対的な三角形マーカーの配置先アンカー位置。選択肢には、CENTER（ボックスの中央）、四隅（TOP\_LEFT、TOP\_RIGHT、BOTTOM\_LEFT、BOTTOM\_RIGHT）、辺の中点（TOP\_CENTER、CENTER\_LEFT、CENTER\_RIGHT、BOTTOM\_CENTER）、または CENTER\_OF\_MASS（オブジェクトの重心。不規則な形状に有用）があります。。 | ✅  |
| `底辺`                | `int`       | 三角形のピクセル単位の底辺幅。三角形マーカーの底辺における水平方向の幅を制御します。値が大きいほど三角形は幅広くなり、値が小さいほど細くなります。高さと組み合わせて、三角形全体のサイズと形状を制御します。。                                                                                                                        | ✅  |
| `高さ`                | `int`       | 三角形のピクセル単位の高さ。底辺から頂点までの三角形マーカーの垂直方向の高さを制御します。値が大きいほど三角形は高くなり、値が小さいほど低くなります。底辺と組み合わせて、三角形全体のサイズと形状を制御します。。                                                                                                                      | ✅  |
| `outline_thickness` | `int`       | 三角形の輪郭の太さをピクセル単位で指定します。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 ラベル）は、中立的なグレーで描画されます..
  * `位置` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)) : 検出のバウンディングボックスに対する相対的な三角形マーカーの配置先アンカー位置。選択肢には、CENTER（ボックスの中央）、四隅（TOP\_LEFT、TOP\_RIGHT、BOTTOM\_LEFT、BOTTOM\_RIGHT）、辺の中点（TOP\_CENTER、CENTER\_LEFT、CENTER\_RIGHT、BOTTOM\_CENTER）、または CENTER\_OF\_MASS（オブジェクトの重心。不規則な形状に有用）があります。。
  * `底辺` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)) : 三角形のピクセル単位の底辺幅。三角形マーカーの底辺における水平方向の幅を制御します。値が大きいほど三角形は幅広くなり、値が小さいほど細くなります。高さと組み合わせて、三角形全体のサイズと形状を制御します。。
  * `高さ` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)) : 三角形のピクセル単位の高さ。底辺から頂点までの三角形マーカーの垂直方向の高さを制御します。値が大きいほど三角形は高くなり、値が小さいほど低くなります。底辺と組み合わせて、三角形全体のサイズと形状を制御します。。
  * `outline_thickness` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)) : 三角形の輪郭の太さをピクセル単位で指定します。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/triangle_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",
	    "position": "CENTER",
	    "base": 10,
	    "height": 10,
	    "outline_thickness": 2
	}
```

</details>
