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

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

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
ИзображениеImage

Переменная, которая будет содержит изображение для распознавания.

Robin.Image

Область_распознаванияДа
Основной языкPrimary language

Язык, который распознаватель ожидает в тексте.

По умолчанию значение равно "rus".

Пользователь имеет возможность выбрать один или несколько языков в прилагающейся тулзе.

Справочник содержит следующие значения:

  • Russian - русский;
  • English - английский;
Robin.CollectionRussianНет
Формат контентаSegmentation mode

Ожидаемый формат контента (увеличивает вероятность правильно прочесть текст).


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

Справочник содержит следующие значения:

  • Line - строка;
  • Block - блок;
  • Page - страница.

По умолчанию значение равно "Page".

Robin.String

PageНет
Результаты
РезультатResult

Переменная, в которую будет сохранен распознанный текст.

Если изображение не содержит текст или его невозможно прочитать, будет сохранено пустое значение.

Robin.String

Результат_распознавания_текстаДа

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

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

Пример использования в 1-й студии

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

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

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

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
Выделение областиSet an area

Выделение области вручную.


Реализовано кнопкой.

При нажатии Система свернет ROBIN Studio и предоставит пользователю возможность самостоятельно выделить область экрана, которую требуется распознать.

После завершения выделения Система автоматически заполнит следующие поля данными выбранной области для распознавания:

  • "Координаты начала";
  • "Координаты конца";
Robin.Collection
Нет
Координаты начала
Start coordinates

Координаты левого верхнего угла области для распознавания.

Определяется двумя координатами Х и Y.

После использования кнопки "Выделение области" параметр автозаполняется в соответствии с выделенной областью.

Robin.LocationPoint

(вопрос){233;122}Да
Координаты конца
Finish coordinates

Координаты правого нижнего угла области для распознавания.

Определяется двумя координатами Х и Y.

После использования кнопки "Выделение области" параметр автозаполняется в соответствии с выделенной областью.

Robin.LocationPoint
(вопрос){333;322}Да
XX

Положение начальной координаты (координата левого верхнего угла области для распознавания) определяется двумя координатами Х и Y.

Начальная координата, обозначенной области, по горизонтали.

После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью.

Если поле содержит строковые символы, то Система выведет сообщение: " "Не найдены переменные: <Новое значение>",

Число233Нет
YY

Положение начальной координаты (координата левого верхнего угла области для распознавания) определяется двумя координатами Х и Y.

Начальная координата, обозначенной области, по вертикали.

После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью.

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

Число242Нет
ВысотаHeigth

Высота, обозначенной области (отсчет идет сверху вниз от начальной координаты области скриншота).

После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью.

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

Число330Нет
ШиринаWidht

Ширина, обозначенной области (отсчет идет слева направо от начальной координаты области).

После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью.

Если поле содержит строковые символы, то Система выведет сообщение: " "Не найдены переменные: <Новое значение>",

Число528Нет
Использовать DirectXUse DirectXПо умолчанию признак не установлен.Чек-бокс
Нет
Результаты
РезультатResult

Переменная, в которую будет сохранена выделенная область.

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

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

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

Пример использования в 1-й студии

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

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

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

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
ИзображениеImage

Переменная, которая содержит изображение.

Robin.Image

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

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

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

Пример использования в 1-й студии

Задача:

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

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

Решение:

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

Реализация:

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

  6. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

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

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

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

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
ИзображениеImage

Переменная, которая содержит изображение для распознавания.

Robin.Image

Область_распознаванияДа
Степень сходстваSimilarity rate

Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью.

По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области.

Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".".

Robin.Numeric

0.75Да
Тайм-аутTime-out

Время, в течении которого будет ожидаться появление заданного объекта.

Задается в мс.

Значение по умолчанию равно временному промежутку, указанному в разделе "Настройки робота" в поле "TimeOutTime".

Robin.Numeric1000Да
Возвращать центрGive center

Возвращает координаты центров изображений, найденных на экране.

По умолчанию возвращаются координаты верхнего левого угла изображения.

Robin.BooleanTrueНет
Результаты
КоординатыCoordinates

Переменная, которая будет содержать координаты всех найденных объектов.


Порядок заполнения коллекции результатов: первым идет объект, найденный ближе всех к верхнему левому углу области поиска.

Если объект не появился за указанный промежуток времени, то будет выведена ошибка "Изображение не найдено".

Robin.CollectionКоординатыДа

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

Для данного действия необходимо устанавливать задержку не менее 1000 (мc).

После введения параметра ожидания данное действие функционально дублируется действием "Ждать появления".

Поэтому последнее можно считать не нужным.

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

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

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
ИзображениеImage

Переменная, которая содержит изображение для распознавания.

Robin.Image

Область_распознаванияДа
Степень сходстваSimilarity rate

Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью.

По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области.

Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".".

Robin.Numeric

1Да
Тайм-аутTime-out

Время, в течении которого будет ожидаться появление заданного объекта.

Задается в мс.

Значение по умолчанию равно временному промежутку, указанному в разделе "Настройки робота" в поле "TimeOutTime".

Robin.Numeric1000Да
Возвращать центрGive center

Действие будет возвращать координаты центров изображений, найденных на экране.

По умолчанию возвращаются координаты верхнего левого угла изображения.

Robin.Boolean
Нет
Результаты
КоординатыCoordinates

Переменная, которая будет содержать координаты всех найденных объектов.

