Прочитать текст / Read text action

Данное действие предназначено для распознавания печатного текста в заданной области и сохранения распознанного текста в переменную.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Входные параметры
Изображение	Image	Переменная с типом "Общий", которая будет содержать область для распознавания. Если значение не указано, то Система выведет сообщение: "Не задана переменная".	Выпадающий список	Область_распознавания	Да
Основной язык	Primary language	Язык, который распознаватель ожидает в тексте. По умолчанию значение равно "rus".	Строка	rus	Нет
Формат контента	Segmentation mode	Ожидаемый формат контента (увеличивает вероятность правильно прочесть текст). Справочник содержит следующие значения: Char - символ; Line - строка; Block - блок; Page - страница. По умолчанию значение равно "Char".	Выпадающий список	Char	Да
Выходные параметры
Результат	Result	Переменная с типом "Строка", в которую будет сохранен распознанный текст. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Выпадающий список	Результат_распознавания_текста	Да

Особые условия использования

Отсутствуют.

Пример использования

Задача:

Существует на экране область с текстом.

Необходимо выделить область и распознать текст.

Решение:

Снять область.
Прочитать текст.
Показать изображение.

Реализация:

Создаем переменную "Область_распознавания1" с типом "Общий", которая будет содержать область для распознавания.
Создаем переменную "Результат_распознавания1" с типом "Строка", в которую будет сохранен распознанный текст.
Открываем группу действий "Машинное зрение".
Помещаем в рабочее пространство студии действие "Снять область" (см. описание действия "Машинное зрение 2.0").
Помещаем в рабочее пространство студии действие "Прочитать текст".
Настройка действия:
1. Параметр "Изображение". Выбираем переменную "Область_распознавания1", которая будет содержать область для распознавания.
2. Параметр "Форма контента". Выбираем из списка значение "Page".
3. Параметр "Результат". Выбираем переменную "Результат_распознавания1", в которую будет сохранен распознанный текст.
Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Переменная "РезультатРаспознавания1" содержит текст.

Снять область / Area screen action

Данное действие предназначено для скриншота области и сохранения его в переменную.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Входные параметры
Область	Area	При нажатии на кнопку "Выбрать область" Система свернуть ROBIN Studio и предоставит пользователю возможность самостоятельно выделить область экрана, которую требуется распознать. После завершения выбора области пользователем Система автоматически заполнит следующие поля данными выбранной области для распознавания: "X"; "Y"; "Высота"; "Ширина".	Кнопка		Да
X	X	Положение начальной координаты (координата левого верхнего угла области для распознавания) определяется двумя координатами Х и Y. Начальная координата, обозначенной области, по горизонтали. После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: " "Не найдены переменные: <Новое значение>",	Число	233	Нет
Y	Y	Положение начальной координаты (координата левого верхнего угла области для распознавания) определяется двумя координатами Х и Y. Начальная координата, обозначенной области, по вертикали. После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: "Не найдены переменные: <Новое значение>".	Число	242	Нет
Высота	Heigth	Высота, обозначенной области (отсчет идет сверху вниз от начальной координаты области скриншота). После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: "Не найдены переменные: <Новое значение>".	Число	330	Нет
Ширина	Widht	Ширина, обозначенной области (отсчет идет слева направо от начальной координаты области). После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: " "Не найдены переменные: <Новое значение>",	Число	528	Нет
Использовать DirectX	Use DirectX	По умолчанию признак не установлен.	Чек-бокс		Нет
Выходные параметры
Результат	Result	Переменная с типом "Общий", в которую будет сохранена выделенная область. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Выпадающий список	Область_распознавания	Да

Особые условия использования

Отсутствуют.

Пример использования

Задача:

Существует на экране область с текстом.

Необходимо выделить область и распознать текст.

Решение:

Снять область.
Прочитать текст.
Показать изображение.

Реализация:

Создаем переменную "Область_распознавания1" с типом "Общий", в которую будет сохранена выделенная область.
Открываем группу действий "Машинное зрение".
Помещаем в рабочее пространство студии действие "Снять область".
Настройка действия:
1. Параметр "Результат". Выбираем переменную "Область_распознавания1", в которую будет сохранена выделенная область.
2. Нажимаем на кнопку "Выбрать область" и выделяем на экране область с текстом В результате Система автоматически заполнит параметры "Х", "Y", "Высота" и "Ширина".
Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Переменная "РезультатРаспознавания1" содержит текст.

Показать изображение / Show image

Данное действие предназначено для вывода указанного изображения на экран.

Настройки

Свойство

Англ. наименование

Описание

Тип

Пример заполнения

