Multi Line Trace By Channel
KismetSystemLibraryЧто это
Multi Line Trace By Channel — exec-функция из KismetSystemLibrary, выполняет множественную трассировку луча по заданному каналу коллизий. Возвращает все объекты, пересечённые лучом (в отличие от Single, которая возвращает только первый). Используется для определения всех препятствий или целей вдоль линии.
Пины
Exec-входы:
- execute (exec) — запуск трассировки
Exec-выходы:
- then (exec) — продолжение выполнения после завершения трассировки
Входы (данные):
- WorldContextObject (Object) — контекст мира (обычно self)
- Start (Vector) — начальная точка луча
- End (Vector) — конечная точка луча
- TraceChannel (ETraceTypeQuery) — канал трассировки (например, Visibility, Camera)
- bTraceComplex (bool) — true — трассировать сложные коллизии (детализированная геометрия), false — только простые (AABB)
- ActorsToIgnore (Array of Actor) — массив акторов, которые исключаются из трассировки
- bIgnoreSelf (bool) — игнорировать собственный актор (контекст)
- DrawDebugType (EDrawDebugTrace) — тип отладки: None, For One Frame, For Duration, Persistent
- TraceColor (LinearColor) — цвет линии в режиме отладки
- TraceHitColor (LinearColor) — цвет в точке попадания (отладка)
- DrawTime (float) — время отображения отладки (если DrawDebugType = For Duration)
Выходы (данные):
- OutHits (Array of Hit Result) — массив всех результатов попаданий (отсортирован по расстоянию)
- ReturnValue (bool) — true, если было хотя бы одно попадание
Пины отладки: DrawDebugType, TraceColor, TraceHitColor, DrawTime (работают только если DrawDebugType != None)
Когда используется
- Поиск всех акторов или объектов вдоль прямой линии
- Реализация сканирования, лучевого оружия с поражением нескольких целей
- Определение видимости между двумя точками с учётом всех препятствий
- Сбор информации о геометрии уровня (например, для процедурной генерации)
Типичные проблемы
- Неправильный Trace Channel — если канал не настроен в проекте или выбран неверно, трассировка может не находить цели (например, Visibility вместо Camera)
- Забытые ActorsToIgnore — если не исключить самого стреляющего актора, он может попасть в OutHits (особенно при bIgnoreSelf = false)
- Путаница с Single-трассой — разработчики иногда ожидают только первый хит и игнорируют массив OutHits, используя ReturnValue как единственный результат (хотя он лишь индикатор наличия хотя бы одного попадания)
- Ненужная отладка — забывают переключить DrawDebugType на None в релизной версии, что создаёт визуальный шум и снижает производительность