Keyboard Input
SourcesEl bloque KeyboardInput permite el control manual en tiempo real de modelos de simulación mediante el teclado estándar (teclas de flechas o teclas WASD). Al hacer clic sobre el bloque en el lienzo se le otorga el foco del teclado; pulsar las teclas direccionales modifica dos salidas de coordenadas independientes ( e ). Colocar un bloque KeyboardInput sincroniza automáticamente el motor con el tiempo de reloj real, por lo que es ideal para simuladores de vuelo interactivos, teleoperación robótica, demostraciones interactivas e inyección manual de perturbaciones.
Modelo Matemático
El capturador de teclado interpreta las pulsaciones y liberaciones de teclas como estados direccionales discretos :
Las señales emitidas por los dos puertos de salida se escalan mediante el factor de ganancia gain ():
Cuando el usuario hace clic fuera del bloque, se desactiva la captura y ambos estados se restablecen de forma segura a cero ().
Entradas y Salidas
| Direction | ID | Label | Tipo | Status |
|---|---|---|---|---|
| ← Out | x |
X | number | Output |
| ← Out | y |
Y | number | Output |
Parámetros
| Parámetros | Label | Tipo | Por defecto | Descripción |
|---|---|---|---|---|
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 |
Ejemplos de Uso
Ejemplo 1: Control de aceleración y dirección de vehículo estilo videojuego
Teleoperación de un vehículo terrestre eléctrico simulado. El puerto proporciona el par motor con gain = 50.0 (Nm), mientras que el puerto comanda el ángulo de giro de la dirección con gain = 25.0 (grados). Pasar la señal del puerto por un bloque RateLimiter dota a la dirección de una respuesta suave y realista en lugar de transiciones bruscas.
Ejemplo 2: Inyección interactiva de perturbaciones dinámicas
Evaluación de la inmunidad a perturbaciones de un sistema de control bajo comando humano. Conexión del puerto mediante un bloque Gain de directamente al nudo de suma de fuerzas de un modelo de levitación magnética o péndulo invertido. Pulsar las flechas aplica impulsos calibrados para comprobar la estabilidad en tiempo real.
Observaciones y Buenas Prácticas
- Seguridad mediante activación por clic: El bloque requiere un clic directo para capturar el teclado. Al hacer clic fuera se desarma de inmediato la captura y se restablecen a cero las salidas, evitando teclas retenidas.
- Mapeo dual de teclas: Es compatible tanto con las teclas de flechas estándar como con las teclas WASD, ofreciendo ergonomía tanto a diestros como a zurdos.
- Suavizado mediante filtros dinámicos: Como las teclas generan escalones bruscos (), interconectar la salida con bloques
RateLimiter,TransferFunctionoLeadLaggenera respuestas analógicas suaves. - Sincronización automática en tiempo real: Incluir este bloque acopla la tasa del resolvedor 1:1 con el tiempo del sistema.
Bloques Relacionados
- Joystick2D: Control analógico continuo de dos ejes mediante ratón o pantalla táctil.
- Slider: Deslizador continuo lineal de un eje con vinculación a variables del proyecto.
- RateLimiter: Limita la rapidez de cambio de los comandos escalón del teclado.
- Constant: Fuente de señal escalar fija y no interactiva.