***********************************************************************
*       CrockMan68k v1.15 pour toutes les calculatrices TI-68k        *
*								      *
*                (C)1999-2000 Par Flavien Racine   -FLASH-            *
*   <FlashZ@netcourrier.com>      http://www.multimania.com/flashz    *
*								      *
*		      http://www.ExpertTI.cjb.net		      *
*								      *
* Dernire mise  jour: 13/09/2000  -  Dernire publication: euh ?... *
***********************************************************************



<><><><><><><><><><><><><><><><><><+><><><><><><><><><><><><><><><><><>
<><><><><><><><><><><><><><><><><><+><><><><><><><><><><><><><><><><><>
<><><><><><><><><><><><><><><><><><+><><><><><><><><><><><><><><><><><>
<								      >
< Avant tout, une petite annonce :				      >
<								      >
<	Recherche jeune (ou vieux) programmeur mle (ou femelle)      >
<	(et pourquoi pas femelle de prfrence ? :o))		      >	
<	concepteur de niveaux (ou de niveaux) pour PacMan (ou pour    >
<	PacMan) pour une rmunration de 0 francs,  + ou - 0 francs  >
<	prs en attendant la sortie de l'diteur.		      >
<								      >
<		Veuillez vous adresser au guichet n7 		      >
<		l'adresse suivante :				      >
<								      >
<			FlashZ@netcourrier.com			      >
<								      >
<		(de toute facon, vous n'vous tromperez pas, y'a qu'un >
<		 guichet !)					      >
<								      >
<	Au passage, si vous avez dj fait des niveaux, publiez les ! >
<								      >
<	Merci de votre comprhension.				      >
<								      >
<						Flavien Racine	      >
<								      >
<><><><><><><><><><><><><><><><><><+><><><><><><><><><><><><><><><><><>
<><><><><><><><><><><><><><><><><><+><><><><><><><><><><><><><><><><><>
<><><><><><><><><><><><><><><><><><+><><><><><><><><><><><><><><><><><>




Sommaire:
---------
 1.  La description du jeu
 1b. Installation
 2.  Les touches et leurs fonctions
 3.  L'historique du programme
 4.  Les tests que j'ai pu faire
 5.  Les bugs connus
 6.  Futures amliorations
 7.  A propos de moi
 8.  Comment me contacter
 9.  Le plus important : les remerciements
 10. Les sites les plus importants


***********************************************************************	

 1.  La description du jeu
 -------------------------
	A l'origine, mme si le nom a chang, c'est un PacMan.
	Alors qui ne connat pas PacMan ?
	Bon vous l'avez compris, je ne vais pas vous expliquer en quoi
	consiste le jeu.
	Il est programm pour DoorsOS et fonctionne sous
	toutes les ROMs, de la v1.00  la v2.05, puisqu'il est compil
	avec la dernire version de DoorsOS II v0.98.
	Pour le reste, voir dans la section Test (4.)

***********************************************************************	

 1b. Installation
 ----------------
	Tout ce qui est ncessaire pour faire tourner le jeu sur votre
	calculatrice est fourni.

	J'explique la marche a suivre, dans le cas d'une calculatrice
	fraichement rinitialise (RESET).

	- Envoyez les fichiers suivants :
	  -> crockman.xxz
	  -> crocklib.xxz
	  -> crocklvl.xxs (les niveaux de base)

	  -> install.xxz et kernel.xxz,

	  -> hw2patch.xxz (si ncessaire)

	- Si vous possdez d'un HardWare 2.00, avec la ROM v2.0x, vous
	  deverez installer en priorit le patch dans le rpertoire
	  System\HW2Patch. Il suffit de l'excuter.
	  exemple : 'main\hw2patch()'
	  Lisez d'abord la documentation correspondante, dans le mme
	  rpertoire.
	  Je donne ce patch, car beaucoup de gens ne connaissent pas
	  encore son existance.

	- Installez un OS, quel qu'il soit, en le lanant comme le
	  patch. (je ne fournis plus que UniversalOS)
	  exemple : 'main\install()'
	  Je fournis toujours les dernires versions disponibles
	  (Je ne donne que UniversalOS, a devrait satisfaire tout le
	  monde)

	- Normalement, c'est bon, vous pouvez lancer le jeu en tappant
	  'main\crockman()'
	  Si a marche pas, alors mailez moi.

