Get Distance Between Two Sockets
KismetAnimationLibraryЧто это
Pure-функция для вычисления расстояния между двумя сокетами (костями) скелетной меш-компоненты и последующего ремаппинга этого расстояния в заданный диапазон. Используется в анимационных системах для генерации управляющих параметров.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (Skeletal Mesh Component) — компонент скелета, содержащий сокеты
- Socket A (Name) — имя первого сокета или кости
- Socket B (Name) — имя второго сокета или кости
- In Range Input (Float) — входное значение для ремаппинга (обычно само расстояние)
- In Range Min (Float) — минимальная граница входного диапазона
- In Range Max (Float) — максимальная граница входного диапазона
- Out Range Min (Float) — минимальная граница выходного диапазона
- Out Range Max (Float) — максимальная граница выходного диапазона
Выходы (данные):
- Return Value (Float) — результат ремаппинга (значение из выходного диапазона, соответствующее входному)
- Distance (Float) — фактическое расстояние между сокетами в мировых координатах
Когда используется
При процедурной настройке анимации, где нужно преобразовать расстояние между костями в управляющий параметр (вес бленда, скорость, ограничение поворота). Часто применяется в IK-системах, эффектах растяжения, динамике лоскута ткани.
Типичные проблемы
- Выход входного значения за границы In Range Min/Max — при экстраполяции результат может стать нелинейным или выйти за ожидаемые пределы.
- Некорректное указание скелетного компонента или отсутствие сокетов с заданными именами (функция вернёт Distance=0, если сокеты не найдены).
- Перепутанные диапазоны (In/Out) — это приводит к обратному или сжатому ремаппингу, что незаметно в редакторе, но ломает логику в игре.