1DEUTEX(6) DEUTEX(6)
2
6 deutex - do things with wad files
7
9 deutex -?|-h|-help|--help
10 deutex --version
12 deutex [OPTIONS] -add incomplete.wad out.wad
14 deutex [OPTIONS] -af flats.wad
16 deutex [OPTIONS] -append incomplete.wad
18 deutex [OPTIONS] -as sprite.wad
20 deutex [OPTIONS] -check in.wad
22 deutex [OPTIONS] -debug [in.gif]
24 deutex [OPTIONS] -get entry [in.wad]
26 deutex [OPTIONS] -join incomplete.wad in.wad
28 deutex [OPTIONS] -make [dirctivs.txt] out.wad
30 deutex [OPTIONS] -merge in.wad
32 deutex [OPTIONS] -pkgfx [in.wad [out.txt]]
34 deutex [OPTIONS] -pknormal [in.wad [out.txt]]
36 deutex [OPTIONS] -restore
38 deutex [OPTIONS] -usedidx [in.wad]
40 deutex [OPTIONS] -usedtex [in.wad]
42 deutex [OPTIONS] -unused in.wad
44 deutex [OPTIONS] -wadir [in.wad]
46 deutex [OPTIONS] -xtract in.wad [dirctivs.txt]
48
50 DeuTex is a wad composer for Doom, Heretic, Hexen and Strife. It can be
51 used to extract the lumps of a wad and save them as individual files or
52 the reverse, and much more.
53 When extracting a lump to a file, it does not just copy the raw data,
55 it converts it to an appropriate format (such as PPM for graphics, Sun
56 audio for samples, etc.). Conversely, when it reads files for inclusion
57 in pwads, it does the necessary conversions (for example, from PPM to
58 Doom picture format).
59 Decomposing a wad
61 To decompose a wad (i.e. extract its contents), use the -extract
62 (a.k.a. -xtract) command. When decomposing a wad, DeuTex creates one
63 file for each lump. The files are created in one of the following
64 subdirectories of the working directory: flats/, lumps/, musics/,
65 patches/, sounds/, sprites/, textures/. The decomposing process also
66 creates a very important file, wadinfo.txt, which will be used later
67 when composing.
68 To extract the contents of the Doom II iwad,
70 deutex -doom2 /path/to/doom2.wad -xtract
72 To extract the contents of a Doom II pwad named mywad.wad,
74 deutex -doom2 /path/to/doom2.wad -xtract mywad.wad
76 To extract only the sprites,
78 deutex -doom2 /path/to/doom2.wad -sprites -xtract
80 To extract only the sounds,
82 deutex -doom2 /path/to/doom2.wad -sounds -xtract
84 Composing (building) a wad
86 Composing is the symmetrical process. It’s done with the three commands
87 -build, -create and -make, that are equivalent. Using wadinfo.txt and
88 the files in flats/, lumps/, musics/, patches/, sounds/, sprites/ and
89 textures/, DeuTex creates a new wad.
90 To create a new pwad named mywad.wad,
92 deutex -doom2 /path/to/doom2.wad -make mywad.wad
94 To create a new iwad named mytc.wad,
96 deutex -doom2 /path/to/doom2.wad -iwad -make mytc.wad
98 Other operations
100 DeuTex has many (too many?) other commands like -join, -merge, -usedtex
101 etc.
102
104 Modal options not requiring an iwad
105 -?, -h, -help, --help
106 Print list of options.
107 -syntax
109 Print the syntax of wad creation directives.
110 --version
112 Print version number and exit immediately.
113 -unused in.wad
115 Find unused spaces in a wad.
116 Modal options requiring an iwad
118 -add in.wad out.wad
119 Copy sp & fl of iwad and in.wad to out.wad.
120 -af flats.wad
122 Append all floors/ceilings to the wad.
123 -append io.wad
125 Add sprites & flats of iwad to io.wad.
126 -as sprite.wad
128 Append all sprites to the wad.
129 -build|-create|-make [in.txt] out.wad
131 Make a pwad.
132 -check|-test in.wad
134 Check the textures.
135 -debug [file]
137 Debug color conversion.
138 -extract|-xtract [in.wad [out.txt]]
140 Extract some/all entries from a wad.
141 -get entry [in.wad]
143 Get a wad entry from main wad or in.wad.
144 -join incomplete.wad in.wad
146 Append sprites & flats of Doom to a pwad.
147 -merge in.wad
149 Merge doom.wad and a pwad.
150 -pkgfx [in.wad [out.txt]]
152 Detect identical graphics.
153 -pknormal [in.wad [out.txt]]
155 Detect identical normal.
156 -restore
158 Restore doom.wad and the pwad.
159 -usedidx [in.wad]
161 Color index usage statistics.
162 -usedtex [in.wad]
164 List textures used in all levels.
165 -wadir [in.wad]
167 List and identify entries in a wad.
168 General options
170 -overwrite
171 Overwrite all.
172 -dir dir
174 Extraction directory (default .).
175 Iwad
177 -doom dir
178 Path to Doom iwad.
179 -doom2 dir
181 Path to Doom II iwad.
182 -doom02 dir
184 Path to Doom alpha 0.2 iwad.
185 -doom04 dir
187 Path to Doom alpha 0.4 iwad.
188 -doom05 dir
190 Path to Doom alpha 0.5 iwad.
191 -doompr dir
193 Path to Doom PR pre-beta iwad.
194 -heretic dir
196 Path to Heretic iwad.
197 -hexen dir
199 Path to Hexen iwad.
200 -strife dir
202 Path to Strife iwad.
203 -strife10 dir
205 Path to Strife 1.0 iwad.
206 Wad options
208 -be
209 Assume all wads are big endian (default LE).
210 -deu
212 Add 64k of junk for DEU 5.21 compatibility.
213 -george|-s_end
215 Use S_END for sprites, not SS_END.
216 -ibe
218 Input wads are big endian (default LE).
219 -ile
221 Input wads are little endian (default).
222 -ipf code
224 Picture format (alpha, normal, pr; default normal).
225 -itf code
227 Input texture format (nameless, none, normal, strife11; default
228 normal).
229 -itl code
231 Texture lump (none, normal, textures; default normal).
232 -iwad
234 Compose iwad, not pwad.
235 -le
237 Assume all wads are little endian (default).
238 -obe
240 Create big endian wads (default LE).
241 -ole
243 Create little endian wads (default).
244 -otf code
246 Output texture format (nameless, none, normal, strife11; default
247 normal).
248 -pngoffsets
250 Override offsets in WADINFO with offsets contained in PNG metadata
251 -tf code
253 Texture format (nameless, none, normal, strife11; default normal).
254 Lump selection
256 -flats
257 Select flats.
258 -graphics
260 Select graphics.
261 -levels
263 Select levels.
264 -lumps
266 Select lumps.
267 -musics
269 Select musics.
270 -patches
272 Select patches.
273 -scripts
275 Select Strife scripts.
276 -sneas
278 Select sneas (sneaps and sneats).
279 -sneaps
281 Select sneaps.
282 -sneats
284 Select sneats.
285 -sounds
287 Select sounds.
288 -sprites
290 Select sprites.
291 -textures
293 Select textures.
294 Graphics
296 -bmp
297 Save pictures as BMP (.bmp).
298 -png
300 Save pictures as PNG (.png). Default format.
301 -gif
303 Save pictures as GIF (.gif).
304 -ppm
306 Save pictures as rawbits PPM (P6, .ppm).
307 -rgb r g b
309 Specify the transparent colour (default 0 47 47).
310 Sound
312 -rate code
313 Policy for != 11025 Hz (reject, force, warn, accept; default warn).
314 Reporting
316 -di name
317 Debug identification of entry.
318 -v0|-v1|-v2|-v3|-v4|-v5
320 Set verbosity level, default 2.
321
323 All messages are identified by a unique code. Some messages are
324 identical; the code is useful to distinguish them. All codes have four
325 characters: two letters and two digits. The letters identify the part
326 of the code where the message comes from, the digits give the message
327 number within that area. In general, numbers are assigned so that
328 messages that come from parts of the code that are executed earlier
329 have lower numbers.
330
332 dir/flats/
333 When extracting, flats are saved to this directory. When composing,
334 flats are read from this directory.
335 dir/graphics/
337 When extracting, graphics are saved to this directory. When
338 composing, graphics are read from this directory.
339 dir/levels/
341 When extracting, levels are saved to this directory. When
342 composing, levels are read from this directory.
343 dir/lumps/
345 When extracting, lumps are saved to this directory. When composing,
346 lumps are read from this directory.
347 dir/musics/
349 When extracting, musics are saved to this directory. When
350 composing, musics are read from this directory.
351 dir/patches/
353 When extracting, patches are saved to this directory. When
354 composing, patches are read from this directory.
355 dir/scripts/
357 When extracting, Strife scripts are saved to this directory. When
358 composing, Strife scripts are read from this directory.
359 dir/sneaps/
361 When extracting, Doom alpha sneaps are saved to this directory.
362 When composing, Doom alpha sneaps are read from this directory.
363 dir/sneats/
365 When extracting, Doom alpha sneats are saved to this directory.
366 When composing, Doom alpha sneats are read from this directory.
367 dir/sounds/
369 When extracting, sounds are saved to this directory. When
370 composing, sounds are read from this directory.
371 dir/sprites/
373 When extracting, sprites are saved to this directory. When
374 composing, sprites are read from this directory.
375 dir/textures/texture1.txt
377 The TEXTURE1 lump (all but Doom alpha 0.4 and 0.5).
378 dir/textures/texture2.txt
380 The TEXTURE2 lump (all commercial IWADs except Doom 2).
381 dir/textures/textures.txt
383 The TEXTURES lump (Doom alpha 0.4 and 0.5).
384 dir/tx_start/
386 Special texture directory for certain engines such as ZDoom.
387 Specifying a positive integer after the name in wadinfo.txt causes
388 no format conversion to be performed (eg, PNGs and BMPs remain as
389 PNGs and BMPs in the WAD), otherwise an attempt to convert to
390 Doom’s patch format is done.
391 dir/wadinfo.txt
393 The default master file.
394
396 DOOMWADDIR
397 The directory where the iwad resides. The value of this environment
398 variable is overridden by -main, -doom and friends.
399
401 DeuTex is copyright © 1994-1995 Olivier Montanuy, copyright © 1999-2005
402 André Majorel, copyright © 2006-2019 contributors to DeuTex.
403 Most of this program is under the GNU General Public License version 2,
405 but some of it is available under other licenses. This program is
406 distributed in the hope that it will be useful, but WITHOUT ANY
407 WARRANTY; without even the implied warranty of MERCHANTABILITY or
408 FITNESS FOR A PARTICULAR PURPOSE. See LICENSE for specific information
409 and copyright notices. All trademarks are property of their owners.
410
412 The original author of DeuTex is Olivier Montanuy. From 1994 to 1996,
413 DeuTex was maintained by Olivier Montanuy with help from Per Allansson,
414 James Bonfield, Sharon Bowles, Mark Mathews, and Chuck Rossi. The
415 original manual was written by Kevin McGrail.
416 From version 4.0 (1999) through 4.4.902 (2005), the maintainer was
418 André Majorel (http://www.teaser.fr/~amajorel).
419 The project has since been maintained by a loose collaboration of
421 authors primarily as part of the Debian project and Freedoom project.
422 They include Jon Dowland, Simon Howard, Mike Swanson, RjY, Ayub Ahmed,
423 and Nick Zatkovich.
424
426 Please report bugs to the issue tracker at
427 https://github.com/Doom-Utils/deutex.
428 07/19/2023 DEUTEX(6)