home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the DOOM Programming Gurus / Tricks_of_the_Doom_Programming_Gurus.iso / bonus / utils / doomview / doomview.doc < prev    next >
Encoding:
Text File  |  1995-03-19  |  15.6 KB  |  397 lines
  1.                                Mr. Skibone
  2.                        (known on his BBS as DJ SKI)
  3.              (known to the outside world as Russell Wronski)
  4.                (known on the Internet as skibone@ripco.com)
  5.                                  presents
  6.  
  7.                       DoomView Special Edition (SE)
  8.                               (Version 3.25)
  9.                   Included on the Sams Publishing CD-ROM
  10.                   Secrets of the Doom Programming Gurus
  11.  
  12.                              March 19th, 1994
  13.  
  14. *****************
  15. ** New Stuff!! **
  16. *****************
  17.  
  18. - Heretic support!
  19.  
  20. - DoomView doesn't have to be in the same directory as your WAD
  21.   Tell it where to look!
  22.   for example:  DVIEW C:\WHEE\THIS\IS\FUN\ID\GAMES\HERETIC\HERETIC1.WAD
  23.   (Not important to me but people asked for it.)
  24.  
  25. - 'Export All' command now tells you exactly how many files will be exported
  26.   and how many bytes it will take
  27.  
  28. - Delete that COLOR.PAL file.  It's now incorporated into the EXE.  Wow!
  29.  
  30. - Ultra-exotic slightly colorized menus (Thanks to Todd Farrington)
  31.  
  32.  
  33.  
  34. *****************
  35. ** Greetings!! **
  36. *****************
  37.  
  38. I love writing doc files about as much as I like documenting my own code,
  39. so this little doc file ain't pretty but I'm putting in some little tidbits
  40. of information that may be useful.
  41.  
  42. The program itself it pretty self-explanatory, so I'm not going to take up
  43. five hundred pages writing long-winded explanations of the subtle uses of
  44. the up and down arrow keys.
  45.  
  46. But here is a thing or two you may find interesting:
  47.  
  48.  
  49.  
  50. *************************
  51. ** Running the program **
  52. *************************
  53.  
  54. DoomView SE is a program that will let you take any Doom, Doom II, and
  55. Heretic WAD or PWAD view any of the graphics and export them to BMP.  Just
  56. type 
  57.  
  58. DVIEW <wadfilename>
  59.  
  60. where <wadfilename> is the name of the WAD you'd like to view.  Got that?
  61. Really confusing, right?  Well, to make this doc file real
  62. professional-like, here's an example:
  63.  
  64. DVIEW SKIBONE.WAD
  65.  
  66. That will allow you to view all of the graphics in SKIBONE.WAD
  67.  
  68. If you don't include a WAD filename, it will look in the current directory
  69. for an id WAD in this order:
  70. Doom 1 registered    DOOM.WAD
  71. Doom 1 shareware    DOOM1.WAD
  72. Doom II            DOOM2.WAD
  73. Heretic registered    HERETIC.WAD
  74. Heretic shareware    HERETIC1.WAD
  75.  
  76. If it doesn't find any of those, back to DOS you go.
  77.  
  78. This program should work on any current version of Doom, Doom II and
  79. Heretic, even the SGI and NeXT WADs.  (Let's change the SGI and NeXT
  80. support to a maybe - I haven't tried those lately.)
  81.  
  82. (I had assumed that it would even work on the Doom 1 betas, but a DoomView
  83. fan informed me that it would not.  He even took the time to find out the
  84. differences between the way the graphics are stored in the beta and the
  85. releases and asked me to include support for this in DoomView.  If I hadn't
  86. erased my copies of the beta...ummm, I mean, since I >NEVER< had a copy of
  87. any of the betas :-) , I didn't include support for them and it seems late
  88. to do it now.  That, plus Romero and company are the last people in the
  89. world that I would want to piss off!)
  90.  
  91. The program assumes you are trying to view a Doom WAD file.  If you try to
  92. be cute and use this on a spreadsheet or something else, well.....it's your
  93. hard drive.  Nothing will be damaged but a reboot will probably be in order.
  94.  
  95. If you use this on a PWAD that doesn't have any graphics, the program will
  96. gracefully boot you out without a wimper (or an explanation).
  97.  
  98.  
  99. This archive should include:
  100. DVIEW.EXE    - The main executable
  101. FILE_ID.DIZ  - For lazy sysops
  102. DOOMVIEW.DOC - This fascinating piece of literature
  103. DOOMINFO.REV - Revision History of DoomView (A horrible glimpse into the
  104.                mind of a DOOMented DJ)
  105.  
  106.  
  107.  
  108. *******************
  109. ** Program Start **
  110. *******************
  111.  
  112. When the program starts, it searches through the WAD file looking for any
  113. picture files.  The more entries the WAD file has, the more DoomView has to
  114. look through.  So be patient with a Doom II WAD file.  It's got a few
  115. thousand entries to look through.  It will also access your hard drive like
  116. mad because it looks at a little piece of every entry.
  117. The program kindly informs you:
  118. Looking for pictures.
  119. This may take a minute...
  120. But unless you are using this on the registered Doom WAD on a 386sx (or
  121. slower - hey!, it is 8086 code - use it on your XT!), it should find all
  122. the pictures in only a few seconds.
  123.  
  124.  
  125.  
  126. ***************************
  127. ** [ ] - Change Palettes **
  128. ***************************
  129.  
  130. Mr Owl!  How many palettes does it take to view all of id and Ravens
  131. creations??  1...2...3...Crunch...3!
  132. The first palette is the Doom/Doom II palette.  The second is the Heretic
  133. palette and the third is the palette for the picture E2END in Heretic
  134. registered.  For some reason, this picture has its very own palette.  If
  135. you just type DVIEW and it automatically finds an id or Raven WAD, it will
  136. automatically load the correct palette (except, of course, for the E2END
  137. picture).  Make sense?  Probably not, but you'll figure it out. 
  138.  
  139.  
  140.  
  141. **************************
  142. ** T - Toggle 5x3 tiles **
  143. **************************
  144.  
  145. What can I say?  It was easy.  It looks cool.  Nuff said.
  146.  
  147.  
  148.  
  149. ****************************
  150. ** Export current picture **
  151. ****************************
  152.  
  153. "Oooo, a cute little bunny rabbit.  I'd like to snatch this picture and use
  154. it with my cornball screen saver!"
  155.  
  156. No problem.  While viewing a picture, hitting X (for Xport? ;) ), will
  157. export the current picture to a BMP file.
  158.  
  159.  
  160.  
  161. ****************
  162. ** Export All **
  163. ****************
  164.  
  165. The F8 key will start "Export All".  It will first make sure you actually
  166. want to do this - hit "Y" to continue, and then it will start.  During
  167. exporting, hit any key to cancel this gigantic task.
  168.  
  169. The program will first tell you how many pictures it will export and how
  170. much space they will take up.  On a full Doom (1 or 2) WAD, DoomView will
  171. give you a number that is one or two files off.  That's because the wall
  172. pictures SW18_7 and COMP03_8 were included in id's WAD twice.  (I guess
  173. they were too busy destroying OS/2 support to check check for for
  174. redundancies.) 
  175.   
  176. The Export All command will go through EVERY picture in the WAD file and
  177. export it to BMP.  That may be fairly harmless on a PWAD, but that's 2289
  178. pictures on Doom II, and (if I remember correctly) 1597 pictures on
  179. registered Doom v1.1 or 1567 on registered Doom v1.2 (the status bar was
  180. changed from multiple pictures to one and a few other changes I can't
  181. recall at the moment).  When the exporting is done, it will return you to
  182. the first picture.  It will take about 3 minutes on a 486/66 and will
  183. amount to about 14 megabytes of BMP files on your hard drive.  Now you're
  184. probably thinking - "14+ megabytes just for the pictures?  That's almost as
  185. big as the DOOM2.WAD itself!  Why so big?" Well, the DOOM2.WAD only needs
  186. the palette data once.  The palette is included in every BMP exported.
  187. That plus some additional BMP info accounts for 1078 bytes per file.  1078
  188. bytes times 1600 files equals over 1.6 of basically redundant data.  But
  189. don't blame me - you're the one who hit the F8 key!  :) 
  190.  
  191. Why the F8 key, you ask??  I just wanted to make something you probably
  192. wouldn't hit by accident.  Even though it still asks you if you want to
  193. proceed, I wanted to add that extra layer of protection.  Actually, it's
  194. three layers of protection, since you can cancel the "Export All" at any
  195. time while it's running.
  196.  
  197.  
  198.  
  199. *******************
  200. ** id Trickery?? **
  201. *******************
  202.  
  203. When the program was almost done, I decided to go for the "Export All" on
  204. the Doom II WAD.  It cruised along for awhile, then crashed.  Crashing is
  205. frowned upon.  It crashed every time while trying to export the Arch-Vile
  206. pictures.  A quick look at the WAD file showed picture names like VILEG1,
  207. VILEH1, VILEI1, etc.  After they got to Z (LOTS of Arch-Vile frames), they
  208. continued on their ASCII way to use the characters [, \, and ].  This is a
  209. DOS filename no-no.  So for those few pictures, I have replaced the [, \,
  210. and ] with 1, 2, and 3, respectively.  So no more crashing when you're
  211. filling your hard drive up with 2300 Doom II pictures.  Was this a harmless
  212. instance of blindly following ASCII conventions??  Or was it an evil id
  213. plot to throw a monkey wrench into the works of Doom utility programs?!?!
  214. Enquiring minds want to know!  ;)
  215.  
  216.  
  217.  
  218. ******************
  219. ** Registration **
  220. ******************
  221.  
  222. This program is ANNOY-THEM-WARE.  If you like it, send some e-mail to the
  223. gurus at id telling them to fix the sound code in their products so they
  224. work with OS/2 (like they used to - see Greets and Grunts for ideas on what
  225. to tell them).
  226. Send e-mail to the following people:
  227. johnc@idsoftware.com    (John Carmack)
  228. johnr@idsoftware.com    (John Romero)
  229. ddt@idsoftware.com    (Dave Taylor)
  230. jayw@idsoftware.com    (Jay Wilbur)
  231.  
  232. When you're done with that, drop a line to
  233. skibone@ripco.com
  234. and lavish me with praise.  Mail me an Internet tip (I'm an
  235. InterKnucklehead.) Mail me some wild and wooly FTP site information.  Mail
  236. me a recommendation for BBS software.  Or tell me my program is as
  237. worthless as a Microsoft operating system.
  238. HEY!  Even better - get up close and personal.  Feed Ma Bell's pockets and
  239. call Bitstream of the Eschaton - where a line is always open and a slow
  240. system means I'm playing Doom (so don't bug me!  ;)  )
  241. Assembly source code (barely documented) is available to anyone who asks
  242. nicely for it.
  243.  
  244.  
  245.  
  246. ***********************************
  247. ** Strange features (minor bugs) **
  248. ***********************************
  249.  
  250. Nope - all v2.5 demons were exorcized?...exorcised?...exercised??....ummm,
  251. I got rid of all the bugs!
  252.  
  253.  
  254.  
  255. ******************
  256. ** Program bugs **
  257. ******************
  258.  
  259. NONE!  Never!  NO! NO! NO! NO!
  260. But if this program crashes (chokes on your WAD??), give the Bitstream a
  261. call and tell me what happened and the WAD file you were viewing at the
  262. time.  Go ahead and upload the offending WAD if I don't have it already.
  263. HA!  The Bitstream of the Eschaton has eeeeeeeeevery Doom WAD file and
  264. add-on!  Silly me!
  265. Or send me e-mail cursing me out in five different languages to:
  266.  
  267. skibone@ripco.com
  268.  
  269. Yah-hey!  Da info'mayshun supadupahighway!
  270.  
  271.  
  272.  
  273. ***********************
  274. ** Greets and Grunts **
  275. ***********************
  276.  
  277. id Software (Greet): Thank you for completely overrunning my BBS and taking
  278. up over a year of my life (and counting.) I'm sure I'll still be playing
  279. Doom II PWADs by the time Quake rolls into town.  Now if only you'd let me
  280. borrow one of dem Ferraris..... 
  281.  
  282.  
  283. id Software (Grunt): So what is the inside story?  Did Lou Gerstner call
  284. your mother a nasty name??  Did you offer to help IBM port Doom to OS/2 and
  285. they said "We don't need your help!" so you thought, welllll, we'll fix
  286. their wagons!!  
  287.  
  288. In other words, Why has SoundBlaster sound effect support for OS/2 still
  289. not been put back in Doom (and Doom II and Heretic)???  It was there.  I've
  290. got it.  I hear it.  I still play v1.1
  291.  
  292. According to a brief e-mail from Jay Wilbur, you guys "...updated the sound
  293. driver to make it work better with DOS (the platform it was made for) which
  294. made it incompatible with OS/2..." (not exact quote but close) Now I know
  295. you guys are busy with Quake, so I wouldn't want to distract you
  296. unnecessarily, so I'll even give you step by step instructions. 
  297.  
  298. 1) Take current code for Doom
  299. 2) Get sound driver used in Doom v1.1
  300. 3) Replace current sound driver with Doom v1.1 sound driver
  301. 4) Compile
  302. 5) Run RTPatch
  303. 6) Distribute
  304. 7) Repeat for Doom II and Heretic.
  305. 8) Get more money from people like myself who haven't purchased all your
  306.    products because of lack of support.
  307. 9) Buy more Ferraris!
  308.  
  309. And don't give me the "Doom/2" line.  I could care less about Doom in
  310. Presentation Manager.  I want it in a DOS session, on my PC running OS/2,
  311. with full sound.  Is that a lot to ask for?? 
  312.  
  313.  
  314. Sams Publishing (Big Greet!): Ya shoulda heard them grovel!  "Please,
  315. please, Mr. Skibone!!  Our CD won't be complete unless you let us include
  316. DoomView!!" Well...maybe not exactly groveling.  Maybe more like ... just
  317. asking ... once ... but very politely and official like!
  318.  
  319.  
  320. GT Interactive (Grunt): Still waiting for my refund!!
  321.  
  322.  
  323. ****************************************************************
  324. ** Copyright / Permissions/ Goofy Political Commentary / Etc. **
  325. ****************************************************************
  326.  
  327. You may distribute this utility in any electronic format (BBS, Diskette,
  328. CD, cassette, 8-track, mini disc, DAT, DEM, DE OTHA ONE, ISDN, T1,
  329. satellite, Internet, Internot, Interknot, Internut, etc) as long as you
  330. include the following files with NO modifications: 
  331.  
  332. DVIEW.EXE    - The main executable
  333. FILE_ID.DIZ  - For lazy sysops
  334. DOOMVIEW.DOC - This fascinating piece of literature
  335. DOOMINFO.REV - Revision History of DoomView (A horrible glimpse into the
  336.                mind of a DOOMented DJ)
  337.  
  338.  
  339. id, Doom, Doom II, Heretic and other things are trademarks and copyrights
  340. and other legal mumbo-jumbo of those guys with 1000hp Ferraris.
  341.  
  342.  
  343. IBM is big and blue (like the sky, but IBM is bigger).  If your system can
  344. run Doom, you should be running OS/2.  (Unless you have some sort of
  345. demented fetish for GPF's!)
  346.  
  347.  
  348. Microsoft is going down!!  BAHAHAHA!!!  Judge Sporkin is gonna carve you up
  349. like a turkey!!
  350.  
  351.  
  352.  
  353. *****************
  354. ** Coming Soon **
  355. *****************
  356.  
  357. A little Bird (of the Charles variety) whispered an idea into my mailbox
  358. where it worked its way into my brain and is growing - The Doom Screen
  359. Saver (for DOS, of course!).  DoomView is neat but fairly lifeless.  We
  360. need something entertaining.  Flying toasters is for your mom.  We need
  361. something on your screen that says "Careful 'round these parts.  I've got a
  362. double-barreled and I ain't afraid to use it." Supposedly one existed long
  363. ago, but it never worked for me.  This is still in idea stage.  If it never
  364. is produced, edit this part of the document out and wait for other promises
  365. that will never ship - like Windows 95 and DEU 5.3  ;-)
  366.  
  367.  
  368.  
  369. ******************
  370. ** And then.... **
  371. ******************
  372.  
  373. Yikes, this little doc file got big.  Well, most people stopped reading
  374. about 140 lines ago, but if you've got that kind of extra-strength
  375. attention span then do the 100-meter mosey on down to....
  376.  
  377.  
  378. ╔═════════════════════════════════════════════════════════════════════╗
  379. ║                      Bitstream of the Eschaton                      ║
  380. ║                           Sysop : DJ SKI                            ║
  381. ║           2 Nodes - U.S. Robotics 28.8 v.34 Dual Standards          ║
  382. ║                            (708)705-7749                            ║
  383. ╠═════════════════════════════════════════════════════════════════════╣
  384. ║      ******  High Performance Entertainment for your PC  ******     ║
  385. ║                              Featuring:                             ║
  386. ║                                                                     ║
  387. ║                       Doom / Doom II / Heretic                      ║
  388. ║                 Add-on levels / Editors / Utilities                 ║
  389. ║                                                                     ║
  390. ║                        The Best in Shareware                        ║
  391. ║            id / Apogee / Epic Megagames / MVP / Lots More           ║
  392. ║                                                                     ║
  393. ║      Previews / Playable Demos for the Latest Commercial Games      ║
  394. ║                                                                     ║
  395. ║                         Demos / Source Code                         ║
  396. ╚═════════════════════════════════════════════════════════════════════╝
  397.