30/06/03
	 _____   _____   _____    _____   _____   __   _   _____        _____  
	/  ___/ | ____| |  _  \  |  _  \ | ____| |  \ | | |_   _|      /___  \ 
	| |___  | |__   | |_| |  | |_| | | |__   |   \| |   | |         ___| | 
	\___  \ |  __|  |  _  /  |  ___/ |  __|  | |\   |   | |        /  ___/ 
	 ___| | | |___  | | \ \  | |     | |___  | | \  |   | |        | |___  
	/_____/ |_____| |_|  \_\ |_|     |_____| |_|  \_|   |_|        |_____| 
										par Tyraniek


				|| | /\ |\ |\/| | 
				|\ | || |_/ |  | | 
				                     
				======================

english version at the bottom of the page


I. Prsentation

"Serpent2" est mon deuxime programme en assembleur z80 (sur TI-83+). Il s'intitule Serpent 2 car le
premier a t cre longtemps auparavent, en BASIC. Son autre nom est "Serpent ASM", mais peu importe.
Ce programme est aussi le seul serpent asm pour TI-83+ que j'ai trouv sur www.ticalc.org !!!
La source est disponible sur mon site perso : www.TYRANIEK.fr.st


II. Lancer le serpent

Vous tes maintenant normalement en possession d'un fichier qui s'appelle "SERPENT2.8XP". C'est le
fichier que vous devrez exporter vers votre TI-83+ (ou TI-83+ Silver Edition, mais pas la TI-83
normale)  l'aide du logiciel TI-Graph Link (ou quivalent si vous ne le possdez pas).
Une fois que le transfert est termin, vous aurez un programme intitul "SERPENT2" dans votre liste
de programmes. Vous ne pouvez l'diter, c'est normal, c'est d  la compilation. Si vous essayez de
le lancer comme un programme normal, une erreur va se crer (ERREUR:SYNTAXE). Effectivement, vous
devez utiliser la syntaxe qui permet de lancer un programme en assembleur sur TI-83+ :
Asm(prgmSERPENT2)
La commande "Asm(" se trouve dans le catalogue.


III. Une fois dans le jeu

Lorsque vous avez russi  lancer le programme (vous pouvez aussi le lancer avec un shell si vous en
avez un), vous arrivez devant le menu, vous pouvez alors choisir :
- Jouer : cela lancera une partie suivant le mode de jeu choisi
- Le mode de jeu : le Mode STORY est consitu de 8 niveaux. La vitesse et la longueur du serpent
                   sont grs automatiquement, vous commencez avec 4 vies (vous perdez  0), en
		   mode councours, le but du jeu est d'atteindre le plus de cibles sans perdre.
		   Vous ne disposez que d'une seule vie !!! Un highscore est ensuite enregistr.
- La vitesse, mais seulement en mode "concours". 1 est lent, 11 est impossible !
- Quitter, c'est ce qu'il y a de moins intressant ;-)
Notez que lorsque vous sortez de l'cran par la droite, vous r-apparaissez  gauche : c'est une
possibilit dont il faut tirer part.
Les touches utilises dans le jeu sont les suivantes :
- Flches directionnelles pour diriger le serpent
- ENTER pour mettre le jeu en pause
- CLEAR pour immdiatement revenir au menu


IV. Trucs et astuces

ATTENTION !!!
Normalement, le programme dtecte lorsque vous vous crashez et empche par exemple de placer la
cible sur une emplacement dj occup. Cependant, il peut arriver, lorsque vous executez le
programme pour la premire fois qu'il ne dtecte pas correctement les pixels.
Quittez alors le jeu, changez la configuration de la fentre (zoom, 6, zoom, 5, gridOn etc.), 
puis relancez le jeu : normalement il fonctionnera bien. (en tout cas, c'est comme a que j'ai fait).
Choisissez plutt le mode STORY la toute premire fois que vous jouez ; il m'est arriv d'avoir
des crashs lorsque je prenais le mode concours ds la premire utilisation.

