# OCR Execute

OCR Execute opens an image file and returns any text found.

Action available for the following operating systems:

![](/files/kfMeq0OanEe5OOx5RmUn)

### Parameters

* **Source Image** *\<string> -* Image path to be read and converted to Text.

*Target Values*

* **Text** *\<string> -* Select a Variable or Control to receive the Text value.
* **Line Count** *\<numeric> -* Select a Variable or Control to receive the numeric value.
* **Word Count** *\<numeric> -* Select a Variable or Control to receive the numeric value.

*Target Corner Points*

Four Corner Points are returned in the format: X1, Y1, X2, Y2, X3, Y3, X4, Y4 starting in the top left corner, in clockwise direction Corner Points List are returned with each element separated by CR.

* **Text** *\<string> -* Select a Variable or Control to receive the Text value.
* **Lines** *\<string*> - Select a Variable or Control to receive the Text value.
* **Words** *\<string*> - Select a Variable or Control to receive the Text value.

{% hint style="info" %}
OCR recognition is performed using the Firebase SDK on Android and iOS, and using Windows.Media.OCR from Microsoft on Win10, and as such the recognition accuracy and result types can be different in the different platforms.
{% endhint %}

{% hint style="warning" %}
On Android, if the recognition engine is not installed on the device, the device may require internet connection to download the engine. This is done using Google Play services, so it is required that the device as Google Play services enabled. The first times you make an OCR request, if the engine is not yet downloaded you will get an error.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.sysdevmobile.com/kalipso5/developing/form/actions/actions-description/group-others/ocr-execute.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.