DESCRIPTION.

La fonction ADVAL() retourne des renseignements sur les joysticks, le clavier et les canaux sonores.

SYNTAXE.

kposition = ADVAL( valeur )

REMARQUES.

valeur doit être un nombre entier. valeur peut valoir :

- -8, renvoie le nombre d'octets libres dans la file d'attente SOUND du canal 3 ;

- -7, renvoie le nombre d'octets libres dans la file d'attente SOUND du canal 2 ;

- -6, renvoie le nombre d'octets libres dans la file d'attente SOUND du canal 1 ;

- -5, renvoie le nombre d'octets libres dans la file d'attente SOUND du canal 0 ;

- -1, renvoie le nombre d'espaces libres dans le tampon clavier ;

- 0, renvoie l'état des quatre boutons du joystick ;

- 1, renvoie la position X du joystick ;

- 2, renvoie la position Y du joystick ;

- 3, renvoie la position Z du joystick ;

Avec valeur allant de -8 à -5, si la file d'attente est vide, la fonction ADVAL() retourne 16 et 0 si elle est pleine. Remarque, chaque événement sonore utilise 4 octets.

Avec valeur = 1, si le tampon du clavier est vide, la fonction ADVAL() retourne 255 et 0 s'il est plein. Remarque : ce fonctionnement diffère de celui de ADVAL( −1 ) dans d'autres versions de BBC BASIC.

Avec valeur = 0, la fonction ADVAL() retourne une valeur comprise entre 0, tous les boutons sont relachés et 15, les 4 boutons sont enfoncés. Selon la plateforme et le type de joystick/contrôleur, des boutons supplémentaires peuvent être disponibles, correspondant à des valeurs supérieures à 15.

Avec valeur allant de 1 à 3, la valeur typique retournée par la fonction ADVAL() va de 0 à 255, pour un convertisseur analogique-numérique 8 bits, mais cela peut varier selon le matériel.

Note : les formes ADVAL( 5 ) et ADVAL( 6 ) la limite X et Y de la souris, ADVAL( 9 ) état des boutons de la souris, ADVAL( -9 ), octets libres dans le buffer de la synthèse vocale, ADVAL( -10 ), octets utilisés par la souris, présents dans des versions postérieures du BBC Basic ne sont par repris par le BBC BASIC SDL 2.0.

EXEMPLES.

PRINT "ADVAL( -8 ) retourne : " ; ADVAL( -8 ) : REM retourne 16

PRINT "ADVAL( -7 ) retourne : " ; ADVAL( -7 ) : REM retourne 16

PRINT "ADVAL( -6 ) retourne : " ; ADVAL( -6 ) : REM retourne 16

PRINT "ADVAL( -5 ) retourne : " ; ADVAL( -5 ) : REM retourne 16

PRINT "ADVAL( -1 ) retourne : " ; ADVAL( -1 ) : REM retourne 255

PRINT "ADVAL( 0 ) retourne : " ; ADVAL( 0 ) : REM retourne 8

PRINT "ADVAL( 1 ) retourne : " ; ADVAL( 1 ) : REM retourne 0

PRINT "ADVAL( 2 ) retourne : " ; ADVAL( 2 ) : REM retourne 255

PRINT "ADVAL( 3 ) retourne : " ; ADVAL( 3 ) : REM retourne 0

Les valeurs retournées sont fonction de environnement utilisé par l'utilisateur.

Si aucun joystick n'est présent, une erreur de type Devise unavailable est retournée.