home *** CD-ROM | disk | FTP | other *** search
/ Quake 'em / QUAKEEM.BIN / doom_i / program / deciupgr.exe / DOOMIM.DOC < prev    next >
Encoding:
Text File  |  1995-07-16  |  3.8 KB  |  99 lines
  1. DOOMIM - DOOM Resource Import Utility
  2.          Version 1.0 as of 9/1/94
  3.  
  4. NOTICE: The author of DOOMEX, DOOMIM, and DOOMCV will not be held
  5.         responsible for damage or problems that may occur through
  6.         use of this software. You accept full responsibility for
  7.         the consequences of using this software.
  8.                  
  9.  
  10. DOOMIM is part of a collection of 3 utilities used to import, export, and
  11. convert the resource objects in any DOOM WAD file. The other 2 programs in
  12. this set are DOOMEX, for exporting and converting resource objects in a DOOM
  13. wad file to individual files, and DOOMCV, the batch resource conversion
  14. utility.
  15.  
  16. DOOMIM is a very simple program to use. It is batch-oriented, taking all
  17. files located in a special batch processing file and generating a new WAD
  18. file using an existing WAD file or a new PWAD file. You must run DOOMCV first
  19. to convert resources into DOOM resource image files (DRI). See DOOMCV.DOC.
  20.  
  21. DOOMIM accepts one of three command line formats:
  22.  
  23. 1. doomim -r <batch file> <old wad file> <new wad file>
  24. 2. doomim -a <batch file> <old wad file> <new wad file>
  25. 3. doomim -n <batch file> <new wad file>
  26.  
  27. Format 1 will replace the existing entries in a wad file with the entries
  28. in the batch file.
  29.  
  30. Format 2 will add the entries in the batch file as new entries to the
  31. existing wad file.
  32.  
  33. Format 3 will create a new PWAD file using the entries in the batch file.
  34.  
  35. The batch file is a standard DOS text file that contains WAD directory
  36. entries, 1 per line. Each line contains a pair of names. The first name is
  37. the file name without the DRI extension. The second name is the actual
  38. WAD entry name. Separate the names with a comma. In most every case, you
  39. can keep the two names identical, since DOOMEX will use the WAD entry name
  40. as the file name UNLESS the WAD entry name uses illegal DOS file name
  41. characters. In this case, the file name will have to be different than the
  42. WAD entry name. An example of replacing the chainsaw sounds in the WAD
  43. file is shown by the following batch entries (assume that the batch file
  44. is called chain.txt):
  45.  
  46. DSSAWUP,DSSWAUP
  47. DSSAWIDL,DSSAWIDL
  48. DSSAWFUL,DSSAWFUL
  49. DSSAWHIT,DSSAWHIT
  50.  
  51. To make a new PWAD file, just enter the following command line:
  52.  
  53. doomim -n chain.txt chain.wad
  54.  
  55. If you want to replace the chainsaw sounds in an existing wad, use:
  56.  
  57. doomim -r chain.txt doom.wad newdoom.wad
  58.  
  59.  
  60. Creating a new PWAD file is easiest, since it isn't necessary to rebuild
  61. an existing WAD file. If you modify the original IWAD file, make sure you
  62. rename the new WAD file to DOOM.WAD and keep the existing IWAD as a backup.
  63.  
  64. The 'r' and 'a' options will take a long time to execute, since the entire
  65. WAD file will be rebuilt to the new wad file name. All entries that do not
  66. match any in the batch file will be written to the new WAD file unchanged.
  67. All entries that match when using the 'r' option will be replaced. All
  68. entries in the batch file using the 'a' option will be added to the END of
  69. all other entries in the existing WAD file. Warning: If the WAD file already
  70. contains matching entries using the 'a' option, you will create duplicate
  71. entries in the WAD file. Make sure this doesn't happen.
  72.  
  73.  
  74. NOTES:
  75.  
  76. 1. Batch file text must ALWAYS be in upper case.
  77. 2. Batch files that contain a map resource image file must be handled
  78.    differently because DOOMCV will generate a DRI file that contains all
  79.    resources for one DOOM level (as many as 10 resource objects). To import
  80.    a map level DRI file, just use the map level name as the file name and
  81.    use an asterisk (*) as the WAD entry name, as shown below:
  82.    
  83.    contents of map.txt batch file:
  84.    
  85.    E1M1,*
  86.    
  87.    To import this into a new patch WAD file:
  88.    
  89.    doomim -n map.txt newlev.wad
  90.  
  91.  
  92. Comments/suggestions to:
  93.  
  94. Alan Peters
  95. c/o DarkStar Systems
  96. 71 Wagon Trailway
  97. North York, Ontario
  98. Canada M2J 4V4
  99.