                   *************************************
                   *                                   *
                   *     TETRHEX 1.15 (27/11/1994)     *
                   *                                   *
                   *************************************


Dernire modification: le 28 novembre 1994.


  TETRHEX est un  jeu, ou  plutt un  ensemble de  jeux, de  type Tetris  ou
Columns se jouant sur un tableau hexagonal, avec des cases hexagonales.  Une
des principales caractristiques  est de pouvoir  crer ses propres  rgles.
Cette version est diffuse avec un seul fichier de rgle (TETRHEX.RUL), mais
d'autres fichiers de rgle seront fournis plus tard.

  Cette version peut tre copie et diffuse 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, excepts  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, mme s'il n'est pas diffus.

  TETRHEX est SHAREWARE.  Cela veut dire  que si vous  voulez l'utiliser  et
recevoir la version  complte, 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 accs  Internet,  il est prfrable de me contacter  d'abord
par email. Mon adresse est:

      vlefevre@ens.ens-lyon.fr


La version non enregistre comporte les limitations suivantes:
  . On ne peut pas changer de rgle (la touche UNDO est dsactive).
  . Pas de sauvegarde des scores.
  . Parties limites  5 minutes environ.
  . 10 parties au maximum.
  . Pas de routine extrieure.


  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 ncessaire:
       """"""""""""""""""""""""

  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  entrelacs), ventuellement  avec un  systme d'exploitation  de
remplacement comptatible TOS/GEM.

  TETRHEX a besoin d'environ 300 Ko de mmoire libre (ST RAM ou TT RAM) pour
tourner. Un des deux timers A et D est utilis (cf "Lancement"); par dfaut,
c'est le timer D.


    2. Compatibilit:
       """""""""""""

  TETRHEX peut gnralement tourner avec  les programmes AUTO, mais il  peut
