Line Trace For Objects
KismetSystemLibraryЧто это
Exec-функция трассировки луча (line trace) по заданным типам объектов (Object Types). Возвращает первый попавшийся объект в виде структуры Hit Result и булево значение успеха. Используется, когда нужно проверить пересечение луча с объектами определённых категорий (например, только с динамическими или только с физическими телами).
Пины
Exec-входы:
- execute (exec) — запуск трассировки
Exec-выходы:
- then (exec) — продолжение выполнения после завершения трассировки
Входы (данные):
- Start (Vector) — начальная точка луча
- End (Vector) — конечная точка луча
- Object Types (Array of EObjectTypeQuery) — массив типов объектов, по которым выполняется трассировка
- bTraceComplex (bool) — если true, трассировка учитывает сложную коллизию (по полигонам), иначе — по упрощённым примитивам
- Actors to Ignore (Array of Actor) — массив актёров, которые игнорируются при трассировке
- Ignore Self (bool) — игнорировать ли актёра, вызвавшего трассировку
- Draw Debug Type (EDrawDebugTrace) — режим отображения отладочного луча (None, For One Frame, For Duration, Persistent)
- Trace Color (LinearColor) — цвет луча при отсутствии попадания
- Trace Hit Color (LinearColor) — цвет луча при попадании
- Draw Time (float) — длительность отображения отладочного луча (если Draw Debug Type не None)
Выходы (данные):
- Out Hit (Hit Result) — структура с деталями попадания (точка, нормаль, актёр, кость и т.д.)
- Return Value (bool) — true, если луч задел хотя бы один объект из указанных Object Types
Когда используется
- Проверка видимости между двумя точками (например, для AI или прицела).
- Определение объекта под курсором мыши (pickup, стрельба).
- Трассировка по категориям объектов (например, только статика или только персонажи).
Типичные проблемы
- Пустой массив Object Types — трассировка не найдёт ни одного объекта, Return Value всегда false.
- Забытый Ignore Self — луч может попасть в собственный актёр (например, в капсулу персонажа), что даёт ложное срабатывание.
- Неправильный Draw Debug Type — если оставить None, отладка не отобразится, что усложняет отладку в редакторе.