Триггеры мыши

Триггеры мыши позволяют привязать ввод от кнопок мыши и колеса прокрутки к игровым действиям.

Кнопки мыши

Кнопки мыши генерируют события нажатия, отпускания и повтора. Пример, показывающий, как обнаружить ввод для левой кнопки мыши (нажата или отпущена):

function on_input(self, action_id, action)
    if action_id == hash("mouse_button_left") then
        if action.pressed then
            -- left mouse button pressed
        elseif action.released then
            -- left mouse button released
        end
    end
end

Колесико мыши

Вводы колесика мыши определяют действия прокрутки. Поле action.value равно 1, если колесико прокручено, и 0 в противном случае. (Действия прокрутки обрабатываются так же, как нажатия кнопок. В настоящее время Defold не поддерживает тонкий ввод прокрутки на тачпадах).

function on_input(self, action_id, action)
    if action_id == hash("mouse_wheel_up") then
        if action.value == 1 then
            -- mouse wheel is scrolled up
        end
    end
end

Движение мыши

Движение мыши обрабатывается отдельно. События движения мыши не принимаются, если в привязках ввода не установлен хотя бы один триггер мыши.

Движение мыши не привязано к input bindings, но action_id устанавливается в nil, а таблица action заполняется координатами и дельтой перемещения позиции мыши.

function on_input(self, action_id, action)
    if action.x and action.y then
        -- let game object follow mouse/touch movement
        local pos = vmath.vector3(action.x, action.y, 0)
        go.set_position(pos)
    end
end

Сенсорные триггеры

Триггеры типа Single-touch и Multi-touch доступны на устройствах iOS и Android в нативных приложениях и в пакетах HTML5.

Single-touch

Триггеры типа single-touch не настраиваются в разделе Touch Triggers в input bindings. Вместо этого single-touch триггеры автоматически настраиваются, когда у вас настроен ввод кнопки мыши для MOUSE_BUTTON_LEFT или MOUSE_BUTTON_1.

Multi-touch

Триггеры типа multi-touch заполняют таблицу touch внутри таблицы действий. Элементы этой таблицы индексируются целыми числами 1–N, где N — количество точек касания. Каждый элемент таблицы содержит поля с входными данными:

function on_input(self, action_id, action)
    if action_id == hash("touch_multi") then
        -- Spawn at each touch point
        for i, touchdata in ipairs(action.touch) do
            local pos = vmath.vector3(touchdata.x, touchdata.y, 0)
            factory.create("#factory", pos)
        end
    end
end

Обнаружение клика или касания на объектах

Определение момента, когда пользователь кликнул или коснулся визуального компонента, является очень распространённой задачей, необходимой во многих играх. Это может быть взаимодействие пользователя с кнопкой или другим элементом интерфейса либо взаимодействие с игровым объектом, например с управляемым юнитом в стратегической игре, сокровищем на уровне в dungeon crawler или квестодателем в RPG. Подход зависит от типа визуального компонента.

Обнаружение взаимодействия с GUI-узлами

Для элементов интерфейса существует функция gui.pick_node(node, x, y), которая возвращает true или false в зависимости от того, находится ли указанная координата в границах GUI-узла. Подробнее см. в документации API, примере pointer over или примере button.

Обнаружение взаимодействия с игровыми объектами

Для игровых объектов обнаружить взаимодействие сложнее, поскольку на необходимые вычисления влияют такие вещи, как смещение камеры и проекция render script. Существует два основных подхода к обнаружению взаимодействия с игровыми объектами:

1. Отслеживать положение и размер игровых объектов, с которыми может взаимодействовать пользователь, и проверять, находится ли координата мыши или касания в границах одного из объектов.
2. Прикрепить collision object к игровым объектам, с которыми пользователь может взаимодействовать, а также один collision object, следующий за мышью или пальцем, и проверять столкновения между ними.

В обоих случаях нужно преобразовать координаты мыши или события касания из экранного пространства в мировые координаты игровых объектов. Это можно сделать несколькими способами:

• Вручную отслеживать, какие view и projection используются render script, и применять их для преобразования в мировое пространство и обратно. Пример см. в руководстве по камере.
• Использовать стороннее решение камеры и воспользоваться предоставляемыми им функциями преобразования из экранных координат в мировые.