История страницы
...
Группа действий: Машинное зрение
Описание
...
Данное действие предназначено для ожидания появления объекта, соответствующего указанному шаблону, и получения его координат. В случае совпадения переданного изображения с изображением(ями) на экране, возвращаются возращаются координаты всех найденных совпадений.
Иконка
Параметры
Входные параметры
- Изображение Путь к изображению для распознавания. Допустимые расширения: ".jpeg", ".jpg", ".bmp", ".png", ".tif", ".tiff".
Если алгоритм не нашел расширение файла или тип файла неприменим, будет выведено предупреждение.
- Степень сходства Требуемый коэффициент сходства между указанным изображением и искомой областью. Максимальное значение равно "1".
- Тайм-аут Время, в течение которого будет ожидаться появление заданного объекта. Задается в мс.
- Возвращать центр Действие будет возвращать координаты центров изображений, найденных на экране. По умолчанию возвращаются координаты верхнего левого угла изображения.
- Интервал снятия скриншота Интервал снятия снимка экрана для сравнения с указанным изображением. Измеряется в секундах. Допустимые значения: целые числа от 1 и более. Минимум 1 секунда. По умолчанию 1 секунда.
- Алгоритм сравнения Алгоритм для сравнения указанного изображения с изображением на экране. Если некорректно работает один алгоритм, следует попробовать другой. Для разных кейсов более корректно будут работать разные алгоритмы сравнения изображения. Применяются следующие алгоритмы сравнения изображения (TemplateMatchModes):
- TM_SQDIFF - Сумма квадратов разницы цветов.
- TM_CCORR - Сумма поэлементных произведений.
- TM_CCOEFF - Кросс-корреляция между изображениями без среднего (корреляция Пирсона).
- Прямое соответствие - Соответствие пикселей с указанным изображением.
Параметр задается в виде выпадающего списка. Режимы сопоставления шаблонов TemplateMatchModes. Значение по умолчанию - TM_CCOEFF.
Элементы выпадающего списка:
- TM_SQDIFF
- TM_CCORR
- TM_CCOEFF
- Прямое соответствие
- Сделать изображение черно-белым Если значение "true", то цвет изображения будет изменен на оттенки серого.
- Искать ребра изображения Если значение "true", то будет выполнен поиск ребер объектов на изображении. Ребра - это границы, которые обрисовывают объект изображения.
- Мин. граница поиска ребер Минимальный размер ребер объектов изображения. Вместе со значением из поля «Макс. граница поиска ребер» составляет диапазон возможных размеров ребер. Учитывается, только если параметр "Искать ребра изображения" - true. Параметр "Минимальная граница поиска ребер" должен быть целым числом от 0 до 255. Значение параметра "Мин. граница поиска ребер" не должно превышать значение параметра "Макс. граница поиска ребер". Допустимое значение: от 0 до 255. По умолчанию: 150.
- Макс. граница поиска ребер Максимальный размер ребер объектов изображения. Вместе со значением из поля «Мин. граница поиска ребер» составляет диапазон возможных размеров ребер. Учитывается, только если параметр "Искать ребра изображения" - true. Параметр "Максимальная граница поиска ребер" должен быть целым числом от 0 до 255. Допустимое значение: от 0 до 255. По умолчанию: 200.
- Мин. изменение размера изображения Минимальный коэффициент изменения масштаба указанного изображения. Параметр используется, если размер изображение на экране может отличаться от размера указанного изображения. Параметр "Минимальное изменение размера изображения" должен быть вещественным положительным числом. Рекомендуемое значение: от 0.5. По умолчанию: 1.
- Макс. изменение размера изображения Максимальный коэффициент изменения указанного изображения. Параметр "Максимальное изменение размера изображения" должен быть вещественным положительным числом.
Выходные параметры
- Координаты Переменная, которая будет содержать координаты всех найденных объектов. Порядок заполнения коллекции результатов: первым идет объект, найденный ближе всех к верхнему левому углу области поиска. Если объект не появился за указанный промежуток времени, то будет выведена ошибка "Изображение не найдено".
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Изображение | Image | Путь к изображению для распознавания. Допустимые расширения: ".jpeg", ".jpg", ".bmp", ".png", ".tif", ".tiff" Если алгоритм не нашел расширение файла или тип файла неприменим, будет выведено предупреждение. | Изображение | Область_распознавания | Да |
Степень сходства | Similarity rate |
Необходимый коэффициент сходства между |
изображением и искомой областью. Максимальное значение равно "1" . | Число | 1 | Да | ||
Тайм-аут | Time-out | Время, в течении которого будет ожидаться появление заданного объекта. Задается в мс. | Число | 1000 | Да |
Возвращать центр | Give center | Действие будет возвращать координаты центров изображений, найденных на экране. По умолчанию возвращаются координаты верхнего левого угла изображения. | Логический |
true
Нет
Интервал снятия скриншота
Interval of taking screenshots
Интервал снятия снимка экрана для сравнения с указанным изображением. Измеряется в секундах. Допустимые значения: целые числа от 1 и более.
Минимум 1 секунда. По умолчанию 1 секунда.
Число
Нет
Алгоритм сравнения
Comparison algorithm
Алгоритм для сравнения указанного изображения с изображением на экране. Если некорректно работает один алгоритм, следует попробовать другой. По умолчанию "TM_CCOEFF".
Режимы сопоставления шаблонов TemplateMatchModes.
Значение по умолчанию - TM_CCOEFF.
Строка
Выпадающий список. Элементы списка:
•TM_SQDIFF
•TM_CCORR
•TM_CCOEFF
•Прямое соответствие
Нет
Сделать изображение черно-белым
Make the image black and white
Если значение "true", то цвет изображения будет изменен на оттенки серого.
Логический
Нет
Искать ребра изображения
Search for image edges
Если значение "true", то будет выполнен поиск ребер объектов на изображении. Ребра - это границы, которые обрисовывают объект изображения.
Логический
Нет
Мин. граница поиска ребер
Min edge search boundary
Минимальный размер ребер объектов изображения. Вместе со значением из поля «Макс. граница поиска ребер» составляет диапазон возможных размеров ребер.
Учитывается, только если параметр "Искать ребра изображения" - true. Допустимое значение: от 0 до 255. По умолчанию: 150.
Число
Нет
Макс. граница поиска ребер
true |
Число
Нет
Мин. изменение размера изображения
Min image size change
Минимальный коэффициент изменения масштаба указанного изображения. Параметр используется, если размер изображение на экране может отличаться от размера указанного изображения. Рекомендуемое значение: от 0.5. По умолчанию: 1.
Нет |
Макс. изменение размера изображения
Mах image size change
Результаты | |||||
---|---|---|---|---|---|
Координаты | Coordinates | Переменная, которая будет содержать координаты всех найденных объектов. Порядок заполнения коллекции результатов: первым идет объект, найденный ближе всех к верхнему левому углу области поиска. Если объект не появился за указанный промежуток времени, то будет выведена ошибка "Изображение не найдено". | Коллекция | Координаты_2 | Да |
...
Особые условия использования
Разрешение изображения для поиска и разрешение экрана должно совпадать для корректности отработки действия. Для этого рекомендуется делать скриншот изображения.
Наиболее эффективно применение файлов с расширением ".png
...
"
...
Пример использования
Задача: вернуть координаты найденных изображений на экране, соответствующих указанному изображению.
...