home *** CD-ROM | disk | FTP | other *** search
/ Ultimate DOOM Companion / PowersourceMultimedia-UltimateDOOMCompanion.iso / goodies / dview276.zip / DOOMVIEW.DOC < prev    next >
Text File  |  1994-12-07  |  11KB  |  260 lines
  1.             Mr. Skibone (but you can call me DJ SKI) presents
  2.                                DoomView 2.76
  3.                   (formerly DoomEdit(formerly DoomView))
  4.  
  5.                             December 7th, 1994
  6.             (Almost time to celebrate an entire Doomed year!)
  7.  
  8.  
  9. I love writing doc files about as much as I like documenting my own code,
  10. so this little doc file ain't pretty but I'm putting in some little tidbits
  11. of information that may be useful.
  12.  
  13. The program itself it pretty self-explanatory, so I'm not going to take up
  14. five pages writing long-winded explanations of the subtle uses of the up
  15. and down arrow keys.
  16.  
  17. But here is a thing or two you may find interesting:
  18.  
  19.  
  20. *************************
  21. ** Running the program **
  22. *************************
  23.  
  24. DoomView 2.76 is a program that will let you take any Doom WAD or PWAD,
  25. registered or shareware (sorry, couldn't find a way to make it exclude the
  26. shareware WADs), view any of the graphics and export them to BMP.  Just
  27. type 
  28.  
  29. DVIEW276 <wadfilename>
  30.  
  31. where <wadfilename> is the name of the WAD you'd like to view.  Got that?
  32. Really confusing, right?  Well, to make this doc file real
  33. professional-like, here's an example:
  34.  
  35. DVIEW276 SKIBONE.WAD
  36.  
  37. That will allow you to view all of the graphics in SKIBONE.WAD
  38.  
  39. If you don't include a WAD filename, it will look in the current directory
  40. for DOOM2.WAD or DOOM.WAD (in that order).  If it doesn't find either one,
  41. back to DOS you go.
  42.  
  43. This program should work on any current or future(??) version:
  44. Doom 1 : .99, 1.1, 1.2, 1.666
  45. Doom 2 : 1.666, 1.7a
  46. even the SGI and NeXT WADs.
  47.  
  48. (I had assumed that it would even work on the Doom 1 betas, but a DoomView
  49. fan informed me that it would not.  He even took the time to find out the
  50. differences between the way the graphics are stored in the beta and the
  51. releases and asked me to include support for this in DoomView.  If I hadn't
  52. erased my copies of the beta...ummm, I mean, since I >NEVER< had a copy of
  53. any of the betas :-) , I didn't include support for them and it seems late
  54. to do it now.  That, plus Romero and company are the last people in the
  55. world that I would want to piss off!)
  56.  
  57. The program assumes you are trying to view a Doom WAD file.  If you try to
  58. be cute and use this on a spreadsheet or something else, well.....it's your
  59. hard drive.  Nothing will be damaged but a reboot will probably be in order.
  60.  
  61. If you use this on a PWAD that doesn't have any graphics, the program will
  62. gracefully boot you out without a wimper (or an explanation).
  63.  
  64.  
  65. This archive should include:
  66. DVIEW276.EXE - The main executable
  67. COLOR.PAL    - Palette file
  68. FILE_ID.DIZ  - For lazy sysops
  69. DOOMVIEW.DOC - This fascinating piece of literature
  70. DOOMINFO.REV - Revision History of DoomView (A horrible glimpse into the
  71.                mind of a DOOMented DJ)
  72.  
  73.  
  74. *******************
  75. ** Program Start **
  76. *******************
  77.  
  78. When the program starts, it searches through the WAD file looking for any
  79. picture files.  The only difference between this version and 2.5 is that
  80. this one doesn't constantly access your hard drive to figure out if the WAD
  81. contains pictures.  The program kindly informs you:
  82. Looking for pictures.
  83. This may take a minute...
  84. But unless you are using this on the registered Doom WAD on a 386sx (or
  85. slower - hey!, it is 8086 code - use it on your XT!), it should find all
  86. the pictures in only a few seconds.
  87.  
  88.  
  89.  
  90. **************************
  91. ** T - Toggle 5x3 tiles **
  92. **************************
  93.  
  94. What can I say?  It was easy.  It looks cool.  Nuff said.
  95.  
  96.  
  97.  
  98. ****************************
  99. ** Export current picture **
  100. ****************************
  101.  
  102. "Oooo, a cute little bunny rabbit.  I'd like to snatch this picture and use
  103. it with my cornball screen saver!"
  104.  
  105. No problem.  While viewing a picture, hitting X (for Xport? ;) ), will
  106. export the current picture to a BMP file.
  107.  
  108.  
  109.  
  110. ****************
  111. ** Export All **
  112. ****************
  113.  
  114. The F8 key will start "Export All".  It will first make sure you actually
  115. want to do this - hit "Y" to continue, and then it will start.  During
  116. exporting, hit any key to cancel this gigantic task.
  117.  
  118. The Export All command will go through EVERY picture in the WAD file and
  119. export it to BMP.  That may be fairly harmless on a PWAD, but that's 2328
  120. pictures on Doom II, and (if I remember correctly) 1597 pictures on
  121. registered Doom v1.1 or 1567 on registered Doom v1.2 (the status bar was
  122. changed from multiple pictures to one and a few other changes I can't
  123. recall at the moment).  When the exporting is done, it will return you to the
  124. first picture (a garbage picture on a registered Doom/Doom II WAD - see
  125. Strange Features section).  It will take about 3 minutes on a 486/66 and
  126. will amount to over 14 megabytes of BMP files on your hard drive.  Now
  127. you're probably thinking - "14+ megabytes just for the pictures?  That's
  128. almost as big as the DOOM2.WAD itself!  Why so big?" Well, the DOOM2.WAD
  129. only needs the palette data once.  The palette is included in every BMP
  130. exported.  That plus some additional BMP info accounts for 1078 bytes per
  131. file.  1078 bytes times 1600 files equals over 1.6 of basically redundant
  132. data.  But don't blame me - you're the one who hit the F8 key!  :) 
  133.  
  134. Why the F8 key, you ask??  I just wanted to make something you probably
  135. wouldn't hit by accident.  Even though it still asks you if you want to
  136. proceed, I wanted to add that extra layer of protection.  Actually, it's
  137. three layers of protection, since you can cancel the "Export All" at any
  138. time while it's running.
  139.  
  140.  
  141. *******************
  142. ** id Trickery?? **
  143. *******************
  144.  
  145. When the program was almost done, I decided to go for the "Export All" on
  146. the Doom II WAD.  It cruised along for awhile, then crashed.  Crashing is
  147. frowned upon.  It crashed every time while trying to export the Arch-Vile
  148. pictures.  A quick look at the WAD file showed picture names like VILEG1,
  149. VILEH1, VILEI1, etc.  After they got to Z (LOTS of Arch-Vile frames), they
  150. continued on their ASCII way to use the characters [, \, and ].  This is a
  151. DOS filename no-no.  So for those few pictures, I have replaced the [, \,
  152. and ] with 1, 2, and 3, respectively.  So no more crashing when you're
  153. filling your hard drive up with 2300 Doom II pictures.  Was this a harmless
  154. instance of blindly following ASCII conventions??  Or was it an evil id
  155. plot to throw a monkey wrench into the works of Doom utility programs?!?!
  156. Enquiring minds want to know!  ;)
  157.  
  158.  
  159. ******************
  160. ** Registration **
  161. ******************
  162.  
  163. This program is MAIL-ME-WARE.  If you like it, drop a line to
  164. skibone@ripco.com
  165. and lavish me with praise.  Mail me an Internet tip (I'm an
  166. InterKnucklehead.) Mail me some wild and wooly FTP site information.  Mail
  167. me a recommendation for BBS software.  Or tell me my program is as
  168. worthless as a Microsoft operating system.
  169. HEY!  Even better - get up close and personal.  Feed Ma Bell's pockets and
  170. call Bitstream of the Eschaton - where a line is always open and a slow
  171. system means I'm playing Doom (so don't bug me!  ;)  )
  172. Assembly source code (barely documented) is available to anyone who asks
  173. nicely for it.
  174.  
  175.  
  176. ***********************************
  177. ** Strange features (minor bugs) **
  178. ***********************************
  179.  
  180. Nope - all v2.5 demons were exorcized?...exorcised?...exercised??....ummm,
  181. I got rid of all the bugs!
  182.  
  183.  
  184. ******************
  185. ** Program bugs **
  186. ******************
  187.  
  188. NONE!  Never!  NO! NO! NO! NO!
  189. But if this program crashes (chokes on your WAD??), give the Bitstream a
  190. call and tell me what happened and the WAD file you were viewing at the
  191. time.  Go ahead and upload the offending WAD if I don't have it already.
  192. HA!  The Bitstream of the Eschaton has eeeeeeeeevery Doom WAD file and
  193. add-on!  Silly me!
  194. Or send me e-mail cursing me out in five different languages to:
  195.  
  196. skibone@ripco.com
  197.  
  198. Yah-hey!  Da info'mayshun supadupahighway!
  199.  
  200.  
  201. ***********************
  202. ** Greets and Grunts **
  203. ***********************
  204.  
  205. id Software: Thank you for completely overrunning my BBS and taking up
  206. almost a year of my life (and counting.)  I'm sure I'll still be playing
  207. Doom II PWADs by the time Quake rolls into town.  Now if only you'd let me
  208. borrow one of dem Ferraris.....
  209.  
  210. GT Interactive: Still pissed at you.  The only thing you screwed up more
  211. than the shipment was the 'apology'.  You said "Have a T-shirt".  I said
  212. OK.  Then you said MUCH LATER, "...or have a complete refund".  What?  Now
  213. I'm supposed to miss out on the complete refund cause I got your '$1.98 and
  214. will probably shrink like hell' T-shirt?!?!  I don't think so.  I expect
  215. the complete refund also.  (Again, only because of GT's breach of contract
  216. - not because of anything that id did).  I guess both you and Intel have
  217. the same public relations people.
  218.  
  219.  
  220. *****************************
  221. ** Copyright / Permissions **
  222. *****************************
  223.  
  224. You may distribute this utility in any electronic format (BBS, Diskette,
  225. CD, cassette, 8-track, mini disc, DAT, DEM, DE OTHA ONE, ISDN, T1,
  226. satellite, Internet, Internot, Interknot, Internut, etc) as long as you
  227. include the following files with NO modifications: 
  228.  
  229. DVIEW276.EXE - The main executable
  230. COLOR.PAL    - Palette file
  231. FILE_ID.DIZ  - For lazy sysops
  232. DOOMVIEW.DOC - This fascinating piece of literature
  233. DOOMINFO.REV - Revision History of DoomView (A horrible glimpse into the
  234.                mind of a DOOMented DJ)
  235.  
  236.  
  237. ******************
  238. ** And then.... **
  239. ******************
  240.  
  241. Yikes, this little doc file got big.  Well, most people stopped reading
  242. about 140 lines ago, but if you've got that kind of extra-strength
  243. attention span then do the 100-meter mosey on down to....
  244.  
  245.  
  246. ╔═══════════════════════════════════════════════════════════════╗
  247. ║                   Bitstream of the Eschaton                   ║
  248. ║                        Sysop : DJ SKI                         ║
  249. ║          (708)705-7749 - Hayes OPTIMA 28800 v.34/v.FC         ║
  250. ║          (708)705-7741 - USR 28800 v.34 Dual Standard         ║
  251. ╠═══════════════════════════════════════════════════════════════╣
  252. ║   *********************************************************   ║
  253. ║   *   Your main source for Doom WAD files and utilities   *   ║
  254. ║   *********************************************************   ║
  255. ║                                                               ║
  256. ║                   Demos - Games - OS/2 files                  ║
  257. ║                                                               ║
  258. ╚═══════════════════════════════════════════════════════════════╝
  259.  
  260.