                   *************************************
                   *                                   *
                   *     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 --
