> 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/icon-visualization.md).
# アイコン可視化
画像上にカスタムアイコン画像を、固定位置（静的モード）または検出されたオブジェクト上の動的な位置（動的モード）に配置します。ウォーターマーク、ラベル、バッジ、視覚的マーカーに便利です。
## このブロックの仕組み
このブロックは画像と、任意で検出予測を受け取り、画像上にカスタムアイコン画像を配置します。ブロックは2つのモードをサポートします:
**静的モード** （ウォーターマークと固定位置配置用）:
1. 画像とアイコン画像を入力として受け取ります
2. アイコンを画像上の固定された x および y 座標に配置します
3. 右端または下端からの配置のために負の座標をサポートします
4. 指定された静的位置にアイコンを配置した注釈付き画像を返します
**動的モード** （検出ベースの配置用）:
1. 画像、アイコン画像、および検出予測を入力として受け取ります
2. 選択したアンカーポイント（中心、角、辺、または重心）に基づいて、各検出オブジェクト上にアイコンを配置します
3. 各検出に対して同じ相対位置にアイコンを配置します
4. 検出されたオブジェクト上にアイコンを重ねた注釈付き画像を返します
このブロックは透明度（アルファチャンネル）を持つ PNG 画像をサポートしており、アイコンを背景になじませて自然に表示できます。アイコンは任意の幅と高さにリサイズできるため、小さなバッジから大きなウォーターマークまで、さまざまな用途に適しています。静的モードでは、アイコンは固定座標に配置されるため、ウォーターマークやブランディングに最適です。動的モードでは、アイコンは検出されたオブジェクトに自動的に追従するため、カスタムの視覚的指標で検出アイテムにラベル付け、分類、マーキングを行うのに便利です。
## 一般的な使用例
* **ウォーターマークとブランディング**：ロゴ、ウォーターマーク、またはブランド要素を画像や動画の固定位置（静的モード）に配置し、コンテンツ保護、著作権表示、ブランド識別に利用します
* **アイコンによるオブジェクトのラベル付け**：カスタムアイコンを検出されたオブジェクト（動的モード）上に配置し、視覚的インジケータ（例: 危険なオブジェクトに警告アイコン、製品にカテゴリアイコン、ステータスバッジ）でオブジェクトを分類、ラベル付け、マーキングします
* **視覚的ステータスインジケータ**：分類結果、信頼度、またはカスタムロジックに基づいて検出されたオブジェクト上にステータスアイコン（例: チェックマーク、警告サイン、情報バッジ）を表示し、素早い視覚的フィードバックを提供します
* **製品のマーキングと分類**：小売、Eコマース、在庫管理のワークフローで、検出された製品にカテゴリアイコン、製品タイプの指標、またはカスタムマーカーを配置します
* **カスタム注釈システム**：製造や検査のワークフローで、品質管理、不良品マーキング、またはコンプライアンス追跡のために特化したアイコンを使ったカスタム注釈ワークフローを作成します
* **インタラクティブ UI 要素**：ユーザーインターフェース、ダッシュボード、またはカスタムアイコンが直感的な視覚的手がかりを提供するインタラクティブアプリケーション向けに、画像や動画にアイコンベースの視覚要素を追加します
## 他のブロックへの接続
このブロックの注釈付き画像は次のものに接続できます：
* **他の可視化ブロック** （例: ラベルの可視化、バウンディングボックスの可視化、ポリゴンの可視化）アイコン配置を追加の注釈と組み合わせて、包括的な可視化を行います
* **データ保存ブロック** （例: ローカルファイルシンク、CSV フォーマッタ、Roboflow データセットアップロード）アイコン付きの画像を保存して、ドキュメント化、レポート作成、アーカイブに利用します
* **Webhook ブロック** アイコン付きの可視化結果を外部システム、API、または Web アプリケーションに送信し、ダッシュボードや監視ツールで表示します
* **通知ブロック** （例: メール通知、Slack 通知）アイコン付きの注釈画像を、アラートやレポートの視覚的証拠として送信します
* **ビデオ出力ブロック** ライブ監視、追跡の可視化、または後処理分析のために、アイコン付きの注釈済みビデオストリームや録画を作成します
### 種別識別子
ステップで次の識別子を使用します `"type"` フィールド: `roboflow_core/icon_visualization@v1` ワークフローにステップとしてブロックを追加するには。
### プロパティ
| **名前** | **型** | **説明** | 参照 |
| ------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name` | `str` | このステップの一意の識別子を入力してください。 | ❌ |
| `copy_image` | `bool` | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用します。 | ✅ |
| `mode` | `str` | アイコンの配置モード。「static」モードではアイコンを固定の x,y 座標に配置します（ウォーターマークや固定位置要素に便利です）。「dynamic」モードでは、検出されたオブジェクトの位置に基づいてアイコンを配置します（オブジェクトのラベル付けや分類に便利です）。 | ✅ |
| `icon_width` | `int` | アイコンのピクセル幅。高さも指定されている場合、アイコン画像はアスペクト比を維持したままこの幅にリサイズされます。 | ✅ |
| `icon_height` | `int` | アイコンのピクセル高さ。幅も指定されている場合、アイコン画像はアスペクト比を維持したままこの高さにリサイズされます。 | ✅ |
| `position` | `str` | 各検出のバウンディングボックスに対するアイコン配置のアンカーポイント（動的モードのみ）。選択肢には、CENTER（ボックス中央）、角（TOP\_LEFT、TOP\_RIGHT、BOTTOM\_LEFT、BOTTOM\_RIGHT）、辺の中点（TOP\_CENTER、CENTER\_LEFT、CENTER\_RIGHT、BOTTOM\_CENTER）、または CENTER\_OF\_MASS（オブジェクトの重心）があります。 | ✅ |
| `x_position` | `int` | 静的モードの配置用 X 座標。正の値は画像の左端からの位置を示します。負の値は右端からの位置を示します（例: -10 は右端から 10 ピクセルの位置にアイコンを配置します）。 | ✅ |
| `y_position` | `int` | 静的モードの配置用 Y 座標。正の値は画像の上端からの位置を示します。負の値は下端からの位置を示します（例: -10 は下端から 10 ピクセルの位置にアイコンを配置します）。 | ✅ |
この **参照** 列は、で利用可能な動的値を使用してプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細情報
### 入出力バインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `アイコンの可視化` のバージョン `v1` 持つか確認してください。
入出力バインディング
* 入力
* `画像` ([*`画像`*](/workflows/ja/gaido/developer-guide/kinds/image.md)）：可視化対象の画像。
* `copy_image` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)）：このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用します。
* `icon` ([*`画像`*](/workflows/ja/gaido/developer-guide/kinds/image.md)): 入力画像に配置するアイコン画像。最良の結果を得るには、透明度（アルファチャンネル）を持つ PNG 形式を推奨します。これにより、アイコンが背景になじみやすくなります。アイコンは指定された幅と高さにリサイズされます。
* `mode` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)): アイコンの配置モード。「static」モードではアイコンを固定の x,y 座標に配置します（ウォーターマークや固定位置要素に便利です）。「dynamic」モードでは、検出されたオブジェクトの位置に基づいてアイコンを配置します（オブジェクトのラベル付けや分類に便利です）。
* `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)*]*): アイコンを配置するモデル予測（dynamic モードでは必須）。選択した位置のアンカーポイントに基づいて、各検出オブジェクト上にアイコンが配置されます。
* `icon_width` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): アイコンのピクセル幅。高さも指定されている場合、アイコン画像はアスペクト比を維持したままこの幅にリサイズされます。
* `icon_height` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.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（オブジェクトの重心）があります。
* `x_position` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 静的モードの配置用 X 座標。正の値は画像の左端からの位置を示します。負の値は右端からの位置を示します（例: -10 は右端から 10 ピクセルの位置にアイコンを配置します）。
* `y_position` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 静的モードの配置用 Y 座標。正の値は画像の上端からの位置を示します。負の値は下端からの位置を示します（例: -10 は下端から 10 ピクセルの位置にアイコンを配置します）。
* 出力
* `画像` ([`画像`](/workflows/ja/gaido/developer-guide/kinds/image.md)）：ワークフロー内の画像。
JSON 定義の例
```json
{
"name": "",
"type": "roboflow_core/icon_visualization@v1",
"image": "$inputs.image",
"copy_image": true,
"icon": "$inputs.icon",
"mode": "static",
"predictions": "$steps.object_detection_model.predictions",
"icon_width": 64,
"icon_height": 64,
"position": "TOP_CENTER",
"x_position": 10,
"y_position": 10
}
```