Trigger del mouse

I trigger del mouse consentono di associare l’input dei pulsanti e delle rotelle del mouse alle azioni di gioco.

Pulsanti del mouse

I pulsanti del mouse generano eventi pressed, released e repeated. Questo esempio mostra come rilevare l’input del pulsante sinistro del mouse (quando viene premuto o rilasciato):

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

Rotella del mouse

Gli input della rotella del mouse rilevano le azioni di scorrimento. Il campo action.value vale 1 se la rotella viene fatta scorrere e 0 altrimenti. (Le azioni di scorrimento vengono gestite come pressioni di pulsanti. Defold attualmente non supporta l’input di scorrimento preciso dei touchpad.)

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

Movimento del mouse

Il movimento del mouse viene gestito separatamente. Gli eventi di movimento del mouse vengono ricevuti solo se nei binding di input è configurato almeno un trigger del mouse.

Il movimento del mouse non viene associato nei binding di input: action_id viene impostato a nil e la tabella action viene popolata con la posizione del mouse e la variazione di tale posizione.

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

Trigger tattili

I trigger per tocchi singoli e multipli sono disponibili sui dispositivi iOS e Android nelle applicazioni native e nei bundle HTML5.

Tocco singolo

I trigger per tocchi singoli non si configurano nella sezione Touch Triggers dei binding di input. I trigger per tocchi singoli vengono invece configurati automaticamente quando configuri l’input di un pulsante del mouse per MOUSE_BUTTON_LEFT o MOUSE_BUTTON_1.

Tocchi multipli

I trigger per tocchi multipli popolano una tabella chiamata touch all’interno della tabella dell’azione. Gli elementi della tabella sono indicizzati con i numeri interi 1–N, dove N è il numero di punti di contatto. Ogni elemento della tabella contiene campi con i dati di input:

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

Rilevare clic o tocchi sugli oggetti

Rilevare quando l’utente fa clic o tocca un componente visivo è un’operazione molto comune, necessaria in molti giochi. Può trattarsi dell’interazione dell’utente con un pulsante o un altro elemento dell’interfaccia, oppure con un oggetto di gioco, come un’unità controllata dal giocatore in un gioco di strategia, un tesoro in un livello di un dungeon crawler o un personaggio che assegna missioni in un gioco di ruolo. L’approccio da usare varia a seconda del tipo di componente visivo.

Rilevare l’interazione con i nodi GUI

Per gli elementi dell’interfaccia è disponibile la funzione gui.pick_node(node, x, y), che restituisce true o false a seconda che la coordinata specificata rientri o meno nei limiti di un nodo GUI. Per saperne di più, consulta la documentazione API, l’esempio del puntatore sopra un nodo o l’esempio di un pulsante.

Rilevare l’interazione con gli oggetti di gioco

Per gli oggetti di gioco, rilevare l’interazione è più complicato, perché fattori come la traslazione della camera e la proiezione dello script di rendering influiscono sui calcoli necessari. Esistono due approcci generali per rilevare l’interazione con gli oggetti di gioco:

1. Tenere traccia della posizione e delle dimensioni degli oggetti di gioco con cui l’utente può interagire e verificare se la coordinata del mouse o del tocco rientra nei limiti di uno degli oggetti.
2. Collegare oggetti di collisione agli oggetti di gioco con cui l’utente può interagire, aggiungere un oggetto di collisione che segua il mouse o il dito e verificare le collisioni tra questi oggetti.

In entrambi i casi è necessario convertire le coordinate dell’evento del mouse o del tocco nello spazio dello schermo in coordinate nello spazio del mondo degli oggetti di gioco. Puoi farlo in diversi modi:

• Tenere traccia manualmente della vista e della proiezione utilizzate dallo script di rendering e usarle per convertire le coordinate da e verso lo spazio del mondo. Consulta il manuale della camera per un esempio.
• Usare una soluzione di terze parti per la camera e le funzioni di conversione dallo spazio dello schermo allo spazio del mondo che mette a disposizione.