> 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. 元の画像の上に三角形のマーカーを重ねた注釈付き画像を返します
このブロックは、バウンディングボックスの中心、4つのコーナー、辺の中点、または重心（不規則な形状のオブジェクトに有用）を含むさまざまな位置オプションをサポートします。三角形は、さまざまなサイズ（底辺幅と高さ）、視認性を高めるための任意の輪郭、各種カラーパレットでカスタマイズできます。三角形のマーカーは、特定の方向を示す方向指示子として、または幾何学的マーカーとして機能できる独特な幾何学形状を提供し、円形のドットや四角形のマーカーの代替となります。これにより、検出位置を方向的または幾何学的な強調で示すすっきりとした可視化スタイルが実現し、方向指示子、幾何学的マーカー、または特徴的なポイントマーカーを必要とする用途に最適です。
## 一般的な使用例
* **方向性のあるオブジェクトのマーキング**: 三角形のマーカーで検出されたオブジェクトをマーキングし、方向や向きを示せます。トラッキング用途、モーション解析、三角形の先端が方向情報を提供する方向重視のワークフローに有用です
* **幾何学的マーカーの可視化**: 円形のドットや矩形のバウンディングボックスと比べて視覚的な変化を持たせながら、検出位置を示す特徴的な幾何学形状として三角形のマーカーを使用し、デザイン目的や幾何学的な強調を実現します
* **最小限のオブジェクトマーク付け**: 密集したシーンや多数の検出を扱う際に、よりすっきりとして散らかりの少ない可視化のため、バウンディングボックスの代わりに小さな三角形のマーカーで検出されたオブジェクトを示します。三角形の形状が視覚的な差別化を提供します
* **追跡の可視化**: 時間の経過に伴うオブジェクトの軌跡やトラッキング 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` | バウンディングボックスの色をどのように割り当てるかを選択します。 | ✅ |
| `position` | `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 にすると輪郭のない塗りつぶし三角形になります。値が大きいほど三角形の境界線は太くなり、視認性とコントラストが向上します。複雑な背景に対して三角形マーカーをより見やすくするのに有用です。 | ✅ |
この **参照** 列は、で利用可能な動的値を使用してプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細情報
### 入出力バインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `三角形の可視化` のバージョン `v1` 持つか確認してください。
入出力バインディング
* 入力
* `画像` ([*`画像`*](/workflows/ja/gaido/developer-guide/kinds/image.md)）：可視化対象の画像。
* `copy_image` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)）：このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用します。
* `predictions` (*Union\[*[*`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)*,* [*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`rle_instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/rle-instance-segmentation-prediction.md)*]*): 可視化するモデル予測。。
* `color_palette` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：可視化要素のカラーパレットを選択します。
* `palette_size` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：パレット内の色数を指定します。カスタムパレットまたはMatplotlibパレットを使用する場合に適用されます。
* `custom_colors` ([*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)）：バウンディングボックス用のカスタムカラーのリストをHEX形式で定義します。
* `color_axis` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：バウンディングボックスの色をどのように割り当てるかを選択します。
* `position` ([*`string`*](/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`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 三角形のベース幅をピクセル単位で指定します。三角形マーカーの底辺の水平幅を制御します。値が大きいほど三角形は幅広くなり、小さいほど細くなります。高さと組み合わせて、三角形全体のサイズと形状を制御します。
* `高さ` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 三角形の高さをピクセル単位で指定します。三角形マーカーの底辺から頂点までの垂直方向の高さを制御します。値が大きいほど三角形は高くなり、小さいほど低くなります。ベースと組み合わせて、三角形全体のサイズと形状を制御します。
* `outline_thickness` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 三角形の輪郭の太さをピクセル単位で指定します。0 にすると輪郭のない塗りつぶし三角形になります。値が大きいほど三角形の境界線は太くなり、視認性とコントラストが向上します。複雑な背景に対して三角形マーカーをより見やすくするのに有用です。
* 出力
* `画像` ([`画像`](/workflows/ja/gaido/developer-guide/kinds/image.md)）：ワークフロー内の画像。
JSON 定義の例
```json
{
"name": "",
"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
}
```