Line Trace By Profile
KismetSystemLibraryЧто это
Функция выполняет линейную трассировку (лучевую проверку) от Start до End. Возвращает первый объект, пересечённый лучом, используя Profile Name (имя коллизионного профиля). Используется для одноразового одиночного трейса без необходимости настройки канала вручную. Exec-функция (не pure).
Пины
Exec-входы:
- execute (exec) — запуск трассировки
Exec-выходы:
- then (exec) — выполнение после завершения
Входы (данные):
- Start (Vector) — начальная точка луча
- End (Vector) — конечная точка луча
- ProfileName (Name) — имя коллизионного профиля (например,
"Pawn","WorldStatic","BlockAll") - bTraceComplex (bool) — если true, трассировка учитывает сложные коллизии (использует коллизию треугольника, а не только примитива)
- ActorsToIgnore (Array of Actor) — список актёров, которые будут пропущены при проверке
- DrawDebugType (EDrawDebugTrace::Type) — тип отладочной визуализации (None, ForOneFrame, ForDuration, Persistent)
- bIgnoreSelf (bool) — если true, игнорируется собственный актёр, на котором вызывается нода
Пины отладки: Trace Color (LinearColor), Trace Hit Color (LinearColor), Draw Time (float)
Выходы (данные):
- OutHit (Hit Result) — структура с данными о попадании (актёр, точка, нормаль, кость и т.д.)
- ReturnValue (bool) — true, если луч что-то задел; false — если ничего не найдено
Когда используется
- Проверка видимости между двумя точками (например, стреляет ли персонаж во врага).
- Проверка препятствий на пути (сможет ли персонаж пройти, есть ли стена).
- Интерактивные элементы: наведение на объекты, лучевой прицел.
Типичные проблемы
- Неправильное имя профиля — вводится строка, которая не соответствует ни одному коллизионному профилю в проекте. Трассировка либо ничего не находит, либо задевает всё подряд.
- Забытые ActorsToIgnore — если игнорировать собственного актёра не указано (через
bIgnoreSelfили массив), трассировка может попасть в самого себя (например, капсулу персонажа). - Путаница между Single и Multi — функция возвращает только первое попадание. Для всех объектов используется
LineTraceMultiByProfile.