# Recognize Text from Screen This block allows you to specify a screen area (application window, panel, or another element within the window) during robot development, and then during the execution of the script, the robot recognizes all text from the specified screen area using OCR technology and stores the recognition result in the specified text variable. You can choose from several available offline and online OCR modules.
Selector[Selector] The identifier of the window or user interface element within which text recognition will occur.
X Coordinate[Number] The horizontal coordinate of the top-left corner of the selected window or control area where the image will be captured and recognized.
Y Coordinate[Number] The vertical coordinate of the top-left corner of the selected window or control area where the image will be captured and recognized.
Width[Number] The width of the image to be captured and recognized in pixels.
Height[Number] The height of the image to be captured and recognized in pixels.
Text LanguageSelect the language of the text.
Result[Text] The recognized text will be placed in the variable specified here.
Process ID

[Link] A variable that stores the process identifier. Indicates which application to work with.

If the specified application is minimized or its window is covered by other windows, it will be brought to the foreground. When working with browsers, the process ID additionally specifies the particular browser tab that the block should work with.

If the property is left empty, or if the process ID variable was not previously assigned at the moment of launching the application or opening the browser, the application and browser tab will be determined from the content of the corresponding selector line.

The process ID can be obtained, for example, using the Launch Application or Get Process blocks.

ModuleSelect the OCR module used for recognizing the image into text.
Splitting Method

[Text] The recognized text can be automatically split into segments, separated by commas. Splitting method:

  • 0 - Use the specified block separator,
  • 1 - Automatic splitting (only for Yandex),
  • 2 - Split by empty spaces longer than the specified number of characters.
Block Separator

[Number] The hexadecimal code of the character that will be considered a block separator.

For example, a space has the code 20, a tab character has the code 9. Used when selecting splitting method 0.

Number of Characters[Number] The length of the empty space in the recognized text, measured in the number of characters, which is used when selecting the text splitting method 2.
Zoom

[Number] A value indicating how many times to zoom the image before recognition.

Depending on the engine used, zooming the image by 2 or 3 times helps improve recognition quality.

Error Handling Level

Select the error handling level. Possible values:

  • "Default" - default;
  • "Ignore" - errors are ignored;
  • "Handle" - errors are handled.

If "Default" is selected, the value from the "Start" block of this diagram will be used.

Message Level

Select the message level that the blocks will output during operation. Possible values:

  • "Default" - default;
  • "Release" - output is disabled;
  • "Debug" - outputs basic information;
  • "Detailed" - outputs detailed information.

If "Default" is selected, the value from the "Start" block of this diagram will be used.

Error Text[Text] Returns detailed information about the error in case of incorrect execution of the block's work.