Deproject Screen To World
GameplayStaticsЧто это
Преобразует 2D-координаты экрана (в пикселях) в луч (начало и направление) в 3D-мире. Используется для определения того, на какой объект указывает курсор мыши, или для реализации кастомного пикинга. Функция pure (не имеет exec-пинов) — результат вычисляется сразу, без ожидания.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Player Controller (Object Reference) — контроллер игрока, через который выполняется депроекция.
- Screen Position (Vector 2D) — координаты точки на экране (обычно в пикселях, начало отсчёта — левый верхний угол).
Выходы (данные):
- World Origin (Vector) — точка начала луча в 3D-мире (положение камеры).
- World Direction (Vector) — единичный вектор направления луча от камеры через указанную точку экрана.
- Return Value (Boolean) — true, если депроекция выполнена успешно (контроллер корректен и камера существует); false в противном случае.
Когда используется
- Определение объекта под курсором мыши (в паре с Line Trace).
- Реализация кастомных систем взаимодействия (клик по предметам, стрельба по прицелу).
- Преобразование UI-координат в игровое пространство.
Типичные проблемы
- Некорректный Player Controller — если контроллер невалиден (например, не инициализирован или уничтожен), функция вернёт false, а выходные векторы останутся нулевыми.
- Игнорирование Return Value — разработчики часто подключают только World Origin и World Direction, не проверяя успешность операции, что может привести к использованию некорректных данных.
- Путаница с координатами экрана — Screen Position должен быть в пикселях относительно вьюпорта; если передать координаты из другого пространства (например, относительные 0–1), результат будет неверным.