Sélectionnez votre langue

"Je suis pour l'égalité des sexes, je prendrai moi-même les mesures."
Thierry Le Luron

L'objectif de ce tutoriel est de découvrir le détecteur d'évènement souris.
Nous allons faire en sorte que le personnage saute quand on clique dessus.

***

Version utilisée pour la rédaction de ce tuto (cf barre d'état) :

"UPBGE v0.3 Alpha (based on Blender v2.83.13)"


Conventions :
Les touches du clavier et les boutons de la souris sont indiqués entre '[' et ']'.
Les parcours à suivre dans l'interface utilisent '>' comme séparateur.
Quelques exemples :

[A] : touche 'A'.
[Num .] : '.' sur le pavé numérique.
[BGS] : Bouton Gauche de la Souris.
[BMS] : Bouton du Milieu de la Souris (il est possible de cliquer avec la molette !).
[BDS] : Bouton Droit de la Souris.
[Maj]+[BDS] : maintenir la touche Majuscule enfoncée et cliquer avec le Bouton Droit de la Souris.
File > Save : menu "File", puis item de menu "Save".


Notre point de départ sera le fichier obtenu à la fin du tuto précédent :

clavier.blend (748 Kio)

Si vous n'avez pas suivi le tuto précédent, téléchargez le fichier.
Ouvrez le fichier :
File > Open...

***

Pour enregistrer le fichier, faites dans le menu principal :
File > Save As...,
choisissez le dossier où vous souhaitez enregistrer, puis cliquez dans la ligne de saisie contenant "clavier.blend", tapez le nom sous lequel vous souhaitez enregistrer le fichier ("souris", par exemple) et validez la saisie avec [Entrée] (l'extension ".blend" est ajoutée automatiquement).
Enfin validez l'enregistrement avec [Entrée].
Par la suite, pensez à enregistrer de temps en temps, il suffira de faire :
File > Save.
En fait, la version de UPBGE utilisée ici étant marquée "Alpha", elle est potentiellement instable, il est donc fortement recommandé d'enregistrer souvent (raccourci clavier : [Ctrl]+[S]) !

***

Suzanne doit être sélectionnée (contour orange), si ce n'est pas le cas, faites [BGS].

Dans le "Logic Editor" (zone du bas), ajoutez un détecteur d'évènement souris :
Add Sensor > Mouse

Capture d'écran : Add Sensor - Mouse


Dans la liste déroulante "Mouse Event" située en bas du bloc que vous venez d'ajouter, sélectionnez "Mouse Over".
Ce détecteur se déclenche lorsque le curseur souris survole l'objet.
Le bloc a été nommé "Mouse" par défaut, renommez-le "Survol" :

Capture d'écran : Mouse Over - Survol


Ajoutez un deuxième détecteur d'évènement souris :
Add Sensor > Mouse
Cette fois, laissez à "Mouse Event" sa valeur par défaut, "Left Button".
Ce détecteur se déclenche lorsque le bouton gauche de la souris est activé.
Le bloc a été nommé "Mouse" par défaut, renommez-le "Bouton G".

Tout comme nous avons été amenés à activer le bouton "Tap" pour le détecteur "Espace" (cf Tuto 1), il nous faut activer "Tap" pour "Bouton G" (le contrôleur ne sera activé qu'un instant, même si le détecteur reste actif) :

Capture d'écran : Tap


Ajoutez un contrôleur :
Add Controller > And
Repliez ce bloc contrôleur en cliquant sur son icone "Expanded" en haut à gauche.

Ajoutez un connecteur entre "Survol" et le contrôleur.
Ajoutez un connecteur entre "Bouton G" et le contrôleur.
Ce nouveau contrôleur sera activé si "Survol" et "Bouton G" sont activés.

Enfin ajoutez un connecteur entre le contrôleur et l'action "Sauter" :

Capture d'écran : Logic Editor

Notons qu'il y a, dans ce que nous avons mis en place, ce que nous pourrions appeler un "ou implicite". En effet, 2 chemins mènent à l'action "Sauter". Suzanne saute si on presse [Espace] ou si on clique dessus.

Il ne reste plus qu'à demander à afficher le curseur souris lorsque le jeu est lancé :
Properties > Render Properties > Game Debug > [x] Mouse Cursor

Capture d'écran : Mouse Cursor


Vous pouvez lancer le jeu pour tester :
Properties > Render Properties > Game Resolution > Standalone Start

Voici le fichier final :

souris.blend (749 Kio)