Sphere Trace For Objects
KismetSystemLibraryЧто это
Exec-функция трассировки сферы (Sphere Trace) из набора KismetSystemLibrary. Запускает луч от Start до End с заданным радиусом, проверяет коллизии с объектами и возвращает одно (single) первое попадание. Используется для детекции препятствий, проверки видимости, поиска объектов в объёме.
Пины
Exec-входы:
- execute (exec) — запуск трассировки
Exec-выходы:
- then (exec) — выполнение после завершения трассировки
Входы (данные):
- Start (Vector) — начальная точка луча
- End (Vector) — конечная точка луча
- Radius (float) — радиус сферы
- Trace Channel (byte) — канал трассировки (0 — Visibility, 1 — Camera, 2 — Default, 3 — Interaction, 4 — Everything)
- Trace Complex (bool) — учитывать сложные коллизии (Mesh, Volume)
- Actors to Ignore (Array of Actor) — актёры, исключаемые из проверки
- Ignore Self (bool) — игнорировать собственный актёр
- Draw Debug Type (byte) — тип отладки (0 — None, 1 — OneFrame, 2 — Duration)
- Draw Debug Color (LinearColor) — цвет отладки
- Draw Debug Time (float) — время отображения отладки
Выходы (данные):
- Out Hit (Hit Result) — структура с деталями попадания
- Out Hit Location (Vector) — точка попадания
- Out Hit Normal (Vector) — нормаль в точке попадания
- bHit (bool) — true, если было попадание
Пины отладки: Draw Debug Color (LinearColor), Draw Debug Time (float) — задают визуализацию трассировки в редакторе.
Когда используется
- Проверка видимости между двумя точками (например, от персонажа до цели).
- Определение препятствий на пути объекта заданного радиуса.
- Поиск первого объекта, пересекающего сферу вдоль луча.
Типичные проблемы
- Неправильный Trace Channel — выбор Visibility вместо Default может дать неожиданные результаты (Visibility игнорирует некоторые типы коллизий).
- Radius = 0 — сфера нулевого радиуса ведёт себя как Line Trace, что может быть неочевидно.
- Ignore Self = false — если актёр, с которого запускается трассировка, не исключён, он может «попасть в себя».
- Trace Complex без необходимости — включение увеличивает нагрузку; используйте только когда нужны коллизии с Mesh/Volume.