Comment utiliser la librairie ?
Syntaxe de base :
Pour utiliser Vertel il faut la lancer (dans lécran
HOME ou dans un programme) avec comme argument la fonction que vous voulez utiliser.
Par exemple : vertel("d_pixl",50,20).
La chaîne d_pixl est le nom de la fonction
Vertel à utiliser (voir les fonctions). Les nombre 50 et
20 précisent à Vertel comment utiliser cette fonction, dans ce
cas ils indiquent les coordonnées du point à tracer. Tous les
arguments omis seront remplacés par 0. Dans cet exemple, un dernier argument
aurait pu être entré, il indiquait comment afficher le pixel (noir,
blanc, inversé). Cet argument étant absent, il vaut 0 et donc
le pixel sera affiché en noir.
Mais attention : si la fonction accepte deux arguments,
et que vous ne voulez définir que le 2eme, vous êtes obligé
de préciser que le 1er vaut zéro :
vertel("a_fonc",0,2)
Vous pouvez entrer plusieurs fonctions en un seul appel de
Vertel, il suffit pour cela de les séparer par "/".
Voici par exemple comment baisser le contraste puis fixer l'apd à 600 :
vertel("s_cntr",0,"/","s_apdt",600).
Lavantage est que vous ne quittez pas Vertel entre les différentes
commandes, et donc elles sont exécutées plus vite (voir annexe).
Note : Puisque les arguments omis sont fixés
à 0, vous pouvez remplacer la commande ci-dessus par : vertel("s_cntr","/","s_apdt",600).
Petit détail, qui peut plaire à certains : Le
deuxième caractère _ (underscore) des noms de fonctions peut être
remplacé par n'importe quoi, sans que cela affecte le fonctionnement.
Autrement dit, vous pouvez écrire "dxline",
"d*line" ou encore "d
line" à la place de "d_line",
le résultat sera le même.
Dans cette notice, l'underscore est systématiquement utilisé,
ce qui ne veut pas dire qu'il est "mieux" que n'importe quel autre
caractère.
Syntaxe par liste :
Vertel supporte aussi les listes, et en les utilisant correctement
vous pouvez optimiser vos programmes en taille et en vitesse. Vous pouvez donc
placer des listes dans vos appels, et la fonction se répetera alors pour
tous les elements de la liste. Par exemple : vertel("d_pixl",{10,20,30},{5,10,20})
aura pour effet de tracer 3 pixels, aux coordonnées (10,5), (20,10) et
(30,20).
L'utilisation des listes est très importante si vous souhaitez optimiser
vos programmes. Pour plus d'informations, voyez le chapitre 4.
Vertel possède également son propre système
d'indirections. Attention : il ne s'utilise pas comme en Ti-Basic, même
si la syntaxe est proche. Si var est une variable
contenant un nombre, Vous pouvez remplacer un appel vertel("s_keyi",var)
par vertel("s_keyi","#var"),
ce qui dans ce cas est équivalent (mais inutile). Voyez le chapitre
4 pour savoir comment utiliser efficacement ce système.
Attention : vous ne pouvez pas cumuler les deux
procédés. vertel("d_pixl",10,{"#crd1","#crd2"})
est invalide.
Notez que ceci vous empeche d'afficher une chaine commençant par #. En effet, si vous voulez afficher "#test#", Vertel pensera que vous voulez afficher la chaine contenue dans la variable test#. Pour remédier à ce problème, utilisez "/#test#". Le slash en début de chaine ne sera pas affiché, il indique juste à Vertel que le diese qui suit n'est pas à prendre en compte comme une indirection.
Retour de variable :
Enfin, il est indiqué que certaines fonctions « renvoient » une valeur. Cela signifie que si vous utilisez la fonction e_retr (voir plus bas), vertel créera une liste qui contiendra toutes les valeurs et chaines renvoyées par les diverses fonctions. Certains renvois ne sont pas indispensables, par exemple la fonction s_apdt qui regle lAPD de la calculatrice renvoie la valeur enregistrée avant le changement. Si cela ne vous interesse pas de lavoir, vous pouvez ne pas utiliser la fonction e_retr. Par contre la fonction v_list renvoie la liste des dossiers ou fichiers de la Ti, si vous nutilisez pas ensuite e_retr, vous ne pourrez pas récupérer la liste envoyée par Vertel, et la fonction aura été alors inutile.