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

# リッチラベルの可視化

承認済みのTrueTypeフォントを使用して、画像上に高品質でアンチエイリアス処理されたテキストラベルを描画します。

検出されたオブジェクト上に高品質な TrueType フォントのレンダリングを使ってテキストラベルを描画します。このブロックは Label Visualization ブロックのリッチテキスト版です。OpenCV の組み込みビットマップフォントの代わりに、Pillow を通じて Supervision の `RichLabelAnnotator`、本番用 UI、レポート、顧客向け画像に適したアンチエイリアス付きの、見栄えの良いプロフェッショナルなテキストを生成します。

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

このブロックは画像と検出予測を受け取り、各検出オブジェクトにテキストラベルを描画します。このブロックは：

1. 画像と予測を入力として受け取ります
2. 選択したテキストオプション（クラス名、信頼度、トラッカー ID、寸法、面積、ゾーン内滞在時間、またはインデックス）に基づいて、各検出のラベルテキストを抽出します
3. 選択された `font_family` 識別子を、同梱されている承認済みフォントに解決します `推論`
4. 選択したアンカー位置に基づいてラベルの位置を決定します
5. 選択したカラーパレットに基づいて背景色のスタイルを適用し、色はクラス、インデックス、またはトラック ID によって割り当てられます
6. 選択したフォント、サイズ、色、パディング、角丸半径を使って、Supervision の `RichLabelAnnotator`
7. 元の画像上にテキストラベルを重ねた注釈付き画像を返します

## 承認済みフォント

フォントは `font_family` パラメータで選択します。 `推論` で承認され配布されているフォントのみ使用できます。任意のフォントファイル、ファイルシステムのパス、リモートのフォント URL は **サポートされていません** 。これによりレンダリングは決定論的になり、信頼されていないフォントファイルの解析を回避できます。公式 Docker イメージと wheel には承認済みフォントがすべて含まれており、ソースをそのままチェックアウトした環境では、欠落しているフォントは初回使用時に固定済みでチェックサム検証された取得元からダウンロードされます（無効化するには `ALLOW_WORKFLOWS_FONTS_DOWNLOAD=False`）。すべての承認済みフォントは SIL Open Font License 1.1 の下でライセンスされており、ライセンス文書も同梱されています。

フォントは表示名で選択されます。20 個のフォントが利用可能です：

等幅：Geist Mono（デフォルト、Vercel 提供）、Anonymous Pro、Courier Prime、Fira Code、IBM Plex Mono、Inconsolata、JetBrains Mono、PT Mono、Roboto Mono、Source Code Pro、Space Mono。

サンセリフ：Geist、Inter、Lato、Montserrat、Noto Sans、Nunito Sans、Open Sans、Roboto、Work Sans。

従来の snake\_case 識別子（例： `geist_mono`）も引き続き受け付けられ、表示名に正規化されます。

Noto Sans は最も広い文字範囲（ラテン文字、ギリシャ文字、キリル文字）を提供します。選択したフォントでサポートされていない文字は、そのフォントの欠損グリフ記号（通常は空のボックス）としてレンダリングされます。非ラテン文字に注釈を付ける場合は Noto Sans を選んでください。

## Label Visualization との比較

