Déclencheurs de la souris

Les déclencheurs de la souris vous permettent d’associer les entrées des boutons et des molettes de la souris à des actions du jeu.

Boutons de la souris

Les boutons de la souris génèrent des événements pressed, released et repeated. Voici un exemple montrant comment détecter les entrées du bouton gauche de la souris (enfoncé ou relâché) :

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

Molette de la souris

Les entrées de la molette de la souris détectent les actions de défilement. Le champ action.value vaut 1 si la molette est tournée et 0 sinon. (Les actions de défilement sont traitées comme des pressions sur des boutons. Defold ne prend actuellement pas en charge les entrées de défilement de haute précision des pavés tactiles.)

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

Déplacement de la souris

Le déplacement de la souris est traité séparément. Les événements de déplacement de la souris ne sont reçus que si au moins un déclencheur de souris est configuré dans vos associations d’entrée.

Le déplacement de la souris n’est pas configuré dans les associations d’entrée, mais action_id est défini sur nil et la table action est remplie avec la position de la souris et la variation de cette position.

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

Déclencheurs tactiles

Les déclencheurs à un seul point de contact et les déclencheurs multitactiles sont disponibles sur les appareils iOS et Android dans les applications natives et les bundles HTML5.

Tactile à un seul point de contact

Les déclencheurs à un seul point de contact ne sont pas configurés dans la section Touch Triggers des associations d’entrée. Les déclencheurs à un seul point de contact sont configurés automatiquement lorsque vous avez configuré une entrée de bouton de souris pour MOUSE_BUTTON_LEFT ou MOUSE_BUTTON_1.

Multitactile

Les déclencheurs multitactiles remplissent une table appelée touch dans la table de l’action. Les éléments de cette table sont indexés par des nombres entiers de 1 à N, où N est le nombre de points de contact. Chaque élément de la table contient des champs avec les données d’entrée :

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

Détection des clics ou des appuis sur les objets

Détecter quand l’utilisateur a cliqué ou appuyé sur un composant (component) visuel est une opération très courante, nécessaire dans de nombreux jeux. Il peut s’agir d’une interaction avec un bouton ou un autre élément d’interface utilisateur, ou avec un objet de jeu (game object), tel qu’une unité contrôlée par le joueur dans un jeu de stratégie, un trésor dans un niveau de jeu d’exploration de donjons ou un donneur de quête dans un jeu de rôle. L’approche à utiliser varie selon le type de composant visuel.

Détection des interactions avec les nœuds GUI

Pour les éléments d’interface utilisateur, la fonction gui.pick_node(node, x, y) renvoie true ou false selon que les coordonnées spécifiées se trouvent ou non dans les limites d’un nœud GUI. Consultez la documentation de l’API, l’exemple de survol avec le pointeur ou l’exemple de bouton pour en savoir plus.

Détection des interactions avec les objets de jeu

Pour les objets de jeu, il est plus compliqué de détecter les interactions, car des éléments tels que la translation de la caméra et la projection du script de rendu influent sur les calculs nécessaires. Il existe deux approches générales pour détecter les interactions avec les objets de jeu :

1. Suivez la position et la taille des objets de jeu avec lesquels l’utilisateur peut interagir et vérifiez si les coordonnées de la souris ou du point de contact se trouvent dans les limites de l’un de ces objets.
2. Attachez des objets de collision aux objets de jeu avec lesquels l’utilisateur peut interagir, ajoutez un objet de collision qui suit la souris ou le doigt et vérifiez les collisions entre eux.

Dans les deux cas, il est nécessaire d’effectuer une conversion entre les coordonnées de l’événement de souris ou de contact dans l’espace écran et les coordonnées des objets de jeu dans l’espace monde. Vous pouvez procéder de différentes façons :

• Suivez manuellement la vue et la projection utilisées par le script de rendu et servez-vous-en pour effectuer la conversion vers et depuis l’espace monde. Consultez le manuel de la caméra pour un exemple.
• Utilisez une solution de caméra tierce et ses fonctions de conversion de l’espace écran vers l’espace monde.