home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / game / think / mastermind / mastermind.doc < prev    next >
Encoding:
Text File  |  1993-12-04  |  8.3 KB  |  217 lines
  1.  
  2. Program name:  MasterMind V1.6
  3.  
  4. What it does:  Implements the game of Master Mind 
  5.  
  6. Author:        Kamran Karimi
  7.  
  8. Written with:  SAS/C 6.00
  9.  
  10. Source:        Included
  11.  
  12. Machine:       Amiga 1200
  13.  
  14. Run methode:   From both WorkBench and Shell
  15.  
  16. Program status:You can run the program freely, but I retain the Copyright 
  17. to the program including the source and the executable form of it.
  18. -----------------------------------------------------------------------------
  19.  
  20. Directory contents:
  21.  
  22.  MasterMind <-- The program itself
  23.  
  24.  MasterMind.doc <-- The file you are reading now
  25.  
  26.  MasterMind.jl <-- this is a demo of how to use MasterMind. To use it,
  27.                    first run MasterMind, then this program
  28.  
  29.  MasterMind.jl.doc <-- a short explanaition of masterMind.jl
  30.  
  31.  Source/MasterMind.c <-- source of mastermind
  32.  
  33.  Source/misc.h <-- header used by MasterMind.c
  34.  
  35.  Source/MasterMind.jl.c <-- source of MasterMind.jl
  36.  
  37.  Source/MasterMind.jl.h <-- header used by MasterMind.jl.c
  38. -----------------------------------------------------------------------------
  39.  
  40.  
  41.  What Is Master Mind?
  42.  
  43.  Master Mind is a simple but interesting game: The Amiga chooses some
  44. colors randomly and places them in a row. You have to guess not only
  45. the colors, but also their places in the row. To do this, you guess
  46. some colors and place them in a row as you see appropriate. When done,
  47. the Amiga shows you the results by way of white and black circles.
  48.  
  49.  A white circle shows that a color you have guessed is among the ones 
  50. the Amiga has chosen. A black circles says that one of the colors you
  51. have guessed matches one of the Amiga's, more than that, it says that
  52. the column of this color is the same as that of the Amiga's. Neither
  53. white nor black circles don't say to which of your guessed colors they
  54. belong. Also if a black circle appears for one of your guessed colors,
  55. then no white circle will be shown for it.
  56.  
  57.  You use these information to help a better guess in the next row, until
  58. you either find the correct colors and their order, or you lose.
  59.  
  60.  No timer is provided for this version so you can think as long as you 
  61. want.
  62.  
  63.  Note that in this progam the Amiga does not choose duplicate colors. This 
  64. simplifies the game.
  65. -----------------------------------------------------------------------------
  66.    
  67.  This Implementation:
  68.  
  69.  You can change many properties of the game including Board dimension 
  70. and the number of colors to guess among.
  71.  
  72.  The board can be as small as having just one column and one row.
  73. Maximum number of rows and columns depends on the Amiga the program is 
  74. running on. See 'What You Get...' for more information.
  75.  
  76.  If number of rows exceeds 11 in PAL (8 in NTSC) the screen is changed into
  77. an interlaced one. (unless you have OS2.0 or newer and suppress this with
  78. 'NOINTERLACE' in tool types or 'e' in command line).
  79.  
  80.  The default configuration has 10 rows for PAL (8 for NTSC), 4 columns
  81. and 6 colors to choose among. To configure the board, click on the
  82. 'Configure' gadget. three string gadgets appear, into which you can enter 
  83. number of rows, columns and number of colors to choose among. When done,
  84. click on the 'Done!' gadget. Note than selecting a large screen in an
  85. Amiga with little chip memory may lead to program termination, so consider
  86. the amount of your chip RAM when configuring.
  87.  program compute the permutation of total colors and number of columns. row
  88. number should be less than this.
  89.  Any configuration not appropriate from the program's point of view is 
  90. changed to defualt values.
  91.  
  92.  To start playing, you should fill the first row, that is the lowest row
  93. in the board. fill the row with colors. When done, click on the '<- Done'
  94. gadget. You should not choose duplicate colors and all the row should be
  95. filled. Considering these are done, the program shows you white and black
  96. circles as appropriate and you can begin filling the next row up.
  97.  
  98.  The game starts officially when you click '<- Done' the first time. After
  99. that 'Quit Game' and 'Configure' gadgets become disabled, and 'Cheat!' and
  100. 'Abort!' are enabled.
  101.  
  102.  If you are filling the top rows of the board, you may want to click the
  103. right mouse button. This opens a window near the mouse pointer with the 
  104. color gadgets. You can drag this any where you like. Clicking right mouse
  105. button another time, puts the color gadgets to their original place. 
  106.      
  107.  Another option is cheating, if you click on the 'Cheat!' gadget, one of the
  108. colors the Amiga has chosen is shown, but not its position.
  109.  
  110.  After the game has begun, you can terminate the current play by clicking
  111. on the 'Abort!' gadget. After this, a window opens showing the correct 
  112. settings and you should close it to continue.
  113.  
  114.  You lose a game when you fail to find the colors and their order in the
  115. last row. In this case also, the window with correct color and order is
  116. showed, which you should close before continuing.
  117.  
  118.  If you win, you should click on the 'OK' gadget to continue.
  119.  
  120.  Some text appears in the upper right corner of the screen. This may be
  121. considered as help. Error texts are in red and accompanied by a screen beep.
  122.   
  123.    
  124.  What You Get If You Have...
  125.  
  126. OS1.2 or OS1.3:
  127.  In this case you have the basic game. You can choose among at most 12
  128. colors. board dimentions can have up to 24 rows in PAL (18 rows in NTSC)
  129. and 9 columns.
  130.  
  131. OS2.0:
  132.  You get a Public Screen with the name of MasterMind (if not suppressed
  133. with 'CUSTOMSCREEN' in tool types or 'm' in command line).
  134.  The board can have up to 99 rows and 12 columns. If the number of rows
  135. becomes more than 24 in PAL (18 in NTSC) or the number of columns becomes 
  136. greater than 9, an scrollable window is opened. This is reflected in the 
  137. screen name. You may not be able to use very large boards because of lack 
  138. of chip RAM.
  139.  
  140. OS2.0 and ECS:
  141.  Here the program tries to open a PAL screen on NTSC machines (if not
  142. suppressed with 'NOPAL' in tool types or 'n' in command line).
  143.  
  144. OS3.0:
  145.  Nothing that the user can see, but OS3.0 graphics routines are used in 
  146. this case. As I don't have access to 3.0 includes, few 3.0-specific
  147. features could be used.
  148.  
  149.  
  150.  ARGUMENTS:
  151.  To change configuration before starting the program, you may use command
  152. line arguments (if started from CLI) or tool type arguments (if started
  153. from WorkBench). To change the tool types, you should use 'Information'
  154. or 'Info' from WorkBench menus on the icon of the program. 
  155.  In Shell, type 'MasterMind ?' for a brief explanation of command line
  156. arguments. In Workbench, all the arguments are present in the program
  157. icon, but either set to default values or disabled by appending a ';' to
  158. them (like ';CUSTOMSCREEM').
  159.  
  160.  To change board columns:
  161.   In CLI:       Enter: 'g' or 'G' followed immidiately with the number you
  162.                  want. Example: g5.
  163.   In WorkBench: Type 'GUESS' and the number you like in tool types.
  164.                  Example: GUESS=6.
  165.   Default:      4.
  166.   Minimum:      1.
  167.   Maximum:      Machine dependent (9 or 12).      
  168.  
  169.  To change board rows:
  170.   In CLI:        Enter 't' or 'T' fllowed immidiately with the number you
  171.                   want. Example: T80. 
  172.   In WorkBench:  Type 'TRIES' and the number you like in tool types.
  173.                   Example: TRIES=12.
  174.   Default:       10 for PAL, 8 for NTSC.
  175.   Minumum:       1.
  176.   Maximum:       Machine dependent (24/18 or 99).
  177.  
  178.  To change number of colors to choose among:
  179.   In CLI:        Enter 'c' or 'C' followes immidiately with the number you
  180.                   want. Example: c12.
  181.   In WorkBench:  Type 'COLORS' and the number you like in tool types.
  182.                   Example: COLORS=3.
  183.   Default:       6.
  184.   Minimum:       2.
  185.   maximun:       12.
  186.  
  187.  To prevent opening a public screen:
  188.  (Ignored under 1.2 and 1.3)
  189.   In CLI:        Enter 'm' or 'M'.
  190.   In WorkBench:  Type 'CUSTOMSCREEN' in tool types.
  191.   Default:       Opens a public screen.
  192.  
  193.  To prevent the programm from opening an interlaced screen:
  194.  (Ignored under 1.2 and 1.3)
  195.   In CLI:        Enter 'e' or 'E'.
  196.   In WorkBench:  Type 'NOINTERLACE' in tool types.
  197.   Default:       Uses interlace screen.
  198.  
  199.  To prevent the program from opening a PAL screen in NTSC machines:
  200.  (Ignored under 1.2 and 1.3)
  201.   In CLI:        Enter 'n' or 'N'.
  202.   In WorkBench:  Type 'NOPAL' in tool types.
  203.   Default:       tries to opens a PAL screen.
  204. -----------------------------------------------------------------------------
  205.  
  206.  
  207.  My Address:
  208.  
  209.  You can reach me at the following address:
  210.  
  211.         Kamran Karimi
  212.         2,HassanAbad
  213.         HaghShenas str.
  214.         Navab str.
  215.         13599 - Tehran
  216.         Iran
  217.