* The Same Game : documentation *

1) Dispositions lgales
-----------------------

Ce logiciel obit a la GNU General Public Licence. Pour plus d'informations,
consultez le fichier COPYING.


2) Historique
-------------

J'ai decouvert de petit jeu que j'ai trouv vraiment sympa. Aprs en avoir
parl avec un copain, il s'est avr que le jeu original tait l'oeuvre d'un
de ses copains... Le monde est petit. Aussi recopie-je le header de la
version X-Window, afin de citer les auteurs originaux :
   /************************************************************************
    * SameGame for X Window (sxsame)                                       *
    * Copyleft  1994,1995  Software Kenkyu Academy                         *
    *  Original idea  Eiji Fukumoto (fukumoto@yh.ntts.co.jp)               *
    *  Produced by    Y.YONEYAMA                                           *
    *  Special thanks Tetsu Satoh   (tetu-s@is.aist-nara.ac.jp),           *
    *                 Yoh Asami     (asami@dv1.nnes.nec.co.jp)             *
    ************************************************************************/

Malheureusement, je n'ai rien compris  la faon dont ils avaient cod le
jeu, donc je l'ai rcris de 0. Et  la fin du compte, j'ai fini par me
retrouver avec un code assez similaire au leur (tant donn que j'avais
compris comment coder problme, je pouvais voir un peu mieux comment marchait
leur code puisqu'on tait sens rsoudre le mme probleme !)
Puis, je me suis apercu qu'une de mes fonctions etait un peu trop rcursive
pour le Pilot (2K de pile !), donc j'ai du repenser cette partie. Aussi
mon code est, je pense un peu plus illisible que le leur, mais mieux adapt
au Pilot. Pour finir, j'ai rajout un mode de jeu supplmentaire qui
n'existait dans la version originale du jeu.


3) Le but du jeu
----------------
Le but du Same Game est de retirer des blocs de mme motif parmis ceux se
trouvant  l'cran. Vous pouvez retirer un bloc si sa surface est suprieure
ou gale  2. Les points sont calculs de la faon suivante : S tant la
surface de la pice retire, cela vous rapporte (S-2)^2 points.
Autrement dit, les blocs de 2 cases ne rapportent rien. Et plus un bloc est
gros plus il vous rapporte de point (dans un rapport au carr).
Vous avez donc intrt  crer des pices de grande surface si vous voulez
faire des hiscores.
Pour retirer une pice, pointez simplement avec le crayon dessus. Les cases
se trouvant au dessus de celles supprimes tomberont alors vers le bas de
l'cran, ce qui pourra recomposer de nouvelles pices.

Si vous arrivez  vider TOUT l'cran, votre score sera augment de 1000 points
de bonus.

Cette version du jeu possde un non mode prsent dans la version originale :
le mode Challenge. Dans ce mode de jeu, le principe reste le mme,  ceci
prs que vous devez prciser au dbut du jeu quel motif vous rapportera des
points quand vous supprimerez de pices avec de motif. Vous devez donc arriver
 dterminer quelle "couleur" vous sera la plus profitable puisque les autres
ne vous rapporteront rien... C'est beaucoup plus dur ;-)
Au dbut du jeu, un petit motif compos d'une barre horizontale situ  ct
de la zone de score vous indique le vous n'avez pas encore choisi votre
challenge.
Pour dire quel motif vous choisissez, lorsque vous commencez un jeu en mode
Challenge, le premier coup, pointez une pice compose de ce motif. Ceci ne
la retirera pas pour cette fois-ci. Vous verrez alors apparatre,  ct de
la zone de score un petit carr rempli avec ce motif pour vous indiquer que
vous avez choisi votre challenge, et ventuellement vous rappeler quel
motif vous avez choisi si vous l'oubliez en cours de jeu ou si vous reprennez
un jeu commenc prcdemment.
Comme il est beaucoup plus difficile de faire des scores comparables  ceux
du mode original, les hiscores ne se mlangent pas entre les 2 modes de
jeu. Sinon, comme ceux du mode Challenge sont souvent plus petits que ceux du
mode standard, on le les verrait pas !

Si votre score est digne de figurer dans la liste des hiscores, votre nom
vous sera alors demand. Dans le cas contraire, rien ne vous sera demand.


Voil, c'est tout.


4) Menus et fonctionnalits
---------------------------
Il y 6 entres dans le menu du jeu :
 * New Game : pour commencer un nouveau jeu en mode original. Si un jeu est
              dj en cours ceci l'abandonne
 * New Challenge : pour commencer un nouveau jeu en mode Challenge. Comme
              pour le mode original, si un jeu est dj en cours ceci
              l'abandonne
 * Standard Hiscores : pour prendre connaissance des 5 plus hauts scores
              raliss en mode standard
 * Challenge Hiscores : pour prendre connaissance des 5 plus hauts scores
              raliss en mode Challenge
 * Rules : pour afficher un petit mmo sur la rgle du jeu
 * About : juste l'histoire de me citer un peu ;-)

The Same Game possde une petite caractristique sympa : il conserve l'tat
de votre partie. Autrement dit, si vous changez d'application ou teignez
votre Pilot en cours de partie, lorsque vous relancerez le jeu, il reviendra
dans l'tat mme o vous l'aviez laiss. Ainsi, vous pourrez continuer
votre partie.

Voila, je crois que c'est  peu prs tout.


5) Me contacter
---------------

Pour tout commentaire, suggestion, rapport de bug, etc, vous pouvez me
joindre par email: francois.pessaux@inria.fr


6) Note technique
-----------------

L'identificateur de ce jeu est 'SaMe', obtenu par enregistrement standard
auprs de 'http://palmpilot.3com.com/devzone/crid/cridsub.html'
