Nom du programme: BasicLib
Auteur: Alban Gervaise
Date: 5/04/1999
Version: 1.1


PRINCIPE:
	BasicLib est comme son nom l'indique, une librairie pour basic. Son but  est trs simple: apporter aux programmeurs basics des fonctions supplmentaires... mais cela sans utiliser rellement de l'assembleur puisque BasicLib ne ncessite absolument aucun autre fichiers assembleur ou mme basic, BasicLib est totalement autonome.


INSTALLATION:
	Son installation est donc par consquent trs simple, il suffit d'envoyer par le link le fichier basiclib.89z vers votre Ti89. Une autre librairie est disponible : MemLib par philippe Gervaise. C'est une extension pour la manipulation de textes et de fichiers. Vous pouvez
l'obtenir  cette adresse : http://www.i-france.com/candyman.


FONCTIONNEMENT:
	Pour fonctionner, BasicLib a cependant besoin d'un "messager", une variable qui peut  partir du basic donner des informations  l'assembleur.  Cette variable existe donc et se nomme 'b_l' (Basic_Lib) et il s'agit en fait d'un string dans lequel vous inscrivez les instructions que BasicLib va devoir excuter. Puis vous lancez BasicLib qui automatiquement prendra en compte les instructions qu'il trouve dans la variable b_l (en fait, la premire variable du VAR-LINK qui s'appelle b_l) puis BasicLib excute des fonctions en assembleur pour plus de vitesse et plus de puissance...

SYNTAXES:
	BasicLib v1.1 contient 27 fonctions qui permettent de grer des fichiers, des graphismes ou encore d'accder  des fonctions incontrlables pour le basic.
Cependant, pour que BasicLib reconnaisse les diffrentes fonctions, il est ncessaire de connatre les syntaxes de chacune. Mais la syntaxe gnrale est toujours la mme:
* La plus simple est le cas d'une fonction unique et sans arguments:
"fonction"->b_l:basiclib()
par exemple, la fonction "Off" (permettant d'teindre la Ti89):
"Off"->b_l:basiclib()
* Mais une fonction peut avoir plusieurs arguments, le titre de la fonction est alors suivi par un ':' et les arguments s'enchanent avec en chacun une virgule ',':
"fonction:argument1,argument2,argument3,...,argument n"->b_l:basiclib()
par exemple, la fonction "ST_busy" possde un argument et est donc de la forme:
	"ST_busy:0"->b_l:basiclib()
* Enfin, plusieurs fonctions peuvent s'enchaner et sont spares avec un '|' de valeur 124 (correspond au F sur la Ti89...) la formule gnrale devient alors:
"fonction1[:arg1,...,arg n][|fonction2|...fonction n]->b_l:basiclib()
par exemple, on peut avoir la fonction "Off" suivie de "ST_showHelp" et de "Idle_loop" qui donne donc comme syntaxe:
	"Off|ST_showHelp:string|Idle_loop"->b_l:basiclib()

(Pour plus de prcisions sur les fonctions, voir fonctions_fr.htm et examples...)


AUTRES CHOSES...:
	Si b_l sert pour communiquer du basic jusqu' l'assembleur, l'inverse est aussi vrai. Ainsi, pour chaque fonction, BasicLib revoit une valeur qui dpend  la fois de la fonction excute et du rsultat de son excution.
De manire gnrale, BasicLib renvoie la variable b_l sous forme d'une liste dont le premier lments est soit:
	"0" alors une erreur est survenue lors de l'excution
	"1" alors la fonction a bien t excute
Mais certaine fonction comme "GetSize" renvoie b_l sous la forme d'un string contenant, un nombre...Dans la nomenclature, toutes les fonctions qui renvoient une valeur de b_l autre que "0" ou "1" sont signales et le contenu de b_l est alors dcrit.


Tout comme la version 1.0, BasicLib v1.1 garde une surt contre le plantage. De plus, certaines erreurs ont t corrig (pour Sprite par exemple...)

BasicLib v1.0 le 25/03/99:
	Premire version
	24 fonctions (dont certaines ayant des erreurs...)
	
BasicLib v1.1 le 05/04/1999:
	Deuxime version modifie avec la collaboration de CandyMan
	3 fonctions en plus (Break souvent demande, Error et ST_Folder)
	plus de commentaires (par CandyMan bien sr!)
	de meilleures routines
	Partenariat avec MemLib de CandyMan (d'autres fonctions...)
      (Memlib disponible sur http://www.i-france.com/candyman)
	Plus d'exemples pour tous ceux qui les ont demands
	
	
Si vous avez des suggestions, des questions ou tout autre renseignement  demander, contactez-moi :
GefunS@I-France.com

Site web : 
  http://www.i-france.com/candyman


Par Alban Gervaise
Le 5/04/99
