Get Touch State
InputComponent
0
Что это
Pure-функция, возвращающая текущее состояние касания (touch) для указанного пальца. Позволяет получить координаты нажатия в экранном пространстве и флаг нажатия. Не требует exec-пинов (pure).
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (InputComponent) — компонент ввода, к которому применяется функция (self)
- Finger Index (Integer) — индекс пальца (0 — первое касание, 1 — второе и т.д.)
Выходы (данные):
- Location X (Float) — X-координата касания в экранном пространстве (пиксели)
- Location Y (Float) — Y-координата касания в экранном пространстве (пиксели)
- Is Currently Pressed (Boolean) — true, если палец в данный момент нажат
Когда используется
- Обработка мультитач-ввода в мобильных или сенсорных проектах.
- Получение точных координат касания для UI-взаимодействий или управления камерой.
Типичные проблемы
- Выход за границы Finger Index — если передать индекс, превышающий количество активных касаний, функция вернёт false, а выходные параметры останутся неопределёнными. Всегда проверяйте возвращаемое значение (пин Return Value, если он есть) или используйте проверку Is Currently Pressed.
- Путаница с экранными координатами — Location X/Y возвращаются в пикселях экрана, а не в вьюпорте. Для преобразования в относительные координаты (0–1) используйте деление на размер экрана.
- Игнорирование pure-природы — поскольку функция pure, её можно вызывать в любом месте графа без exec-соединения, но результат будет вычисляться каждый раз при обращении. Если нужно однократное чтение, используйте переменную для кэширования.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.