Wrap (Integer)
KismetMathLibrary
0
Что это
Pure-функция библиотеки KismetMathLibrary. Возвращает целое число, «обёрнутое» в заданный полуинтервал [Min, Max). Если значение выходит за границы, оно переносится на противоположную границу, циклически повторяя диапазон. Не имеет exec-пинов (pure).
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Value (Integer) — исходное число, которое нужно обернуть
- Min (Integer) — нижняя граница диапазона (включительно)
- Max (Integer) — верхняя граница диапазона (не включается; при Value == Max вернётся Min)
Выходы (данные):
- ReturnValue (Integer) — результат: число, приведённое к диапазону [Min, Max) циклическим сдвигом
Когда используется
- Циклические индексы (например, анимация по кругу, прокрутка меню, бесконечный таймер).
- Пересчёт значений из одного диапазона в другой с сохранением фазы (без потери).
- Создание «закольцованных» координат (как wrap в шейдерах).
Типичные проблемы
- Путаница с Clamp: Clamp останавливает значение на границе, Wrap переносит его на противоположную сторону — разные сценарии.
- Некорректный порядок Min / Max: если Min > Max, функция может дать неожиданный результат (движок обрабатывает это как вырожденный случай — лучше всегда передавать Min ≤ Max).
- Работа с нецелыми типами: для чисел с плавающей точкой (float) нужно использовать отдельную ноду «Wrap (Float)».
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.