Programming Language	C#
Operating System	Microsoft Windows with the .NET 1.1 Runtime installed.
Intended audience	DOOM level designers; DOOM tool writers

Background
----------

DOOM (the game) has a special file format for the data files used by the game
called WAD files.  These WAD files are made up of directory entries called
lumps which details the level data and all the graphics and sounds used during
the game.

Of specific interest to the WAD Mangle project is the non-map data, meaning
that WAD Mangle can be used to introduce new sounds, graphics and textures
into WAD files for use in user-created levels.


Reasons
-------

WAD Mangle was started for personal use as I needed a tool to do its job.
There are alternative tools available, but a lot of these are not free,
changable or are old and do not support some of the recent features
introduced by recent source updates to the DOOM engine.

It has already turned into a very usable tool and as such I want to release it
to a wider community and to anyone who may find it useful; either as a tool in
its own right, or for the source code that illustrates how to manipulate WAD
files.


WAD Mangle
----------

WAD Mangle is a GUI program written in C# for Windows with .NET 1.1 using
Windows Forms for display.

It allows WAD files to be loaded and the lumps inside them to be edited and
manipulated.  It does this using a standard MDI interface showing each loaded
WAD file in its own window, and allowing lumps from other loaded WADs and files
from Explorer to be dragged and dropped into the WAD file.

For manipulating individual lumps inside the WAD files; specifically it allows
the viewing, editing, exporting and importing of the following lump types:

ASCII		ASCII lumps are used by recent updates to the DOOM engine to
		allow such things as animated textures, map names and
		game texts to be altered.

Binary		Allows the importing of any binary file into the WAD.

Graphics	The WAD file contains entries for all the graphics in DOOM,
		for instance wall patches (used to make wall textures), flats
		(used for the floor and ceilings), sky backgrounds and
		title screens.

Samples		Allows the import and export of sound effects.

PNAMES		Allows the editing of the PNAMES lump -- a special DOOM lump
		that defines all the graphical lumps that can be used to
		create textures.

TEXTURES	Allows the editing of the texture definitions.  DOOM does this
		by defining which PNAME entries are used and their offset into
		the texture space.

ZDoom Features	ZDoom is an advanced version of the DOOM engine.  It allows
		the easy definition of graphical items (flats and textures)
		in user-created WAD files.  WAD Mangle allows the easy, fully
		interactive and graphical editing of these features.

It also allows the easy extension of functionality using .NET DLL assemblies.