> 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 要素**：ユーザーインターフェース、ダッシュボード、またはカスタムアイコンが直感的な視覚的手がかりを提供するインタラクティブアプリケーション向けに、画像や動画へアイコンベースの視覚要素を追加します
## 他のブロックへの接続
このブロックの注釈付き画像は次に接続できます:
* **他の可視化ブロック** （例: ラベルの可視化、バウンディングボックスの可視化、ポリゴンの可視化）を使用して、アイコン配置と追加の注釈を組み合わせ、包括的な可視化を実現します
* **データ保存ブロック** （例: Local File Sink、CSV Formatter、Roboflow Dataset Upload）を使用して、文書化、レポート作成、アーカイブのためにアイコン付き画像を保存します
* **Webhookブロック** アイコン付きの可視化結果を外部システム、API、または Web アプリケーションに送信し、ダッシュボードや監視ツールで表示します
* **通知ブロック** （例: Email Notification、Slack Notification）を使用して、アラートやレポートの視覚的証拠として、アイコン付きの注釈画像を送信します
* **動画出力ブロック** ライブ監視、追跡の可視化、または後処理分析のために、アイコン付きの注釈済みビデオストリームや録画を作成します
### 型識別子
ステップで次の識別子を使用してください `"type"` フィールド： `roboflow_core/icon_visualization@v1` ワークフローにこのブロックをステップとして追加するには。
### プロパティ
| **名前** | **型** | **説明** | 参照 |
| ------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name` | `str` | このステップの一意の識別子を入力してください。 | ❌ |
| `copy_image` | `bool` | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。 | ✅ |
| `モード` | `str` | アイコンを配置するモード。'static' モードでは、アイコンを固定の x,y 座標に配置します（水印や固定位置要素に便利です）。'dynamic' モードでは、位置に基づいて検出されたオブジェクト上にアイコンを配置します（オブジェクトのラベリングや分類に便利です）。 | ✅ |
| `アイコンの幅` | `整数` | ピクセル単位のアイコンの幅。高さも指定されている場合、アスペクト比を維持しながら、この幅に合わせてアイコン画像がリサイズされます。 | ✅ |
| `アイコンの高さ` | `整数` | ピクセル単位のアイコンの高さ。幅も指定されている場合、アスペクト比を維持しながら、この高さに合わせてアイコン画像がリサイズされます。 | ✅ |
| `位置` | `str` | 各検出のバウンディングボックスに対するアイコン配置のアンカーポイント（動的モードのみ）。選択肢には、CENTER（ボックスの中心）、角（TOP\_LEFT、TOP\_RIGHT、BOTTOM\_LEFT、BOTTOM\_RIGHT）、辺の中点（TOP\_CENTER、CENTER\_LEFT、CENTER\_RIGHT、BOTTOM\_CENTER）、または CENTER\_OF\_MASS（オブジェクトの重心）が含まれます。 | ✅ |
| `x_position` | `整数` | 静的モードでの位置指定用の X 座標。正の値は画像の左端からの位置を指定します。負の値は右端からの位置を指定します（例: -10 でアイコンは右端から 10 ピクセルの位置に配置されます）。 | ✅ |
| `y_position` | `整数` | 静的モードでの位置指定用の Y 座標。正の値は画像の上端からの位置を指定します。負の値は下端からの位置を指定します（例: -10 でアイコンは下端から 10 ピクセルの位置に配置されます）。 | ✅ |
この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。
### 入力と出力のバインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `アイコンの可視化` のバージョン `v1` あるか確認してください。
入力と出力のバインディング
* 入力
* `image` ([*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)): 可視化対象の画像。
* `copy_image` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)): このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。
* `アイコン` ([*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)）：入力画像に配置するアイコン画像。透明度（アルファチャンネル）を持つ PNG 形式が最適な結果のために推奨されます。これは、アイコンが背景になじんで自然に重ねられるためです。アイコンは指定された幅と高さにリサイズされます。
* `モード` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：アイコンを配置するモード。'static' モードでは、アイコンを固定の x,y 座標に配置します（水印や固定位置要素に便利です）。'dynamic' モードでは、位置に基づいて検出されたオブジェクト上にアイコンを配置します（オブジェクトのラベリングや分類に便利です）。
* `predictions` (*Union\[*[*`rle_instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/rle-instance-segmentation-prediction.md)*,* [*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`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)*]*）：アイコンを配置する対象のモデル予測（動的モードで必須）。アイコンは、選択した位置アンカーポイントに基づいて各検出オブジェクト上に配置されます。
* `アイコンの幅` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：ピクセル単位のアイコンの幅。高さも指定されている場合、アスペクト比を維持しながら、この幅に合わせてアイコン画像がリサイズされます。
* `アイコンの高さ` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：ピクセル単位のアイコンの高さ。幅も指定されている場合、アスペクト比を維持しながら、この高さに合わせてアイコン画像がリサイズされます。
* `位置` ([*`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` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：静的モードでの位置指定用の X 座標。正の値は画像の左端からの位置を指定します。負の値は右端からの位置を指定します（例: -10 でアイコンは右端から 10 ピクセルの位置に配置されます）。
* `y_position` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：静的モードでの位置指定用の Y 座標。正の値は画像の上端からの位置を指定します。負の値は下端からの位置を指定します（例: -10 でアイコンは下端から 10 ピクセルの位置に配置されます）。
* 出力
* `image` ([`image`](/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
}
```