Vector Clamp Size Max2 D
KismetMathLibraryЧто это
Pure-функция, возвращающая копию вектора A, у которого длина проекции на плоскость XY (2D-магнитуда) ограничена сверху значением Max. Компонента Z исходного вектора не изменяется. Используется для ограничения горизонтальной скорости, смещения или любого 2D-вектора.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- A (Vector) — исходный вектор, чью 2D-длину требуется ограничить
- Max (float) — максимально допустимая 2D-длина (неотрицательное число)
Выходы (данные):
- Return Value (Vector) — результирующий вектор: XY-компоненты ограничены по длине, Z-компонента совпадает с входной
Когда используется
- Ограничение скорости персонажа/транспорта по горизонтали (например, максимальная скорость бега) без влияния на вертикальную скорость.
- Кламп 2D-оффсета или силы в AI-логике (навигация, преследование цели).
- Нормализация с учётом максимального радиуса в 2D-пространстве (например, ограничение джойстика до единичной окружности).
Типичные проблемы
- Путаница с 3D-аналогом — разработчики ожидают, что функция ограничит полную (3D) длину вектора; на самом деле Z не участвует. Для полного ограничения используйте
Vector_ClampSize(3D). - Отрицательное Max — при передаче отрицательного значения функция может не сработать как ожидается (обычно длина не клампится, остаётся исходной). Рекомендуется всегда передавать
Max >= 0. - Неявное влияние Z на результат — хотя Z не ограничивается, при сложении с другими векторами Z-компонента может нарушить ограничение скорости. Следите, чтобы итоговый вектор обрабатывался корректно.