home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the DOOM Gurus / TricksOfTheDoomGurus.iso / editors / deutex / manual / advanced / format.txt < prev    next >
Encoding:
Text File  |  1994-10-25  |  7.7 KB  |  279 lines
  1.  
  2.  
  3. ************ Formats of the Text files for DeuTex *************
  4.  
  5.     *************************** 
  6.     * WAD Creation Directives *
  7.     ***************************
  8.  
  9.  
  10. the creation directive file is necessary to use the -make command.
  11. It is automatically generated by the -xtract command.
  12.  
  13. This file lists the entries wich are present in the PWAD file.
  14. It contains 6 sections: LEVELS LUMPS TEXTURES SOUNDS GRAPHICS FLATS.
  15. This is the same order as that of DOOM.WAD.
  16.  
  17. The sections MUST appear in that order. Those not in the right order
  18. will be ignored without warning. All the sections are optionnal.
  19.  
  20. note: 
  21. - There is no PATCHES sections. PATCH loading is automatic.
  22. - There is no PNAMES entry defined. PNAMES creation is automatic.
  23. - TEXTURE1 and TEXTURE2 are reserved TEXTURE names. TEXTURE1 must
  24.   be present if *any* texture is redefined. TEXTURE2 shall *not*
  25.   be present if no registred (DOOM1) texture is defined.
  26.  
  27.  
  28. ************************ WADINFO.TXT *****************************
  29.  
  30. #
  31. # lines begining with '#' are comments
  32. #
  33. # The LEVELS section define the DOOM1 levels and DOOM2 maps.  
  34. # 
  35. Begin: LEVELS
  36. E1M2        #DeuTex will look for LEVELS\E1M2.WAD
  37. MAP04        #DeuTex will look for LEVELS\MAP04.WAD
  38. End: LEVELS
  39. #
  40. #
  41. # E1M2.WAD must contain all the 11 entries that define a level.
  42. # which means the NODES and BLOCKMAP and REJECT must have been built
  43. # 
  44. # if E1M2.WAD contains one level, it will be selected.
  45. # if E1M2.WAD contains many levels, the one named 'E1M2' will be selected.
  46. # 
  47.  
  48.  
  49. # 
  50. # The LUMPS section defines the lumps of raw data for DOOM
  51. # 
  52. Begin: LUMPS
  53. ENDOOM        #DeuTex will look for LUMPS\ENDOOM.LMP
  54. DEMO1        #DeuTex will look for LUMPS\DEMO1.LMP
  55. End: LUMPS
  56. #
  57. # See the DOOM SPECS for a precise description of all those entries.
  58. # Apart from the DEMO, there is no real need to mess with them.
  59. # DEMOs can be recorded by DOOM.
  60. #
  61.  
  62.  
  63. #
  64. # The TEXTURES section defines the new textures.
  65. # 
  66. Begin: TEXTURES
  67.         #DeuTex will first load TEXTURES\TEXTURE1.TXT
  68. MYWALLS        #DeuTex will look for TEXTURES\MYWALLS.TXT
  69.         #DeuTex will then look for TEXTURES\TEXTURE2.TXT
  70. End: TEXTURES
  71. #
  72. # If you redefine any texture, TEXTURE1.TXT must be present.
  73. # it is loaded before anything else, because else the old textures
  74. # might not appear in DOOM. Must be a bug...
  75. # TEXTURE2 is optionnal. Redefine it only if you need to modify
  76. # one of the registred textures.
  77. # DOOM2 does not contain a TEXTURE2 entry.
  78. #
  79.  
  80.  
  81.  
  82. #
  83. # The SOUNDS section defines MUSIC, PCSOUNDS and WAVE SOUNDS
  84. #
  85. Begin: SOUNDS
  86. D_E2M3            #DeuTex will look for SOUNDS\D_E2M3.MUS
  87.             #this is the music of Episode2 Mission3
  88. D_E3M4        *    #sets D_E3M4 music to be equal to D_E2M3
  89. D_MAP01        *    #set  D_MAP01 music to be equal to D_E2M3
  90. DSSLOP            #DeuTex will look for SOUNDS\DSSLOP.WAV or .AU
  91.             #this is a WAVE sound, meant for sound cards.
  92. DPSLOP            #DeuTex will look for SOUNDS\DPSLOP.TXT
  93.             #this is a PC speaker sound.
  94. End: SOUNDS
  95. #
  96. # MUS format can be obtained from MIDI with MIDI2MUS, or converted
  97. # back to MIDI by MUS2MIDI (by just_joe). These are separate utilities.
  98. # This is not a feature of DeuTex because I have no knowledge of MIDI.
  99. #
  100. # The WAV and .AU format were hacked. DeuTex can't read compressed data.
  101. #
  102. # The format of the PC-speaker sound is a list of integer (range 1-255).
  103. # Must represent the inverse of frequency or something. I dunno. 
  104. #
  105.  
  106. # The GRAPHICS section defines all the fixed pictures.
  107. # you can only use already existing names, to replace the
  108. # correponding entry.
  109. Begin: GRAPHICS
  110. WIMAP1            #DeuTex will load GRAPHICS\WIMAP1.BMP    
  111. STHURT1    23    45    #DeuTex will load GRAPHICS\STHURT1.BMP
  112.             #and set the insertion point to 23,45
  113. STHURT2        *    #DeuTex will set STHURT2 equal to STHURT1
  114. End: Graphics
  115. #
  116. # Fixed pictures include: opening screen, texts (!), menues,
  117. # status bar, ending pictures ...
  118. # You can only use names already defined in DOOM. Else DOOM will
  119. # ignore them. (you'll be warned :-)
  120. #
  121.  
  122. #
  123. # This section declares the SPRITES.
  124. #
  125. Begin: SPRITES
  126. BOSSB1            #DeuTex will load SPRITES\BOSSB1.BMP or .GIF
  127.             #and calculate insertion point by itself
  128. BOSSA1      10    20    #DeuTex will load SPRITES\BOSSA1.BMP or .GIF
  129.             #and set the insertion point to 10,20
  130. BOSSA2A8    *    #DeuTex will set BOSSA2A8 equal to BOSSA1
  131. End: SPRITES
  132. #
  133. # If you redefine all sprites, use the -iwad option.
  134. # else you'll have to use DeuSF to rebuild a complete sprite PWAD
  135. # each time. This is because of a limitation of DOOM which still
  136. # has not been removed (ask IDsoftware about it).
  137. #
  138.  
  139. #
  140. # Don't declare your patches. 
  141. # the patch, say xxxx, will be automaticaly loaded in PWAD from 
  142. # file PATCHES\xxxx.BMP or .GIF if:
  143. # - 'xxxx' is referenced in one of the TEXTURE files, as a patch.
  144. # - 'xxxx' exists as a patch in the original DOOM, and a file 
  145. #     PATCHES\xxxx.BMP or .GIF exists. (replacement of existing patch)
  146. # 
  147.  
  148.  
  149. #
  150. # 
  151. # The FLATS section declares the Floors and Ceiling.
  152. #
  153. Begin: FLATS
  154. GRASS            #DeuTex will load FLATS\GRASS.BMP or .GIF
  155. HERBE        *    #DeuTex will set HERBE to be equal to GRASS 
  156. End: FLATS
  157. #
  158. # You can define new Flat names, or redefine existing flats,
  159. # but unless you redefine the complete list of FLATS, and use
  160. # the -iwad option, you'll have to rebuild the complete FLAT
  161. # list with DEUSF each time you want to use the PWAD. 
  162. #
  163.  
  164. #
  165. # WAD creation directives end here
  166. #
  167.  
  168.  
  169.  
  170.  
  171.  
  172.     **********************************
  173.     * Format of Textures Definitions *
  174.     **********************************
  175.  
  176.  
  177. # Texture file
  178. #
  179. Begin: TEXTURES
  180. #
  181. ASHWALL             64    128
  182. *    W104_1          0    0
  183. #
  184. # BIGDOOR7 is a texture of size is 256x128 (X size, Y size)
  185. # composed of two patches, W105_1 and W105_1
  186. # respectively placed at offset -4,-4  and offset 124, -4 
  187. # '*' at the beginning of line indicates a patch
  188. #
  189. BIGDOOR7            256    128
  190. *    W105_1          -4    -4
  191. *    W105_1          124    -4
  192. #
  193. # FLOWER is a new texture, composed of an old patch
  194. #
  195. FLOWER             32    128
  196. *    TP5_1           0    0
  197. #
  198. # BLODGR2 redefines the old BLODGR2 texture to be composed of
  199. # the new patch BIRDY
  200. #
  201. BLODGR2             34    128
  202. *    BIRDY           0    0
  203. #
  204. # new texture HADDOCK, composed of new an old ones 
  205. #
  206. HADDOCK            64    128
  207. *    FISH1        0    0
  208. *    BIGFISH        23    44
  209. *    TP5_1           0    0
  210. #
  211. #
  212. End TEXTURES
  213. #
  214. # texture definitions end here.
  215.  
  216.  
  217. Once you have created a new PWAD, check it with the -check
  218. command. DeuTex will complain for:
  219.  texture width which are not power of 2
  220.     (DOOM rounds them to a power of 2)
  221.  texture height above 128
  222.     (DOOM ignore everything above 128)
  223.  textures with columns not covered by any patch
  224.     (DOOM exit with an error)
  225.  
  226. READ the DOOM SPECS by Matt Fell
  227.  
  228. Avoid common mistakes, like:
  229. - using a multi-patch texture for a transparent wall
  230. - using a texture of height below 128 on a wall whose
  231.   height is superior to that of the texture.
  232.  
  233.  
  234.  
  235.  
  236.     *****************************
  237.     * format of list of strings *
  238.     *****************************
  239.  
  240.       (-list2exe -exe2list)
  241.  
  242.  
  243. This function allows you to modify strings in DOOM.EXE
  244.  
  245. # exemple
  246. Let: #original_string_as_found_in_DOOM.EXE#
  247. Be:  #your_own_modification_of_that_string#
  248. #
  249.  
  250. DO NOT EDIT THE STRING JUST AFTER 'Let:'
  251. EDIT ONLY THE STRING AFTER 'Be:'
  252. SUPPRESS ALL NON NEEDED STRING PAIRS.
  253.  
  254. REPLACE ONLY DATA THAT IS OBVIOUSLY A STRING
  255. (DeuTex cannot find exactly the start of strings)
  256.  
  257. DON'T EDIT SMALL STRINGS (high crash probability)
  258.     
  259. ONLY CHANGE STRINGS OBTAINED FROM 'exe2list'
  260.  
  261. DOOM.EXE is preserved. You must copy it to DOOMFAKE.EXE
  262. before you try to modify it.
  263.  
  264. Better use DEHACKED if you're not sure of what you're doing. 
  265.  
  266.  
  267.  
  268.  
  269.  
  270.     *******************
  271.     * PC sound format *
  272.     *******************
  273.  
  274. only a list of number, between 0 and 255
  275.  
  276. The higher the number, the higher the pitch played.
  277. must be in proportion with the inverse of the delay between
  278. two speaker click...
  279.