Mis à jour pour la version 6.0.30
Deux types de variables servent à afficher une progression ou une attente : Pourcentage (un nombre de 0 à 100, comme une barre de vie) et Durée (un temps en secondes, comme un délai ou un chronomètre). Chacun a son panneau visuel pour régler la valeur, et ils se branchent partout où un nombre est attendu, y compris dans une Jauge simple de menu.
Le navigateur de variables avec une variable Pourcentage sélectionnée, le panneau de la jauge à droite
À quoi ça sert
| Type | Valeur | Exemples d'usage |
|---|---|---|
| Pourcentage | Un nombre de 0 à 100 | Barre de vie, progression d'une formation, taux de réussite |
| Durée | Un temps en secondes (jamais négatif) | Délai d'attente, temps imparti, chronomètre |
Un Nombre ordinaire n'a pas de bornes. Un Pourcentage reste entre 0 et 100, et une Durée reste positive : c'est ce qui les rend plus sûrs pour une jauge ou un minuteur.
Où trouver ces types
- Ouvrez la liste des variables et cliquez sur Ajouter variable.
- Donnez un nom, puis ouvrez le menu Type de la variable (ne peut pas être changé).
- Choisissez Pourcentage (« Un nombre de 0 à 100, comme une jauge de santé ou un taux de réussite ») ou Durée (« Un temps en secondes, comme un chronomètre ou un délai d'attente »).
- Cliquez sur Ajouter.
⚠ Attention : le type d'une variable ne peut pas être changé après sa création. Si vous vous trompez, créez une nouvelle variable.
Le panneau visuel règle la valeur initiale, c'est-à-dire la valeur de départ au lancement du graphe. Tant que la variable n'a pas de valeur, le panneau propose de la créer (Ajouter un pourcentage ou Ajouter une durée).
Pourcentage
Le panneau Pourcentage avec la valeur en grand, le niveau, la jauge, les valeurs rapides et le champ.
Le panneau affiche la valeur en grand (par exemple « 50 % ») avec un niveau : Faible sous 25, Moyen de 25 à moins de 75, Élevé à partir de 75. Une phrase rappelle l'état : « En ce moment, Vie est à 50 %. »
Pour changer la valeur :
- cliquez sur la jauge, ou faites-la glisser ;
- cliquez sur une valeur rapide : 0, 25, 50, 75 ou 100 ;
- tapez un nombre dans le champ, ou utilisez les boutons Diminuer et Augmenter (un pas de 1 par défaut, 10 en maintenant Maj).
Les flèches du clavier fonctionnent sur la jauge (touches Début et Fin pour aller à 0 et à 100) et dans le champ. Une valeur hors de la plage est ramenée à 0 ou à 100. Si le champ est vide, la variable garde sa valeur précédente jusqu'à ce que vous tapiez un nombre.
Durée
Le panneau Durée avec les champs Jours, Heures, Minutes, Secondes et les durées courantes
Le panneau affiche la durée lisible (« 1 min 30 s »), son total en secondes et quatre champs : Jours, Heures, Minutes, Secondes. Les secondes acceptent des décimales, jusqu'à la milliseconde. Les quatre champs s'additionnent : 90 secondes et 1 minute 30 secondes sont la même durée, et le panneau les réécrit sous la forme la plus courte.
Sous les champs, Durées courantes propose cinq boutons : 5 s, 30 s, 1 min, 5 min et 1 h. Les boutons plus et moins de chaque champ changent la valeur de 1 (de 10 en maintenant Maj).
Une durée ne peut pas être négative : une valeur négative n'est pas gardée et le panneau le dit (« Une durée ne peut pas être négative, cette valeur n'a donc pas été gardée »). Le maximum est de 10 000 jours.
Utiliser ces variables dans les blocs
Pourcentage et Durée appartiennent à la famille des nombres : ils se branchent là où un Nombre est attendu, et un Nombre se branche là où ils sont attendus.
- Les blocs Incrémentation, Décrémentation et Assignation peuvent les modifier.
- Une Durée se branche sur les entrées qui lisent un nombre, par exemple la Durée du bloc Pause, le minuteur d'un bloc QTE ou le délai d'une Notification.
- Un Pourcentage se branche sur les opérandes d'une Expression et dans les emplacements d'un bloc Formater texte. Il ne se branche pas directement sur une entrée Booléen ou Texte : passez par une Expression.
- Quand un bloc écrit un nombre dans une variable Pourcentage pendant l'exécution, le résultat est ramené entre 0 et 100. Un Pourcentage écrit dans une variable Nombre devient un simple nombre.
- Une Durée ne peut pas servir d'élément dans une liste ; un Pourcentage le peut.
Pour les calculs, lisez ➗ Opérations mathématiques, et pour comparer des valeurs 🔢 Mettre en place des conditions numériques.
Une jauge de menu pilotée par une variable
L'élément de menu Jauge simple affiche une barre de progression (une option PRO).
- Dans l'éditeur de menu, cliquez sur Ajouter un élément.
- Dans Choisir l'élément à ajouter, choisissez Jauge simple.
- Dans Variable, choisissez la variable à afficher, par exemple un Pourcentage.
- Réglez Minimum et Maximum.
- Ajustez Apparence, Couleur, Afficher la valeur et Apparence du texte.
L'éditeur de la Jauge simple avec les champs Variable, Minimum et Maximum
Les bornes Minimum et Maximum valent 0 et 100 par défaut, ce qui convient tel quel à un Pourcentage. Chaque borne peut être un nombre fixe ou une variable de la famille Nombre : dès qu'une variable est liée, le champ numérique disparaît. La jauge suit alors la valeur de cette variable. Ainsi, un maximum lié à une Durée « Temps imparti » adapte la jauge à chaque épreuve.
À savoir sur le comportement :
- si la variable d'une borne a été supprimée, la jauge reprend le nombre fixe ;
- si le maximum est égal au minimum, la jauge est vide ; gardez un maximum supérieur au minimum ;
- sans variable liée, la jauge s'affiche à moitié ;
- avec Afficher la valeur, le texte montre la valeur brute (60, et non 60 %).
Exemples
Une barre de vie. Créez un Pourcentage « Vie » à 100. Ajoutez une Jauge simple liée à « Vie », avec Minimum 0 et Maximum 100. Un bloc Décrémentation retire des points à chaque coup reçu, et la jauge descend avec lui. La valeur ne passe pas sous 0 : pendant la partie, un Pourcentage est toujours ramené entre 0 et 100.
Un temps imparti. Créez une Durée « Temps imparti » à 30 s avec le bouton de durée courante, puis branchez-la sur la Durée d'un bloc Pause ou sur le minuteur d'un bloc QTE.
Dépannage
| Symptôme | Solution |
|---|---|
| Je ne peux pas changer le type de ma variable | Le type est définitif : créez une nouvelle variable du bon type |
| Ma valeur reste à 100 alors que j'ai tapé plus | Un Pourcentage est borné à 100 : la valeur est ramenée à la limite |
| La valeur négative est refusée | Une Durée n'est jamais négative : tapez 0 ou un nombre positif |
| Mon champ vide ne change rien | La variable garde sa valeur tant qu'aucun nombre n'est tapé |
| Ma jauge est vide | Vérifiez que le maximum est supérieur au minimum |
| Je ne trouve pas la Jauge simple | C'est un élément PRO : il demande un abonnement qui l'inclut |