Convert Mouse Location To World Space
PlayerControllerЧто это
Преобразует текущие экранные координаты мыши (курсора) в мировую точку и направление луча, исходящего из камеры через эту точку. Используется для реализации кликов по объектам, прицеливания или взаимодействия с миром. Функция exec (не pure) — требует выполнения и возвращает данные через выходные пины.
Пины
Exec-входы:
- execute (exec) — запуск преобразования
Exec-выходы:
- then (exec) — продолжение выполнения после расчёта
Входы (данные):
- _(нет входных пинов, кроме неявного self — PlayerController)_
Выходы (данные):
- WorldLocation (Vector) — точка в мировом пространстве, соответствующая положению мыши на ближней плоскости отсечения камеры
- WorldDirection (Vector) — единичный вектор направления луча от камеры через эту точку
Когда используется
- Реализация трассировки луча (Line Trace) под курсор мыши для определения объекта под прицелом.
- Создание эффектов, снарядов или декалей в точке, куда указывает мышь.
- Отладка визуализации луча от камеры через курсор.
Типичные проблемы
- Невалидный PlayerController — если контроллер не принадлежит локальному игроку (например, в сетевой игре на сервере), функция вернёт нулевые значения. Всегда проверяйте
IsValidперед вызовом. - Зависимость от активного viewport — результат корректен только для игрока, чей экран активен. В сплитскрине или при переключении камер убедитесь, что используется правильный контроллер.
- Путаница с другими функциями — не перепутайте с
Get Hit Result Under Cursor by Channel(которая уже выполняет трассировку) —DeprojectMousePositionToWorldдаёт только точку и направление, трассировку нужно делать отдельно.