...

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

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

Пример использования в 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

...

Якорь
Снять область Снять область

Снять область / 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	Ширина, обозначенной области (отсчет идет слева направо от начальной координаты области)

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

Настройки

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

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

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

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

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

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

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

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

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

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

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Выделение области	Set an area	Robin.Collection	Нет	Координаты начала	Start coordinates	Robin.LocationPoint	{233;122}	Да	Координаты конца	Finish coordinates	. После использования кнопки "Выделение области"	параметра "Область" автозаполняется в соответствии с выделенной областью.	Robin.LocationPoint	{333;322}	Да
X	X	Положение начальной координаты (координата левого верхнего угла области для распознавания) определяется двумя координатами Х и Y. Начальная координата, обозначенной области, по горизонтали. После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: " "Не найдены переменные: <Новое значение>",	Число	233	Нет
Y	Y	Положение начальной координаты (координата левого верхнего угла области для распознавания) определяется двумя координатами Х и Y. Начальная координата, обозначенной области, по вертикали. После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: "Не найдены переменные: <Новое значение>".	Число	242	Нет
Высота	Heigth	Высота, обозначенной области (отсчет идет сверху вниз от начальной координаты области скриншота). После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: "Не найдены переменные: <Новое значение>".	Число	330	Нет
Ширина	Widht	Ширина, обозначенной области (отсчет идет слева направо от начальной координаты области). После использования кнопки "Выделение области" параметра "Область" автозаполняется в соответствии с выделенной областью. Если поле содержит строковые символы, то Система выведет сообщение: " "Не найдены переменные: <Новое значение>",	Число	528	Нет
Использовать DirectX	Use DirectX	По умолчанию признак не установлен.	Чек-бокс	Нет
Результаты
Результат	Result	Переменная, в которую будет сохранена выделенная область.	Robin.Image	Область_распознавания	Да

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

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

Пример использования в 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

...

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

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

Якорь
Показать изображение Показать изображение

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

...

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

Настройки

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

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

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

...

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

Настройки

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

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

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

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

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

...

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

Настройки

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

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

Пример использования в 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

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

Настройки

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

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

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

...

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

Настройки

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

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

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

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

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

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

Настройки

...

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

...

Robin.Image

...

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

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

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

...

Robin.Numeric

...

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

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

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

...

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

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

...

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

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

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

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

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

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

...

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

Настройки

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

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

Якорь
Загрузить PDF-страницу Загрузить PDF-страницу

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

...

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

Настройки

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

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

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

...

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

Настройки

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

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

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

...

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

Настройки

...

Robin.Collection

...

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

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

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

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

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

Настройки

...

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

...

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

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

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

...

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

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

...

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

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

...

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

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

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

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

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

Настройки

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

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

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

Задача:

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

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

Решение:

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

Реализация:

...

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

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

...

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

Настройки

...

...

...

1. Параметр "Путь к файлу". Указываем путь к картинке, содержимое которого будет использовано для распознавания
2. Параметр "Результат". Выбираем переменную "ОбластьРаспознавания4", в которую будет сохранено содержимое PDF-файла.
   Image Removed

...

Результат:

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

Image Removed

...

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

Настройки

...

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

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

...

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

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

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

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

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

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

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

Якорь
Найти страницу в PDF Найти страницу в PDF

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

...

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

Настройки

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

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

...

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

По умолчанию значение равно "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