Узлы: числа, текст, точки и время
Обновлено
Вспомогательные узлы преобразуют данные для условий и действий. Время, текстовое извлечение и именованные таймеры также находятся здесь.
Как пользоваться
- Тип числа важен: счётчик и индекс обычно целые, пороги и расстояния могут быть дробными. Проверяйте деление на ноль и границы диапазона.
- Text Extract поддерживает выбор нужного фрагмента текста. OCR Text To Number преобразует запись числа, в том числе с K/M, по своим правилам.
- Start Timer не сбрасывает существующий именованный отсчёт. Check Timer только читает его; Control Timer перезапускает, ставит на паузу, продолжает или удаляет.
- Параметры имени, области и ключа у трёх узлов должны совпадать. Подробный пример есть в главе «Именованные таймеры».
В раскрываемых деталях перечислены входы и результаты. Некоторые поля появляются только в соответствующем режиме инспектора.
Проверить число
Сравнивает входное число с образцом из инспектора по выбранному правилу. Возвращает результат: истина или ложь.
Входы, выходы и идентификатор
util.number
Входы: Значение — число; Оператор — текст; Цель — число
Результаты: Результат — да/нет
Продолжения: Выход
Целое число
Возвращает постоянное целое число, заданное в инспекторе.
Входы, выходы и идентификатор
util.integer
Входы: Значение — целое число
Результаты: Выход — целое число
Продолжения: Выход
Логическое значение
Возвращает постоянное значение: истина или ложь. Подключите к входу условия или флага.
Входы, выходы и идентификатор
util.boolean
Входы: Значение — да/нет
Результаты: Выход — да/нет
Продолжения: Выход
Текст
Возвращает постоянную строку, заданную в инспекторе. Подходит для сообщений, имён и текстовых образцов.
Входы, выходы и идентификатор
util.text
Входы: Значение — текст
Результаты: Выход — текст
Продолжения: Выход
Сложить числа
Складывает два числа и возвращает сумму.
Входы, выходы и идентификатор
math.add
Входы: A — число; B — число
Результаты: Результат — число
Продолжения: Выход
Вычесть числа
Вычитает второе число из первого и возвращает разность.
Входы, выходы и идентификатор
math.subtract
Входы: A — число; B — число
Результаты: Результат — число
Продолжения: Выход
Умножить числа
Умножает два числа и возвращает произведение.
Входы, выходы и идентификатор
math.multiply
Входы: A — число; B — число
Результаты: Результат — число
Продолжения: Выход
Разделить числа
Делит первое число на второе. При делении на ноль возвращает 0.
Входы, выходы и идентификатор
math.divide
Входы: A — число; B — число
Результаты: Результат — число
Продолжения: Выход
Ограничить число
Оставляет число в пределах заданного минимума и максимума. Значения за пределами заменяются ближайшей границей.
Входы, выходы и идентификатор
math.clamp
Входы: Значение — число; Мин — число; Макс — число
Результаты: Результат — число
Продолжения: Выход
Меньшее из двух чисел
Возвращает меньшее из двух переданных чисел.
Входы, выходы и идентификатор
math.min
Входы: A — число; B — число
Результаты: Результат — число
Продолжения: Выход
Большее из двух чисел
Возвращает большее из двух переданных чисел.
Входы, выходы и идентификатор
math.max
Входы: A — число; B — число
Результаты: Результат — число
Продолжения: Выход
Модуль числа
Возвращает величину числа без знака. Например, для −5 результат равен 5.
Входы, выходы и идентификатор
math.abs
Входы: Значение — число
Результаты: Результат — число
Продолжения: Выход
Остаток от деления
Возвращает остаток от деления первого числа на второе. Если второе число равно нулю, возвращает 0.
Входы, выходы и идентификатор
math.modulo
Входы: A — число; B — число
Результаты: Результат — число
Продолжения: Выход
Случайное дробное число
Выбирает случайное дробное число в заданном диапазоне от минимума до максимума.
Входы, выходы и идентификатор
math.random_float
Входы: Мин — число; Макс — число
Результаты: Результат — число
Продолжения: Выход
Случайное целое число
Выбирает случайное целое число между минимумом и максимумом, включая границы.
Входы, выходы и идентификатор
math.random_int
Входы: Мин — целое число; Макс — целое число
Результаты: Результат — целое число
Продолжения: Выход
Минимум из списка чисел
Выбирает наименьшее из подключённых чисел. Возвращает значение и номер входа, начиная с 1; затем продолжает выполнение.
Входы, выходы и идентификатор
math.min_list
Входы: A — число; B — число
Результаты: Значение — число; Индекс — число
Продолжения: Выход
Максимум из списка чисел
Выбирает наибольшее из подключённых чисел. Возвращает значение и номер входа, начиная с 1; затем продолжает выполнение.
Входы, выходы и идентификатор
math.max_list
Входы: A — число; B — число
Результаты: Значение — число; Индекс — число
Продолжения: Выход
Все условия выполнены
Возвращает истину, только если все подключённые логические значения истинны.
Входы, выходы и идентификатор
bool.and
Входы: A — да/нет; B — да/нет
Результаты: Истина — да/нет; Ложь — да/нет
Продолжения: Выход
Хотя бы одно условие
Возвращает истину, если хотя бы одно подключённое логическое значение истинно.
Входы, выходы и идентификатор
bool.or
Входы: A — да/нет; B — да/нет
Результаты: Истина — да/нет; Ложь — да/нет
Продолжения: Выход
Инвертировать условие
Меняет логическое значение на противоположное: истину на ложь, а ложь на истину.
Входы, выходы и идентификатор
bool.not
Входы: Значение — да/нет
Результаты: Результат — да/нет
Продолжения: Выход
Соединить текст
Объединяет две строки в одну, сохраняя их порядок.
Входы, выходы и идентификатор
string.concat
Входы: A — текст; B — текст
Результаты: Результат — текст
Продолжения: Выход
Текст содержит фразу
Проверяет, входит ли заданная фраза в исходный текст.
Входы, выходы и идентификатор
string.contains
Входы: Текст — текст; Поиск — текст
Результаты: Результат — да/нет
Продолжения: Выход
Текст совпадает
Проверяет, равны ли две переданные строки.
Входы, выходы и идентификатор
string.equals
Входы: A — текст; B — текст
Результаты: Результат — да/нет
Продолжения: Выход
Сравнить текст с погрешностью
Сравнивает текст с образцом, допуская ошибки распознавания и опечатки. Несколько образцов можно перечислить через запятую.
Входы, выходы и идентификатор
text.fuzzy_match
Входы: Текст — текст; Цель — текст; Algorithm — текст; Порог — число; Case Sensitive — да/нет; Trim — да/нет
Результаты: Найдено — да/нет; Score — число; Дистанция — целое число
Продолжения: Выход
OCR: сравнить число
Сравнивает число из распознанного текста с образцом. Учитывает сокращения K/M/B/T: например, 16.7M означает 16 700 000.
Входы, выходы и идентификатор
text.ocr_number_match
Входы: Текст — текст; Оператор — текст; Цель — целое число
Результаты: Совпадение — да/нет; Распознано — да/нет; Число — целое число; Цель — целое число
Продолжения: Выход
Точка из X и Y
Создаёт координаты точки из отдельных значений X и Y.
Входы, выходы и идентификатор
vec2.make
Входы: X — число; Y — число
Результаты: Результат — точка (X, Y)
Продолжения: Выход
Сложить координаты
Складывает две пары координат по X и Y. Удобно для смещения точки.
Входы, выходы и идентификатор
vec2.add
Входы: A — точка (X, Y); B — точка (X, Y)
Результаты: Результат — точка (X, Y)
Продолжения: Выход
Вычесть координаты
Вычитает координаты второй точки из первой по X и Y.
Входы, выходы и идентификатор
vec2.subtract
Входы: A — точка (X, Y); B — точка (X, Y)
Результаты: Результат — точка (X, Y)
Продолжения: Выход
Расстояние между точками
Вычисляет расстояние по прямой между двумя точками.
Входы, выходы и идентификатор
vec2.distance
Входы: A — точка (X, Y); B — точка (X, Y)
Результаты: Результат — число
Продолжения: Выход
Точки достаточно близко
Проверяет, меньше ли расстояние между точками заданного предела.
Входы, выходы и идентификатор
vec2.distance_less
Входы: A — точка (X, Y); B — точка (X, Y); Макс. дистанция — число
Результаты: Результат — да/нет; Дистанция — число
Продолжения: Выход
Случайная позиция
Выбирает случайную точку рядом с заданной позицией, вне неё или внутри прямоугольной области объекта. Режим задаётся в инспекторе.
Входы, выходы и идентификатор
vec2.random_pos
Входы: Позиция — точка (X, Y); Внутри — да/нет; Outside — да/нет; All Inner Area — да/нет; Inside Radius — число; Outside Min Radius — число; Outside Max Radius — число; Inner Area Size — точка (X, Y)
Результаты: Позиция — точка (X, Y)
Продолжения: Выход
Случайная точка в области
Выбирает случайную точку внутри прямоугольника с заданными центром, шириной и высотой.
Входы, выходы и идентификатор
vec2.random_in_rect
Входы: Center — точка (X, Y); Размер — точка (X, Y); Inset — число
Результаты: Результат — точка (X, Y)
Продолжения: Выход
Число в диапазоне
Проверяет, находится ли число между заданными минимумом и максимумом.
Входы, выходы и идентификатор
number.in_range
Входы: Значение — число; Мин — число; Макс — число
Результаты: Результат — да/нет
Продолжения: Выход
Проверить текст по правилу
Проверяет текст по выбранному правилу: содержит, совпадает, начинается или заканчивается заданной фразой.
Входы, выходы и идентификатор
string.match
Входы: Текст — текст; Поиск — текст; Режим — текст
Результаты: Результат — да/нет
Продолжения: Выход
Извлечь текст
Выделяет нужный фрагмент текста: до, после или между фразами, по словам, символам, строке или регулярному выражению. Режим выбирается в инспекторе.
Входы, выходы и идентификатор
string.extract
Входы: Текст — текст; Режим — текст; Фраза — текст; Конечная фраза — текст; Начало — целое число; Кол-во — целое число; Строка — целое число; Шаблон Regex — текст; Группа — целое число; Case Sensitive — да/нет; Trim — да/нет
Результаты: Текст — текст; Найдено — да/нет
Продолжения: Выход
OCR: текст в число
Извлекает первое число из текста, учитывая шум OCR и сокращения K/M/B/T. Например, 472.9K превращается в 472 900. Возвращает число и признак успешного чтения.
Входы, выходы и идентификатор
string.to_number
Входы: Текст — текст
Результаты: Число — число; Найдено — да/нет
Продолжения: Выход
Значение из JSON
Читает значение из JSON по пути через точки. Например, data.items.0.name выбирает имя первого элемента списка.
Входы, выходы и идентификатор
json.get
Входы: JSON — текст; JSON Path — текст
Результаты: Значение — текст; Число — число; Найдено — да/нет
Продолжения: Выход
Запустить таймер
Запускает именованный таймер без ожидания. Существующий таймер не сбрасывается.
Входы, выходы и идентификатор
time.named_start
Входы: Имя — текст; Scope — текст; Клавиша — текст; Длительность, сек — число
Результаты: Started — да/нет
Продолжения: Выход
Проверить таймер
Проверяет состояние и оставшееся время. Не запускает и не сбрасывает таймер.
Входы, выходы и идентификатор
time.named_check
Входы: Имя — текст; Scope — текст; Клавиша — текст
Результаты: Существует — да/нет; Запущено — да/нет; Paused — да/нет; Finished — да/нет; State — текст; Remaining — число; Elapsed Seconds — число; Длительность, сек — число
Продолжения: Выход
Управление таймером
Перезапускает, приостанавливает, продолжает или удаляет именованный таймер.
Входы, выходы и идентификатор
time.named_control
Входы: Имя — текст; Scope — текст; Клавиша — текст; Действие — текст
Результаты: Успех — да/нет
Продолжения: Выход
Время с запуска
Возвращает число секунд с начала выполнения сценария.
Входы, выходы и идентификатор
time.now
Результаты: Секунды — число
Продолжения: Выход
Прошедшее время
Показывает, сколько секунд прошло с первого выполнения этого узла.
Входы, выходы и идентификатор
time.elapsed
Входы: Длительность, сек — число; Сброс — да/нет
Результаты: Истекло — да/нет; Секунды — число; Прошло, мс — число
Продолжения: Continue, Истекло
Таймер
Возвращает истину после заданного числа секунд и автоматически сбрасывается. Подходит для условий повторения действий.
Входы, выходы и идентификатор
time.timer
Входы: Длительность, сек — число
Результаты: Результат — да/нет; Секунды — число
Продолжения: Выход