⌨

Keyboard Input

Sources
Start het live voorbeeld Gratis · geen account · draait in je browser

Het KeyboardInput-blok maakt handmatige besturing van simulatiemodellen in real-time mogelijk via standaard toetsenbordinvoer (pijltjestoetsen of WASD). Door op het blok op het canvas te klikken wordt toetsenbordfocus geactiveerd; het indrukken van richtingstoetsen stuurt twee onafhankelijke uitgangssignalen aan (XX en YY). Het plaatsen van een KeyboardInput-blok schakelt de simulatie-engine automatisch over naar synchrone werkelijke tijd, waardoor het uitermate geschikt is voor interactieve vluchtsimulators, teleoperatie van robots, speelse demonstraties en handmatige storingsinjectie.

Wiskundig Model

De toetsenbordluisteraar vertaalt toets-indruk- en loslaat-gebeurtenissen naar discrete richtingswaarden sx(t),sy(t)∈{−1,0,1}s_x(t), s_y(t) \in \{-1, 0, 1\}:

sx(t)={−1,PijlLinks / A+1,PijlRechts / D0,anders,sy(t)={+1,PijlOmhoog / W−1,PijlOmlaag / S0,anderss_x(t) = \begin{cases} -1, & \text{PijlLinks / A} \\ +1, & \text{PijlRechts / D} \\ 0, & \text{anders} \end{cases}, \quad s_y(t) = \begin{cases} +1, & \text{PijlOmhoog / W} \\ -1, & \text{PijlOmlaag / S} \\ 0, & \text{anders} \end{cases}

De uitgangssignalen van de twee poorten aan de rechterzijde worden geschaald met de factor 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}

Wanneer de gebruiker elders op het canvas klikt, verliest het blok zijn focus en worden beide toestanden veilig gereset naar nul (sx=0,sy=0s_x = 0, s_y = 0).

Ingangen & Uitgangen

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

Parameters

Parameters Label Type Standaard Beschrijving
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

Gebruiksvoorbeelden

Voorbeeld 1: Voertuigbesturing en gasbediening in racestijl

Teleoperatie van een gesimuleerd elektrisch grondvoertuig. Poort yy levert het aandrijfkoppel met gain = 50.0 (Nm), terwijl poort xx de voorwielstuurhoek aanstuurt met gain = 25.0 (graden). Door poort xx door een RateLimiter-blok te leiden ontstaat een vloeiende, realistische stuurwieldynamica in plaats van abrupte stapsprongen.

Voorbeeld 2: Interactieve dynamische storingsinjectie

Beproeving van storingsonderdrukking van een regelsysteem onder menselijke interactie. Sluit poort yy via een Gain-blok van 10.010.0 rechtstreeks aan op het sommatiepunt van krachten in een magneetzweef- of omgekeerde slinger-model. Door op de pijltjestoetsen te tikken worden gekalibreerde krachtstoten toegebracht om de live stabilisatie te controleren.

Opmerkingen & Best Practices

  • Focusbeveiliging via klik: Het blok vereist een expliciete muisklik om toetsenbordinteractie te activeren. Klikken buiten het blok deactiveert de invoer direct en zet de uitgangen op nul, waardoor hangende toetsen worden voorkomen.
  • Dubbele toetsentoewijzing: Ondersteunt gelijktijdig standaard pijltjestoetsen en WASD-toetsen voor optimale ergonomie voor zowel links- als rechtshandigen.
  • Vloeiend maken met dynamische filters: Omdat toetsaanslagen discrete stapsprongen (±K\pm K) genereren, zorgt koppeling met een RateLimiter, TransferFunction of LeadLag-blok voor een natuurgetrouwe analoge respons.
  • Automatische real-time synchronisatie: Het invoegen van een KeyboardInput-blok koppelt de solver automatisch 1:1 aan de fysieke kloktijd.

Gerelateerde Componenten

  • Joystick2D: Continue twee-assige analoge joystickbediening via muis of touchscreen.
  • Slider: Eén-assige continue schuifregelaar met optionele variabelekoppeling.
  • RateLimiter: Begrenst de veranderingssnelheid van discrete toetsenbordstappen.
  • Constant: Vaste niet-interactieve signaalbron.