***********************************************************************

 2.  Les touches et leurs fonctions
 ----------------------------------
	- Menu de chargement des niveaux
	   [Haut] et [Bas] pour la slection
	   [Enter] pour valider
	   [ESC] pour quitter

	- Menu de Dpart :
	   [Haut] et [Bas] pour la slection
	   [Enter] pour valider
	   [ESC] pour quitter
	   [F5] pour voir les records

	- Menu des options :
	   [Haut] et [Bas] pour la slection
	   [->] et [<-] pour changer
	    (uniquement pour la vitesse)
	   [Enter] pour valider
	    (choix du niveau, des couleurs ou validation uniquement)
	   [ESC] pour quitter

	- Bote de dialogue A Propos:
	   N'importe quelle touche pour retourner au menu

	- L'cran des HiScores:
	   N'importe quelle touche pour retourner au menu

	- Pendant une partie :
	   [TI-89]
	    Le pad pour se dplacer
	    [ESC] pour abandonner
	    [APPS] pour la pause, qui teint tout
	    [+]/[-] pour ajuster le contraste

	   [TI-92+]
	    Le pad pour se dplacer
	    [Q] pour abandonner
	    [P] pour la pause, qui teint tout
	    [+]/[-] pour ajuster le contraste

***********************************************************************

 3.  L'historique du programme
 ----------------------------
	- CrockMan v1.15 [Flash WebSite]		     07/09/2000
		Suppression de l'erreur de transmission des niveaux
		Ajout de deux petits niveaux
		Suppression de la pub d'ExpertTI
		(Restez tout de mme fidles au site)
		www.ExpertTI.cjb.net

	- CrockMan v1.14 [Flash WebSite/ExpertTI]	     07/09/2000
		Utilisation d'une police personnalise !!!
		 > meilleur qualit graphique
		 > plus rapide que les routines du TIOS
		 > nuances de gris
		Merci PreNono ! <perenono@free.fr>
		Quelques bugs corrigs
		Ajout de la phrase '...CHARGEMENT...'
		...

	- CrockMan v1.13 [ExpertTI]			     01/09/2000
		Correction d'un bug lors du chargement de la carte
		Nouveaux sprites du CrockMan

	- CrockMan v1.12 [internal]			     31/08/2000
		Suppression du scrolling de dpart
		3 types de monstres diffrents avec des graphismes
		 un peu mieux

	- CrockMan v1.11 [internal]			     30/08/2000
		Un scrolling encore un peu plus rapide
		Suppression de la pub ExpertTI sur la version Fargo II

	- CrockMan v1.10 [internal]			     30/08/2000
		Une version pour Fargo II (TI-92/TI-92II) !
		Trois fantomes supplmentaires
		Tous les petits bugs corrigs
		Le jeu est en partie rcrit
		Un scrolling beaucoup plus rapide
		Adaptation parfaite  la TI-92+ (ecran pendant une
		 partie compltement utilis)
		Le programme n'a besoin d'aucune librairie
		 (i-e plus GraphLib; UserLib)
		Il y aura peut-etre une version _nostub
		Suppression de l'utilisation des touches du tios dans
		 les menus
		Ajout de la pub pour ExpertTI (qui sera supprime 
		 l'avenir en raison de la taille de l'image ~4.5 Ko)
		La prochaine version sera peut-etre disponible sur
		 d'autres sites que ExpertTI
		J'avais oubli le grand merci  eXor pour son aide avec
		 le scrolling (exor@netcourrier.com)

	- CrockMan v1.05 [ExpertTI]			     17/08/2000
		Jeu entierement refait ! (au niveau systme graphique)
		 -> Sprites de 16*16
		 -> Le scrolling !!!
		 -> Des niveaux de 30*30
		Ce programme est une exclusivit ExperTI, et ne doit
		 etre publi en aucun cas sur un autre site avant la
		 prochaine version.

	- CrockMan v1.0	[internal]			     19/05/2000
		Premire restructuration du jeu (anciennement PacMan).
		Nouvelle prsentation.
		Un nouveau nom, plus original, plutt marrant !

