...

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

Настройки

...

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

...

Robin.Image

...

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

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

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

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

• Russian - русский;
• English - английский;

...

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

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

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

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

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

...

Robin.String

...

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

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

...

Robin.String

...

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

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

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

Задача:

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

Image Removed

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

...

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

Настройки

...

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

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

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

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

• "Координаты начала";
• "Координаты конца";

...

Start coordinates

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

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

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

...

Robin.LocationPoint

...

Finish coordinates

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

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

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

...

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

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

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

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

...

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

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

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

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

...

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

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

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

...

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

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

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

...

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

...

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

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

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

Задача:

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

Image Removed

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

...

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

Настройки

...

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

...

Robin.Image

...

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

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

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

Задача:

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

Image Removed

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

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

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

Настройки

...

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

...

Robin.Image

...

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

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

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

...

Robin.Numeric

...

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

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

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

...

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

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

...

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

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

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

...

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

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

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

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

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

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

Настройки

...

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

...

Robin.Image

...

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

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

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

...

Robin.Numeric

...

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

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

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

...

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

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

...

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

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

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

...

Robin.Collection

...

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

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

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

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

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

Настройки

...

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

...

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

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

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

...

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

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

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

...

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

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

...

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

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

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

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

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

Настройки

...

...

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

...

Robin.Image

...

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

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

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

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

...

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

Настройки

...

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

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

...

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

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

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

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

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

...

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

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

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

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

...

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

...

Robin.Image

...

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

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

Пример использования в 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-файла.
      Image Removed
5. Помещаем в рабочее пространство студии действие "Прочитать текст" (см. описание действия "Машинное зрение 2.0"). 
6. Помещаем в рабочее пространство студии действие "Показать изображение" (см. описание действия "Машинное зрение 2.0").
7. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

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

Image Removed

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

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

Настройки

...

Свойство

...

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

...

Описание

...

Тип

...

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

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

...

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

...

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

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

...

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

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

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

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

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

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

Настройки

...

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

...

Robin.Image

...

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

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

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

...

Robin.Numeric

...

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

• "True", если объект существует.
• "False", если объект не существует или не был найден.

...

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

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

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

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

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

Настройки

...

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

...

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

Если поле содержит ресурс, который Система не смогла распознать, то в лог будет выведено сообщение: "resource was not found or source had incorrect type."

...

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

...

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

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

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

...

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

Настройки

...

...

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

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

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

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

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

...

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

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

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

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

• Russian - русский;
• English - английский;

...

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

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

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

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

...

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

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

...

Robin.Collection

...

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

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

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

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed