home *** CD-ROM | disk | FTP | other *** search
/ 4-Ever Doomed / 4-everdoomedcypresssoftware1994.iso / utils / d1 / dmgraph / graphelp.txt < prev    next >
Text File  |  1994-11-22  |  5KB  |  127 lines
  1. The following is a description of how to use DMGRAPH and should be pretty
  2. straightforward.
  3.  
  4. FORWARD
  5. ========
  6.   In case you don't know, before you start, you have to find out what graphic
  7. you want to replace.  Each graphic/sprite has it's own name in the Doom 
  8. Director (ie SKY1 for Episode 1's sky picture or M_EPI1 for episode 1's title 
  9. bar).  You can get a list of the names in Doom's directory by browsing a file 
  10. called WAD.DIR that should come with DMGRAPH v1.1. Note that editting 
  11. utilities like DMGRAPH must have it's file(s) in the same directory as 
  12. DOOM.WAD to work properly since these utilities don't have the option to look 
  13. for the DOOM.WAD in a separate directory.
  14.  
  15. VIEWING A GRAPHIC
  16. ================
  17.    Let's say I want to view M_EPI1.  To view it from the IWAD (DOOM.WAD), I 
  18. would type:
  19.  
  20. DMGRAPH M_EPI1 -d
  21.  
  22.    To view M_EPI1 from a PWAD, I would type:
  23.  
  24. DMGRAPH M_EPI1 -d -f MYSTUFF.WAD
  25.  
  26.     In general, to view a graphic, you would type:
  27.  
  28.        DMGRAPH graphic_name -d          (to view from IWAD)
  29. or    DMGRAPH graphic_name -d -f pwadname.WAD  (to view from a PWAD)
  30.  
  31. where graphic_name is the directory name of the graphic (ie. M_EPI1).
  32.  
  33. GETTING GRAPHIC RELATED INFO
  34. ===========================
  35.   Before replacing a graphic in DOOM.WAD or a PWAD, you need to know a few 
  36. pieces of information about the graphic, namely:  graphic type, graphic size,
  37. and insertion point.
  38.   To get this info, just type:
  39.  
  40.       DMGRAPH graphic_name -v         (for graphic from DOOM.WAD)
  41. or   DMGRAPH graphic_name -v -f pwadname.WAD (for graphic from a PWAD)
  42.  
  43. NOTE:  the -v parameter does not work with the -d parameter.  This means you 
  44. cannot view a graphic AND get info on it.  If you use both of these
  45. parameters, the graphic will be displayed but no info will be given.
  46.  
  47.  
  48. TO EXTRACT A GRAPHIC
  49. ===================
  50.   To extract a graphic from DOOM.WAD, type:
  51.  
  52.        DMGRAPH graphic_name -e extractedfilename.GIF <-t GIF>
  53. or    DMGRAPH graphic_name -e extractedfilename.PPM <-t PPM>
  54.  
  55. NOTE:  If you add the extension .GIF or .PPM to your extractedfilename, you
  56. do not need the -t option.  The -t option is only really required if you 
  57. don't add an extension or if you use some other extension.
  58.  
  59.   To extract a graphic from a PWAD, type:
  60.  
  61.    DMGRAPH graphic_name -e extractfilename.GIF <-t GIF> -f pwadname.WAD
  62. or 
  63. DMGRAPH graphic_name -e extractfilename.PPM <-t PPM> -f pwadname.WAD
  64.  
  65. NOTE:  Again, the -t option is not required if you use a .GIF or .PPM
  66. extension to your extractfilename.  Also, the .WAD extension is required when 
  67. specifying the PWAD.
  68.  
  69. TO REPLACE A GRAPHIC
  70. ====================
  71.   First make up your graphic in some paint program.  Important things to 
  72. remember are:
  73.  
  74.   a)  make sure your graphic is in GIF or PPM format
  75.   b)  make sure the graphic is in 320x200 resolution
  76.   c)  make your graphic to the size of the graphic you are replacing
  77.   d)  try to preserve the palette that is used for the graphic you are
  78.       replacing
  79.   e)  use cyan as color for areas of graphic that are see through
  80.  
  81.   I don't know what will happen if you use a graphic that is larger in size
  82. than the graphic you are replacing.
  83.   If you use a palette that is not DOOM's palette, the graphic you put into
  84. the WAD may be dis-coloured.
  85.   I'm not sure if the -b switch for DMGRAPH makes black a see-through colour
  86. or just a background colour.
  87.  
  88. After you have made up your graphic, then type the following command:
  89.  
  90.     DMGRAPH graphic_name -s newgraphicfilename.GIF -i x,y
  91. or DMGRAPH graphic_name -s newgraphicfilename.PPM -i x,y
  92. or DMGRAPH graphic_name -s newgraphicfilename.GIF -i x,y -f pwadname.WAD
  93. or DMGRAPH graphic_name -s newgraphicfilename.PPM -i x,y -f pwadnam.WAD
  94.  
  95. where newgraphicfilename is the filename of you new graphic and x,y are the 
  96. insertion points as reported by the -v parameter.
  97. NOTE:  Be sure to enter the insertion point as one number followed
  98. immediately by a comma, followed immediately by the final number (ie. no 
  99. spaces).
  100.  
  101.  
  102. TO REMOVE A GRAPHIC FROM A PWAD
  103. ================================
  104.   Simply type:
  105.  
  106.   DMGRAPH graphic_name -r -f pwadname.WAD
  107.  
  108.  
  109. TO LIST THE CONTENTS OF A WAD
  110. ============================
  111.  
  112. Type:
  113.  
  114.     DMGRAPH -c           (to view directory contents of DOOM.WAD)
  115. or DMGRAPH -c -f pwadname.WAD  (to view directory contents of a PWAD)
  116.  
  117. NOTE:  You do not need a graphic_name when using the -c parameter.  Also, 
  118. while viewing a long list of directory contents, DMGRAPH will show the
  119. contents page by page with a (more) indicator at the bottom of the screen.  
  120. To stop viewing the contents, simply hit ^C.
  121.  
  122. Well, that's about it.  Happy Dooming!
  123.  
  124.  
  125. Written by:  Ben Sze
  126. 09-14-1994
  127.