> 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/run-a-model/ppocr.md).

# PP-OCR

PP-OCR（PaddleOCR）光学文字認識を使用して画像からテキストを抽出します。

PP-OCR（PaddleOCR）光学文字認識（OCR）を使用して、画像内の文字を取得します。

このブロックは画像内のテキストを返します。

このブロックは、検出ベースのブロック（例: ObjectDetectionBlock）と組み合わせて使用するとよいでしょう。物体検出モデルを使うと、画像内の特定の領域（例: 物流ユースケースにおける輸送コンテナID）を切り出して、さらに処理できます。その後、OCRを実行する前に、DynamicCropBlockを使用して関心領域を切り抜くことができます。

検出モデルを使用してから検出結果を切り抜くことで、画像の特定の領域に分析を絞り込めます。

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/pp_ocr@v1` を、ワークフローにステップとして追加します。

### プロパティ

| **名前**             | **型** | **説明**                                                                      | 参照 |
| ------------------ | ----- | --------------------------------------------------------------------------- | -- |
| `name`             | `str` | ワークフロー内のステップの一意な名前。                                                         | ❌  |
| `text_detection`   | `str` | テキスト検出モデルのサイズ。次に設定すると `なし` 検出を無効にし、各入力画像に対して、事前に切り抜かれた1本のテキスト行として認識を実行します.. | ❌  |
| `text_recognition` | `str` | テキスト認識モデルのサイズ。次に設定すると `なし` 認識を無効にし、転記テキストなしで検出されたテキストボックスのみを返します..          | ❌  |

この **参照** この列は、 `workflow` の実行時に利用可能な動的値でプロパティをパラメータ化できる可能性を示します。 *バインディング* の詳細を参照してください。

### 入力および出力バインディング

利用可能な接続は、そのバインディング種別に依存します。 `PP-OCR` バージョン `v1` に、どのバインディング種別があるか確認してください。

<details>

<summary>入力と出力のバインディング</summary>

* input
  * `images` ([*`image`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)) : 推論対象の画像。
* output
  * `結果` ([`string`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)): 文字列値。
  * `predictions` ([`object_detection_prediction`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)）：sv.Detections(...) オブジェクト形式の検出済みバウンディングボックスを含む予測。
  * `parent_id` ([`parent_id`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/parent-id.md)) : ステップ出力の親の識別子。
  * `root_parent_id` ([`parent_id`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/parent-id.md)) : ステップ出力の親の識別子。
  * `prediction_type` ([`prediction_type`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/prediction-type.md)): 予測の種類を表す文字列値。

</details>

<details>

<summary>JSON定義の例</summary>

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/pp_ocr@v1",
	    "images": "$inputs.image",
	    "text_detection": "<block_does_not_provide_example>",
	    "text_recognition": "<block_does_not_provide_example>"
	}
```

</details>