Обязательность заполнения поля

Входные параметры

Источник изображения

Image source

Переменная c типом "Общий", которая содержит изображение.

Если значение не указано, то Система выведет сообщение: "Не задана переменная".

Выпадающий список

Область_распознавания

Да

Особые условия использования

Отсутствуют.

Пример использования

Задача:

Существует на экране область с текстом.

Необходимо выделить область и распознать текст.

Решение:

Снять область.
Прочитать текст.
Показать изображение.

Реализация:

Создаем переменную "Область_распознавания1" с типом "Общий", которая содержит изображение..
Открываем группу действий "Машинное зрение".
Помещаем в рабочее пространство студии действие "Снять область" (см. описание действия "Машинное зрение 2.0").
Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
Помещаем в рабочее пространство студии действие "Показать изображение".
Настройка действия:
1. Параметр "Источник изображения". Выбираем переменную "Область_распознавания1", которая содержит изображение.
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Переменная "РезультатРаспознавания1" содержит текст.

Найти на экране / Find on screen first action

Данное действие предназначено для поиска области на экране и получения ее координат.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Изображение	Image	Переменная с типом "Общий",которая будет содержать область для распознавания. Если значение не указано, то Система выведет сообщение: "Не задана переменная".	Выпадающий список	Область_распознавания	Да
Степень сходства	Similarity rate	Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью. По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области. Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".".	Число	0.75	Да
Возвращать центр	Give center	Если чек-бокс: установлен, то возвращает координаты центра изображения, найденного на экране. не установлен, то возвращает координаты верхнего левого угла изображения, найденного на экране.	Чек-бокс		Нет
Выходные параметры
Координаты	Coordinates	Переменная с типом "Общий", которая будет содержать координаты найденного объекта. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Выпадающий список	Координаты1	Да

Особые условия использования

Необходимо установить задержку не менее 1000 (мc).

Пример использования

Ждать появления / Wait for action

Данное действие предназначено для ожидания появления объекта, соответствующего указанному шаблону, и получения его координат.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Входные параметры
Изображение	Image	Переменная с типом "Общий", которая будет содержать область для распознавания. Если значение не указано, то Система выведет сообщение: "Не задана переменная".	Выпадающий список	Область_распознавания	Да
Степень сходства	Similarity rate	Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью. По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области. Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".".	Число	1	Да
Тайм-аут	Time-out (ms)	Устанавливается время, в течении которого будет длится ожидание появления заданного объекта. Значение по умолчанию "-1", равное временному промежутку, указанному в разделе "Настройки робота" в поле "TimeOutTime".	Число	1000	Да
Возвращать центр	Give center	Если чек-бокс: установлен, то возвращает координаты центра изображения, найденного на экране. не установлен, то возвращает координаты верхнего левого угла изображения, найденного на экране.	Чек-бокс		Нет
Выходные параметры
Координаты	Coordinates	Переменная с типом "Общий", которая будет содержать координаты опознанного объекта. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена". Если объект не появился за указанный промежуток времени, то переменной присваивается значение {X=-10000,Y=-10000}.	Выпадающий список	Координаты2	Да

Особые условия использования

Отсутствуют.

Пример использования

Ждать исчезновения / Wait for disappear action

Данное действие предназначено для ожидания исчезновения объекта, соответствующего указанному шаблону.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Входные параметры
Изображение	Image	Переменная с типом "Общий",которая будет содержать область для распознавания. Если значение не указано, то Система выведет сообщение: "Не задана переменная".	Выпадающий список	Область_распознавания	Да
Степень сходства	Similarity rate	Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью. По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области. Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".".	Число	0.8	Да
Тайм-аут	Time-out (ms)	Устанавливается время, в течении которого будет длится ожидание исчезновения заданного объекта. Значение по умолчанию "-1", равное временному промежутку, указанному в разделе "Настройки робота" в поле "TimeOutTime".	Число	1000	Да
Выходные параметры
Результат	Result	Переменная с типом "Логический", в которую будет сохранен результат проверки исчезновения объекта: "True", если объект был на экране и исчез в течении указанного времени. "False", если объект не был найден или не исчез с экрана в течении указанного времени. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Выпадающий список	Результат_исчезновения	Да

Особые условия использования

Отсутствуют.

Пример использования

Загрузить из файла / Load from file

Данное действие предназначено для загрузки изображения из директории.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Входные параметры
Путь к файлу	Path to file	Путь к файлу, содержимое которого будет использовано для распознавания (доступен ввод вручную, либо выбор папки в модальном окне "Открыть" по кнопке ). Если значение не указано, то в поле "Результат" будет записано пустое значение.	Строка	C:\Users\RLABUTIN\Desktop\ Действия в Studio.pdf.png	Да
Выходные параметры
Результат	Result	Переменная с типом "Общий", в которую будет сохранено содержимое файла. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Выпадающий список	Скриншот1	Да

