Giter VIP home page Giter VIP logo

deutex's Introduction

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.

deutex's People

Contributors

chungy avatar voros2 avatar jengelh avatar jmtd avatar fabiangreffrath avatar fragglet avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.