Мышь и тач-ввод

Позиция курсора читается парой функций: ebiten.CursorPosition() возвращает два int — x и y, а добавленная в свежих версиях ebiten.CursorPositionF() — те же координаты в float64, с дробной точностью. Главное, что нужно знать про эти числа: движок отдаёт их уже в логических координатах холста. Документация формулирует это как «logical position, учитывающая масштаб экрана», и за этими словами стоит забота: какой бы ни был масштаб окна, растяжение из Layout и чёрные поля — движок сам переводит позицию указателя из оконных пикселей в систему координат вашей игры. При Layout 320 на 240 и окне вдвое больше курсор в правом нижнем углу игровой области вернёт примерно (320, 240), а не оконные (960, 720). Ручной пересчёт «окно минус поле, делить на масштаб» писать не нужно — и не нужно, потому что он ломает то, что движок уже учёл.

Кнопки опрашивает ebiten.IsMouseButtonPressed(button): константы MouseButtonLeft, MouseButtonMiddle, MouseButtonRight закрывают классическую трёхкнопочную мышь — по внутренностям это именованные алиасы MouseButton0, MouseButton1 и MouseButton2. У игровых мышей рядом живут MouseButton3 и MouseButton4: боковые кнопки читаются тем же вызовом с другой константой, без единой строки платформенного кода. Для колеса есть ebiten.Wheel() — пара float64 с горизонтальным и вертикальным смещением колеса или тачпад-скролла за тик, нулевая, когда колесо стоит; зум в картах и прокрутка инвентаря — её работа. Все три вызова — опрос за тик в Update, ровно та же модель, что у клавиатуры: никаких событий, только честные вопросы каждый тик.

Пара «зажата против только что» у мыши повторяет клавиатурную один в один. ebiten.IsMouseButtonPressed отвечает на состояние — кнопка зажата прямо сейчас; inpututil.IsMouseButtonJustPressed истинна в тике нажатия; inpututil.IsMouseButtonJustReleased — в тике отпускания; а inpututil.MouseButtonPressDuration возвращает, сколько тиков кнопку держат, — удобно для натяжения лука или зарядки удара. Практическое разбиение действий такое: одиночный выстрел, клик по кнопке интерфейса, выбор предмета — только JustPressed; полёт за курсором, рисование кистью, стрельба очередью — IsMouseButtonPressed на удержании; перетаскивание собирается из всех трёх: JustPressed начал тягать, IsMouseButtonPressed держит, JustReleased бросил. Заметьте, что и здесь работает правило шестого урока: функции inpututil обязаны вызываться в Update, не в Draw — кадр может выйти без тика, и тогда событие из Draw потеряется.

Правая и средняя кнопки — не экзотика: правая снимает выбор и открывает контекстное меню, средняя прокруивает камеру в редакторах. Опрашивайте нужные кнопки тем же вызовом с другой константой и не пытайтесь хранить «нажатия» между тиками: опрос дёшев, а ваше хранилище состояний обязательно устареет на один тик — ровно там, где случится баг.

Тач устроен иначе, чем мышь: пальцев может быть несколько, и каждому нужен адрес. В Ebitengine адрес — это ebiten.TouchID, а полный словарь тач-ввода такой: ebiten.AppendTouchIDs дописывает в переданный срез идентификаторы всех активных касаний; ebiten.TouchPosition(id) возвращает позицию конкретного пальца парой int и (0, 0), если касание уже кончилось; inpututil.AppendJustPressedTouchIDs выделяет пальцы, коснувшиеся экрана именно в этом тике; inpututil.IsTouchJustReleased и inpututil.TouchPressDuration закрывают те же вопросы отпускания и длительности, что и для кнопок. Есть и тонкий прибор: inpututil.TouchPositionInPreviousTick возвращает позицию пальца в прошлом тике — разница текущей и прошлой позиций и есть скорость свайпа, а для пинч-зума берут расстояние между двумя пальцами и делят на него же из прошлого тика. Когда дробной точности не хватает — свайпы по сетке дрожат на усечении до пикселя, — в v2.10 появились TouchPositionF и TouchPositionFInPreviousTick: те же позиции в float64, без округления до целого. Официальный пример touch в репозитории движка собирает из этих примитивов жесты руками, и его пороги — полезные ориентиры: тап — касание, которое либо продержалось меньше тридцати тиков (при TPS 60 это около полусекунды), либо почти не съехало с точки касания; пан — одиночный палец, ушедший от точки касания; пинч — пара пальцев, чьё взаимное расстояние изменилось больше допустимой дельты.

