Multi Line Trace For Objects
KismetSystemLibraryЧто это
Multi Line Trace For Objects — exec-функция трассировки лучей из библиотеки KismetSystemLibrary. Выполняет линейную трассировку (line trace) от точки Start до точки End и возвращает все объекты, пересечённые лучом, отфильтрованные по заданным типам объектов (Object Types). Отличается от одиночного луча (LineTraceForObjects) тем, что не останавливается на первом попадании — собирает все пересечения до конца луча. Не pure, не async — блокирует выполнение до завершения трассы.
Пины
Exec-входы:
- execute (exec) — запуск трассировки
Exec-выходы:
- then (exec) — продолжение после завершения
Входы (данные):
- Start (Vector) — начальная точка луча
- End (Vector) — конечная точка луча
- Object Types (Array of EObjectTypeQuery) — типы объектов для поиска (например, WorldDynamic, Pawn, PhysicsBody и т.д.)
- bTraceComplex (bool) — если true, трассировка учитывает сложную коллизию (Complex Collision), иначе простую (Simple Collision)
- Actors to Ignore (Array of Actor) — массив акторов, которые будут проигнорированы при трассировке
- bIgnoreSelf (bool) — если true, игнорируется сам владелец (Owner) этого вызова
Выходы (данные):
- Out Hits (Array of Hit Result) — массив результатов попаданий (все пересечения, отсортированные от ближайшего к дальнейшему)
- Return Value (bool) — true, если был хотя бы один хит (любой элемент в Out Hits)
Пины отладки: Draw Debug Type (EDrawDebugTrace), Trace Color (LinearColor), Trace Hit Color (LinearColor), Draw Time (float)
Когда используется
- Проверка видимости нескольких объектов вдоль луча (например, определение, все ли цели за препятствием).
- Сбор всех объектов под прицелом (выстрел сквозь стены, проникающие пули).
- Физические симуляции, где нужно получить все пересечения сцены на одной линии.
Типичные проблемы
- Пустой массив Object Types — трассировка не найдёт ни одного попадания, так как нет заданных типов для проверки.
- Не заданы Actors to Ignore — может поймать самого стреляющего или уже поражённые объекты, если их не включить в игнорируемые.
- Игнорирование Return Value — если не проверить bool, можно обрабатывать пустой массив Out Hits и получить ошибки чтения.
- Неверный Draw Debug Type — при частых вызовах (каждый кадр) нужно ставить
For One Frame, иначе отладка будет накапливаться и тормозить редактор.