Langage de programmation - GWBASIC - Références de commandes, d'instructions et de fonctions - PEN

Section courante

A propos

Section administrative du site

PEN	Crayon
GWBASIC

Syntaxe

PEN ON

PEN OFF

PEN STOP

x = PEN(n)

Paramètres

Nom	Description
n	Ce paramètre permet d'indiquer un nombre entier compris entre 0 et 9, soit les coordonnées du crayon lumineux correspondant aux valeurs suivantes :
	Valeur	Description
	0	Cette valeur permet d'indiquer si PEN était en panne depuis la dernière interrogation, renvoie -1 ; sinon, renvoie 0.
	1	Cette valeur permet de retourner la coordonnée x-pixel lorsque PEN a été activé pour la dernière fois. La plage est comprise entre 0 et 319 pour une résolution moyenne ; 0 à 639, pour une haute résolution.
	2	Cette valeur permet de retourner la coordonnée y-pixel lorsque PEN a été activé pour la dernière fois. La plage est comprise entre 0 et 199.
	3	Cette valeur permet d'indiquer de retourner la valeur actuelle du commutateur PEN. Renvoie -1 si vers le bas ; 0 si activé.
	4	Cette valeur permet de retourner la dernière coordonnée x-pixel valide connue. L'intervalle est comprise entre 0 et 319 pour une résolution moyenne ; ou 0 à 639 pour une haute résolution.
	5	Cette valeur permet de retourner la dernière coordonnée de pixel y valide connue. L'intervalle est comprise entre 0 et 199.
	6	Cette valeur permet de retourner la position de la rangée de caractères lorsque PEN a été activé pour la dernière fois. L'intervalle est comprise entre 1 et 24.
	7	Cette valeur permet de retourner la position de la colonne de caractères lorsque PEN a été activé pour la dernière fois. L'intervalle est comprise entre 1 et 40, ou entre 1 et 80, selon la largeur de l'écran.
	8	Cette valeur permet de retourner la dernière ligne de caractères valide connue. L'intervalle est comprise entre 1 et 24.
	9	Cette valeur permet de retourner la dernière position de colonne de caractères valide connue. La plage est comprise entre 1 et 40, ou entre 1 et 80, selon la largeur de l'écran.
x	Ce paramètre permet d'indiquer la variable numérique recevant la valeur PEN.
ON	Ce paramètre permet d'activer la fonction de lecture PEN.
OFF	Ce paramètre permet de désactiver la fonction de lecture PEN.
STOP	Ce paramètre permet d'arrêter le piégeage. Il se souvient de l'événement afin qu'un recouvrement immédiat se produise lorsque PEN ON est exécuté.

Description

Cette commande ou fonction permet de lire le crayon lumineux.

Remarques

La fonction PEN est initialement désactivée. Une instruction PEN ON doit être exécutée avant que tout appel de fonction de lecture PEN puisse être effectué, sinon un appel de fonction de lecture PEN entraîne une erreur :

Illegal function call

x = PEN(n) lit les coordonnées du crayon lumineux. x est la variable numérique recevant la valeur PEN.
Pour améliorer la vitesse d'exécution, éteignez le crayon lumineux avec une instruction PEN OFF pour les programmes n'utilisant pas le crayon lumineux.
Lorsque le crayon lumineux se trouve dans la zone de bordure de l'écran, les valeurs renvoyées seront inexactes.

Dernière mise à jour : Lundi, le 20 Mars 2023