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