***********************************************************************

 4.  Les tests que j'ai pu faire
 -------------------------------
        - Virtual TI v2.5 Beta 5 et VTI68k
	   -> ROM v1.00
	   -> ROM v1.01 (TI-92+)
	   -> ROM v1.05
	   -> ROM v2.03
	   -> ROM v2.04
	   -> ROM v2.05

	- Ma TI-89, HardWare v1.00, ROM v2.05

	- Ma TI-92, ROM v1.12 internal

***********************************************************************

 5.  Les bugs connus
 -------------------
	Le jeu me parrat trs stable, puisque je n'ai encore jamais
	plant.

	Cependant, si vous trouvez un bug, mailez moi en me donnant la
	version du jeu, de l'OS, de la ROM, et du HardWare.

  IMPORTANT:
  ----------
	Je vous demanderais une description parfaite du bug, indiquant
	les causes comme les consquences.

***********************************************************************

 6.  Futures amliorations
 -------------------------
	- toutes les amliorations que vous me proposerez
	- plein de surprises...

***********************************************************************

 7.  A propos de moi
 -------------------

 J'ai maintenant mon BAC, et j'entre en IUT Services et Rseaux de 
 Communication (SRC)  Dijon.

    
	Anne 1999/2000

	       |
	       |
	       |
	      \|/
	       V

  Qui suis-je ?
 Bonne question !
 J'ai fait des tudes gnrales jusqu'en Terminale S, on peut donc dire 
 que j'avais un niveau correct. Je n'ai pas de difficults au niveau de
 l'orthographe, de la grammaire, des maths, de l'anglais ou de je ne
 sais quoi.
 Simplement, la Terminale S, c'est pas si loin : c'tait l'anne
 dernire. N'ayant pas foutu grand chose en Terminale S, je n'ai
 biensur pas eu mon bac, et loin de l.
 Comme j'avais la possibilit d'aller dans un lyce professionnel 
 Chenve,  ct de Dijon, dans une section d'informatique et de
 rseau, j'ai saisi l'occasion, puisque c'est un BAC PRO d'un assez bon
 niveau, et que je peux poursuivre mes tudes en BTS et dans certains
 IUT de rseau.
 Par rapport  la Terminale S, il n'y a plus de Biolo, de Chimie et de
 Philo.
 Par contre il y a du Franais...
 Comme c'est un bac PRO, c'est un peu plus concret, mais en Maths par
 exemple, on tudie quand mme les LOG, les Drives et les Primitives.
 ...je ne m'attendais pas  une classe d'aussi bon niveau dans lyce
 professionnel.
 Cette section s'appelle MRBT (Maintenance des Rseaux Bureautiques
 et Tlmatiques), elle n'existe que depuis deux ans dans trois lyces
 en France uniquement il me semble.
 Enfin un programmeur pour 68k qui n'est pas en Prpa ou Maths SUP !
 Il faut dire que mes programmes ne montent encore pas au niveau de
 Street Fighter II Turbo ou de Solar Striker...

 Voila en ce qui concerne mes tudes.


  Comment ai-je appris  programmer ?
 Au dbut, j'avais une vieille Casio 8800 GC, avec des pauvres jeux
 en basic sans mme la fonction GetKey. Je ne comprenais rien du tout 
 la programmation et je ne voulais pas en entendre parler.
 J'ai commenc  diter ces jeux, regarder comment ceux-ci
 fonctionnaient, puis j'y ai ajout des petites options,
 des amliorations, ce qui m'a montr comment utiliser les Labels, les
 Gotos, et toutes les autres fonctions de base de la programmation en
 Casio Basic.

 Ensuite, j'ai eu deux autres Casio : la 8930 GT et la 9990 GT, avec
 plus de fonctions, et c'est l que j'ai commenc  vraiment beaucoup
 programmer, puisque je faisais environ un jeu par weekend.

 Six mois aprs, j'ai dcouvert l'assembleur sur TI, grace  un amis
 qui avais achet une TI-86 avec le GraphLink.
 Quand j'ai vu ce que l'on pouvait faire avec ce langage, j'ai t pas
 mal dgout de m'tre achet 2 Casio GT.
 A la fin de l'anne scolaire, il avait l'intention de revendre sa 86.
 J'ai saut sur l'occasion, mais  la rentre, il ne voulait plus la
 vendre...
 J'avais appris pendant les vacances que la TI-89 devait sortir en
 octobre.

 Remarque trs trs trs trs trs trs trange:
 -----------------------------------------------
  La personne qui devait me vendre sa 86 l'a revendue quelques temps
  aprs pour s'acheter une 89...

 Une fois sortie, je l'ai achete, et en janvier 99, j'ai commenc les
 cours en A68k grce au formidable ZGuide de Florian Drevet, qui je
 pense est indispensable pour ceux qui dbute en A68k.
 J'ai programm FlashShell, grce  certaines routines de PlusShell.
 C'tait une sorte de mise en jambes.
 Je pense cependant le refaire un jour entirement avec mes propres
 routines.

 J'ai fait ROMLib, un essai de librairie.
                      -----
 Maintement, j'en suis  PacMan, j'ai d'autres projets en A68k, mais
 j'ai aussi prvu de me mettre au Z80, au Pascal et au C/C++.

 Voil pour la programmation, et c'est dj pas mal pour un txt.

