The following is a description of how to use DMGRAPH and should be pretty
straightforward.

FORWARD
========
  In case you don't know, before you start, you have to find out what graphic
you want to replace.  Each graphic/sprite has it's own name in the Doom 
Director (ie SKY1 for Episode 1's sky picture or M_EPI1 for episode 1's title 
bar).  You can get a list of the names in Doom's directory by browsing a file 
called WAD.DIR that should come with DMGRAPH v1.1. Note that editting 
utilities like DMGRAPH must have it's file(s) in the same directory as 
DOOM.WAD to work properly since these utilities don't have the option to look 
for the DOOM.WAD in a separate directory.

VIEWING A GRAPHIC
================
   Let's say I want to view M_EPI1.  To view it from the IWAD (DOOM.WAD), I 
would type:

DMGRAPH M_EPI1 -d

   To view M_EPI1 from a PWAD, I would type:

DMGRAPH M_EPI1 -d -f MYSTUFF.WAD

    In general, to view a graphic, you would type:

       DMGRAPH graphic_name -d          (to view from IWAD)
or    DMGRAPH graphic_name -d -f pwadname.WAD  (to view from a PWAD)

where graphic_name is the directory name of the graphic (ie. M_EPI1).

GETTING GRAPHIC RELATED INFO
===========================
  Before replacing a graphic in DOOM.WAD or a PWAD, you need to know a few 
pieces of information about the graphic, namely:  graphic type, graphic size,
and insertion point.
  To get this info, just type:

      DMGRAPH graphic_name -v         (for graphic from DOOM.WAD)
or   DMGRAPH graphic_name -v -f pwadname.WAD (for graphic from a PWAD)

NOTE:  the -v parameter does not work with the -d parameter.  This means you 
cannot view a graphic AND get info on it.  If you use both of these
parameters, the graphic will be displayed but no info will be given.


TO EXTRACT A GRAPHIC
===================
  To extract a graphic from DOOM.WAD, type:

       DMGRAPH graphic_name -e extractedfilename.GIF <-t GIF>
or    DMGRAPH graphic_name -e extractedfilename.PPM <-t PPM>

NOTE:  If you add the extension .GIF or .PPM to your extractedfilename, you
do not need the -t option.  The -t option is only really required if you 
don't add an extension or if you use some other extension.

  To extract a graphic from a PWAD, type:

   DMGRAPH graphic_name -e extractfilename.GIF <-t GIF> -f pwadname.WAD
or 
DMGRAPH graphic_name -e extractfilename.PPM <-t PPM> -f pwadname.WAD

NOTE:  Again, the -t option is not required if you use a .GIF or .PPM
extension to your extractfilename.  Also, the .WAD extension is required when 
specifying the PWAD.

TO REPLACE A GRAPHIC
====================
  First make up your graphic in some paint program.  Important things to 
remember are:

  a)  make sure your graphic is in GIF or PPM format
  b)  make sure the graphic is in 320x200 resolution
  c)  make your graphic to the size of the graphic you are replacing
  d)  try to preserve the palette that is used for the graphic you are
      replacing
  e)  use cyan as color for areas of graphic that are see through

  I don't know what will happen if you use a graphic that is larger in size
than the graphic you are replacing.
  If you use a palette that is not DOOM's palette, the graphic you put into
the WAD may be dis-coloured.
  I'm not sure if the -b switch for DMGRAPH makes black a see-through colour
or just a background colour.

After you have made up your graphic, then type the following command:

    DMGRAPH graphic_name -s newgraphicfilename.GIF -i x,y
or DMGRAPH graphic_name -s newgraphicfilename.PPM -i x,y
or DMGRAPH graphic_name -s newgraphicfilename.GIF -i x,y -f pwadname.WAD
or DMGRAPH graphic_name -s newgraphicfilename.PPM -i x,y -f pwadnam.WAD

where newgraphicfilename is the filename of you new graphic and x,y are the 
insertion points as reported by the -v parameter.
NOTE:  Be sure to enter the insertion point as one number followed
immediately by a comma, followed immediately by the final number (ie. no 
spaces).


TO REMOVE A GRAPHIC FROM A PWAD
================================
  Simply type:

  DMGRAPH graphic_name -r -f pwadname.WAD


TO LIST THE CONTENTS OF A WAD
============================

Type:

    DMGRAPH -c           (to view directory contents of DOOM.WAD)
or DMGRAPH -c -f pwadname.WAD  (to view directory contents of a PWAD)

NOTE:  You do not need a graphic_name when using the -c parameter.  Also, 
while viewing a long list of directory contents, DMGRAPH will show the
contents page by page with a (more) indicator at the bottom of the screen.  
To stop viewing the contents, simply hit ^C.

Well, that's about it.  Happy Dooming!


Written by:  Ben Sze
09-14-1994