Порядок заполнения коллекции результатов: первым идет объект, найденный ближе всех к верхнему левому углу области поиска.

Если объект не появился за указанный промежуток времени, то будет выведена ошибка "Изображение не найдено".

Robin.Collection

Координаты_2Да

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

Данное действие функционально дублирует действие "Найти на экране", потому его можно удалить.

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


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

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

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
ИзображениеImage

Переменная, которая содержит изображение для распознавания.

Robin.ImageОбласть_распознаванияДа
Степень сходстваSimilarity rate

Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью.

По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области.

Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".".

Robin.Numeric0.8Да
Тайм-аутTime-out

Время, в течении которого будет ожидаться исчезновение заданного объекта.

Задается в мс.

Значение по умолчанию равно временному промежутку, указанному в разделе "Настройки робота" в поле "TimeOutTime".

Robin.Numeric1000Нет
Результаты
РезультатResult

Переменная, в которую будет сохранен результат проверки исчезновения объекта.

  • "True", если объект был на экране и исчез в течении указанного времени или не был найден.
  • "False", если объект не исчез с экрана в течении указанного времени.
Robin.BooleantrueДа

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

Если результат "true", а объект на экране присутствует, значит есть необходимость уточнить степень сходства с изображением для поиска.

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


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

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

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
Путь к файлуPath to file

Путь к файлу, содержимое которого будет использовано для распознавания.

Robin.FilepathC:\Users\RLABUTIN\Desktop\ Действия в Studio.pdf.pngДа
Результаты
РезультатResult

Переменная, в которую будет сохранено содержимое файла.

Robin.Image

Скриншот1Да

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

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

Пример использования в 1-й студии.

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

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

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

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
Путь к файлуPath to file

Путь к PDF-файлу, страница которого будет использована для распознавания

Если поле содержит путь к файлу, отличному от формата PDF, то в логах будет выведено сообщение: "File not in PDF format or corrupted."

Robin.FilepathC:\Users\RLABUTIN\Desktop\ Действия в Studio.pdfДа
КачествоQuality

Выбор разрешения (числа точек на полученном изображении, которые умещаются в одном дюйме).

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

Справочник содержит следующие значения:

  • DPI_300;
  • DPI_600;
  • DPI_720;
  • DPI_1200.

По умолчанию значение равно "DPI_300".

Robin.StringDPI_600Нет
Номер страницыPage number

Номер, извлекаемой страницы.

По умолчанию значение равно "1".


Если поле содержит:

  • строковые значения, то Система выведет сообщение: "Не найдены переменные: <Новое значение>".
  • только символы, то Система выведет сообщение: "Используются некорректные символы".
  • номер страницы, который Система не смогла распознать, то в логах будет выведено сообщение: "Индекс не должен быть за пределами диапазона. Индекс должен быть положительным числом, а его размер не должен превышать размер коллекции."
Robin.Numeric23Нет
Результаты
РезультатResult

Переменная, в которую будет сохранено содержимое PDF-файла.

Robin.Image

Скриншот2Да

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

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

Пример использования в 1-й студии.

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

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

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

Настройки

Свойство

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

Описание

Тип

Пример заполненияОбязательность заполнения поля
Входные параметры
РесурсResource

Ресурс с типом "Изображение", содержащий область распознавания.

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

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

РесурсДа
Выходные параметры
РезультатResult

Переменная с типом "Объект", в которую будет сохранено содержимое ресурса.

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

Выпадающий списокСкриншот3Да

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

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

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

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

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

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

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
ИзображениеImage

Переменная, которая содержит изображение для распознавания.

Robin.Image

Рисунок_распознаванияДа
Степень сходстваSimilarity rate

Коэффициент сходства. Устанавливается степень сходства между изображением и искомой областью.

По умолчанию значение равно "0.75". Максимальное значение равно "1" (Чем больше число, тем точнее должно быть сходство изображения и искомой области.

Значение степени сходства необходимо устанавливать как десятичную дробь, после 0 должна быть точка ".".

Robin.Numeric

0.8Да
Результаты
РезультатResult

Переменная, в которую будет сохранен результат проверки.

  • "True", если объект существует.
  • "False", если объект не существует или не был найден.
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.FilepathC:\Users\RLABUTIN\Desktop\ Действия в Studio.pdfДа
КачествоQuality

Выбор разрешения (числа точек на полученном изображении, которые умещаются в одном дюйме).

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

Справочник содержит следующие значения:

  • DPI_300;
  • DPI_600;
  • DPI_720;
  • DPI_1200.

По умолчанию значение равно "DPI_300".

Robin.StringDPI_300Нет
Основной языкPrimary language

Язык, который распознаватель ожидает в тексте.

По умолчанию значение равно "rus".

Пользователь имеет возможность выбрать один или несколько языков в прилагающейся тулзе.

Справочник содержит следующие значения:

  • Russian - русский;
  • English - английский;
Robin.CollectionrusНет
ТекстText

Текст, который должна содержать страница.


Язык распознается автоматически по введенному тексту.

Если введенная строка не содержит символьных элементов, а только специальные, то поиск идет по ним.

Язык, в таком случае, при необходимости, определяется по умолчанию, как локальный.

Robin.StringЗагрузитьДа
Результаты
Номер страницыPage number

Переменная, которая будет содержать номера всех найденных страниц.

Если страница не будет найдена вывести ошибку: "Не найдена страница, содержащая заданный текст."

Robin.Collection

РезультатДа

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

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

Пример использования в 1-й студии.

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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