Joystick 2D
SourcesEl bloque Joystick2D proporciona un control interactivo de palanca de mando de dos ejes sobre el lienzo que permite el gobierno multivariable simultáneo durante la simulación en tiempo real. Al arrastrar el mando circular se generan señales coordinadas de desviación bidimensional (horizontal y vertical ), lo que resulta idóneo para controlar la actitud de drones (alabeo y cabeceo), la velocidad y ángulo de dirección de robots móviles, gimbals de cámara o fuerzas perturbadoras en dos ejes. Dispone de limitación radial al círculo unidad, ganancia de escala configurable y retorno elástico opcional al centro al soltar el control.
Modelo Matemático
El usuario arrastra el control sobre el lienzo a las coordenadas de desplazamiento . El vector de deflexión normalizado se limita radialmente al círculo unidad:
Las señales emitidas por los dos puertos de salida ( e ) se escalan mediante la ganancia gain ():
Cuando springReturn = true, al soltar el botón del ratón o el contacto táctil, las coordenadas de deflexión vuelven inmediatamente al origen:
Cuando springReturn = false, el mando conserva su última posición fijada.
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 |
|---|---|---|---|---|
valueX |
X Value | number | 0 |
Current X deflection — written by the on-canvas knob. Bounded with Y to the unit circle (|(x,y)| ≤ 1). |
valueY |
Y Value | number | 0 |
Current Y deflection — written by the on-canvas knob. Bounded with X to the unit circle (|(x,y)| ≤ 1). |
gain |
Gain | number | 1 |
Output scale: out = deflection × gain |
springReturn |
Spring Return | boolean | true |
Snap the knob back to (0,0) when released |
Ejemplos de Uso
Ejemplo 1: Control manual de alabeo y cabeceo de un cuadricóptero
Gobierno interactivo de ángulos de orientación de un dron. Configuración de gain = 30.0 (grados) y springReturn = true. Conectando el puerto a la consigna de alabeo y el puerto a la consigna de cabeceo, el operador pilota el dron en simulación en vivo; al soltar el mando, el vehículo recupera la horizontalidad.
Ejemplo 2: Teleoperación de robot móvil con tracción diferencial
Control a distancia de un vehículo terrestre autónomo. El puerto suministra la velocidad lineal de avance () con gain = 2.0 (m/s), mientras que el puerto comanda la velocidad angular de guiñada () con gain = 1.5 (rad/s). Al soltar la palanca, el vehículo se detiene de forma segura.
Observaciones y Buenas Prácticas
- Limitación radial al círculo unidad: Las deflexiones diagonales quedan confinadas a una norma máxima , previniendo la saturación artificial en esquinas ().
- Sincronización automática en tiempo real: La inclusión de un bloque Joystick2D acopla de inmediato la velocidad de simulación al tiempo de reloj real para garantizar una respuesta táctil natural.
- Retorno elástico vs. retención de consigna: Desactivar el resorte (
springReturn = false) es útil para aceleradores continuos o puntos de consigna que no deben restablecerse al soltar el ratón. - Compatibilidad táctil y ratón: Diseñado para responder con total fluidez tanto en entornos de escritorio como en pantallas táctiles de tabletas.
Bloques Relacionados
- Slider: Deslizador lineal interactivo de un solo eje.
- KeyboardInput: Control de señales mediante teclas de flechas o WASD.
- XYPlot: Visualización de trayectorias bidimensionales y retratos de fase.
- Gain: Escalado independiente de canales de señal individuales.