home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / games / wcoltris / readme.txt < prev    next >
Text File  |  1995-01-01  |  9KB  |  235 lines
  1. WinColTris  V2.0  27.12.1994
  2.  
  3. yet another COLUMNS and TETRIS version
  4.  
  5. written by Th. Morus Walter
  6. (c) 1994 by Never Ready Software, Morus Walter
  7.  
  8. This program is FREEWARE!
  9.  
  10. Th. Morus Walter
  11. Schulstr. 22
  12. 93080 Pentling
  13. FEDERAL REPUBLIC of germany
  14.  
  15.  - - - - -
  16.  
  17. First of all, I want to apologize for my bad english and all the mistakes
  18. i made
  19.  
  20.  - - - - -
  21.  
  22. WinColTris V2.0 is a new version of ColTris V1.0.
  23. Since there was already a tetris-program called ColTris, I decided to
  24. use a new name for my ColTris. The Win stands for window (not Windows,
  25. and not MS-Windows at all). However I will sometimes use the old name
  26. COLTRIS in this document.
  27.  
  28. When writing V1.0, I thought windows would be to much work and not very
  29. neccessory. This has changed in V2.0.
  30. The other new feature in V2.0 is the support of color-resolution. This
  31. is not quite as fast as monochrom, since WinColTris uses the VDI in
  32. color-resolutions, but I think it is fast enauge. (You should NVDI
  33. or something else to speed up things).
  34.  
  35. Preface to V1.0 (partially)
  36. ---------------------------
  37. yet another COLUMNS and TETRIS version - why?
  38.  
  39. There are a lot of columns and tetris versions, so why another one?
  40. Until now, I used PCM van der Arends COLUMNS and STETRIS. I liked these
  41. versions but they don't run with MagiX (especially not if you use
  42. AutoswitchOverscan).
  43. So I needed an alternative and couldn't find one I liked (although
  44. there were a lot of programs).
  45. Therefore I wrote my own program (using PCM van der Arends programs as
  46. a model) and here it is.
  47.  
  48. Compared to PCM van der Arends programs there are some missing features,
  49. on the other hand there are some advantages.
  50.  
  51.  - - - - -
  52.  
  53. COLTRIS should run on every ST/TT/Falcon.
  54.  
  55. COLTRIS works under MagiX (I guess also MultiTOS but I couldn't check);
  56. in the 'multi'-Mode of COLTRIS you can play without blocking the screen.
  57.  
  58.  - - - - -
  59.  
  60. I guess everyone knows columns and tetris, so I won't explain the games.
  61.  
  62.  - - - - -
  63.  
  64. COLTRIS V2.0 runs - other than V1.0 did - only as a program, since it uses
  65. a pulldown menu. You can't use it as a accessory.
  66.  
  67. WinColTris uses up to four windows, for the game itself, the scoring, the
  68. preview and a statistic.
  69.  
  70. After starting the program the main window, more windows if active and the
  71. menu is displayed.
  72.  
  73. WinColTris provides the following menu items:
  74.  
  75. menu 'WinColTris' entry 'about WinColTris':
  76. you guess it...
  77.  
  78. menu 'File':
  79.   entry 'Play'
  80.     Hmm, what might this mean.
  81.     If you reach a new hiscore, you will be ask to enter your name at
  82.     the end...
  83.   entry 'Hiscore'
  84.     show the hiscore-table of the active game
  85.     If the last result was a new hiscore, it's entry will be marked
  86.     by '*'
  87.   entry 'Save'
  88.     Save hiscore AND options
  89.     The hiscore is not save automatic.
  90.     Together with the options, the window postions are save. This is
  91.     done separate for up to 8 screen resolutions.
  92.   entry 'Quit'
  93.     lets go...
  94.  
  95. menu: 'Options':
  96.   entry 'Tetris'
  97.     set playmode to tetris
  98.   entry 'Columns'
  99.     set playmode to columns
  100.    if the playmode is changed, the main window is adjusted and the other
  101.    windows are shown according to the settings for the game, this means
  102.    you can toggle the preview on for tetris and off for columns...
  103.   entry 'Score'
  104.    toggle the score-window
  105.   entry 'Preview'
  106.    toggle the preview
  107.   entry 'Statistic'
  108.    toggle the statistic
  109.   entry 'Options'
  110.     set options
  111.     These are partially separate for columns and tetris, so you get
  112.     the tetris options if 'tetris' is selected and the columns options
  113.     if 'columns' is selected (together with the common options).
  114.     First you can select the start level for the game. Second you can
  115.     select some random preset for the game.
  116.     The rest of the options is common.
  117.     There are two graphics modes in COLTRIS. If the screen is comparable
  118.     to ST-high-res (just the organisation of the bitmap, this does not
  119.     mean that you have to have 640x400 pixels) you might use 'ST'. The blocks
  120.     are then copied to the screen directly. LineA variables are used
  121.     to get the screen width and Logbase() to get the screen adress in this mode
  122.     (COLTRIS does NOT use LineA besides this).
  123.     Otherwise use 'VDI'. The blocks are then copied to the screen by the VDI.
  124.     The VDI is slower than my assembler routines, but there should be no
  125.     flickering since there is a buffer.
  126.     In color resolutions VDI is used automaticly.
  127.     Next you can select the playmode: in the mode 'single' WinColTris takes
  128.     control over screen and mouse, so window-operations etc. are impossible,
  129.     other programs (under multitasking) can't do any output (this causes
  130.     a minor problem if you toggle the windows during game (see below).
  131.     If you switch of a window and the background is another window
  132.     this window can't be redrawn. So the window seems to stays on the screen.
  133.     If the background is the desktop the screenmanager does redraw (don't
  134.     understand that), so the problem is relevant under multitasking only...).
  135.     In the other mode ('multi') WinColTris simply tops it's windows.
  136.     Mouse- and screen-control isn't taken, so other programs can do
  137.     output, windows can be moved... This mode is slower, since the window
  138.     has been checked every output. The WinColTris' menu items can be
  139.     used partialy, however shortcuts aren't possible. The AV/VA send-key
  140.     message, which is used to send unrecognized keys to the AV/VA-server
  141.     (if there is one, e.g. gemini or ease, in multitasking), is not used.
  142.     PLEASE NOTE: even if the names of the modes sound like, you don't have
  143.     to use 'single' under single-tos and 'multi' under multitasking.
  144.     Both modi are possible unter both OS...
  145.     Next you can select the AV/VA mode, which is interesting in multitasking
  146.     if you have an good desktop like gemini or ease. You can set, which
  147.     windows WinColTris should tell the desktop, so that they participate
  148.     in the window cycling (via Ctrl-W).
  149.     The last button is to set, wether all windows or the main window only
  150.     should be raised when starting a game.
  151.     With the last option you can choose the user-defined keys. You can
  152.     define (additional) keys for the basic functions (stone left, stone
  153.     right, rotate stone and drop stone).
  154.  
  155.  - - - - -
  156.  
  157. Shortcuts:
  158. besides the shortcuts shown in the menu you have the following possibilities:
  159.  
  160. all commands apart from 'ctrl S' and 'ctrl Q' can be used without ctrl.
  161. 'return' and 'enter' start the game.
  162.  
  163.  - - - - -
  164.  
  165. While playing several keys are predefined:
  166.  
  167. 7#     stone left
  168. 9#     stone right
  169. 8#     rotate stone
  170. 4#     drop stone
  171. space  drop stone
  172. q      quit game
  173. esc    quit game
  174. s      stop game (continue with any key)
  175. l      increase level
  176. *#     increase level
  177. n      toggle preview (next)
  178. b      toggle statistics
  179. i        toggle score
  180.  
  181. The hash (#) indicates keys on the num-pad (COLTRIS uses scancodes, however
  182. there shouldn't be problems with non-german keyboards).
  183. Userdefined keys are interpreted first, so they may overwrite the predefined
  184. keys (defining a user key 'n' for example disables the toggling of the
  185. preview during the game).
  186.  
  187. If you toggle a window during game, it's old value will be restored at the
  188. end of the game.
  189.  
  190.  - - - - -
  191.  
  192. Sprites:
  193.  
  194. At first i wrote WinColTris for monochrom resolutions only. The only
  195. sprites included are for this case.
  196. In other cases (four or more colors) the sprites are loaded from
  197. IMG-files (without color-table). You can do that also in monochrom,
  198. but then WinColTris uses the VDI-mode for graphic output.
  199.  
  200. The files have the names COLUMNSx.IMG und TETRISx.IMG, where x means
  201. the number of planes (4 colors -> 2 planes, 16 colors -> 4 planes,
  202. 256 colors -> 8 planes, True/HiColor is impossible).
  203. There are separate files for columns and tetris, however you might
  204. use the same file twice (note: tetris is 10x20, columns 6x16 stones).
  205.  
  206. The stones can have any size. There is no check wether the main window
  207. fits on the screen.
  208.  
  209. The IMG-files has to contain one line with 16 sprites, where
  210.  
  211. the first one is empty (it's used to delete),
  212. the second to the eighth are the differant colors of the stones
  213.   (column does not use the last one)
  214. the nineth to thirteenth are shown as a 'film' before stones are removed
  215. the last three stones are unused (they have to be there, otherwise
  216.   the width can't be calculated correctly).
  217.  
  218. The stones don't have to be quadratic, however all stones have to
  219. have the same width.
  220.  
  221. The colortable of a XIMG-file is ignored.
  222.  
  223. The example files (equal for columns and tetris) are very ugly.
  224. They should be used to create one stones not to play (I don't use
  225. color...)
  226.  
  227.  - - - - -
  228.  
  229. known bugs (not everything below is really a bug):
  230.  
  231. there is almost NO error handling on reading and writing the opts file
  232. (COLTRIS.SET).
  233.  
  234.  
  235.