Boutons d’arcade
Les boutons d’arcade permettent de disposer un ensemble de 6 ou 8 boutons en arc de cercle, dans le style des bornes d’arcade. Ils sont le plus souvent utilisés pour les jeux de combat.Propriétés
type - “arcadeButtons”lightKick - objet. Le bouton pour un coup de pied léger.mediumKick - objet. Le bouton pour un coup de pied moyen.heavyKick - objet. Le bouton pour un coup de pied puissant.specialKick - objet, facultatif. Le bouton pour un coup de pied spécial.lightPunch - objet. Le bouton pour un coup de poing léger.mediumPunch - objet. Le bouton pour un coup de poing moyen.heavyPunch - objet. Le bouton pour un coup de poing puissant.specialPunch - objet, facultatif. Le bouton pour un coup de poing spécial.
Chaque objet ci-dessus décrit un bouton avec les propriétés suivantes :
action - chaîne. Action(s) à appeler lorsqu’un joueur touche le bouton.
enabled - booléen, facultatif. Valeur par défaut : true. Définit l’état visuel du contrôle sur activé/désactivé. Un contrôle désactivé continue de recevoir les entrées du joueur, mais ne modifie PAS son style visuel en fonction de ces entrées.
toggle - booléen, facultatif. Valeur par défaut : false.
- Si
false, l’entrée du bouton est envoyée lorsqu’il est enfoncé, et non lorsqu’il ne l’est pas. - Si
true, chaque pression sur le bouton bascule l’envoi ou non de l’entrée pour la ou les actions correspondantes.
visible - booléen, facultatif. Valeur par défaut : true. Détermine si le contrôle est affiché au joueur pour qu’il puisse interagir avec. Pour le modifier en cours de jeu, consultez Modification des dispositions tactiles à l’aide de l’état du jeu.
styles - objet, facultatif. Personnalisation de la représentation visuelle du contrôle. Les styles sont représentés sous la forme d’un objet par état pouvant être stylisé.
Les états suivants du contrôle de bouton peuvent être stylisés :
default- Le style de base.disabled- Le style lorsque le contrôle est désactivé. S’il n’est pas spécifié, une transformation est appliquée au style par défaut lorsque le contrôle est désactivé pour lui donner un aspect désactivé.idle- Appliqué lorsque le joueur n’interagit PAS avec le contrôle.activated- Appliqué lorsque le joueur touche le bouton.
opacity - nombre, facultatif. L’opacité à appliquer au contrôle. Valeur par défaut : 1.0 pour tous les états sauf disabled.
faceImage - objet, facultatif. Peut être une icône ou une ressource image.
background - objet, facultatif. Peut être une couleur ou une ressource image. N’est pas visible dans les états inactif et désactivé.
Dimensions des ressources
Pour chacun des objets de style qui acceptent des ressources image, une ressource donnée doit être fournie à cinq niveaux de DPI : @1.0x, @1.5x, @2.0x, @3.0x et @4.0x. La résolution d’une image à un niveau de DPI donné doit être inférieure ou égale aux résolutions maximales suivantes :
Remarques
arcadebuttons vous permet de disposer un ensemble de boutons en un groupe de six ou huit, à la manière d’une borne d’arcade. Ce contrôle est optimisé pour les jeux de combat.
Il existe également un indicateur sur lequel le joueur peut appuyer, qui correspond à l’appui simultané sur tous les boutons de coup de poing ou de coup de pied.
arcadebuttons occupe davantage d’espace ; soyez donc attentif aux autres contrôles placés autour.
Remarques sur le style
Dans l’état activated, faceImage est affiché 25 % plus petit.
Des étiquettes et un style par défaut de la couleur d’arrière-plan sont prévus pour les boutons qui n’utilisent pas de ressources personnalisées et qui ont une action unique gamepadX, gamepadY, gamepadA ou gamepadB.
Exemples
Exemple 1 : Boutons d’arcade - six boutons
Figure 1. Boutons d’arcade
Exemple 2 : Boutons d’arcade - huit boutons
Figure 1. Boutons d’arcade à huit éléments
