ScreenToAbsolute
SlateBlueprintLibraryЧто это
Статическая функция из SlateBlueprintLibrary, преобразует экранные координаты (в пикселях экрана) в абсолютные координаты в пространстве Slate (AbsoluteCoordinate). Используется для перевода позиции мыши или клика в координаты, привязанные к корню окна (Viewport), игнорируя преобразования виджетов. Тип — exec-функция (имеет execute и then).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения после расчёта
Входы (данные):
- World Context (Object) — игровой контекст (обычно
selfиз Blueprint) - Geometry (Geometry) — геометрия виджета, относительно которой выполняется преобразование (обычно берётся из пина
Get Cursor Geometryили прямо от виджета) - Screen Position (Vector 2D) — позиция на экране в пикселях (целевая точка)
- Include Window Position (Boolean) — если
true, к результату добавляется смещение окна (полезно для многооконных приложений); по умолчаниюfalse
Выходы (данные):
- Absolute Coordinate (Vector 2D) — итоговые абсолютные координаты в пространстве Slate (относительно верхнего левого угла окна/игрового вьюпорта)
> Функция ничего не возвращает через Return Value (void), результат — только выходной пин Absolute Coordinate.
Когда используется
- Преобразование позиции клика мыши или события
OnMouseButtonDownв координаты, которые можно передать дальше для проверки попадания в другие виджеты или для отладки. - Коррекция координат при работе с окнами и
Viewportв мульти-дисплейных настройках. - Расчёт абсолютного положения дочернего виджета после его размещения.
Типичные проблемы
- Передача неверной Geometry
Если передать Geometry от родительского виджета, а не от того, к которому относится Screen Position, результат будет смещён на величину трансформаций родителя. Всегда используйте Geometry именно той ноды, откуда берётся позиция (например, Get Cursor Geometry внутри события виджета).
- Забытый флаг
Include Window Position
В многооконных приложениях или при запуске в окне, если не включить bIncludeWindowPosition, координаты могут быть систематически сдвинуты на заголовок окна или рамку, что приведёт к ошибкам в позиционировании.
- Путаница с абсолютными и локальными координатами
Результат этой функции — абсолютные координаты в пространстве Slate (относительно корня окна). Не пытайтесь использовать их напрямую как экранные или как координаты внутри родительского виджета без дополнительных преобразований (например, через GetLocalSize или TransformAbsoluteToLocal).