Descripción detallada
En este módulo se incorporan todas las funciones relacionadas con los controles. En LuaDEV, no es necesario guardar variables con los controles actuales y los anteriores, pues ya se realiza internamente. Para comprobar si los botones están presionados en el momento se usará controls.xxxx(), si se desea comprobar si recién se pulsaron, controls.press("xxxx"), y para comprobar si recién se soltaron controls.release("xxxx") . En cada ciclo se usará un sólo controls.read() . Véase el ejemplo de los controles.
Documentación de las funciones
Realiza la lectura de los controles.
- Devuelve:
- Nada.
D-PAD arriba.
- Devuelve:
- True / false. Según si está presionado arriba en el D-PAD.
| boolean controls.down |
( |
|
) |
|
D-PAD abajo.
- Devuelve:
- True / false. Según si está presionado abajo en el D-PAD.
| boolean controls.right |
( |
|
) |
|
D-PAD derecha.
- Devuelve:
- True / false. Según si está presionado derecha en el D-PAD.
| boolean controls.left |
( |
|
) |
|
D-PAD izquierda.
- Devuelve:
- True / false. Según si está presionado izquierda en el D-PAD.
Botón L.
- Devuelve:
- True / false. Según si está presionado el botón L.
Botón R.
- Devuelve:
- True / false. Según si está presionado el botón R.
| boolean controls.triangle |
( |
|
) |
|
Botón triángulo.
- Devuelve:
- True / false. Según si está presionado el botón triángulo.
| boolean controls.circle |
( |
|
) |
|
Botón círculo.
- Devuelve:
- True / false. Según si está presionado el botón círculo.
| boolean controls.cross |
( |
|
) |
|
Botón cruz.
- Devuelve:
- True / false. Según si está presionado el botón cruz.
| boolean controls.square |
( |
|
) |
|
Botón cuadrado.
- Devuelve:
- True / false. Según si está presionado el botón cuadrado.
| boolean controls.home |
( |
|
) |
|
Botón Home.
- Devuelve:
- True / false. Según si está presionado el botón Home.
| boolean controls.hold |
( |
|
) |
|
Hold. (Bloqueo de controles).
- Devuelve:
- True / false. Según si está activado el Hold.
| boolean controls.start |
( |
|
) |
|
Botón Start.
- Devuelve:
- True / false. Según si está presionado el botón Start.
| boolean controls.select |
( |
|
) |
|
Botón Select.
- Devuelve:
- True / false. Según si está presionado el botón Select.
| boolean controls.wlan |
( |
|
) |
|
Interruptor Wlan.
- Devuelve:
- True / false. Según si está activado el interruptor WLAN.
| number controls.analogx |
( |
|
) |
|
Joystick analógico, eje X.
- Devuelve:
- Un número del rango: (-128: izquierda, +127: derecha).
| number controls.analogy |
( |
|
) |
|
Joystick analógico, eje Y.
- Devuelve:
- Un número del rango: (-128: arriba, +127: abajo).
| boolean controls.press |
( |
string |
key |
) |
|
Botón recién pulsado.
- Parámetros:
-
| key | Un string de entre los siguientes:
"up" D-PAD arriba. "down" D-PAD abajo. "left" D-PAD izquierda. "right" D-PAD derecha. "l" Botón L. "r" Botón R. "triangle" Botón triángulo. "cross" Botón cruz. "circle" Botón círculo. "square" Botón cuadrado. "start" Botón start. "select" Botón select. "hold" Interruptor Hold. "home" Botón Home.
|
- Devuelve:
- True / false según si el botón está recién pulsado.
| boolean controls.release |
( |
string |
key |
) |
|
Botón recién soltado.
- Parámetros:
-
| key | Un string de entre los siguientes:
"up" D-PAD arriba. "down" D-PAD abajo. "left" D-PAD izquierda. "right" D-PAD derecha. "l" Botón L. "r" Botón R. "triangle" Botón triángulo. "cross" Botón cruz. "circle" Botón círculo. "square" Botón cuadrado. "start" Botón start. "select" Botón select. "hold" Interruptor Hold. "home" Botón Home.
|
- Devuelve:
- True / false según si el botón está recién soltado.
| number controls.waitforkey |
( |
|
) |
|
Espera hasta pulsar cualquier botón.
LuaDEV detendrá su ejecución hasta que se presione cualquier botón, y devolverá el botón presionado.
- Devuelve:
- Un número de entre los siguientes:
- 1 (Botón select)
- 4 (Botón start)
- 5 (D-PAD arriba)
- 6 (D-PAD derecha)
- 7 (D-PAD abajo)
- 8 (D-PAD izquierda)
- 9 (Botón L)
- 10 (Botón R)
- 13 (Triángulo)
- 14 (Círculo)
- 15 (Cruz)
- 16 (Cuadrado)
- 17 (Home)
- 18 (Hold)
| nil controls.homepopup |
( |
int |
activado |
) |
|
Habilita / deshabilita el mensaje de Home (Salir del juego).
- Parámetros:
-
| activado | Uno de los siguientes:
- 0 - Deshabilitar el menú "Salir del juego".
- 1 - Habilitar el menú "Salir del juego".
|
- Devuelve:
- Nada.
- Excepciones:
-
| En | HBL, esta función no hace nada. |
| nil controls.analogtodigital |
( |
int |
distancia |
) |
|
Conversor joystick analógico -> digital.
El joystick recibe valores entre -128 y 127. Con esta función, haremos que pasada cierta distancia desde el centro (0), se active también su homólogo en el D-PAD. Es decir, si aplicamos una distancia de 60, al mover el joystick analógico en cualquier dirección, a partir de mas o menos la mitad del recorrido se activará su homólogo. Por ejemplo, si movemos el joystick analógico hacia arriba y izquierda, controls.up() y controls.left() darán también true.
Para volver a desactivar el conversor, utilizar distancia = 0.
- Parámetros:
-
| distancia | Distancia a partir de la cual se activará el D-PAD correspondiente. |
- Devuelve:
- Nada.
