Croix directionnelle
Contrôle de croix directionnelle qui correspond toujours à la croix directionnelle de la manette.Propriétés
type - “directionalPad”. Spécifie le type de contrôle.
scale - nombre, facultatif. La valeur par défaut est 1. Multiplicateur de taille, utile puisque les croix directionnelles sont placées comme des boutons et ne sont pas mises à l’échelle automatiquement comme les manettes de jeu.
deadzone - nombre, facultatif. Valeur comprise entre 0 et 1 qui spécifie la taille de la zone morte en pourcentage du contrôle. Notez que, contrairement à la zone morte des manettes de jeu, les zones mortes de la croix directionnelle sont toujours axiales (carrées).
enabled - booléen, facultatif. La valeur par défaut est true. Définit l’état visuel du contrôle comme activé/désactivé. Un contrôle désactivé recevra toujours les entrées du joueur, mais ne modifiera PAS son style visuel en fonction de ces entrées.
visible - booléen, facultatif. La valeur par défaut est true. Détermine si le contrôle est affiché au joueur pour qu’il puisse interagir avec celui-ci. Pour le modifier pendant le 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 forme d’un objet par état pouvant être stylisé.
interaction - objet, facultatif. Définitions de propriétés qui peuvent modifier les mécanismes d’interaction de l’utilisateur avec le contrôle
Interaction
activationType - chaîne, facultatif. Définit le type d’activation autorisé pour une direction donnée lors de l’interaction avec la croix directionnelle. La valeur par défaut est allowNeighboring. Avec exclusive, une seule direction peut être activée à la fois sur la croix directionnelle (c.-à-d. une seule parmi « Haut », « Droite », « Bas » ou « Gauche »). Avec allowNeighboring, une direction et l’une ou l’autre de ses directions voisines peuvent être activées simultanément en touchant entre elles (c.-à-d. que l’utilisateur peut activer « Haut+Droite », « Droite+Bas », « Bas+Gauche » ou « Gauche+Haut » en touchant entre chacune d’elles, en plus de pouvoir activer chaque direction individuellement).
États et propriétés de style
Les états suivants du contrôle de croix directionnelle 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é afin qu’il paraisse 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. La valeur par défaut est 1.0 pour tous les états, sauf disabled.
fill - objet, facultatif. Objet comportant une couleur définie pour le dégradé à utiliser lorsque la croix directionnelle est activée.
gradient - objet, facultatif. Objet comportant une couleur définie pour le dégradé à utiliser lorsque la croix directionnelle est activée.
background - objet, facultatif. Peut être soit une couleur, soit une ressource d’image.
stroke - objet, facultatif. Couleur à utiliser pour le contour de la croix directionnelle. Doit être un objet stroke.
Dimensions des ressources
Pour chacun des objets de style qui acceptent des ressources d’image, une ressource donnée est fournie à une résolution de base et à des échelles de 1.5x, 2.0x, 3.0x et 4.0x de cette résolution de base. La résolution d’une image donnée doit être inférieure ou égale aux résolutions maximales suivantes :
Remarques
La croix directionnelle sert à offrir une expérience semblable à celle de la croix directionnelle de la manette physique. Si elle est utilisée comme principal mécanisme de déplacement du joueur (normalement dans l’emplacementleft inner), il est recommandé d’utiliser une échelle de 2.
Remarques sur le style
Si vous utilisez une ressource d’image personnalisée pour background, les résolutions maximales indiquées s’appliquent pour scale=1.0. Si vous utilisez une autre échelle, les résolutions maximales seront égales au produit de la résolution et de l’échelle. Par exemple, scale=1.5 implique qu’une image d’arrière-plan à @1.0x PPP peut avoir une résolution maximale de 90x90.
Exemples
Exemple 1 : Croix directionnelle par défaut
Figure 1. Croix directionnelle
Exemple 2 : Croix directionnelle plus grande avec des couleurs personnalisées.
Figure 1. Croix directionnelle personnalisée