> 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/text-display.md).
# テキスト表示
この **テキスト表示** このブロックは、スタイルと配置を完全に制御しながら、画像上にテキストを描画します。
### 動的テキストコンテンツ
テキスト内容は、Email および SMS 通知ブロックと同じテンプレート構文を使用して、ワークフロー実行結果をもとにパラメータ化できます：
```
text = "{{ $parameters.class_name }} クラスのオブジェクトを {{ $parameters.count }} 個検出しました"
```
パラメータは次を通じて提供されます： `text_parameters` フィールド：
```
text_parameters = {
"count": "$steps.model.predictions",
"class_name": "$inputs.target_class"
}
```
次を使用して、パラメータに変換を適用できます： `text_parameters_operations`:
```
text_parameters_operations = {
"count": [{"type": "SequenceLength"}]
}
```
### スタイル設定オプション
* **text\_color**：テキストの色。以下に対応しています：
* Supervision の色名（大文字）："WHITE"、"BLACK"、"RED"、"GREEN"、"BLUE"、"YELLOW"、"ROBOFLOW" など。
* Hex 形式："#RRGGBB"（例：赤の場合は "#FF0000"）
* RGB 形式："rgb(R, G, B)"（例：赤の場合は "rgb(255, 0, 0)"）
* BGR 形式："bgr(B, G, R)"（例：赤の場合は "bgr(0, 0, 255)"）
* **background\_color**：テキストの背後の背景色。text\_color と同じ色形式に対応しています： `text_color`。背景なしにするには "transparent" を使用します。
* **background\_opacity**：背景の透明度（0.0 = 完全に透明、1.0 = 完全に不透明）
* **font\_scale**：フォントサイズの倍率
* **font\_thickness**：テキストの線の太さ
* **padding**：テキスト周囲の余白（ピクセル）
* **text\_align**：テキストの水平方向の配置（"left"、"center"、"right"）
* **border\_radius**：背景の角丸半径
### 配置オプション
このブロックは絶対配置と相対配置の両方をサポートします：
**絶対配置** (`position_mode = "absolute"`):
* `position_x`：左端からの X 座標（ピクセル）
* `position_y`：上端からの Y 座標（ピクセル）
**相対配置** (`position_mode = "relative"`):
* `anchor`：テキストを固定する位置（"center"、"top\_left"、"top\_center"、"top\_right"、"bottom\_left"、"bottom\_center"、"bottom\_right"、"center\_left"、"center\_right"）
* `offset_x`：アンカーポイントからの水平方向オフセット（正の値 = 右）
* `offset_y`：アンカーポイントからの垂直方向オフセット（正の値 = 下）
### 型識別子
ステップで次の識別子を使用してください `"type"` フィールド： `roboflow_core/text_display@v1` ワークフローにこのブロックをステップとして追加するには。
### プロパティ
| **名前** | **型** | **説明** | 参照 |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name` | `str` | このステップの一意の識別子を入力してください。 | ❌ |
| `text` | `str` | 表示するテキスト内容。次を使用したパラメータ補間に対応しています： `{{ $parameters.name }}` 構文.. | ❌ |
| `text_parameters` | `Dict[str, Union[bool, float, int, str]]` | テキストに補間するパラメータ.. | ✅ |
| `text_parameters_operations` | `Dict[str, List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]]` | 補間前にテキストパラメータに適用する操作.. | ❌ |
| `text_color` | `str` | テキストの色。Supervision の色名（WHITE、BLACK、RED、GREEN、BLUE、YELLOW、ROBOFLOW など）、Hex 形式（#RRGGBB）、rgb(R,G,B) 形式、または bgr(B,G,R) 形式に対応しています。. | ✅ |
| `background_color` | `str` | テキスト\_color と同じ色形式に対応しています。背景なしにするには 'transparent' を使用します。. | ✅ |
| `background_opacity` | `float` | 背景の透明度（0.0 = 完全に透明、1.0 = 完全に不透明）.. | ✅ |
| `font_scale` | `float` | フォントサイズの倍率.. | ✅ |
| `font_thickness` | `整数` | テキストの線の太さ.. | ✅ |
| `padding` | `整数` | テキスト周囲の余白（ピクセル）.. | ✅ |
| `text_align` | `str` | バウンディングボックス内でのテキストの水平方向配置.. | ✅ |
| `border_radius` | `整数` | 背景矩形の角丸半径.. | ✅ |
| `position_mode` | `str` | 配置モード：'absolute' は正確なピクセル座標を使用し、'relative' はオフセット付きのアンカーポイントを使用します.. | ✅ |
| `position_x` | `整数` | 左端からの X 座標（ピクセル）を絶対配置で使用する場合.. | ✅ |
| `position_y` | `整数` | 上端からの Y 座標（ピクセル）を絶対配置で使用する場合.. | ✅ |
| `anchor` | `str` | 相対配置のアンカーポイント.. | ✅ |
| `offset_x` | `整数` | アンカーポイントからの水平方向オフセット（正の値 = 右）.. | ✅ |
| `offset_y` | `整数` | アンカーポイントからの垂直方向オフセット（正の値 = 下）.. | ✅ |
| `copy_image` | `bool` | 描画前に入力画像をコピーするかどうか（元画像を保持します）.. | ✅ |
この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。
### 入力と出力のバインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `テキスト表示` のバージョン `v1` あるか確認してください。
入力と出力のバインディング
* 入力
* `image` ([*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)）：テキストを表示する画像..
* `text_parameters` ([*`*`*](/workflows/ja/gaido/developer-guide/kinds/wildcard.md)）：テキストに補間するパラメータ..
* `text_color` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：テキストの色。Supervision の色名（WHITE、BLACK、RED、GREEN、BLUE、YELLOW、ROBOFLOW など）、Hex 形式（#RRGGBB）、rgb(R,G,B) 形式、または bgr(B,G,R) 形式に対応しています。..
* `background_color` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：テキスト\_color と同じ色形式に対応しています。背景なしにするには 'transparent' を使用します。..
* `background_opacity` ([*`float_zero_to_one`*](/workflows/ja/gaido/developer-guide/kinds/float-zero-to-one.md)）：背景の透明度（0.0 = 完全に透明、1.0 = 完全に不透明）..
* `font_scale` ([*`float`*](/workflows/ja/gaido/developer-guide/kinds/float.md)）：フォントサイズの倍率..
* `font_thickness` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：テキストの線の太さ..
* `padding` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：テキスト周囲の余白（ピクセル）..
* `text_align` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：バウンディングボックス内でのテキストの水平方向配置..
* `border_radius` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：背景矩形の角丸半径..
* `position_mode` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：配置モード：'absolute' は正確なピクセル座標を使用し、'relative' はオフセット付きのアンカーポイントを使用します..
* `position_x` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：左端からの X 座標（ピクセル）を絶対配置で使用する場合..
* `position_y` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：上端からの Y 座標（ピクセル）を絶対配置で使用する場合..
* `anchor` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：相対配置のアンカーポイント..
* `offset_x` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：アンカーポイントからの水平方向オフセット（正の値 = 右）..
* `offset_y` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：アンカーポイントからの垂直方向オフセット（正の値 = 下）..
* `copy_image` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)）：描画前に入力画像をコピーするかどうか（元画像を保持します）..
* 出力
* `image` ([`image`](/workflows/ja/gaido/developer-guide/kinds/image.md)): ワークフロー内の画像。
JSON 定義の例
```json
{
"name": "",
"type": "roboflow_core/text_display@v1",
"image": "$inputs.image",
"text": "検出数: {{ $parameters.count }}",
"text_parameters": {
"class_name": "$inputs.target_class",
"count": "$steps.model.predictions"
},
"text_parameters_operations": {
"count": [
{
"type": "SequenceLength"
}
]
},
"text_color": "WHITE",
"background_color": "BLACK",
"background_opacity": 1.0,
"font_scale": 1.0,
"font_thickness": 1,
"padding": 5,
"text_align": "left",
"border_radius": 0,
"position_mode": "absolute",
"position_x": 10,
"position_y": 10,
"anchor": "center",
"offset_x": 0,
"offset_y": 0,
"copy_image": true
}
```