Прочитать текст / Read text action
Данное действие предназначено для распознавания печатного текста в заданной области и сохранения распознанного текста в переменную.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая будет содержит изображение для распознавания. | Robin.Image | Область_распознавания | Да |
| Основной язык | Primary language | Язык, который распознаватель ожидает в тексте. По умолчанию значение равно "Русский". Выпадающий список: Справочник содержит следующие значения:
!!! Реализация списком временная. После подготовки тулзы с возможностью выбрать несколько элементов одновременно (на базе типа Robin.Collection), тип параметра и реализация его ввода будут изменены. | Robin.String | Русский | Да |
| Формат контента | Segmentation mode | Ожидаемый формат контента (увеличивает вероятность правильно прочесть текст). Выпадающий список. Справочник содержит следующие значения:
По умолчанию значение равно "Page". | Robin.String | Page | Да |
| Результаты | |||||
| Результат | Result | Переменная, в которую будет сохранен распознанный текст. Если изображение не содержит текст или его невозможно прочитать, будет сохранено пустое значение. | Robin.String | Результат_распознавания_текста | Да |
Особые условия использования
Отсутствуют.
Снять область / Area screen
Данное действие предназначено для скриншота области и сохранения его в переменную.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Выделение области | Set an area | Выделение области вручную. Реализовано кнопкой. При нажатии Система свернет ROBIN Studio и предоставит пользователю возможность самостоятельно выделить область экрана, которую требуется распознать. После завершения выделения Система автоматически заполнит следующие поля данными выбранной области для распознавания:
| Robin.Collection | Нет | |
| Координаты начала | Start coordinates | Координаты левого верхнего угла области для распознавания. Определяется двумя координатами Х и Y. После использования кнопки "Выделение области" параметр автозаполняется в соответствии с выделенной областью. | Robin.LocationPoint |  {233;122} | Да |
| Координаты конца | Finish coordinates | Координаты правого нижнего угла области для распознавания. Определяется двумя координатами Х и Y. После использования кнопки "Выделение области" параметр автозаполняется в соответствии с выделенной областью. | Robin.LocationPoint | {333;322} | Да |
| X | X | Положение начальной координаты (координата левого верхнего угла области для распознавания) определяется двумя координатами Х и Y. Начальная координата, обозначенной области, по горизонтали. После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: " "Не найдены переменные: <Новое значение>", | Число | 233 | Нет |
| Y | Y | Положение начальной координаты (координата левого верхнего угла области для распознавания) определяется двумя координатами Х и Y. Начальная координата, обозначенной области, по вертикали. После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: "Не найдены переменные: <Новое значение>". | Число | 242 | Нет |
| Высота | Heigth | Высота, обозначенной области (отсчет идет сверху вниз от начальной координаты области скриншота). После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: "Не найдены переменные: <Новое значение>". | Число | 330 | Нет |
| Ширина | Widht | Ширина, обозначенной области (отсчет идет слева направо от начальной координаты области). После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: " "Не найдены переменные: <Новое значение>", | Число | 528 | Нет |
| Использовать DirectX | Use DirectX | По умолчанию признак не установлен. | Чек-бокс | Нет | |
| Результаты | |||||
| Результат | Result | Переменная, в которую будет сохранена выделенная область. | Robin.Image | Область_распознавания | Да |
Особые условия использования
Отсутствуют.
Показать изображение / Show image
Данное действие предназначено для вывода указанного изображения на экран.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая содержит изображение. | Robin.Image | Область_распознавания | Да |
Особые условия использования
Отсутствуют.
Найти на экране / Find on the screen
Данное действие предназначено для поиска области на экране и получения ее координат.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая содержит изображение для распознавания. | Robin.Image | Область_распознавания | Да |
| Степень сходства | Similarity rate | Необходимый коэффициент сходства между изображением и искомой областью. Максимальное значение равно "1" . По умолчанию значение равно "0.75". | Robin.Numeric | 0.75 | Да |
| Тайм-аут | Time-out | Время, в течении которого будет осуществляться поиск заданного объекта. Задается в мс. По умолчанию значение равно "1000". Дублирует параметр из действия "Ждать появления" - задает время, в течение которого осуществляется периодическая проверка существования объекта. | Robin.Numeric | 1000 | Да |
| Возвращать центр | Give center | Возвращает координаты центров изображений, найденных на экране. По умолчанию возвращаются координаты верхнего левого угла изображения. | Robin.Boolean | True | Нет |
| Результаты | |||||
| Координаты | Coordinates | Переменная, которая будет содержать координаты всех найденных объектов. Порядок заполнения коллекции результатов: первым идет объект, найденный ближе всех к верхнему левому углу области поиска. Если объект не появился за указанный промежуток времени, то будет выведена ошибка "Изображение не найдено". | Robin.Collection | Координаты | Да |
Особые условия использования
Для данного действия необходимо устанавливать задержку не менее 1000 (мc).
После введения параметра ожидания данное действие функционально дублируется действием "Ждать появления".
Поэтому последнее можно считать не нужным.
Ждать появления / Wait for action
Данное действие предназначено для ожидания появления объекта, соответствующего указанному шаблону, и получения его координат.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая содержит изображение для распознавания. | Robin.Image | Область_распознавания | Да |
| Степень сходства | Similarity rate | Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью. По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области. Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".". | Robin.Numeric | 1 | Да |
| Тайм-аут | Time-out | Время, в течении которого будет ожидаться появление заданного объекта. Задается в мс. Значение по умолчанию равно временному промежутку, указанному в разделе "Настройки робота" в поле "TimeOutTime". | Robin.Numeric | 1000 | Да |
| Возвращать центр | Give center | Действие будет возвращать координаты центров изображений, найденных на экране. По умолчанию возвращаются координаты верхнего левого угла изображения. | Robin.Boolean | Нет | |
| Результаты | |||||
| Координаты | Coordinates | Переменная, которая будет содержать координаты всех найденных объектов. Порядок заполнения коллекции результатов: первым идет объект, найденный ближе всех к верхнему левому углу области поиска. Если объект не появился за указанный промежуток времени, то будет выведена ошибка "Изображение не найдено". | Robin.Collection | Координаты_2 | Да |
Особые условия использования
Данное действие функционально дублирует действие "Найти на экране", потому его можно удалить.
Ждать исчезновения / Wait for disappear action
Данное действие предназначено для ожидания исчезновения объекта, соответствующего указанному шаблону.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая содержит изображение для распознавания. | Robin.Image | Область_распознавания | Да |
| Степень сходства | Similarity rate | Необходимый коэффициент сходства между изображением и искомой областью. Максимальное значение равно "1" . По умолчанию значение равно "0.75". | Robin.Numeric | 0.8 | Да |
| Тайм-аут | Time-out | Время, в течении которого будет ожидаться исчезновение заданного объекта. Задается в мс. | Robin.Numeric | 1000 | Да |
| Результаты | |||||
| Результат | Result | Переменная, в которую будет сохранен результат проверки исчезновения объекта.
| Robin.Boolean | true | Да |
Особые условия использования
Если результат "true", а объект на экране присутствует, значит есть необходимость уточнить степень сходства с изображением для поиска.
Загрузить из файла / Load from file
Данное действие предназначено для загрузки изображения из директории.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Путь к файлу | Path to file | Путь к файлу, содержимое которого будет использовано для распознавания. | Robin.Filepath | C:\Users\RLABUTIN\Desktop\ Действия в Studio.pdf.png | Да |
| Результаты | |||||
| Результат | Result | Переменная, в которую будет сохранено содержимое файла. | Robin.Image | Скриншот1 | Да |
Особые условия использования
Отсутствуют.
Загрузить PDF-страницу / Load from PDF
Данное действие предназначено для загрузки страницы PDF в виде изображения.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Путь к файлу | Path to file | Путь к PDF-файлу, страница которого будет использована для распознавания Если поле содержит путь к файлу, отличному от формата PDF, то в логах будет выведено сообщение: "File not in PDF format or corrupted." | Robin.Filepath | C:\Users\RLABUTIN\Desktop\ Действия в Studio.pdf | Да |
| Качество | Quality | Выбор разрешения (числа точек на полученном изображении, которые умещаются в одном дюйме). Выпадающий список. Справочник содержит следующие значения:
По умолчанию значение равно "DPI_300". | Robin.String | DPI_600 | Нет |
| Номер страницы | Page number | Номер, извлекаемой страницы. По умолчанию значение равно "1". Если поле содержит номер страницы, который Система не смогла распознать, то в логах будет выведено сообщение: "Индекс должен быть положительным числом и не выходить за пределы диапазона." | Robin.Numeric | 23 | Да |
| Результаты | |||||
| Результат | Result | Переменная, в которую будет сохранено содержимое PDF-файла. | Robin.Image | Скриншот2 | Да |
Особые условия использования
Отсутствуют.
Загрузить из ресурса / Load from resource
Данное действие предназначено для загрузки изображения из ресурса.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Входные параметры | |||||
| Ресурс | Resource | Ресурс с типом "Изображение", содержащий область распознавания. Если значение не указано, то Система выведет сообщение: "Не задан ресурс". | Выпадающий список | Ресурс | Да |
| Выходные параметры | |||||
| Результат | Result | Переменная с типом "Объект", в которую будет сохранено содержимое ресурса. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена". | Выпадающий список | Скриншот3 | Да |
Особые условия использования
Отсутствуют.
Существует на экране / Exists on screen action
Данное действие предназначено для проверки существования на экране указанной области.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая содержит изображение для распознавания. | Robin.Image | Рисунок_распознавания | Да |
| Степень сходства | Similarity rate | Необходимый коэффициент сходства между изображением и искомой областью. Максимальное значение равно "1" . По умолчанию значение равно "0.75". | Robin.Numeric | 0.8 | Да |
| Тайм-аут | Time-out | Время, в течении которого будет осуществляться поиск заданного объекта. Задается в мс. По умолчанию значение равно "1000". | Robin.Numeric | 1000 | Да |
| Результаты | |||||
| Результат | Result | Переменная, в которую будет сохранен результат проверки.
| Robin.Boolean | Результат_проверки_существования | Да |
Особые условия использования
Если результат "false", а объект на экране присутствует, значит есть необходимость уточнить степень сходства с изображением для поиска.
Распознать по шаблону / Recognize by template action
Данное действие предназначено для распознавания текста таблиц по шаблону (позволяет "вытащить" значение из ячеек таблицы и "положить" его в переменную).
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Входные параметры | |||||
| Ресурс | Resource | Ресурс с типом "Разметка таблицы", содержащий область распознавания. | Выпадающий список | Область_распознавания | Да |
| Основной язык | Primary language | Язык который распознаватель ожидает в тексте | Строка | rus | Нет |
| Выходные параметры | |||||
| Шаблон | Template | Переменная с типом "Общий", в которую будет сохранено содержимое ресурса. Если поле содержит ресурс, который Система не смогла распознать, то в лог будет выведено сообщение: "resource was not found or source had incorrect type." | Выпадающий список | Результат | Да |
Особые условия использования
Отсутствуют.
Найти страницу в PDF / Find page in PDF
Данное действие предназначено для поиска страницы по введенному значению и получение ее номера.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Путь к файлу | Path to file | Путь к PDF-файлу, страница которого будет использована для распознавания. | Robin.Filepath | C:\Users\RLABUTIN\Desktop\ Действия в Studio.pdf | Да |
| Качество | Quality | Выбор разрешения (числа точек на полученном изображении, которые умещаются в одном дюйме). Выпадающий список. Справочник содержит следующие значения:
По умолчанию значение равно "DPI_300". | Robin.String | DPI_300 | Нет |
| Основной язык | Primary language | Язык, который распознаватель ожидает в тексте. По умолчанию значение равно "rus". Пользователь имеет возможность выбрать один или несколько языков в прилагающейся тулзе. Справочник содержит следующие значения:
| Robin.Collection | rus | Нет |
| Текст | Text | Текст, который должна содержать страница. Язык распознается автоматически по введенному тексту. Если введенная строка не содержит символьных элементов, а только специальные, то поиск идет по ним. Язык, в таком случае, при необходимости, определяется по умолчанию, как локальный. | Robin.String | Загрузить | Да |
| Результаты | |||||
| Номер страницы | Page number | Переменная, которая будет содержать номера всех найденных страниц. Если страница не будет найдена вывести ошибку: "Не найдена страница, содержащая заданный текст." | Robin.Collection | Результат | Да |
Особые условия использования
Отсутствуют.
Обзор
Инструменты контента