home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_04 / BM19A.LZH / bm19a / read.me < prev    next >
Text File  |  1995-03-23  |  4KB  |  87 lines
  1. VIEW.EXE
  2. By Jake Hill
  3. December 1, 1994
  4.  
  5. OVERVIEW
  6.  
  7. VIEW is a BSP based rendering engine compatible with Id Software's WAD file 
  8. and WAD files generated with DEU 5.2. VIEW.EXE will only (ONLY) work with
  9. DOOM.WAD files from the first doom.  It will NOT work with DOOM-2 wads.
  10. The complete source is included.  If you modify these files and then release
  11. them to the public in ANY form, you MUST include the original source files
  12. and this read.me file.
  13.  
  14. BS
  15.  
  16. First off, I want to thank Matt Fell and Hank Leukart for writing 
  17. _The Unofficial Doom Specs_  without which this program would have
  18. never been written.  I also want to thank Jaimi McEntire and Lloyd Pique
  19. for tips and help along the way.  And last but not least thanks to 
  20. Brendon Wyber and Raphael Quinet for making the source to DEU 5.2
  21. available.  It was much help with reading in the Wad file.  Also thanks
  22. to everyone who I am forgetting now.
  23.  
  24. If more people made their software available to the public, the world
  25. would be a better place.
  26.  
  27. This has been a very fun project for me for the last four months.  I have
  28. learned alot about 3d and pseudo 3d programming.
  29.  
  30. This is my first attempt at 3d programming.  I think it's a pretty good
  31. first try, but it's certainly not great.  Don't be surprised if you find
  32. a bug or two.  It does NOT do any texture mapping, but it should be easy 
  33. for someone experienced in that to add it in.  What it does do is read 
  34. in the DOOM.WAD file (for Doom, NOT Doom 2) and render the level with 
  35. solid colored non shaded polygons via a bsp tree traversal.  It's not fast, 
  36. but it's not real slow either.  About 24 fps on a 486/66 when compiled 
  37. with MSVC 1.5.  About 15 fps when compiled with Borland 3.1 or 4.02.  
  38. And yes I used optimizations.
  39.  
  40. To run the executable put VIEW.EXE in the same directory as 
  41. DOOM.WAD and type VIEW.
  42.  
  43. The command line is as follows:
  44. VIEW                      : Loads DOOM.WAD level 0 (e1m1)
  45. example:  view
  46. This loads DOOM.WAD level 0 (e1m1).
  47.  
  48. VIEW [Level#]       : Where Level# is an integer in the range (0-25)
  49.                     : Loads DOOM.WAD level 0-25 (25=e3m12)
  50. example:  view 3  
  51. This loads DOOM.WAD level 3 (e1m4).
  52.  
  53. VIEW [filename] [Level#]  : Where [filename] is the name of any 
  54.                           : custom WAD file for doom.
  55. example:  view my.wad 3
  56. This loads the file MY.WAD level 3.
  57.  
  58. Use the arrow keys for direction, plus and minus control height,
  59. use ALT with the left and right arrow for strafe mode, and ESC
  60. will exit the demo.
  61.  
  62. The entire thing is written in c++.  There is only one class, the view.
  63. There are some obvious optimizations which can be made with assembler.
  64. If you want to make it more object oriented, it should be fairly 
  65. obvious which data structures need to be objectized, but I didn't have
  66. the patience to do that.
  67.  
  68. The reasons that I am making this available in such an early stage are:
  69.  
  70. 1.  I am sick of looking at this project ;).
  71.  
  72. 2.  I have not seen many (only one) rendering engines which use a bsp
  73.     but I have seen ALOT of questions regarding bsp's.  I hope that 
  74.     this will help some of the people interested in bsp based rendering.
  75.  
  76. 3.  I would like ANYONE who manages to improve on these algorithms
  77.     (and there will be many) to keep in touch.  I would particularly
  78.     like to know how it runs when compiled under Watcom's 32 bit flat
  79.     model.  If anyone sees any blatant mistakes on my part, or has any
  80.     suggestions on how to improve this code PLEASE let me know.
  81.  
  82. I would love to hear any comments or questions you may have.
  83. I can be reached on CIS at Jake Hill 74032,350 or on internet
  84. at jkhil@dbsoftware.com
  85.  
  86. Good Luck.  And remember, Life's too short to wear socks!
  87.