Project
Canvas
0
Что это
Функция Project (C++: K2_Project) — exec-функция класса Canvas, предназначенная для проецирования 3D-точки на экранную плоскость (2D-координаты). Используется для преобразования мировых координат в экранные, например, для отображения UI-элементов в позиции 3D-объекта.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (Canvas Object Reference) — ссылка на Canvas, на котором выполняется проецирование
- World Location (Vector) — 3D-точка в мировом пространстве, которую нужно спроецировать на экран
Выходы (данные):
- Return Value (Vector) — 2D-координаты на экране (X, Y) в пикселях; Z-компонента игнорируется или равна 0
Когда используется
- Для привязки HUD-элементов (текст, иконки, линии) к позициям 3D-объектов в игровом мире.
- Для отладки: отображение меток над объектами в редакторе или в игре.
Типичные проблемы
- Некорректный Canvas — если Canvas не инициализирован (например, в Event Tick без проверки), функция вернёт нулевые координаты или вызовет ошибку.
- Объект за камерой — проецирование точки, находящейся позади камеры, даёт некорректные экранные координаты (обычно с отрицательными значениями). Требуется проверка видимости перед вызовом.
- Игнорирование масштаба экрана — возвращаемые координаты не учитывают текущее разрешение экрана или масштаб UI; для корректного отображения может потребоваться дополнительное масштабирование.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.