home *** CD-ROM | disk | FTP | other *** search
/ GCW Games & More & Wacky Windows Companion / gcw.iso / doom / starwar / deusf.txt < prev    next >
Encoding:
Text File  |  1994-11-04  |  4.3 KB  |  145 lines
  1.             DeuSF version 2.7     11/94
  2.  
  3.      Copyright (C) Olivier Montanuy 1994. 
  4.  
  5.     DeuSF is inspired from DMADDS by Bernd Kreimeier
  6.  
  7.  
  8.  
  9. *******************  DeuSF Commands  *************************
  10.  
  11. SUMMARY:   
  12.  
  13.  DeuSF replaces DMADDS, because it addapts to all versions of DOOM,
  14.  requires less perverted PWAD structure, and appends to a PWAD rather
  15.  than generate a new PWAD (saves space).
  16.  
  17.  you have a PWAD containing sprites and flats (and even other entries)
  18.  but all the sprites and flats are not present:
  19.  > DeuSF -app mywad.wad
  20.  And DeuSF will append to your PWAD the necessary sprites and flats
  21.  from DOOM.WAD or DOOM2.WAD
  22.  > DeuSF -res mywad.wad
  23.  Will restore the PWAD to it's original state.
  24.  
  25.  That kind of PWAD should PREFERABLY be built with DeuTex.
  26.  
  27.  
  28.  You *should* take the time to evaluate this tool even if you're not
  29.  convinced at all. Trust that this time won't be wasted.
  30.  
  31.  
  32. COMPLETE COMMAND REFERENCES:
  33.  
  34.  All the optional commands must appear before the non optional ones
  35.  else they will be ignored.
  36.  
  37.  
  38. * Help commands
  39.  
  40. DEUSF -help
  41. DEUSF -format
  42.     Will print the format of PWAD that DeuSF can recognise
  43.  
  44. * Optionnal commands
  45.  
  46. DEUSF  -doom <doom directory>
  47.     OPTIONAL COMMAND
  48.     DEFAULT IS: CURRENT DIRECTORY or \DOOM or \DOOM2
  49.     use that command to indicate the directory where you put your DOOM.WAD and DOOM.EX
  50.     example:        -doom C:\DOOM
  51.  
  52. DEUSF -sprite
  53. DEUSF -flat
  54.      OPTIONAL COMMANDS
  55.     to be use with -add or -app, to add only sprites or only flats.
  56.  
  57.  
  58. * Mandatory Commands
  59.  
  60. DEUSF -app  <myown.wad>
  61.  
  62.     Will append to MYOWN.WAD only those sprites of DOOM which
  63.     are not redefined. Saves disk space, compared to -add command.
  64.  
  65. DEUSF -add  <myown.wad> <allsf.wad>
  66.  
  67.     Will put in ALLSF.WAD all the sprites and flats of DOOM.WAD
  68.     together with those contained in MYOWN.WAD.
  69.  
  70. DEUSF -res <myown.wad>
  71.  
  72.     Restores a PWAD which had been modified with -app command.
  73.     Quite safe.
  74.  
  75.  
  76. DEUSF -wadir <thatcool.wad>
  77.  
  78.     List the entries in the PWAD directory with identification.
  79.     Usefull to check is DeuSF recognise all the entries correctly,
  80.     if there is a problem with -app or -add.
  81.  
  82.  
  83. ****************** Technical Insight **************************
  84.  
  85. DeuSF need only be applied to PWADS that contain:
  86.     -some sprites to replace those of DOOM.WAD.
  87.     -some flats to replace those of DOOM.WAD.
  88.  
  89. DeuSF need no be used if:
  90.     - the PWAD contains *all* the sprites of DOOM.WAD
  91.     - the PWAD contains *all* the flats of DOOM.WAD
  92.     - the PWAD contains sprites which are not referenced in 
  93.       DOOM.WAD. (a dehacked patch is needed to have them work)
  94.     
  95. DeuSF shall only be used on PWAD that respect a precise format.
  96.     - That format is compatible with the old DMADDS.
  97.     - That format is generated by DeuTex automatically.
  98. If the format is not respected, DeuSF might fail to identify
  99. some entries correctly. This is because there is no type identifier
  100. for entries of IWADs and PWADs.
  101.  
  102.  Sprites are identified only if comprised between:
  103.  - S_START or SS_START
  104.  - S_END   or SS_END 
  105.  Flats (floor/ceilings) are identified only if comprised between:
  106.  - F_START or FF_START
  107.  - F_END   or FF_END  
  108.  
  109.  
  110. About DeuSF:
  111.  The code for DeuSF is 80% the same as that of DeuTex.
  112.  the DeuSF -app command is only a modified version of the amazing
  113.  DeuTex -merge command (the only command that remove all the
  114.  limitations of PWADS :-> )
  115.  
  116.  
  117. ******************* Known problems **********************
  118.  
  119. -    DeuSF was *not* tested under DOOM ][.
  120.         But still it was reported to work correctly.
  121. -    DeuSF does NOT test that all required sprite viewpoints
  122.         are available, when changing viewpoints.
  123.         DOOM will lock up if you forget one sprite.
  124. -    If the -app command is interrupted, then the PWAD file
  125.         becomes bigger, due to appended waste data.
  126.         but it is still operationnal.
  127. -    DeuSF says stupid things if no command is given.
  128.  
  129.  
  130. ***************** CONVIVIALITY ************************ 
  131.  
  132.  DeuSF has NO human interface. I will seriously frown upon complaints
  133.  about the lack of human interface. DeuSF IS MEAN TO BE RUN IN BATCH.
  134.  
  135.  DeuSF, like DeHacked, is here to help you distribute special PWADS.
  136.  You must write by yourself a batch file to install the PWAD.
  137.  
  138.  
  139.  example of DeuSF usage on ALIENDOOM 1.0:
  140.  
  141.  DeuSF -doom c:\doom -sprite -add ALIENGFX.WAD ALINGRFX.WAD
  142.  or, better:
  143.  DeuSF -doom c:\doom -sprite -app ALIENGFX.WAD
  144.  
  145.