Clamp Vector Size
KismetMathLibraryЧто это
Pure-функция, которая ограничивает длину (magnitude) вектора заданным диапазоном. Если длина вектора меньше Min, возвращается вектор той же длины Min; если больше Max — вектор длины Max; иначе — исходный вектор. Направление при этом сохраняется. Тип: pure (не требует exec-подключения, работает как чистое вычисление).
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- In Vector (Vector) — исходный вектор
- Min (Float) — минимальная длина результата
- Max (Float) — максимальная длина результата
Выходы (данные):
- Return Value (Vector) — вектор с зажатой длиной
Когда используется
- Нормализация скорости персонажа или снаряда с сохранением максимальной скорости.
- Ограничение силы ветра или гравитации в процедурных эффектах.
- Подготовка вектора для дальнейших вычислений, где длина должна лежать в заданном интервале (например, для расчёта углов или смещений).
Типичные проблемы
- Отрицательные Min / Max — функция использует абсолютные значения? Нет, Min и Max трактуются как положительные длины. Отрицательные значения приведут к непредсказуемому поведению (обычно игнорируются или приводят к нулевому результату).
- Нулевой входной вектор — если In Vector = (0,0,0), то результат всегда (0,0,0), даже если Min > 0, так как направление не определено.
- Перепутанные Min и Max — если Min > Max, функция всё равно отработает, но логически это ошибка: большинство разработчиков ожидают Min ≤ Max. Рекомендуется проверять порядок перед вызовом.