Особые условия использования

Отсутствуют.

Пример использования

Задача:

Существует текстовая картинка.

Необходимо распознать текст из картинки.

Решение:

Загрузить из файла.
Прочитать текст.
Показать изображение.

Реализация:

Создаем переменную "ОбластьРаспознавания3" с типом "Общий", в которую будет сохранено содержимое PDF-файла.
Создаем ресурс с типом "Изображение".
Открываем группу действий "Машинное зрение".
Помещаем в рабочее пространство студии действие "Загрузить из файла".
Настройка действия:
1. Параметр "Путь к файлу". Указываем путь к картинке, содержимое которого будет использовано для распознавания
2. Параметр "Результат". Выбираем переменную "ОбластьРаспознавания4", в которую будет сохранено содержимое PDF-файла.
Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Переменная "РезультатРаспознавания3" содержит текст.

Загрузить PDF-страницу / Load from PDF

Данное действие предназначено для загрузки страницы PDF в виде изображения.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Входные параметры
Путь к файлу	Path to file	Путь к PDF-файлу, страница которого будет использована для распознавания (доступен ввод вручную, либо выбор папки в модальном окне "Открыть" по кнопке ). Если поле содержит файл, отличный от формата PDF, то в логах будет выведено сообщение: "File not in PDF format or corrupted."	Строка	C:\Users\RLABUTIN\Desktop\ Действия в Studio.pdf	Да
Качество	Quality	Выбор разрешения (числа точек на полученном изображении, которые умещаются в одном дюйме). Справочник содержит следующие значения: DPI_300; DPI_600; DPI_720; DPI_1200. По умолчанию значение равно "DPI_300".	Выпадающий список	DPI_600	Нет
Номер страницы	Page number	Номер, извлекаемой страницы. По умолчанию значение равно "0". Если поле содержит: строковые значения, то Система выведет сообщение: "Не найдены переменные: <Новое значение>". только символы, то Система выведет сообщение: "Используются некорректные символы". номер страницы, который Система не смогла распознать, то в логах будет выведено сообщение: "Индекс не должен быть за пределами диапазона. Индекс должен быть положительным числом, а его размер не должен превышать размер коллекции."	Число	23	Да
Выходные параметры
Результат	Result	Переменная с типом "Общий", в которую будет сохранено содержимое PDF-файла. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Выпадающий список	Скриншот2	Да

Особые условия использования

Отсутствуют.

Пример использования

Задача:

Существует PDF-документ "Действия в Studio.pdf".

Необходимо распознать текст на странице, в которой встречается слово "Базовые действия".

Решение:

Найти страницу в PDF.
Загрузить PDF-страницу.
Прочитать текст.
Показать изображение.

Реализация:

Создаем переменную "ОбластьРаспознавания2" с типом "Общий", в которую будет сохранено содержимое PDF-файла..
Открываем группу действий "Машинное зрение".
Помещаем в рабочее пространство студии действие "Найти страницу в PDF" (см. описание действия "Машинное зрение 2.0").
Помещаем в рабочее пространство студии действие "Загрузить PDF-страницу".
Настройка действия:
1. Параметр "Путь к файлу". Указываем путь к PDF-файлу "Действия в Studio.pdf", страница которого будет использована для распознавания.
2. Параметр "Номер страницы". Указываем переменную "СтраницаКлюч", значение которой получаем из действия "Машинное зрение 2.0".
3. Параметр "Результат". Выбираем переменную "ОбластьРаспознавания2", в которую будет сохранено содержимое PDF-файла.
Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Переменная "РезультатРаспознавания1" содержит текст на странице, в которой встречается слово "Базовые действия".

Загрузить из ресурса / Load from resource

Данное действие предназначено для загрузки изображения из ресурса.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Входные параметры
Ресурс	Resource	Ресурс с типом "Изображение", содержащий область распознавания. Если значение не указано, то Система выведет сообщение: "Не задан ресурс".	Выпадающий список	Ресурс	Да
Выходные параметры
Результат	Result	Переменная с типом "Объект", в которую будет сохранено содержимое ресурса. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Выпадающий список	Скриншот3	Да

Особые условия использования

Отсутствуют.

Пример использования

Задача:

Существует ресурс с типом "Изображение".

Необходимо распознать текст из ресурса.

Решение:

