Get Mouse Position On Platform
WidgetLayoutLibrary
0
Что это
Pure-функция из WidgetLayoutLibrary, возвращает текущие координаты курсора мыши на экране в пикселях (система координат: левый верхний угол — (0,0)). Полезна для UI-взаимодействий, когда нужно получить положение мыши без привязки к конкретному виджету.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- нет (pure-функция не имеет входных данных; неявный self игнорируется)
Выходы (данные):
- ReturnValue (Vector2D) — текущая позиция курсора мыши в экранных координатах (X — горизонталь, Y — вертикаль)
Когда используется
- Отслеживание движения мыши для кастомных виджетов или HUD-элементов.
- Получение координат для контекстных меню, тултипов или перетаскивания.
- Преобразование в локальное пространство конкретного виджета через
GetMousePositionOnViewportили обратное преобразование.
Типичные проблемы
- На платформах без мыши (мобильные устройства, консоли без указателя) возвращает (0,0) или позицию последнего касания — код должен проверять наличие мыши через
GetMouseCursor. - Координаты не масштабируются под DPI-масштаб viewport’а — если виджет использует масштабирование, требуется дополнительное преобразование (например,
GetMousePositionOnViewportс учётом DPI). - При захвате мыши (SetMouseCapture) функция может возвращать устаревшее значение — нужно вызывать её каждый кадр или подписываться на событие
OnMouseMove.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.