Vector Spring Interp
KismetMathLibraryЧто это
Pure-функция из библиотеки KismetMathLibrary. Выполняет плавную интерполяцию вектора с эффектом пружины (spring‑damper). Позволяет получить естественное движение с возможностью «перелёта» и затухания колебаний в зависимости от параметров жёсткости, демпфирования и массы.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Current (Vector) — текущее значение интерполируемой величины
- Target (Vector) — целевое значение, к которому стремится пружина
- SpringState (VectorSpringState) — состояние пружины (velocity и предыдущее смещение); должно сохраняться между вызовами
- Stiffness (float) — коэффициент жёсткости пружины (чем выше, тем быстрее приближение)
- CriticalDamping (float) — коэффициент критического демпфирования (1.0 — без перелёта, <1.0 — перелёт с осцилляциями)
- Mass (float) — инерционная масса (обычно 1.0; увеличение замедляет реакцию)
Выходы (данные):
- ReturnValue (Vector) — интерполированный вектор на текущем шаге
Когда используется
- Плавное движение объектов (например, следование камеры, подвеска, руки с физикой).
- Анимация UI‑элементов с эффектом пружинистости.
- Любая задача, где нужно нелинейное сглаживание с возможностью перелёта.
Типичные проблемы
- Забытый/неправильный SpringState. Пин SpringState должен быть привязан к persistent-переменной (например, в Actor или Component). Если каждый вызов создавать новый экземпляр, эффекта пружины не будет.
- Слишком большая жёсткость (Stiffness). Может вызвать визуальные рывки при малом Delta Time. Рекомендуется согласовывать с частотой кадров.
- Неправильное демпфирование. CriticalDamping = 0 даёт бесконечные колебания; значения >1.0 делают движение вялым. Типичный рабочий диапазон — 0.1–3.0.
- Игнорирование Delta Time. Функция ожидает, что она вызывается каждый кадр (например, в Tick). Если вызывать реже — поведение ломается. Delta Time встроено в расчёт, отдельное время не требуется.