home *** CD-ROM | disk | FTP | other *** search
/ MORE WinGames / WINGAMES.iso / microman / micro1.txt < prev    next >
Text File  |  1993-04-01  |  11KB  |  339 lines
  1.  
  2.                          The Adventures of MicroMan
  3.                          ==========================
  4.  
  5.                         Adventure 1: Crazy Computers
  6.  
  7.  
  8.                      (Shareware - unregistered version)
  9.  
  10.  
  11.                 Programmed and Developed by: Brian L. Goble
  12.  
  13.                      Copyright (c) 1993 Brian L. Goble
  14.  
  15.  
  16.  
  17. WHAT IS MICROMAN - ADVENTURE 1?
  18. ===============================
  19.  
  20. This Text file provides deatiled information.  For summary information
  21. about this program, please refer to the README.TXT file.
  22.  
  23. MicroMan - Adventure 1, is an arcade-action style game for Windows 3.1
  24. developed by Brian Goble using the Windows Animation Package (WAP) which was
  25. also developed by Brian Goble.
  26.  
  27. The object of MicroMan is to run, jump, duck, climb and shoot your way past
  28. the enemies while exploring new areas and collecting special powerups!
  29.  
  30. MicroMan - Adventure 1, is shareware.  Use beyond a 30 evaluation period
  31. requires that you register this program with the author.  Registered users
  32. will receive Adventure 2 of the MicroMan Adventure Series plus a special
  33. bonus Windows application: WallMan.
  34.  
  35. You are free to distribute this program as long as all files are included
  36. and no changes are made.  It is requested that shareware distributors
  37. notify the author.
  38.  
  39.  
  40. WHAT FILES SHOULD THE MICROMAN ARCHIVE CONTAIN?
  41. ===============================================
  42.  
  43. The MicroMan archive should contain the following files:
  44.  
  45.    * MICRO1.EXE
  46.    * MICRO1.IMG
  47.    * MICRO1.RMP
  48.    * MICRO1.WAV
  49.    * MICRO1.PG1
  50.    * MICRO1.PG2
  51.    * MICRO1.TXT
  52.    * README.TXT
  53.    * REGISTER.TXT
  54.  
  55.  
  56. WHAT SYSTEM REQUIREMENTS ARE NEEDED TO RUN MICROMAN?
  57. ====================================================
  58.  
  59. System requirements and recommendations for running MicroMan are:
  60.  
  61.    * Microsoft Windows 3.1  (required)
  62.    * 2 megabytes of memory  (required)
  63.    * 1 meg free disk space  (required)
  64.    * 386DX processor        (recommended)
  65.    * 8-bit color graphics   (recommended)
  66.    * Sound card             (optional)
  67.  
  68.  
  69. HOW DO I INSTALL MICROMAN?
  70. ==========================
  71.  
  72. To install MicroMan, simply copy all the files from the disk (or decompressed
  73. archive) to any directory of your choosing on your hard disk.
  74.  
  75.  
  76. HOW DO I RUN MICROMAN?
  77. ======================
  78.  
  79. To run MicroMan, select "Run..." from the "File" menu in Program Manager.
  80. Next, enter the full pathname (e.g. C:\WINDOWS\GAMES\MICRO1.EXE) and press
  81. the enter key.
  82.  
  83. Alternatively, you can double-click on MICRO1.EXE from File Manager or you
  84. can create a MicroMan icon in Program Manager.  Refer to your Windows
  85. documentation for more information.
  86.  
  87.  
  88. HOW DO I PLAY MICROMAN?
  89. =======================
  90.  
  91. To play MicroMan, select "New Game" from the "File" menu (or press Ctrl+N).  
  92. Press F1 to view the quick reference help screen.  Use the arrow keys to move,
  93. the space-bar to jump (hold longer to jump higher) and the "Ins" key to shoot.
  94. To explore new rooms, simply move to the edge of the screen (and keep going)
  95. to enter the neighboring room.
  96.  
  97. Left Arrow    - Move left, aim left (keypad arrows work best)
  98. Right Arrow   - Move right, aim right
  99. Up Arrow      - Climb up, grab ladder
  100. Down Arrow    - Climb down, duck
  101. Space-Bar     - Jump (hold space-bar longer for higher jumps)
  102. Ins Key       - Shoot a bullet (keypad Ins works best)
  103.  
  104. The keypad works best for game play--make sure Num-Lock is off.  Use
  105. your left hand to jump with the space-bar and place your right hand over
  106. the keypad, with your thumb on the Ins key for firing.
  107.  
  108.  
  109. WHAT IF MY SYSTEM IS TOO SLOW?
  110. ==============================
  111.  
  112. If your system runs MicroMan too slowly, you can select "Skip Frames" from
  113. the "Animation" menu.  This will result in faster, but jerkier animation.
  114.  
  115. You can also un-select "Energy Bar" from the "Display" menu.
  116.  
  117. Un-selecting "Fancy Wipes" under the "Display" menu will speed screen
  118. transitions when the game is in "attract" mode.
  119.  
  120.  
  121. WHAT IS THE MICROMAN STORY?
  122. ===========================
  123.  
  124. MicroMan is the victim of a top-secret experiment that went terribly wrong.
  125.  
  126. Wearing a special weapons suit, Bob Jones voluntarily stepped into the
  127. Molecular Miniaturizer created by Dr. Schnapps.  Dr. Schnapps turned on the
  128. power and the miniaturization process began.
  129.  
  130. After a few moments of blinding light, Bob Jones was reduced to the size of
  131. a few microns.  The experiment seemed to be a success but the Molecular
  132. Miniaturizer suddenly started smoking and a few seconds later, exploded,
  133. killing all those in the lab, including Dr. Schnapps.
  134.  
  135. Bob Jones, now known as MicroMan, was never found after the explosion.
  136. However, since the Molecular Miniaturizer and it's creator had both been
  137. destroyed, it didn't really matter--there was no hope to return him to his
  138. original size.
  139.  
  140. MicroMan now finds himself in a strange and hostile world where he is one
  141. of the smallest inhabitants.  Now, his mission is personal: to explore and
  142. stay alive.
  143.  
  144.  
  145. HOW DO I REGISTER MICROMAN?
  146. ===========================
  147.  
  148. By registering this shareware program, you will receive the following:
  149.  
  150.   * Registered version of MicroMan - Adventure 1  (with cheat mode!)
  151.  
  152.   * Maps, tips, hints, and secrets for MicroMan - Adventure 1
  153.  
  154.   * MicroMan Adventure 2: Savage Stones  (new graphics, sounds, and puzzles!)
  155.  
  156.   * Special bonus Windows application:  WallMan (with five images!)
  157.  
  158.  
  159. To register, send $25 to:    Brian L. Goble
  160.                 2218 Franklin Ave E.
  161.                 Seattle, WA 98102
  162.  
  163. Please specify disk size (5 1/4" or 3 1/2") and whether your Windows system
  164. uses 16 or 256 colors.
  165.  
  166. You can also print the REGISTER.TXT file and use the included registration
  167. form.
  168.  
  169. It is my goal to create the highest quality games for the Windows environment
  170. in terms of graphics, animation, and playability.  Please help support my
  171. continuing efforts by registering this software.
  172.  
  173.  
  174. IS THERE A WARRANTY FOR THIS SOFTWARE?
  175. ======================================
  176.  
  177. This software is provided "as is".  Although the author has made extensive
  178. efforts to make sure no bugs exist in this software, the author claims no
  179. responsibility for any damages you may experience as a result of using this
  180. software.  Use at your own risk.
  181.  
  182. If you do find any bugs, please report them to the author.
  183.  
  184.  
  185. ------------------------------------------------------------------------------
  186.  
  187.  
  188. WHAT IS WAP?
  189. ============
  190.  
  191. WAP stands for Windows Animation Package.  The package implements real 
  192. software sprites and flicker-free sprite animation under Microsoft Windows.
  193. WAP was developed for use with 8-bit color but is able to execute on systems
  194. using less than 256 colors as well.
  195.  
  196. The heart of WAP is the WAP.OBJ file which is linked with the Windows 
  197. application that wants to use WAP's services.  WAP also consists of 3 utility 
  198. applications for capturing sprites, editing rooms/maps, and manipulating
  199. palettes.
  200.  
  201. WAP was developed by Brian L. Goble.
  202.  
  203.  
  204. WHAT LANGUAGE WAS USED TO CREATE WAP?
  205. =====================================
  206.  
  207. WAP was compiled using Microsoft C/C++ 7.0.  No C++ was used however.
  208.  
  209.  
  210. WHAT CONCEPTS DOES WAP SUPPORT?
  211. ===============================
  212.  
  213.    * Sprites
  214.    * Images
  215.    * Patterns
  216.    * Frames
  217.    * Pages
  218.    * Rooms
  219.    * RoomSprites
  220.  
  221.  
  222. WHAT SPRITE FEATURES DOES WAP SUPPORT?
  223. ======================================
  224.  
  225.    * Drawing
  226.    * Moving
  227.    * Erasing
  228.    * Clipping
  229.    * Flashing
  230.    * Mirroring
  231.    * Inverting
  232.    * Mirverting
  233.    * Removing
  234.    * Virtual Frames
  235.    * Collision Detection
  236.    * Sprite Types
  237.    * Sprite States
  238.    * Sprite Control Programs
  239.  
  240.  
  241. IS WAP EASY TO USE?
  242. ===================
  243.  
  244. WAP is very easy to use.  All the low level functions required for flicker- 
  245. free sprite animation are carried out by WAP.  The programmer merely calls
  246. the high level functions when necessary.
  247.  
  248. A typical main animation loop might consist of the following WAP routines:
  249.  
  250. // --------------------------- //
  251. // Example Main Animation Loop //
  252. // --------------------------- //
  253.  
  254.   case WM_TIMER:
  255.  
  256.     WAP_ProcessSprites(lpWAP);           // execute sprite control programs
  257.     WAP_DrawSprites(lpWAP);            // draw all active sprites
  258.     WAP_SwapPages(lpWAP);              // display new sprites, erase old ones
  259.     WAP_CheckSpriteCollisions(lpWAP);  // check for sprite collisions
  260.  
  261.     return(0L);
  262.  
  263.  
  264. The main programming effort required by the programmer is the coding of the 
  265. Sprite Control Programs (SCP).  A SCP is a routine that controls a specific 
  266. sprite.
  267.  
  268. For example, a simple SCP to animate a sprite walking across the screen to
  269. the right might look something like:
  270.  
  271. // ------------------------------------------------------- //
  272. // Example Sprite Control Program for Walking to the Right //
  273. // ------------------------------------------------------- //
  274.  
  275. int       FAR    WalkRight(lpS)
  276.  
  277. LPSPRITE  lpS;
  278.  
  279. {
  280.  
  281.   if (lpS->MoveState == MS_UNINIT) {       // if first time, initialize sprite
  282.  
  283.     lpS->MoveState = MS_WALKING;           // set move state to walking
  284.     lpS->x = 10;                           // set initial x coordinate
  285.     lpS->y = 50;                           // set initial y coordinate
  286.     lpS->image = 5;                        // use graphic image #5
  287.     lpS->frame = 1;                        // use frame #1 of image #5
  288.   }
  289.  
  290.   else if (lpS->MoveState == MS_WALKING) { // process next frame of walking
  291.  
  292.     lpS->x++;                              // increment x coordinate
  293.  
  294.     if (lpS->x > 600) {                    // is sprite at right border?
  295.       lpS->SpriteFlags |= SF_REMOVE;       // if done walking, remove sprite
  296.     }
  297.  
  298.     lpS->frame++;                          // use next animation frame
  299.     if (lpS->frame > 24) lpS->frame = 1;   // if end of frames, wrap to start
  300.   }
  301.  
  302.   return(1);                               // finished - return to WAP
  303. }
  304.  
  305.  
  306. So, by using SCP's, the programmer still has full control over all sprite
  307. actions and logic but doesn't have to worry about all the tasks necessary
  308. to animate them--WAP performs these necessary tasks!
  309.  
  310.  
  311. HOW CAN I OBTAIN WAP
  312. ====================
  313.  
  314. Currently, WAP is not available on a general, wide-spread basis.  However,
  315. if you are working on a finanacially supported software poject and would
  316. like to use WAP in your product, please contact the author for further
  317. discussion.
  318.  
  319. In the future, the author hopes to create proper documentation for WAP so
  320. that it can be made available to all interested programmers--regardless
  321. of their experience level regarding graphics and animation programming.
  322.  
  323.  
  324. HOW CAN I CONTACT THE AUTHOR?
  325. =============================
  326.  
  327. To contact the author of both WAP and MicroMan, use:
  328.  
  329.     Brian L. Goble
  330.     2218 Franklin Ave E.
  331.     Seattle, WA 98102
  332.     (206) 322-7932
  333.     goble@u.washington.edu
  334.  
  335.  
  336. Please contact me if you questions, offers, or comments...I would like
  337. to hear from you.
  338.  
  339.