home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 7 Games / 07-Games.zip / billy164.zip / readme.os2 < prev    next >
Text File  |  1997-12-21  |  8KB  |  207 lines
  1. Some advice on running the beta
  2. ===============================
  3. It is easiest to run OS2BILLY.EXE from a command line. This gives you
  4. the opportunities to read error messages after exiting, and to use
  5. command line parameters.  Start with VESA_PM.DLL. It is guaranteed to
  6. work on all systems. You can switch between the VESA_*.DLLs by
  7. typing for instance "set VESADLL=VESA_DIV" in the commandline you
  8. launch Billy from.
  9.  
  10.  
  11.  
  12. - VESA_PM.DLL
  13.  
  14. Uses Gpi (Graphic Programming Interface). The standard way to draw in
  15. PM.  This is slow but works without problems on all systems.
  16. This .DLL uses the file PMSCREEN.EXE (included in the package).
  17. By changing some of the settings for pmscreen this .DLL actually runs
  18. at reasonable speed on a Pentium 133.
  19.  
  20.  
  21. - VESA_DIV.DLL
  22.  
  23. This new .DLL from Johannes Martin (author of the EMX-VESA library)
  24. uses DIVE (Direct Interface Video Extension). A current limitation is
  25. that you have to choose 256-colour in your system settings for your
  26. desktop.  To do this in Warp 3: (Exact names may vary, I translate the
  27. danish names for the folders)
  28. open OS/2 System  -  System Settings  -  System
  29. choose "screen" and change "resolution" to:
  30. ???x???x256
  31. For best effect choose "800x600x256".
  32. This .DLL uses the file DIVESCR.EXE (included in the package).
  33.  
  34. On some systems the screen isn't centered when using this .DLL.
  35. To fix this specify your desktop resolution with the command line 
  36. parameter -g.
  37.  
  38.  
  39. - VESA_ALL.DLL
  40.  
  41. This .DLL uses VIO (Virtual Input Output) calls to do screen drawing. 
  42. OS2BILLY.EXE must be run from a full-screen session when using this .DLL. 
  43. My expectation is that this is the fastest of the three .DLLs since 
  44. it accesses the screen DIRECTLY like DOS programs.
  45. I have reports on VESA_ALL.DLL working on the following cards:
  46.     Tseng ET4000w32p    2MB
  47.     S3 Trio V64+        2MB
  48.     Cirrus Logic 5446   
  49.     Cirrus Logic 5428   1MB
  50.     S3 764
  51.  
  52. And not on these cards:
  53.     Trident 9680        
  54.     Matrox Millenium    
  55.     S3 Trio V64+        2MB
  56.     Hercules Stingray
  57.     ATI MACH32
  58.     S3Virge 2MB
  59.     ET6000
  60.     Cirrus 5430         2MB
  61.  
  62. As you can see, there migth be some cards in both list. This might
  63. be something to do with drivers etc. So try with your card, even if it
  64. is in the latter list, and report back to me.
  65.  
  66.  
  67.  
  68. Command line parameters
  69. =======================
  70. > os2billy -help
  71. Billy demo v0.25 beta
  72. Billy options:
  73. -nosound           : turn off all sounds.
  74. -lang <language>   : Specify language.
  75. -intro             : Play the introduction video.
  76. -gno               : Display no graphics.
  77. -nojoy             : Disable joystick
  78. -g640x480          : Graphics displayed in 640x480 pixels resolution.
  79. -g800x600          : Graphics displayed in 800x600 pixels resolution.
  80. -g1024x768         : Graphics displayed in 1024x768 pixels resolution.
  81. -nocol             : Use system palette.
  82. Enjoy.
  83. >
  84.  
  85. The -g options can specify any resolution (i.e. -g814x742 is also valid).
  86.  
  87.  
  88.  
  89. CD-audio
  90. ========
  91. If you insert a music CD the track 2 and 3 will be played. If this
  92. doesn't happen, please report to us. If you own the commercial
  93. version, these tracks correspond to the title track and the first
  94. jungle track. If you don't insert a CD the program will probably
  95. report some CD-audio warnings, but you can just ignore this - The
  96. program will not terminate because of this.
  97.  
  98.  
  99.  
  100. Troubleshooting
  101. ===============
  102. - No sound is played. Have you upgraded the DOS demo ? The OS/2
  103. version can only play .WAV files, and not .SVX files which is used in
  104. the old demo. An easy way to check if you need to upgrade, is to look
  105. in the directory samples\bmove8 (if you installed the 8 Mb version) or
  106. samples\bmove16 (if you installed the 16 Mb version). It contains
  107. either .WAV or .SVX files. There might also be trouble with DART.
  108.  
  109. If the keyboard doesn't work with the VESA_PM.DLL or everything hangs,
  110. you migth have an old VESA_PM.DLL or PMSCREEN.EXE running from some
  111. obscure place on your harddisc. Make sure you only have one in your
  112. LIBPATH/PATH.
  113.  
  114.  
  115.  
  116. Interpreting error messages
  117. ===========================
  118. "GAME$" refers to the joystick.
  119.  
  120. The FEJL.LOG (danish for error.log) often contains valuable
  121. information if the program exited with the message:
  122. "A fatal error has ocurred in the program.
  123. Please refer to FEJL.LOG for additional details"
  124.  
  125. If FEJL.LOG reports ......... the reason is probably ......
  126. Couldn't open the file xxx
  127.          ===>  Maybe you didn't install the DOSDEMO ?
  128.  
  129.  
  130.  
  131.  
  132. Finding your way in the blind maze
  133. ==================================
  134. Your might experience that while your screen is black because the game
  135. faded all the colours, your system beeps at you requesting you to
  136. answer "Terminate program or show hardware registers ?". Try to press
  137. this key sequense: [tabulator] [arrow-up] [enter]. Maybe you need two
  138. arrow-ups, it depends on the exact message.
  139.     You can use the "-nocol" commandline parameter to prevent the
  140. screen from going black.
  141.  
  142.  
  143.  
  144. Known limitations/TODO
  145. ======================
  146. Changing to another application and back to Billy under VESA_DIV
  147. and VESA_PM might jam the keyboard. The author of the VESA libray
  148. is working on a fix. Meanwhile use the 'j' key to reset the keyboard.
  149.  
  150. The foreground decorations (lians, chains, ...) are not redrawn when
  151. changing back to Billy.
  152.  
  153. Installation is too difficult.
  154.  
  155.  
  156.  
  157. How YOU can help
  158. ================
  159. Send an email to os2billy@thorsbro.dk we would like to hear from you.
  160.     Describe what works and what doesn't work. If you don't want
  161. to use time on a lengthly bug-report, just send a short one, it is
  162. better than none. We might be aware of the problem anyway. Everything
  163. is read with great appreciation, but please don't expect an answer
  164. right away. I would much rather enhance the OS/2 beta than answer
  165. emails :) and until I make some money on Billy I don't have easy
  166. access to email, since I am not on-line from home. You might also
  167. write to Johannes Martin who wrote the VESA-library if your problem
  168. concerns this. His address is jmartin@valdes.csc.UVic.CA.
  169.     We are much in doubt as to on how many systems Billy runs, so
  170. we would also REALLY like to hear from you if everything works
  171. perfectly.
  172.  
  173.  
  174.  
  175. Buying Billy
  176. ============
  177. If you intend to buy Billy when the OS/2 version is finished
  178. or have bought it and is waiting for it to finish write to us. This
  179. will help motivate programmers and silence scepticism in the
  180. development group. Please buy through BMT micro on our homepage, since
  181. we earn the most this way, and remember to state that you want
  182. "Notification of the OS/2 version".
  183.     What you are buying is a DOS version CD, which you can
  184. upgrade to native OS/2. The OS/2 version will not be included on a CD
  185. until we are out of stock, which won't happen anytime soon. Sorry.If
  186. however the OS/2 sales turn out good we can get back to talking about
  187. talking about a cheap upgrade. But I won't promise anything! 
  188.  
  189.  
  190. Source code
  191. ===========
  192. In the src\vesa directory we've placed the files we've changed in
  193. Johannes Martins VESA-EMX lib 2.0 beta.  In src\dart is our simple
  194. dart code. No warranty given.
  195. Is anyone interested in source code for accesing OS/2 specifics ?
  196.  
  197.  
  198.  
  199. A little disclaimer
  200. ===================
  201. This game is provided as is. We are in no way responsible for any harm
  202. that may be caused by using this program. We do not guarantee that the
  203. OS/2 version of Billy will run on any system, or that it will be
  204. completed at any specific date.
  205.  
  206.  
  207.