Deproject
CanvasЧто это
Функция Deproject (K2_Deproject) класса Canvas преобразует экранные (2D) координаты в мировые (3D) луч, исходящий из камеры. Используется для определения того, на какой объект в мире указывает курсор или заданная точка на экране. Тип — exec (не pure), так как требует контекста Canvas и может зависеть от состояния рендера.
Пины
Exec-входы:
_(не уверен в точной сигнатуре)_
Exec-выходы:
_(не уверен в точной сигнатуре)_
Входы (данные):
_(не уверен в точной сигнатуре)_
Выходы (данные):
_(не уверен в точной сигнатуре)_
Когда используется
- Определение объекта под курсором мыши (пикинг) в UI-виджетах или HUD.
- Преобразование координат клика в мировое пространство для стрельбы, взаимодействия или размещения объектов.
- Отладка визуализации трассировки из экранной точки.
Типичные проблемы
- Функция работает только внутри события
Event Draw(или другого контекста с валидным Canvas). Вызов вне этого контекста приведёт к ошибке или нулевому результату. - Результат (мировое направление) зависит от текущей камеры и её проекции (ортографическая/перспективная). Необходимо учитывать, что при ортографической проекции луч будет параллельным, а не исходить из точки.
- Экранные координаты должны быть в диапазоне [0, размер экрана] (обычно передаются из
Get Mouse Position). Использование нормализованных координат (0–1) без преобразования даст неверный результат.