WAD composer for Doom, Heretic, Hexen, and Strife
C Python Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.adoc

DeuTex

DeuTex can do many things with Doom, Freedoom, Heretic, Hexen, and Strife “WAD” files, such as extracting and inserting graphics, sounds, levels, and other resources. It can be used for creating and modifying IWAD (“Internal WAD”) and PWAD (“Patch WAD”) files both.

It is a command-line driven program and as such, is suitable for scripting such as from a shell script or Makefile.

File formats

For insertion and extraction, DeuTex supports a few common formats.

For music, DeuTex supports both the DMX “mus” file format native to Doom, and also MIDI files supported in Doom 1.666 and newer. There is no conversion between these formats, they are inserted and extracted as-is.

For audio samples, they are saved and read using simple WAV files containing only uncompressed PCM audio streams.

For the various forms of graphics, the BMP (uncompressed only), GIF, PPM, and PNG [1] formats are supported.

Unrecognized-format lumps are saved with .lmp extension in the lumps directory and are re-inserted as-is from there. Levels are saved in an encapsulated PWAD file; breaking them apart would not be useful for editing and all the lumps that make up a level are co-dependent on each other.

Building and installing

DeuTex uses an Autoconf+Automake build system, so its compilation and installation process is identical to most other Unix packages:

./configure
make
make install

When building directly from the version control repository, you will need autoconf and automake installed and run the ./bootstrap command first to generate the ./configure file.

To build and install the manpage, AsciiDoc must be installed, in particular the DocBook-based a2x command for transforming it into manpage format. DeuTex will still build without it, however, and the AsciiDoc source in man/deutex.txt is fairly readable on its own.

To build and install on ReactOS or Microsoft Windows will require an environment compatible with Unix shells and programs, such as Cygwin or MSYS2.

History

DeuTex began life as a fork of Doom Editing Utilities (known as DEU for short) by Olivier Montanuy in 1994, expunging the graphical user interface in favor of command line and scriptable usage scenarios. Originally written for DOS, its primary home is now modern Unix and Windows systems, and is a fundamental piece to building Freedoom’s IWAD files.

The name comes from a play on LaTeX and in turn TeX, a popular typesetting system in academia but no technical connection to DeuTex. It is pronounced as two syllables, the first like “due” or “dew,” and the second like “tech” (not “tex”!), owing from its namesake.

Copyright © 1994-1996 Olivier Montanuy, © 1999-2005 André Majorel, © 2006-2018 contributors to the DeuTex project.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR ANY PARTICULAR PURPOSE. See the GNU General Public License for more details, provided under the name COPYING.


1. Requires libpng 1.6 or newer.