***********************************************************************

 8.  Comment me contacter
 ------------------------
  C'est simple, envoyez moi un E-Mail  : <FlashZ@netcourrier.com>
  Consultez aussi mon site : http://www.multimania.com/flashz
 
 Je comprends pas, je l'ai mis  jour et il ne lance pas l'INDEX.HTM.
  Il faut cliquer dessus pour que ca marche :o(
  A la place, on voit l'arborescence du site.
  Si quelqu'un avait une astuce, ce serait cool.
  Au lieu de remplacer les anciens fichiers, je les ai tous virs, et
  j'ai mis les nouveaux.
  Mais ce  quoi je n'ai pas pens, c'est qu'il pouvait y avoir
  certains fichiers systems de multimaina parmi ceux que j'ai virs.

  Si vous voulez les sources, demandez les moi.

***********************************************************************

 9.  Le plus important : les remerciements
 -----------------------------------------
 - Un grand merci  eXor pour son aide avec le scrolling et pour Pang
     exor@netcourrier.com

 - Elliot Olney (CarBiN) pour Sprite Editor 68k v2.00 et pour la
   premire publication de BomberMan89 (v0.1b)
     e_olney@hotmail.com

 - ExpertTI, 'notre' site en ouverture
     http://www.ExpertTI.cjb.net

 - Manuel Creach, pour son super editeur de niveaux sous Windows !
     mcreach@club-internet.fr

 - PreNono, qui m'a donn ses routines pour les fontes personnalises
     perenono@free.fr

 - Xavier Vassor pour son aide et son travail important sur DoorsOS
     xvassor@mail.dotcom.fr
   et toute la Doors Team
     http://start.at/doors

 - Florian Drevet pour son superbe et convivial ZGuide v3.0 :o)
     E-mail :    zorglop@infonie.fr
     Site :      http://www.multimania.com/zorglop
     ICQ :       99 48 092 
     Adresse :   Florian DREVET
                 24, chemin des charbottes
                 69450 Saint Cyr au Mont d'Or
                 FRANCE  

 - Patrick Pelissier pour ses infos sur le HW2 et la vido
   et surtout pour son aide sur les niveaux externes, et le truc
   sur les NOPs, c'tait bon  savoir.
     ppelissier@hotmail.com

 - CandyMan pour son aide prcieuse sur les matrices
   et j'avais oubli PictureMaker v1.3 ...  :o)
     http://www.i-france.com/candyman

 - De mme pour Andreas Nestmann
     A.Nestmann@gmx.de

 - Thomas Fernique pour ses routines de HiScores :o)

 - Rusty Wagner pour Virtual TI v2.5 Beta 4 et VTI68k et PlusShell
    Enfin la Beta 5 de VTI v2.5 !  C'est pas trop tot, mais c'est
    vraiment coooool ! (pour la ROM v2.03 surtout !)

 - Toute l'quipe de ti-fr pour un site organis et mis  jour
   rgulirement
     http://www.ti-fr.fr.st

 - Tous ceux qui me feront des niveaux !
     http://www.truc.org/machin
     bidule.machin@truc.org

 - Et tous les testeurs qui me conseillent gracieusement !

 - ...     (et tous ceux que j'ai oublis !)

 10. Les sites les plus importants :
 -----------------------------------
 - http://www.ExpertTI.cjb.net

 - http://www.ti-fr.org

 - http://start.at/doors

 - http://www.ticalc.org

 - http://www.calc.org

 - http://www.ti-files.org

 - http://www.ti.com/calc