Прочитать текст / Read text action
Данное действие предназначено для распознавания печатного текста в заданной области и сохранения распознанного текста в переменную.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая будет содержит изображение для распознавания. | Robin.Image | Область_распознавания | Да |
| Основной язык | Primary language | Язык, который распознаватель ожидает в тексте. По умолчанию значение равно "Русский". Пользователь имеет возможность выбрать один или несколько языков в прилагающейся тулзе. Справочник содержит следующие значения:
| Robin.Collection | Русский | Да |
| Формат контента | Segmentation mode | Ожидаемый формат контента (увеличивает вероятность правильно прочесть текст). Выпадающий список. Справочник содержит следующие значения:
По умолчанию значение равно "Page". | Robin.String | Page | Да |
| Результаты | |||||
| Результат | Result | Переменная, в которую будет сохранен распознанный текст. Если изображение не содержит текст или его невозможно прочитать, будет сохранено пустое значение. | Robin.String | Результат_распознавания_текста | Да |
Особые условия использования
Отсутствуют.
Пример использования в 1-й студии
Задача:
Существует на экране область с текстом.
Необходимо выделить область и распознать текст.
Решение:
- Снять область.
- Прочитать текст.
- Показать изображение.
Реализация:
- Создаем переменную "Область_распознавания1" с типом "Общий", которая будет содержать область для распознавания.
- Создаем переменную "Результат_распознавания1" с типом "Строка", в которую будет сохранен распознанный текст.
- Открываем группу действий "Машинное зрение".
- Помещаем в рабочее пространство студии действие "Снять область" (см. описание действия "Машинное зрение 2.0").
- Помещаем в рабочее пространство студии действие "Прочитать текст".
Настройка действия:- Параметр "Изображение". Выбираем переменную "Область_распознавания1", которая будет содержать область для распознавания.
- Параметр "Форма контента". Выбираем из списка значение "Page".
- Параметр "Результат". Выбираем переменную "Результат_распознавания1", в которую будет сохранен распознанный текст.
- Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Переменная "РезультатРаспознавания1" содержит текст.
Снять область / 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 | Область_распознавания | Да |
Особые условия использования
Отсутствуют.
Пример использования в 1-й студии
Задача:
Существует на экране область с текстом.
Необходимо выделить область и распознать текст.
Решение:
- Снять область.
- Прочитать текст.
- Показать изображение.
Реализация:
- Создаем переменную "Область_распознавания1" с типом "Общий", в которую будет сохранена выделенная область.
- Открываем группу действий "Машинное зрение".
- Помещаем в рабочее пространство студии действие "Снять область".
Настройка действия:- Параметр "Результат". Выбираем переменную "Область_распознавания1", в которую будет сохранена выделенная область.
- Нажимаем на кнопку "Выбрать область" и выделяем на экране область с текстом В результате Система автоматически заполнит параметры "Х", "Y", "Высота" и "Ширина".
- Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
- Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Переменная "РезультатРаспознавания1" содержит текст.
Показать изображение / Show image
Данное действие предназначено для вывода указанного изображения на экран.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая содержит изображение. | Robin.Image | Область_распознавания | Да |
Особые условия использования
Отсутствуют.
Пример использования в 1-й студии
Задача:
Существует на экране область с текстом.
Необходимо выделить область и распознать текст.
Решение:
- Снять область.
- Прочитать текст.
- Показать изображение.
Реализация:
- Создаем переменную "Область_распознавания1" с типом "Общий", которая содержит изображение..
- Открываем группу действий "Машинное зрение".
- Помещаем в рабочее пространство студии действие "Снять область" (см. описание действия "Машинное зрение 2.0").
- Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
- Помещаем в рабочее пространство студии действие "Показать изображение".
Настройка действия:- Параметр "Источник изображения". Выбираем переменную "Область_распознавания1", которая содержит изображение.
- Параметр "Источник изображения". Выбираем переменную "Область_распознавания1", которая содержит изображение.
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Переменная "РезультатРаспознавания1" содержит текст.
Найти на экране / Find on the screen
Данное действие предназначено для поиска области на экране и получения ее координат.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая содержит изображение для распознавания. | Robin.Image | Область_распознавания | Да |
| Степень сходства | Similarity rate | Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью. По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области. Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".". | Robin.Numeric | 0.75 | Да |
| Тайм-аут | Time-out | Время, в течении которого будет ожидаться появление заданного объекта. Задается в мс. | 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 | Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью. По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области. Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".". | 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 | Да |
Особые условия использования
Отсутствуют.
Пример использования в 1-й студии.
Задача:
Существует текстовая картинка.
Необходимо распознать текст из картинки.
Решение:
- Загрузить из файла.
- Прочитать текст.
- Показать изображение.
Реализация:
- Создаем переменную "ОбластьРаспознавания3" с типом "Общий", в которую будет сохранено содержимое PDF-файла.
- Создаем ресурс с типом "Изображение".
- Открываем группу действий "Машинное зрение".
- Помещаем в рабочее пространство студии действие "Загрузить из файла".
Настройка действия:- Параметр "Путь к файлу". Указываем путь к картинке, содержимое которого будет использовано для распознавания
- Параметр "Результат". Выбираем переменную "ОбластьРаспознавания4", в которую будет сохранено содержимое PDF-файла.
- Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
- Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Переменная "РезультатРаспознавания3" содержит текст.
Загрузить 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 | Да |
Особые условия использования
Отсутствуют.
Пример использования в 1-й студии.
Задача:
Существует PDF-документ "Действия в Studio.pdf".
Необходимо распознать текст на странице, в которой встречается слово "Базовые действия".
Решение:
- Найти страницу в PDF.
- Загрузить PDF-страницу.
- Прочитать текст.
- Показать изображение.
Реализация:
- Создаем переменную "ОбластьРаспознавания2" с типом "Общий", в которую будет сохранено содержимое PDF-файла..
- Открываем группу действий "Машинное зрение".
- Помещаем в рабочее пространство студии действие "Найти страницу в PDF" (см. описание действия "Машинное зрение 2.0").
- Помещаем в рабочее пространство студии действие "Загрузить PDF-страницу".
Настройка действия:- Параметр "Путь к файлу". Указываем путь к PDF-файлу "Действия в Studio.pdf", страница которого будет использована для распознавания.
- Параметр "Номер страницы". Указываем переменную "СтраницаКлюч", значение которой получаем из действия "Машинное зрение 2.0".
- Параметр "Результат". Выбираем переменную "ОбластьРаспознавания2", в которую будет сохранено содержимое PDF-файла.
- Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
- Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Переменная "РезультатРаспознавания1" содержит текст на странице, в которой встречается слово "Базовые действия".
Загрузить из ресурса / Load from resource
Данное действие предназначено для загрузки изображения из ресурса.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Входные параметры | |||||
| Ресурс | Resource | Ресурс с типом "Изображение", содержащий область распознавания. Если значение не указано, то Система выведет сообщение: "Не задан ресурс". | Выпадающий список | Ресурс | Да |
| Выходные параметры | |||||
| Результат | Result | Переменная с типом "Объект", в которую будет сохранено содержимое ресурса. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена". | Выпадающий список | Скриншот3 | Да |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Существует ресурс с типом "Изображение".
Необходимо распознать текст из ресурса.
Решение:
- Загрузить из ресурса.
- Прочитать текст.
- Показать изображение.
Реализация:
- Создаем переменную "ОбластьРаспознавания3" с типом "Общий", в которую будет сохранено содержимое PDF-файла.
- Создаем ресурс с типом "Изображение".
- Открываем группу действий "Машинное зрение".
- Помещаем в рабочее пространство студии действие "Загрузить из ресурса".
Настройка действия:- Параметр "Ресурс". Указываем ресурс, содержащий область распознавания..
- Параметр "Результат". Выбираем переменную "ОбластьРаспознавания3", в которую будет сохранено содержимое PDF-файла.
- Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
- Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Переменная "РезультатРаспознавания3" содержит текст.
Существует на экране / Exists on screen action
Данное действие предназначено для проверки существования на экране указанной области.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Изображение | Image | Переменная, которая содержит изображение для распознавания. | Robin.Image | Рисунок_распознавания | Да |
| Степень сходства | Similarity rate | Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью. По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области. Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".". | Robin.Numeric | 0.8 | Да |
| Результаты | |||||
| Результат | 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 | Результат | Да |
Особые условия использования
Отсутствуют.
Пример использования в 1-й студии.
Задача:
Существует PDF-документ "Действия в Studio.pdf".
Необходимо распознать текст на странице, в которой встречается слово "Базовые действия".
Решение:
- Найти страницу в PDF.
- Загрузить PDF-страницу.
- Прочитать текст.
- Показать изображение.
Реализация:
- Создаем переменную "СтраницаКлюч" с типом "Число", которая будет содержать номер найденной страницы.
- Открываем группу действий "Машинное зрение".
- Помещаем в рабочее пространство студии действие "Найти страницу в PDF".
Настройка действия:- Параметр "Путь к файлу". Указываем путь к PDF-файлу "Действия в Studio.pdf", страница которого будет использована для распознавания.
- Параметр "Текст". Указываем значение "Базовые действия", которое должна быть на странице.
- Параметр "Найти страницу в PDF. Выбираем переменную "СтраницаКлюч", которая будет содержать номер найденной страницы.
- Помещаем в рабочее пространство студии действие "Загрузить PDF-страницу" (см. описание действия "Загрузить PDF-страницу").
- Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
- Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Переменная "РезультатРаспознавания1" содержит текст на странице, в которой встречается слово "Базовые действия".
Обзор
Инструменты контента