Два практических замечания. Первое: мультитач — не экзотика, а две самые естественные жестовые механики, пинч и вращение, построены на втором пальце; держите идентификаторы в срезе и не предполагайте, что их всегда один. Второе — наследие: в пакете осталась функция TouchIDs, помеченная устаревшей с версии 2.2 — в новом коде используйте AppendTouchIDs, она переиспользует буфер и не создаёт мусор каждый тик. И не забудьте про телефон в целом: нативное мобильное приложение не имеет курсора, CursorPosition там всегда возвращает (0, 0), поэтому единственный живой ввод на телефоне — тач, и pointer() из этого урока — правильный каркас.

Вернёмся к координатам, потому что здесь спрятаны две тонкости, о которых лучше узнать из урока, а не из бага. Первая: до старта игрового цикла CursorPosition возвращает (0, 0) — спрашивать курсор в init бессмысленно, только из Update или позже. Вторая тонкость опаснее: если окно шире пропорций холста, движок при масштабировании оставляет поля — чёрные полосы слева и справа или сверху и снизу, и курсор над полем находится вне игровой области. При этом формула перевода в логические координаты поля не отбрасывает: над левой полосой x уедет в минус, над правой — за ширину холста. Движок честно отдаёт математически верное значение, а забота об отсечении — ваша: проверяйте, что координаты попадают в холст, прежде чем считать клик по миру.

Отсюда же мост к хит-тестам. Курсор — это точка, а игровой объект — прямоугольник: попадание точки в прямоугольник и станет основной операцией следующего урока про прямоугольники и позиции спрайта. Для окна и масштабов в целом — откуда берутся поля и как Layout дружит с окном — справочная база лежит в уроке про окно и холст; координаты курсора опираются на неё напрямую.

Соберём платформенную картину целиком. Десктоп: мышь — главный указатель, тач-ветка всегда пуста, клавиатура из прошлого урока рядом. Телефон: CursorPosition всегда нулевая, и всё поведение живёт на AppendTouchIDs с пальцами; клавиатура существует только как подключённая периферия. Браузер: тот же WASM-бинарник умеет и мышь, и тач — на десктопе работает первая ветка pointer(), на телефоне вторая. Правило, из которого вытекает вся архитектура ввода курса: не выясняйте, чем управляет игрок, — опрашивайте все источники параллельно и позвольте пустым веткам молчать. Тогда перенос игры на новую платформу не трогает логику вовсе: меняются лишь физические жесты, а Update остаётся тем же.

Остался третий источник ввода, который мы сознательно откладываем: геймпад. Движок умеет его честно, и приборы знакомы по этому уроку: ebiten.AppendGamepadIDs перечисляет подключённые устройства с их GamepadID, ebiten.GamepadName называет устройство по-человечески, ebiten.IsGamepadButtonPressed и inpututil.IsGamepadButtonJustPressed работают по тому же принципу «зажата против только что», что клавиши и кнопки мыши. Курсу геймпад не нужен до итоговой аркады, а механика опроса у него ровно та же, что вы уже знаете. Каркас ввода полный: вектор из клавиш, точка из курсора, пальцы со своими идентификаторами. Дальше по курсу эти три источника станут входами одного автомата состояний игры, но фундамент опроса останется именно этим.