Get Point Distance To Segment
KismetMathLibrary
0
Что это
Pure-функция из KismetMathLibrary. Вычисляет кратчайшее расстояние от заданной точки до отрезка (сегмента) в трёхмерном пространстве. Возвращает скалярное значение — длину перпендикуляра от точки до ближайшей точки на отрезке.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Point (Vector) — точка, расстояние от которой измеряется
- SegmentStart (Vector) — начало отрезка
- SegmentEnd (Vector) — конец отрезка
Выходы (данные):
- ReturnValue (float) — расстояние от точки до отрезка
Когда используется
- Проверка попадания точки в зону влияния линейного триггера (например, расстояние до пути движения).
- Вычисление отклонения объекта от заданной траектории (рейкаст, линия движения).
- Оптимизация поиска ближайшей точки на отрезке без необходимости получать саму точку (если нужно только расстояние).
Типичные проблемы
- Путают с функцией GetClosestPointOnSegment (которая возвращает точку, а не расстояние). Если нужна координата ближайшей точки — используйте другую функцию.
- Перепутаны порядок аргументов SegmentStart и SegmentEnd — функция несимметрична, отрезок направлен от Start к End, но расстояние от точки до отрезка не зависит от направления, поэтому порядок не влияет на результат. Однако для читаемости кода лучше соблюдать конвенцию.
- Забывают, что результат — всегда неотрицательное число. Если точка лежит на отрезке, возвращается 0.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.