parfois y avoir quelques problmes.  La liste des compatibilits est  donne
ci-dessous.

  _ SpeedoGDOS (tests effectus avec la version 4.0):
     . Si SpeedoGDOS est install, des fontes vectorielles peuvent tre
       utilises, ce qui est recommand.
     . Le changement de rsolution est impossible (cf "Lancement"), mais il
       n'y a pas de plantage.

  _ NVDI (tests effectus avec la version 2.5):
     . Le changement de rsolution 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 rsolution, sinon a
       plante. Pour savoir si la carte Screen Blaster est prsente, on
       recherche le cookie OSBL. Note: ce cookie ne peut tre enlev
       qu'aprs un redmarrage complet (Ctrl-Alt-Rshift-Delete); par
       consquent, il se peut que le changement de rsolution soit refus
       bien que la carte soit totalement dsactive (aprs un redmarrage
       partiel).

  _ MiNT/MultiTOS:
     . Je n'ai pas fait de test avec la version dmo, mais il faut de toutes
       faons viter de lancer la version dmo sous MultiTOS (elle n'est pas
       faite pour tourner sous MultiTOS).
     . La version 1.10 peut tourner sous MultiTOS (dans une fentre).
     . Avec MiNT, il faut dsactiver la protection mmoire, car TETRHEX
       accde directement  la mmoire video pour acclrer l'affichage.

  _ Outside (mmoire virtuelle):
     . Aucun problme dtect (note: les drapeaux de TETRHDEM.PRG concernant
       la TT-RAM peuvent tre activs).

  _ Idle (protecteur d'cran):
     . Lorsque la protection s'active, des blocs de mmoire de TETRHEX sont
       parfois altrs.


    3. Lancement:
       """""""""

  TETRHEX peut tre lanc soit en double-cliquant sur son icne  partir  du
bureau, soit dans un  shell (par exemple dans  celui de Gemini). Il  accepte
des options style Unix, qui peuvent tre donnes de diffrentes manires. On
forme une chane compose  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 aprs avoir double-cliqu sur l'icne, il faut remplacer l'extension
.PRG par l'extension .GTP (quivalent de .TTP pour un programme GEM). Toutes
les options commencent par le caractre  '-' et elles sont spares par  des
blancs (espace et caractres de contrle). La ligne de commande ne doit  pas
contenir plus de  125 caractres.  Si la syntaxe  de la  chane entire  est
incorrecte, le  programme  se  termine immdiatement  (et  renvoie  un  code
d'erreur non nul). Voici les options  (celles qui sont dj reconnues,  mais
qui servent  des fonctions non disponibles dans cette version dmo, ne sont
pas donnes):

   -fg nombre  [Font Game]  Numro de la fonte Speedo utilise dans le jeu
               lui-mme.

   -fm nombre  [Font Menu]  Numro de la fonte Speedo utilise dans les
               menus.

   -fn nombre  [Font Name]  Numro de la fonte Speedo utilise pour afficher
               le nom de la rgle.

   -ft nombre  [Font Tetrhex]  Numro de la fonte Speedo utilise pour
               afficher "TETRHEX 0.43".

   -l param    Prfrences du langage. Il y a autant de paramtres que
               l'on veut (ventuellement aucun). Chaque paramtre est soit
               un nombre positif ou nul, indiquant le langage de manire
               absolue, soit le caractre '?', indiquant le langage donn
               par le cookie _AKP (langage utilis par le systme), soit
               le caractre '*', indiquant un ou plusieurs langages se
               rapprochant de celui du systme. La chane de paramtres par
               dfaut est "* 0 3".

   -n nombre   Taille d'un ct du tableau hexagonal par dfaut (entre 6 et
               9).

   -o fichier  La liste des options restantes est remplace par le fichier
               (extension .CFG).

   -r fichier  Dtermine le fichier de rgle (extension .RUL)  charger
               (cette option ne sert  rien dans la version dmo, car il
               n'existe qu'un seul fichier de rgle 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
               rsolution.

   -vs[+/-]    [Video Synchro]  Synchronisation avec l'interruption VBL pour
               certains affichages.

  Les nombres sont en  dcimal, sauf s'ils sont  prcds d'un '$'; dans  ce
cas, ils sont en hexadcimal. 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  rgle  sur  l'icne  de  TETRHEX.  Ceci
correspond respectivement aux options "-o" et "-r". Note: certaines  options
ont des effets opposs (ta/td, -vr+/-vr-, -vs+/-vs-); seule la dernire dans
la chane d'options est prise en compte.

  Au moment du lancement, si la  touche Shift-gauche est enfonce, c'est  le
timer A qui sera utilis  (sauf si l'option "-td" est  donne) au lieu du  D
(surtout utile  dans la  version shareware,  si le  port srie  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  dfaut). Mais  (sur
Falcon 030 sans carte  acclratrice) on a alors  des parasites sur  l'cran
lors des changements de palette de couleurs, i.e. pendant la prsentation et
quand on passe d'un cran  un autre.

  Si la  rsolution  graphique dans  laquelle  on lance  TETRHEX  n'est  pas
correcte (i.e. 256 couleurs, >= 640 * 480), alors TETRHEX essaie de  changer
de rsolution (sauf si l'option -vr  est donne), mais peut chouer   cause
de certains programmes (cf "Compatibilit").

  N.B.: le fichier de rgle TETRHEX.RUL doit se trouver dans le mme dossier
que l'application TETRHEX.PRG.


    4. Utilisation:
       """""""""""

  Lancer TETRHEX (cf "Lancement"). Pour  sortir de la prsentation,  appuyer
une touche. Un menu apparat:

   . Help: aide (non disponible dans la version dmo).
   . Undo: charger une rgle (non disponible dans la version dmo).
   . Return: jouer.
   . F1-F10: meilleurs scores (non disponible dans la version dmo).
   . Ctrl-Q: quitter.

  Pour jouer, appuyer sur Return. Lorsque  la partie est finie, appuyer  sur
Ctrl-Escape pour revenir au menu.


    5. Rgle TETRHEX.RUL:
       """""""""""""""""

Touches:
  . Q (A sur claviers amricains): aller en bas (la forme s'arrte pendant
    un moment).
  . Insert: aller en bas  gauche.
  . Clr-Home: aller en bas  droite.
  . Flche vers le bas: rotation gauche (sens trigo).
  . Flche vers le haut: rotation droite (sens des aiguilles d'une montre).
  . Flche gauche: aller  gauche (mme hauteur par rapport  la case du bas
    --> dplacement en V).
  . Flche droite: aller  droite (mme hauteur par rapport  la case du bas
    --> dplacement en V).
  . Barre d'espace: drop (la pice tombe).
  . Escape: abandon.
  . Undo: pause.
  . Return: fin de pause.
  . + (pav numrique): passage au niveau suivant.
  . - (pav numrique): passage au niveau prcdent (la rgle l'interdit!
    donc cette touche ne sert  rien ici).
  . Help: radar on/off.
  . Backspace: dtruit tout,  condition que l'on ait au moins une bombe (on
    en a une quand on arrive  1000 points bombes) et que la pice  courante
    ait des bombes.

  Les hexagones sont dtruits dans les deux cas suivants:
    _ Formation d'une  ligne d'hexagones:  les  hexagones situs  sur  cette
      ligne sont dtruits. N.B.: les lignes sont des V.
    _ Si la pice  courante contient des  bombes: mise en  contact de  cette
      pice  avec  une  composante  connexe  (en  considrant  la   couleur)
      contenant au  moins  une bombe.  Les  deux composantes  connexes  sont
      dtruites.

  Conseils:
    _ Il peut tre intressant de runir les pices de mme couleur pour que
      plus d'hexagones soient dtruits lors d'une mise en contact direct de
      deux bombes.
    _ Les touches Q, Insert et Clr-Home peuvent tre trs utiles pour  faire
      glisser des pices sous d'autres pices (pour boucher certains trous).

  Note 1: il est normal qu'au dbut vous n'arriviez pas  faire de ligne. Au
fur et  mesure  que vous jouerez,  vous aller vous  amliorer. De plus,  la
version dmo est plus difficile que la version shareware.

  Note 2: ce fichier de rgle contient un petit bug que l'on ne remarque que
dans certains cas trs rares (qui ne se sont jamais produits avec moi).  Une
version corrige sera fournie plus tard.


    6. Diffrences avec la version 1.10 enregistre:
       """"""""""""""""""""""""""""""""""""""""""""

  Elles sont nombreuses.  Voici ce que  permet de faire  en plus la  version
enregistre:

  _ Existence d'autres  fichiers de  rgle (plus  faciles): dj  existants:
    Tetrhex (version plus intressante et  un peu plus facile),  Hexcolumns;
    prvu: Tetrhex  light (beaucoup  plus facile);  et peut-tre  une  autre
    rgle...

  _ Possibilit de modifier les fichiers de rgle existants et de crer  ses
    propres rgles; toute la documentation  ncessaire sera fournie dans  la
    version enregistre,  mais il  vaut mieux  savoir bien  programmer  pour
    pouvoir crer ses propres rgles. L'criture des rgles se fait dans  un
    langage spcifique  TETRHEX (langage interprt), proche  la fois  des
    langages fonctionnels (calculs d'expressions en notation prfixe) et de
    l'assembleur (langage de bas niveau). Le format des fichiers de rgle de
    la version shareware est diffrent de celui de la version dmo.

  _ Possibilit de charger d'autres fichiers de rgle (touche Undo).

  _ Sauvegarde des meilleurs scores.

  _ Aide sur TETRHEX et sur le fichier de rgle charg (touche Help).

  _ Existence du radar (visualisation de la pice suivante).

  _ Possibilit de pause (configurable dans les fichiers de rgle).

  _ Possibilit de jouer  dans une  fentre GEM  (notamment sous  MultiTOS).
    TETRHEX supporte la  version 4.1  de l'AES:  possibilit d'iconifier  la
    fentre.

  _ Possibilit de modifier  l'intensit des hexagones  et du tableau  (sous
    forme d'options).

  _ Meilleur affichage par dfaut (les pices  et les motifs sur les  pices
    sont plus visibles).

  _ Possibilit de donner   TETRHEX,  sous forme d'option,  un ensemble  de
    routines relogeables  permettant de  communiquer avec  l'extrieur.  Par
    exemple, on peut crire  des routines pour pouvoir  jouer au Joypad,  ou
    mme 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 donns, 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'excutable  TETRHEX
    (la documentation  ncessaire    l'criture  de  telles  routines  sera
    fournie dans la version enregistre). Les routines d'affichage  d'images
    et de soundtrack seront normalement fournies.

  _ Menu amlior. 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 numros  des
    fontes sont translats.


    7. Logiciels utiliss:
       """"""""""""""""""

  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 dbugg avec  Assemble
et Adebug (de Brainstorm).


Vincent Lefvre.

(email: vlefevre@ens.ens-lyon.fr)


-- Fin du fichier --