Загрузить из ресурса.
Прочитать текст.
Показать изображение.

Реализация:

Создаем переменную "ОбластьРаспознавания3" с типом "Общий", в которую будет сохранено содержимое PDF-файла.
Создаем ресурс с типом "Изображение".
Открываем группу действий "Машинное зрение".
Помещаем в рабочее пространство студии действие "Загрузить из ресурса".
Настройка действия:
1. Параметр "Ресурс". Указываем ресурс, содержащий область распознавания..
2. Параметр "Результат". Выбираем переменную "ОбластьРаспознавания3", в которую будет сохранено содержимое PDF-файла.
Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Переменная "РезультатРаспознавания3" содержит текст.

Существует на экране / Exists on screen action

Данное действие предназначено для проверки существования на экране указанной области.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Входные параметры
Изображение	Image	Переменная с типом "Общий",которая будет содержать область для распознавания. Если значение не указано, то Система выведет сообщение: "Не задана переменная".	Выпадающий список	Область_распознавания	Да
Степень сходства	Similarity rate	Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью. По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области. Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".".	Число	0.8	Да
Выходные параметры
Результат	Result	Переменная с типом "Логический", в которую будет сохранен результат проверки объекта на соответствие: "True", если объект существует на экране. "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-файлу, страница которого будет использована для распознавания (доступен ввод вручную, либо выбор папки в модальном окне "Открыть" по кнопке )	Строка	C:\Users\RLABUTIN\Desktop\ Действия в Studio.pdf	Да
Качество	Quality	Выбор разрешения (числа точек на полученном изображении, которые умещаются в одном дюйме). Справочник содержит следующие значения: DPI_300; DPI_600; DPI_720; DPI_1200. По умолчанию значение равно "DPI_300".	Выпадающий список	DPI_300	Да
Основной язык	Primary language	Язык, который распознаватель ожидает в тексте. По умолчанию значение равно "rus".	Строка	rus	Да
Текст	Text	Значение, которое должна быть на странице.	Строка	Загрузить	Да
Выходные параметры
Найти страницу в PDF	Find page in PDF	Переменная с типом "Число", которая будет содержать номер найденной страницы. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена". Если значение в поле "Путь к файлу" отсутствует, или содержит файл, отличный от формата PDF, то переменная содержит значение "-1".	Выпадающий список	Результат	Да

Особые условия использования

Отсутствуют.

Пример использования

Задача:

Существует PDF-документ "Действия в Studio.pdf".

Необходимо распознать текст на странице, в которой встречается слово "Базовые действия".

Решение:

Найти страницу в PDF.
Загрузить PDF-страницу.
Прочитать текст.
Показать изображение.

Реализация:

Создаем переменную "СтраницаКлюч" с типом "Число", которая будет содержать номер найденной страницы.
Открываем группу действий "Машинное зрение".
Помещаем в рабочее пространство студии действие "Найти страницу в PDF".
Настройка действия:
1. Параметр "Путь к файлу". Указываем путь к PDF-файлу "Действия в Studio.pdf", страница которого будет использована для распознавания.
2. Параметр "Текст". Указываем значение "Базовые действия", которое должна быть на странице.
3. Параметр "Найти страницу в PDF. Выбираем переменную "СтраницаКлюч", которая будет содержать номер найденной страницы.
Помещаем в рабочее пространство студии действие "Загрузить PDF-страницу" (см. описание действия "Загрузить PDF-страницу").
Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0").
Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Переменная "РезультатРаспознавания1" содержит текст на странице, в которой встречается слово "Базовые действия".

Дерево страниц

Машинное зрение 2.0

Прочитать текст / Read text action

Настройки

Особые условия использования

Пример использования

Снять область / Area screen action

Настройки

Особые условия использования

Пример использования

Показать изображение / Show image

Настройки

Особые условия использования

Пример использования

Найти на экране / Find on screen first action

Настройки

Особые условия использования

Пример использования

Ждать появления / Wait for action

Настройки

Особые условия использования

Пример использования

Ждать исчезновения / Wait for disappear action

Настройки

Особые условия использования

Пример использования

Загрузить из файла / Load from file

Настройки

Особые условия использования

Пример использования

Загрузить PDF-страницу / Load from PDF

Настройки

Особые условия использования

Пример использования

Загрузить из ресурса / Load from resource

Особые условия использования

Пример использования

Существует на экране / Exists on screen action

Настройки

Особые условия использования

Пример использования

Распознать по шаблону / Recognize by template action

Настройки

Особые условия использования

Пример использования

Найти страницу в PDF / Find page in PDF

Настройки

Особые условия использования

Пример использования