Get Hit Result Under Cursor For Objects
PlayerController
0
Что это
Exec-функция класса PlayerController. Выполняет трассировку луча из камеры под курсором мыши и возвращает результат попадания только для указанных типов объектов (Object Types). Синхронная, не pure.
Пины
Exec-входы:
- execute (exec) — запуск трассировки
Exec-выходы:
- then (exec) — продолжение выполнения после завершения трассировки
Входы (данные):
- Target (PlayerController) — контроллер, от которого выполняется трассировка
- Object Types (Array of EObjectTypeQuery) — массив типов объектов, по которым проверяется попадание
- Trace Complex (bool) — если true, трассировка учитывает сложную коллизию (треугольники меша), иначе — простые коллизии (примитивы)
Выходы (данные):
- Return Value (bool) — true, если луч попал в объект из указанных типов
- Out Hit (Hit Result) — детальная информация о попадании (точка, нормаль, дистанция, задетый актор и т.д.)
Когда используется
- Для реализации кликов по объектам определённых категорий (например, только по врагам или только по интерактивным предметам).
- В системах выделения юнитов, прицеливания или взаимодействия с UI-независимыми объектами.
Типичные проблемы
- Пустой массив Object Types — трассировка никогда не вернёт попадание.
- Забытое значение bTraceComplex = false — функция может не находить попадания в сложные меши (например, декорации с детальной коллизией).
- Использование Out Hit без проверки Return Value — при false результат невалиден, обращение к его полям может привести к ошибке.
- Вызов функции, когда PlayerController не владеет pawn'ом или неактивен (например, в главном меню) — трассировка не выполнится корректно.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.