⌨

Keyboard Input

Sources
Lancer l’exemple en direct Gratuit · sans inscription · dans votre navigateur

Le bloc KeyboardInput permet le pilotage manuel en temps réel de modèles de simulation à l'aide des entrées clavier standard (touches fléchées ou touches ZQSD/WASD). Un clic sur le bloc dans le canevas lui attribue le focus clavier ; l'enfoncement des touches directionnelles modifie deux sorties de coordonnées indépendantes (XX et YY). L'insertion d'un bloc KeyboardInput bascule automatiquement le moteur de calcul en synchronisation avec le temps réel, ce qui le rend idéal pour les simulateurs de vol interactifs, la téléopération robotique, les démonstrations de jeux et l'injection manuelle de perturbations.

Modèle Mathématique

Le gestionnaire d'événements clavier traduit les appuis et relâchements de touches en états directionnels discrets sx(t),sy(t)∈{−1,0,1}s_x(t), s_y(t) \in \{-1, 0, 1\} :

sx(t)={−1,FleˋcheGauche / A+1,FleˋcheDroite / D0,sinon,sy(t)={+1,FleˋcheHaut / W−1,FleˋcheBas / S0,sinons_x(t) = \begin{cases} -1, & \text{FlècheGauche / A} \\ +1, & \text{FlècheDroite / D} \\ 0, & \text{sinon} \end{cases}, \quad s_y(t) = \begin{cases} +1, & \text{FlècheHaut / W} \\ -1, & \text{FlècheBas / S} \\ 0, & \text{sinon} \end{cases}

Les signaux de sortie émis par les deux ports droits sont pondérés par le facteur gain (KK) :

xout(t)=K⋅sx(t)yout(t)=K⋅sy(t)\begin{aligned} x_{\text{out}}(t) &= K \cdot s_x(t) \\ y_{\text{out}}(t) &= K \cdot s_y(t) \end{aligned}

Lorsque l'utilisateur clique en dehors du bloc, la capture clavier est désarmée et les deux états reviennent immédiatement à zéro (sx=0,sy=0s_x = 0, s_y = 0).

Entrées & Sorties

Direction ID Label Type Status
← Out x X number Output
← Out y Y number Output

Paramètres

Paramètres Label Type Défaut Description
keyX X State number 0 -1 (left/A), 0, or 1 (right/D) — written by the keyboard listener
keyY Y State number 0 -1 (down/S), 0, or 1 (up/W) — written by the keyboard listener
gain Gain number 1 Output scale: out = key state × gain

Exemples d'Utilisation

Exemple 1 : Contrôle de direction et d'accélération façon jeu vidéo

Téléopération d'un véhicule électrique simulé. Le port yy fournit le couple d'entraînement avec gain = 50.0 (Nm), tandis que le port xx commande l'angle de braquage des roues avant avec gain = 25.0 (degrés). Faire passer la sortie xx par un bloc RateLimiter adoucit la dynamique de braquage pour un ressenti fluide.

Exemple 2 : Injection interactive de perturbations dynamiques

Évaluation de la réjection des perturbations d'un asservissement sous commande humaine. Raccordement du port yy via un bloc Gain de 10.010.0 directement sur le sommateur de forces d'un modèle de lévitation magnétique ou de pendule inversé. Taper brièvement sur les touches fléchées applique des impulsions calibrées pour tester la stabilité.

Remarques & Bonnes Pratiques

  • Sécurité d'armement par clic : Le bloc requiert un clic explicite pour capturer les frappes du clavier. Cliquer ailleurs désactive instantanément l'écoute et remet les sorties à zéro, évitant tout blocage d'état.
  • Double cartographie de touches : Prise en charge simultanée des flèches de direction et des touches WASD/ZQSD pour s'adapter à toutes les préférences de saisie.
  • Lissage par filtres dynamiques : Les touches générant des échelons discontinus (±K\pm K), l'utilisation en aval d'un bloc RateLimiter, TransferFunction ou LeadLag permet de reconstituer une réponse analogique continue.
  • Cadencement temps réel automatique : L'ajout de ce bloc synchronise immédiatement le solveur sur l'horloge système réelle.

Composants Associés

  • Joystick2D : Commande analogique continue à deux axes via souris ou écran tactile.
  • Slider : Curseur linéaire continu à axe unique avec couplage optionnel aux variables.
  • RateLimiter : Limite la vitesse de variation des échelons discrets issus du clavier.
  • Constant : Source de signal scalaire fixe et statique.