Vector Clamp Size Max
KismetMathLibraryЧто это
Pure-функция из библиотеки KismetMathLibrary. Ограничивает длину входного вектора заданным максимальным значением (Max). Если длина вектора меньше или равна Max — возвращается исходный вектор; если больше — возвращается вектор той же направленности, но с длиной, в точности равной Max. Аналог Vector_ClampSize, но без нижнего порога.
Пины
Exec-входы:
Нет (pure)
Exec-выходы:
Нет (pure)
Входы (данные):
- Target (Vector) — исходный вектор, который требуется ограничить по длине
- Max (float) — максимальная разрешённая длина вектора (должна быть ≥ 0)
Выходы (данные):
- ReturnValue (Vector) — результирующий вектор с длиной ≤ Max
Когда используется
- Нормализация скорости/силы с сохранением направления без «отбрасывания» компонент (в отличие от Get Safe Normal с последующим умножением).
- Ограничение импульса или ускорения в физике, когда нужно гарантировать, что вектор не превысит порог, но при малых значениях не обнуляется.
- Упрощённое «зажатие» направления персонажа: например, чтобы скорость бега не превышала лимит, но направление оставалось полным.
Типичные проблемы
- Отрицательный Max — при Max < 0 функция может работать непредсказуемо (обычно возвращается нулевой вектор или генерируется предупреждение в лог). Всегда проверяй, что Max неотрицателен.
- Нулевой Max — если передать 0, функция вернёт нулевой вектор (длина 0). Если это нежелательно, используй отдельную проверку.
- Путаница с Vector_ClampSize — эта функция не имеет нижнего порога (Min). Если нужно ограничить и снизу, применяй Vector_ClampSize (у которой два порога).