* **ラベルの可視化** (`roboflow_core/label_visualization@v1`）は OpenCV の Hershey フォントを使用します。高速ですが、エイリアシングがありピクセル化され、フォントの選択はできません。
* **リッチラベルの可視化** （このブロック）は Pillow によってレンダリングされた TrueType フォントを使用します。高品質なアンチエイリアス出力、選択可能なフォント、Unicode サポート、オプションのテキスト折り返し（`max_line_length`）を備え、フレームごとのレンダリングコストはわずかに増加します。

## 一般的な使用例

* **顧客向けの可視化**：Web サイト、ダッシュボード、レポート向けに、製品のタイポグラフィ（例：Geist Mono）に合った検出オーバーレイをレンダリングします
* **高品質なレポート**：読みやすくアンチエイリアスされたラベル付きの、出版品質の注釈画像を生成します
* **非ラテン文字**：Noto Sans を使って、ギリシャ文字やキリル文字を含むラベルをレンダリングします

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/rich_label_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 ラベル）は、中立的なグレーで描画されます..                                                                                                                                                                                                                                               | ✅  |
| `text`            | `str`       | テキストラベルに表示する内容。オプション：'Class'（クラス名）、'Confidence'（信頼度スコア）、'Class and Confidence'（両方）、'Tracker Id'（追跡対象オブジェクトのトラッキング ID）、'Time In Zone'（ゾーン内の滞在時間）、'Dimensions'（中心座標と幅×高さ）、'Area'（バウンディングボックスの面積（ピクセル））、'Area (mask)'（Mask Area Measurement ブロックから得られるマスク面積（ピクセル））、'Area (converted)'（Mask Area Measurement ブロックから得られる変換後単位のマスク面積）、または 'Index'（検出インデックス）です。 | ✅  |
| `text_position`   | `str`       | 各検出のバウンディングボックスに対するラベルの配置アンカー位置。オプションには、CENTER（ボックス中央）、角（TOP\_LEFT、TOP\_RIGHT、BOTTOM\_LEFT、BOTTOM\_RIGHT）、辺の中点（TOP\_CENTER、CENTER\_LEFT、CENTER\_RIGHT、BOTTOM\_CENTER）、または CENTER\_OF\_MASS（オブジェクトの重心）が含まれます。                                                                                                                                             | ✅  |
| `text_color`      | `str`       | ラベルテキストの色。色名（例：'WHITE'、'BLACK'）のほか、HEX 形式のカラーコード（例：'#FFFFFF'）または RGB 形式（例：'rgb(255, 255, 255)'）を使用できます。                                                                                                                                                                                                                                                  | ✅  |
| `font_family`     | `str`       | ラベルテキストのレンダリングに使用するフォント。付属の承認済みフォントから選択してください `推論`。任意のフォントファイルや URL はサポートされていません。最も広い文字範囲が必要な場合は 'Noto Sans' を選んでください。                                                                                                                                                                                                                                   | ✅  |
| `text_size_mode`  | `str`       | ラベルテキストのサイズをどのように決めるか。'Manual' は Size をそのまま使用します。'Automatic' は画像解像度から読みやすいサイズを選び、Size を 1080p 基準（14 pt）を中心とした倍率として扱います。                                                                                                                                                                                                                                  | ✅  |
| `font_size`       | `int`       | ラベルテキストのフォントサイズ（ポイント単位）。Manual モードでは描画サイズになります。Automatic モードでは解像度から導出された基準値（最小次元が 1080p のとき 14 pt）に対する倍率になります。                                                                                                                                                                                                                                           | ✅  |
| `text_padding`    | `int`       | テキスト周囲のパディングをピクセル単位で指定します。テキストとラベル背景の境界線の間隔を制御します。                                                                                                                                                                                                                                                                                                       | ✅  |
| `border_radius`   | `int`       | ラベル背景の角丸半径をピクセル単位で指定します。0 にすると四角い角になります。値を大きくすると角がより丸くなり、柔らかい印象になります。                                                                                                                                                                                                                                                                                    | ✅  |
| `max_line_length` | `int`       | ラベルテキストが折り返される前の、1 行あたりの最大文字数。折り返しを無効にするには空欄のままにしてください。                                                                                                                                                                                                                                                                                                  | ✅  |

この **参照** この列は、 `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 ラベル）は、中立的なグレーで描画されます..
  * `text` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)）：テキストラベルに表示する内容。オプション：'Class'（クラス名）、'Confidence'（信頼度スコア）、'Class and Confidence'（両方）、'Tracker Id'（追跡対象オブジェクトのトラッキング ID）、'Time In Zone'（ゾーン内の滞在時間）、'Dimensions'（中心座標と幅×高さ）、'Area'（バウンディングボックスの面積（ピクセル））、'Area (mask)'（Mask Area Measurement ブロックから得られるマスク面積（ピクセル））、'Area (converted)'（Mask Area Measurement ブロックから得られる変換後単位のマスク面積）、または 'Index'（検出インデックス）です。
  * `text_position` ([*`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（オブジェクトの重心）が含まれます。
  * `text_color` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)）：ラベルテキストの色。色名（例：'WHITE'、'BLACK'）のほか、HEX 形式のカラーコード（例：'#FFFFFF'）または RGB 形式（例：'rgb(255, 255, 255)'）を使用できます。
  * `font_family` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)）：ラベルテキストのレンダリングに使用するフォント。付属の承認済みフォントから選択してください `推論`。任意のフォントファイルや URL はサポートされていません。最も広い文字範囲が必要な場合は 'Noto Sans' を選んでください。
  * `text_size_mode` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)）：ラベルテキストのサイズをどのように決めるか。'Manual' は Size をそのまま使用します。'Automatic' は画像解像度から読みやすいサイズを選び、Size を 1080p 基準（14 pt）を中心とした倍率として扱います。
  * `font_size` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)）：ラベルテキストのフォントサイズ（ポイント単位）。Manual モードでは描画サイズになります。Automatic モードでは解像度から導出された基準値（最小次元が 1080p のとき 14 pt）に対する倍率になります。
  * `text_padding` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)）：テキスト周囲のパディングをピクセル単位で指定します。テキストとラベル背景の境界線の間隔を制御します。
  * `border_radius` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)）：ラベル背景の角丸半径をピクセル単位で指定します。0 にすると四角い角になります。値を大きくすると角がより丸くなり、柔らかい印象になります。
  * `max_line_length` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)）：ラベルテキストが折り返される前の、1 行あたりの最大文字数。折り返しを無効にするには空欄のままにしてください。
* 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/rich_label_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",
	    "text": "LABEL",
	    "text_position": "CENTER",
	    "text_color": "WHITE",
	    "font_family": "Geist Mono",
	    "text_size_mode": "Manual",
	    "font_size": 14,
	    "text_padding": 10,
	    "border_radius": 0,
	    "max_line_length": 30
	}
```

</details>