Notez que lorsque vous lancez le jeu pour la premire fois, le highscore est initialis  55
(normalement il est  30, mais en le testant aprs la compilation, je l'ai modifi ;-).
Pour changer la valeur du highscore dans le fichier SERPENT2.8XP, ouvrez-le avec un diteur
hexadcimal et changez la valeur situe  l'offset 000CF0h (ou 0xCF0 ou $CFO suivant les diteurs)
elle est normalement situe juste avant "Jouer" et est gale  37 en hxa (55 en dcimal).
Changez-la (1 est le minimum, 0 engendre un overflow).


V. Crdits et remerciements

Ce programme a entirement t cre par WRTAL Yannick. Cependant, il est indispensable de remercier
les gens de Cirrus et de United-TI qui m'ont beaucoup appris :
http://www.redelf.net/providence/forums/index.php?s=68a1bff416d6cbb6e98d62f955778b98&act=SF&f=5
Merci aussi  ticalc.org qui permet une distribution rapide de programmes pour TI !!!

http://www.ticalc.org/archives/files/authors/75/7575.html
www.tyraniek.fr.st
Je n'ai volontairement pas joint la source pour que vous alliez la voir sur

		www.tyraniek.fr.st/prgmsASM/serpent2.txt























English Version :

I. Presentation

"Serpent2" is my second assembly z80 prgm (on TI-83+). It's named Serpent 2 because the first
was created a long time ago, in BASIC. It's other name is "Serpent ASM", but who cares ? ;-)
This program is also the only asm SNAKE for TI-83+ that I found on www.ticalc.org !!!
The source is available on my site : www.TYRANIEK.fr.st


II. Launching the snake

You now own a file which is called "SERPENT2.8XP". It's the file you're going to export to your
TI-83+ (or TI-83+ Silver Edition, but not the "simple" TI-83) with the help of the software TI-Graph
Link (or quivalent if you don't own it).
Once the transfer is finished, you've got a program named "SERPENT2" in your programs' list.
You cannot edit it, that's normal, it's due to the compilation. If you try launching it as a BASIC
program, an error will be created (ERROR:SYNTAX). Indeed, you have to use the syntax which
ensures launching a assembly program on TI-83+ :
Asm(prgmSERPENT2)
The "Asm(" command can be found in the catalog.


III. Once you're in the game

When you've managed launching the program (you can also launch it with a shell if you've got any),
there is a menu. You can thus choose:
- "Jouer" : this will launch a game following the kind of game chosen
- the game mode : the STORY mode is constituted of 8 levels. The speed and the length of the snake
                  are automatically handled, you start with 4 lives (0 isn't one), in
		  mode "councours" = competition, contest, the game's goal is to reach the more
		  targets without crashing. You only have one life !!! A highscore is then stored.
- the speed, but only with the mode "concours". 1 is slow, 11 is impossible !
- "Quitter", that's the less interesting ;-)
Notice that when you get out of the screen from the right, you re-spawn on the left : it's a
possibility you should take advantage of.
The keys used in the game are the following :
- arrows to turn the snake
- ENTER to do a pause
- CLEAR to immediatly return to the menu


IV. Tricks

WARNING !!!
The program should detect wether you crash the snake and prevent putting the target on a place
which is already taken. However, it may happen, when you're executing the program for the first
time, that it does not correctly detect pixels.
Quit the game, chang the window configuration (zoom, 6, zoom, 5, gridOn etc.), 
then launch the game again : it should work well. (at least, that's what I made)

Notice that when you launch the program for the first time, the hischore is initialized at 55.
(it should be equal to 30, but while testing the game after compilation, I've modified it ;-).
To change the value of the highcore in the file SERPENT2.8XP, open it with an hexadecimal editor
and change the value situated at the offset 000CF0h (or 0xCF0 or $CFO following editors)
it is normally situated just before "Jouer" and is equal to 37 in hexa (55 in decimal).
Change it (1 is the minimum, 0 send ERROR:OVERFLOW).


V. Credits and thanks

This program has totally been created by WRTAL Yannick. However, it is necessary to thank
Cirrus and United-TI people who taught me a lot :
http://www.redelf.net/providence/forums/index.php?s=68a1bff416d6cbb6e98d62f955778b98&act=SF&f=5
Thanks also to ticalc.org which ensures a fast ditribution of TI programs !!!

http://www.ticalc.org/archives/files/authors/75/7575.html
www.tyraniek.fr.st
I have volontary not joined the source so you have to go on the following address to see it (lol) :

		www.tyraniek.fr.st/prgmsASM/serpent2.txt





(!!! this translation was difficult, and also bad but nervermind, I'm french, not english ;-)
remember, new versions, source code and new projects are first available on tyraniek.fr.st



Tyraniek