Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

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

Настройки

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

Переменная

с типом "Общий"

, которая будет

содержать область Выпадающий список

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

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

Robin.Image

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

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

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

.Строкаrus

.


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

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

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

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

Справочник



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

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

Char - символ;

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

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

Char

Page".

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

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

Robin.String

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

Переменная

с типом "Строка"

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


Если

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

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

Robin.String

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

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

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

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

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

Задача:

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

...

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

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

...

 Area screen

...

 

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

Настройки

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

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



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

Area

При нажатии

на кнопку "Выбрать область" Система свернуть

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

После завершения

выбора области пользователем

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

  • "
X
  • Координаты начала";
  • "
Y
  • Координаты конца";
  • "Высота";
  • "Ширина".
  • КнопкаДаXX
    Robin.Collection
    Нет
    Координаты начала
    Start coordinates

    Координаты

    Положение начальной координаты (координата

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

    )определяется После

    .


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

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

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

    параметра "Область"

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

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

    Число

    233НетYY

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

    Robin.LocationPoint

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

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


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

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

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

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

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

    вертикали

    горизонтали.

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

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

    .

    ,

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

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

    Y

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

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

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

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

    Число
    330
    242Нет
    Ширина
    Высота
    Widht
    Heigth
    Ширина

    Высота, обозначенной области (отсчет идет

    слева направо

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

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

    Если поле содержит строковые символы, то Система выведет сообщение: "

    "

    Не найдены переменные: <Новое значение>"

    ,

    .

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

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

    Widht

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

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

    Если поле содержит строковые символы

    Если значение не указано

    , то Система выведет сообщение: "

    Такая переменная не найдена".Выпадающий список

    "Не найдены переменные: <Новое значение>",

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

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

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

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

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

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

    Задача:

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

    ...

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

    Настройки

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

    Переменная

    c типом "Общий"

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

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

    Robin.Image

    Область

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

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

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

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

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

    Задача:

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

    ...

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

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

    ...

    ...

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

    ...

    с типом "Общий" будет содержать область

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

    с типом "Общий" найденного объекта значение не указано, то Система выведет сообщение: "Такая переменная не найдена".
    СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
    Параметры
    ИзображениеImage

    Переменная

    , которая

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

    Robin.Image

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

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

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

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

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

    ЧислоRobin.Numeric

    0.75ДаВозвращать центрGive center

    Если чек-бокс:

    • установлен, то возвращает координаты центра изображения, найденного на экране.
    • не установлен, то возвращает координаты верхнего левого угла изображения, найденного на экране.
    Чек-боксНет
    Тайм-аутTime-out

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

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

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

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

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

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

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

    Переменная

    , которая будет содержать координаты

    всех найденных объектов.



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

    Если

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

    Robin.CollectionКоординатыВыпадающий списокКоординаты1Да

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

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

    ...

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

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

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

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

    Настройки

    Входные параметры с типом "Общий" будет содержать область

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

    ОбластьЧисло (ms) длится ожидание появления "-1", равное Число

    Если чек-бокс:

    установлен, то возвращает координаты центра изображения, найденного не установлен, то возвращает , найденного на экранеЧек-боксВыходные параметры с типом "Общий" опознанного объекта.Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена" переменной присваивается значение {X=-10000,Y=-10000}.Координаты2
    СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
    Параметры
    Изображение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

    ...

    с типом "Общий" будет содержать область

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

    (ms) длится ожидание исчезновения "-1", равное с типом "Логический": не был найден или

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

    СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
    Входные параметрыПараметры
    Изображение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

    ...

    (доступен ввод вручную, либо выбор папки в модальном окне "Открыть" по кнопке Image Removed).

    Если значение не указано, то в поле "Результат" будет записано пустое значение.

    Строка с типом "Общий"

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

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

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

    .

    Robin.FilepathC:\Users\RLABUTIN\Desktop\ Действия в Studio.pdf.pngДа
    Выходные параметрыРезультаты
    РезультатResult

    Переменная

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

    Robin.Image

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

    Скриншот1Да

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

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

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

    Задача:

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

    ...

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

    Настройки

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

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

    (доступен ввод вручную, либо выбор папки в модальном окне "Открыть" по кнопке Image Removed).


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

    файл

    путь к файлу,

    отличный

    отличному от формата 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

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

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

    0

    1".



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

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

    Переменная

    с типом "Общий"Выпадающий список

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

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

    Robin.Image

    Скриншот2Да

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

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

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

    Задача:

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

    ...

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

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

    ...

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

    Настройки

    Свойство

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

    Описание

    Тип

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

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

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

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

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

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

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

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

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

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

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

    Задача:

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

    ...

    с типом "Общий" будет содержать область

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

    с типом "Логический" объекта на соответствие: на экране или не исчез с экрана в течении указанного времени.

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

    СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
    Входные параметрыПараметры
    Изображение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
    Найти страницу в PDF
    Найти страницу в PDF / Find page in PDF

    ...

    (доступен ввод вручную, либо выбор папки в модальном окне "Открыть" по кнопке Image Removed)Выбор разрешения (числа точек на полученном изображении, которые умещаются в одном дюйме)
    • DPI_300;
    • DPI_600;
    • DPI_720;
    • DPI_1200.

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

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

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

    СтрокаC:\Users\RLABUTIN\Desktop\ Действия в Studio.pdfДаКачествоQuality

    .

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

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


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

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

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

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

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

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

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


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

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

    Выпадающий списокDPI_300Да
    Основной языкPrimary language

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

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

    СтрокаrusДа
    ТекстTextЗначение, которое должна быть на странице.СтрокаЗагрузитьДа
    Выходные параметры
    • Russian - русский;
    • English - английский;
    Robin.CollectionrusНет
    ТекстText

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



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

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

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

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

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


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

    Robin.Collection

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

    Переменная с типом "Число", которая будет содержать номер найденной страницы.

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

    Если значение в поле "Путь к файлу" отсутствует, или содержит файл, отличный от формата PDF, то переменная содержит значение "-1".

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

    РезультатДа

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

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

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

    Задача:

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

    ...