************************************* * * * TETRHEX 1.15 (27/11/1994) * * * ************************************* DerniŠre modification: le 28 novembre 1994. TETRHEX est un jeu, ou plut“t un ensemble de jeux, de type Tetris ou Columns se jouant sur un tableau hexagonal, avec des cases hexagonales. Une des principales caract‚ristiques est de pouvoir cr‚er ses propres rŠgles. Cette version est diffus‚e avec un seul fichier de rŠgle (TETRHEX.RUL), mais d'autres fichiers de rŠgle seront fournis plus tard. Cette version peut ˆtre copi‚e et diffus‚e librement … condition qu'aucun des fichiers fournis (TETRHEX.PRG, TETRHEX.RUL, README.TXT et LISEZMOI.TXT) ne soit modifi‚ ou retir‚, et qu'aucun frais ne soit ajout‚, except‚s les frais d'envoi et de duplication. Vous pouvez ajouter un ou plusieurs fichiers ASCII. En revanche, il est INTERDIT de modifier le programme TETRHEX.PRG, mˆme s'il n'est pas diffus‚. TETRHEX est SHAREWARE. Cela veut dire que si vous voulez l'utiliser et recevoir la version complŠte, il faut vous faire enregistrer. Pour cela, envoyez 50 FF (ou plus si vous voulez) …: Vincent LEFEVRE 24 rue Louis Blanc 31400 Toulouse France N'oubliez pas de me donner votre nom et adresse! Si vous avez accŠs … Internet, il est pr‚f‚rable de me contacter d'abord par email. Mon adresse est: vlefevre@ens.ens-lyon.fr La version non enregistr‚e comporte les limitations suivantes: . On ne peut pas changer de rŠgle (la touche UNDO est d‚sactiv‚e). . Pas de sauvegarde des scores. . Parties limit‚es … 5 minutes environ. . 10 parties au maximum. . Pas de routine ext‚rieure. Comme je n'ai pas encore eu le temps d'‚crire le fichier d'aide, je donne le fichier LISEZMOI de la version 0.43, que j'ai un peu modifi‚. 1. Configuration n‚cessaire: """""""""""""""""""""""" TETRHEX a ‚t‚ ‚crit pour Falcon, mais devrait pouvoir tourner sur tout Atari (ou autre machine … base de TOS) muni d'un 68030 (au moins) et ayant un mode graphique 256 couleurs >= 640 * 480 compatible Falcon (i.e. dont les plans sont entrelac‚s), ‚ventuellement avec un systŠme d'exploitation de remplacement comptatible TOS/GEM. TETRHEX a besoin d'environ 300 Ko de m‚moire libre (ST RAM ou TT RAM) pour tourner. Un des deux timers A et D est utilis‚ (cf "Lancement"); par d‚faut, c'est le timer D. 2. Compatibilit‚: """"""""""""" TETRHEX peut g‚n‚ralement tourner avec les programmes AUTO, mais il peut parfois y avoir quelques problŠmes. La liste des compatibilit‚s est donn‚e ci-dessous. _ SpeedoGDOS (tests effectu‚s avec la version 4.0): . Si SpeedoGDOS est install‚, des fontes vectorielles peuvent ˆtre utilis‚es, ce qui est recommand‚. . Le changement de r‚solution est impossible (cf "Lancement"), mais il n'y a pas de plantage. _ NVDI (tests effectu‚s avec la version 2.5): . Le changement de r‚solution est impossible (cf "Lancement"), mais il n'y a pas de plantage. _ Carte Screen Blaster: . Il n'y a jamais de tentative de changement de r‚solution, sinon ‡a plante. Pour savoir si la carte Screen Blaster est pr‚sente, on recherche le cookie OSBL. Note: ce cookie ne peut ˆtre enlev‚ qu'aprŠs un red‚marrage complet (Ctrl-Alt-Rshift-Delete); par cons‚quent, il se peut que le changement de r‚solution soit refus‚ bien que la carte soit totalement d‚sactiv‚e (aprŠs un red‚marrage partiel). _ MiNT/MultiTOS: . Je n'ai pas fait de test avec la version d‚mo, mais il faut de toutes fa‡ons ‚viter de lancer la version d‚mo sous MultiTOS (elle n'est pas faite pour tourner sous MultiTOS). . La version 1.10 peut tourner sous MultiTOS (dans une fenˆtre). . Avec MiNT, il faut d‚sactiver la protection m‚moire, car TETRHEX accŠde directement … la m‚moire video pour acc‚l‚rer l'affichage. _ Outside (m‚moire virtuelle): . Aucun problŠme d‚tect‚ (note: les drapeaux de TETRHDEM.PRG concernant la TT-RAM peuvent ˆtre activ‚s). _ Idle (protecteur d'‚cran): . Lorsque la protection s'active, des blocs de m‚moire de TETRHEX sont parfois alt‚r‚s. 3. Lancement: """"""""" TETRHEX peut ˆtre lanc‚ soit en double-cliquant sur son ic“ne … partir du bureau, soit dans un shell (par exemple dans celui de Gemini). Il accepte des options style Unix, qui peuvent ˆtre donn‚es de diff‚rentes maniŠres. On forme une chaŒne compos‚e du fichier TETRHEX.CFG (s'il existe), suivi des options de la ligne de commande (s'il y en a). Note: pour pouvoir entrer des options aprŠs avoir double-cliqu‚ sur l'ic“ne, il faut remplacer l'extension .PRG par l'extension .GTP (‚quivalent de .TTP pour un programme GEM). Toutes les options commencent par le caractŠre '-' et elles sont s‚par‚es par des blancs (espace et caractŠres de contr“le). La ligne de commande ne doit pas contenir plus de 125 caractŠres. Si la syntaxe de la chaŒne entiŠre est incorrecte, le programme se termine imm‚diatement (et renvoie un code d'erreur non nul). Voici les options (celles qui sont d‚j… reconnues, mais qui servent … des fonctions non disponibles dans cette version d‚mo, ne sont pas donn‚es): -fg nombre [Font Game] Num‚ro de la fonte Speedo utilis‚e dans le jeu lui-mˆme. -fm nombre [Font Menu] Num‚ro de la fonte Speedo utilis‚e dans les menus. -fn nombre [Font Name] Num‚ro de la fonte Speedo utilis‚e pour afficher le nom de la rŠgle. -ft nombre [Font Tetrhex] Num‚ro de la fonte Speedo utilis‚e pour afficher "TETRHEX 0.43". -l param Pr‚f‚rences du langage. Il y a autant de paramŠtres que l'on veut (‚ventuellement aucun). Chaque paramŠtre est soit un nombre positif ou nul, indiquant le langage de maniŠre absolue, soit le caractŠre '?', indiquant le langage donn‚ par le cookie _AKP (langage utilis‚ par le systŠme), soit le caractŠre '*', indiquant un ou plusieurs langages se rapprochant de celui du systŠme. La chaŒne de paramŠtres par d‚faut est "* 0 3". -n nombre Taille d'un c“t‚ du tableau hexagonal par d‚faut (entre 6 et 9). -o fichier La liste des options restantes est remplac‚e par le fichier (extension .CFG). -r fichier D‚termine le fichier de rŠgle (extension .RUL) … charger (cette option ne sert … rien dans la version d‚mo, car il n'existe qu'un seul fichier de rŠgle pour cette version). -ta [Timer A] C'est le timer A qui sera utilis‚. -td [Timer D] C'est le timer D qui sera utilis‚. -vr[+/-] [Video Resolution] Interdit/autorise le changement de r‚solution. -vs[+/-] [Video Synchro] Synchronisation avec l'interruption VBL pour certains affichages. Les nombres sont en d‚cimal, sauf s'ils sont pr‚c‚d‚s d'un '$'; dans ce cas, ils sont en hexad‚cimal. Au lieu de donner des options dans la ligne de commande, il est possible de faire glisser un fichier d'options (ou de configuration) ou un fichier de rŠgle sur l'ic“ne de TETRHEX. Ceci correspond respectivement aux options "-o" et "-r". Note: certaines options ont des effets oppos‚s (ta/td, -vr+/-vr-, -vs+/-vs-); seule la derniŠre dans la chaŒne d'options est prise en compte. Au moment du lancement, si la touche Shift-gauche est enfonc‚e, c'est le timer A qui sera utilis‚ (sauf si l'option "-td" est donn‚e) au lieu du D (surtout utile dans la version shareware, si le port s‚rie est utilis‚ pendant le jeu). A l'aide d'un player de modules en accessoire, on peut faire jouer des modules; il faut alors prendre le timer D (timer par d‚faut). Mais (sur Falcon 030 sans carte acc‚l‚ratrice) on a alors des parasites sur l'‚cran lors des changements de palette de couleurs, i.e. pendant la pr‚sentation et quand on passe d'un ‚cran … un autre. Si la r‚solution graphique dans laquelle on lance TETRHEX n'est pas correcte (i.e. 256 couleurs, >= 640 * 480), alors TETRHEX essaie de changer de r‚solution (sauf si l'option -vr est donn‚e), mais peut ‚chouer … cause de certains programmes (cf "Compatibilit‚"). N.B.: le fichier de rŠgle TETRHEX.RUL doit se trouver dans le mˆme dossier que l'application TETRHEX.PRG. 4. Utilisation: """"""""""" Lancer TETRHEX (cf "Lancement"). Pour sortir de la pr‚sentation, appuyer une touche. Un menu apparaŒt: . Help: aide (non disponible dans la version d‚mo). . Undo: charger une rŠgle (non disponible dans la version d‚mo). . Return: jouer. . F1-F10: meilleurs scores (non disponible dans la version d‚mo). . Ctrl-Q: quitter. Pour jouer, appuyer sur Return. Lorsque la partie est finie, appuyer sur Ctrl-Escape pour revenir au menu. 5. RŠgle TETRHEX.RUL: """"""""""""""""" Touches: . Q (A sur claviers am‚ricains): aller en bas (la forme s'arrˆte pendant un moment). . Insert: aller en bas … gauche. . Clr-Home: aller en bas … droite. . FlŠche vers le bas: rotation gauche (sens trigo). . FlŠche vers le haut: rotation droite (sens des aiguilles d'une montre). . FlŠche gauche: aller … gauche (mˆme hauteur par rapport … la case du bas --> d‚placement en V). . FlŠche droite: aller … droite (mˆme hauteur par rapport … la case du bas --> d‚placement en V). . Barre d'espace: drop (la piŠce tombe). . Escape: abandon. . Undo: pause. . Return: fin de pause. . + (pav‚ num‚rique): passage au niveau suivant. . - (pav‚ num‚rique): passage au niveau pr‚c‚dent (la rŠgle l'interdit! donc cette touche ne sert … rien ici). . Help: radar on/off. . Backspace: d‚truit tout, … condition que l'on ait au moins une bombe (on en a une quand on arrive … 1000 points bombes) et que la piŠce courante ait des bombes. Les hexagones sont d‚truits dans les deux cas suivants: _ Formation d'une ligne d'hexagones: les hexagones situ‚s sur cette ligne sont d‚truits. N.B.: les lignes sont des V. _ Si la piŠce courante contient des bombes: mise en contact de cette piŠce avec une composante connexe (en consid‚rant la couleur) contenant au moins une bombe. Les deux composantes connexes sont d‚truites. Conseils: _ Il peut ˆtre int‚ressant de r‚unir les piŠces de mˆme couleur pour que plus d'hexagones soient d‚truits lors d'une mise en contact direct de deux bombes. _ Les touches Q, Insert et Clr-Home peuvent ˆtre trŠs utiles pour faire glisser des piŠces sous d'autres piŠces (pour boucher certains trous). Note 1: il est normal qu'au d‚but vous n'arriviez pas … faire de ligne. Au fur et … mesure que vous jouerez, vous aller vous am‚liorer. De plus, la version d‚mo est plus difficile que la version shareware. Note 2: ce fichier de rŠgle contient un petit bug que l'on ne remarque que dans certains cas trŠs rares (qui ne se sont jamais produits avec moi). Une version corrig‚e sera fournie plus tard. 6. Diff‚rences avec la version 1.10 enregistr‚e: """""""""""""""""""""""""""""""""""""""""""" Elles sont nombreuses. Voici ce que permet de faire en plus la version enregistr‚e: _ Existence d'autres fichiers de rŠgle (plus faciles): d‚j… existants: Tetrhex (version plus int‚ressante et un peu plus facile), Hexcolumns; pr‚vu: Tetrhex light (beaucoup plus facile); et peut-ˆtre une autre rŠgle... _ Possibilit‚ de modifier les fichiers de rŠgle existants et de cr‚er ses propres rŠgles; toute la documentation n‚cessaire sera fournie dans la version enregistr‚e, mais il vaut mieux savoir bien programmer pour pouvoir cr‚er ses propres rŠgles. L'‚criture des rŠgles se fait dans un langage sp‚cifique … TETRHEX (langage interpr‚t‚), proche … la fois des langages fonctionnels (calculs d'expressions en notation pr‚fix‚e) et de l'assembleur (langage de bas niveau). Le format des fichiers de rŠgle de la version shareware est diff‚rent de celui de la version d‚mo. _ Possibilit‚ de charger d'autres fichiers de rŠgle (touche Undo). _ Sauvegarde des meilleurs scores. _ Aide sur TETRHEX et sur le fichier de rŠgle charg‚ (touche Help). _ Existence du radar (visualisation de la piŠce suivante). _ Possibilit‚ de pause (configurable dans les fichiers de rŠgle). _ Possibilit‚ de jouer dans une fenˆtre GEM (notamment sous MultiTOS). TETRHEX supporte la version 4.1 de l'AES: possibilit‚ d'iconifier la fenˆtre. _ Possibilit‚ de modifier l'intensit‚ des hexagones et du tableau (sous forme d'options). _ Meilleur affichage par d‚faut (les piŠces et les motifs sur les piŠces sont plus visibles). _ Possibilit‚ de donner … TETRHEX, sous forme d'option, un ensemble de routines relogeables permettant de communiquer avec l'ext‚rieur. Par exemple, on peut ‚crire des routines pour pouvoir jouer au Joypad, ou mˆme par la voix (en faisant une mini-reconnaissance vocale par le DSP; ‡a devrait ˆtre possible), pour faire jouer l'ordinateur, pour jouer des modules … certains moments donn‚s, pour mettre ses propres images comme image de fond, etc... Ces routines n'existent pas pour le moment, mais elles peuvent ˆtre ‚crites sans avoir … modifier l'ex‚cutable TETRHEX (la documentation n‚cessaire … l'‚criture de telles routines sera fournie dans la version enregistr‚e). Les routines d'affichage d'images et de soundtrack seront normalement fournies. _ Menu am‚lior‚. Affichage de "game over" lorsque l'on perd. Touche Escape pour revenir au menu (au lieu de Ctrl-Escape). _ Adaptation … des versions de SpeedoGDOS pour lesquelles les num‚ros des fontes sont translat‚s. 7. Logiciels utilis‚s: """""""""""""""""" Le source de TETRHEX a ‚t‚ ‚crit … l'aide des ‚diteurs de textes suivants: Edith 1.0 (d'Annius V. Groenink), Edith Pro (d'Annius V. Groenink) et Everest (d'Oliver Schmidt). TETRHEX a ‚t‚ assembl‚ et d‚bugg‚ avec Assemble et Adebug (de Brainstorm). Vincent LefŠvre. (email: vlefevre@ens.ens-lyon.fr) -- Fin du fichier --