Get Distance Along Spline At Spline Input Key
SplineComponentЧто это
Pure-функция компонента SplineComponent. Преобразует значение Spline Input Key (параметр вдоль сплайна, обычно в диапазоне 0–1) в физическое расстояние (в юнитах) от начала сплайна до точки, соответствующей этому ключу. Полезна, когда нужно узнать, сколько юнитов «пройдено» при заданном параметре.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (SplineComponent) — компонент сплайна, вдоль которого вычисляется расстояние
- Spline Input Key (Float) — параметр вдоль сплайна (обычно 0.0 — начало, 1.0 — конец)
Выходы (данные):
- Return Value (Float) — расстояние вдоль сплайна в мировых юнитах, соответствующее заданному ключу
Когда используется
- Позиционирование объектов вдоль сплайна с известным параметром (например, анимация движения по пути).
- Расчёт пройденного пути для симуляции транспорта или персонажа, движущегося по сплайну.
- Синхронизация нескольких объектов на сплайне по одинаковому ключу.
Типичные проблемы
- Неправильный диапазон Spline Input Key: ключ может выходить за пределы [0,1] (экстраполяция), но часто разработчик ожидает только отрезок внутри сплайна. Всегда проверяйте, что ключ находится в ожидаемых границах.
- Путаница с обратной функцией:
GetDistanceAlongSplineAtSplineInputKeyиGetSplineInputKeyAtDistanceAlongSpline— разные операции. Не перепутайте, когда нужно получить ключ по расстоянию, а не наоборот. - Игнорирование Target: если компонент сплайна не инициализирован или удалён, функция вернёт 0. Всегда проверяйте ссылку на компонент перед вызовом.