-----------------------------------------------------------------------------

Duke Nukem 3D Art Utilities (v2.0)

-----------------------------------------------------------------------------

DISCLAIMER

The author is not responsible for any damages incurred on any machine due to
the usage of any of the programs in this package (DNA20.ZIP).  A warranty is
not given and a warranty is not implied in any way.  All trademarks, names,
logos, etc. are the property of their respective owners.  Duke Nukem 3D is
made by 3D Realms.  3D Realms will NOT support these programs in any way.

-----------------------------------------------------------------------------

DISTRIBUTION

This package may be distributed freely via the internet as long as the
package is kept intact and the files are not modified in any way.  This
package may NOT be distributed in any commercial package without permission
of the author.  A distribution fee is allowed (provided you can get away
with it).

-----------------------------------------------------------------------------

GREETINGS

CEA
M&M
The Christian Tiger
JJ
The Candle Peoples
Jon "the chicken" Merkel
And others...

-----------------------------------------------------------------------------

SYSTEM REQUIREMENTS

MS-DOS 5.0 (or greater)
8086 Processor (or greater, 80486 or greater recommended)
Up to 50MB of free disk space (for working)

-----------------------------------------------------------------------------

INTRODUCTION

DNA20.ZIP Contains :

AHEAD.EXE       .ART file "header" editor (v1.0)
DNA.EXE         Archiving utility
DNA20.TXT       This file
EXAMPLE.ART     Example .ART file created using DNA.EXE
EXAMPLE.INI     Example .INI file used with DNA.EXE
EXAMPLE.MAP     Example .MAP file (not the greatest)
EXAMPLE.TXT     Authoring template for EXAMPLE.MAP (and installation guide)         
TDNA.EXE        Tile information utility
XDNA.EXE        Extracting/Creating utility

--

The DNA20.ZIP package contains utilities for distributing new image tiles
which can be used to created/change monsters, weapons, etc.  The programs
are free and they are without warranties or guarantees.  Please read the
documentation provided below.

-----------------------------------------------------------------------------

DNA.EXE

--

USAGE :

  DNA <MapName.MAP> [ININame.INI]

Notes:

  Creates <MapName.ART>
  Use XDNA.EXE to extract

--

DNA.EXE creates a .ART file from a given .MAP file.  DNA.EXE will identify
animated tiles and add them.  DNA.EXE optionally takes a .INI file for
fine-tuning the creation of the .ART file.

--

A .INI file is made up of lines beginning with a plus (+) or minus (-) sign.
If the plus (+) sign preceeds a tile number, that tile will be added to the
.ART file.  If the minus (-) sign preceeds a tile number, that tile will not
be added to the .ART file (unless it is part of an animated sequence later).
See the EXAMPLE.INI file.

The .INI file is processed before DNA.EXE identifies animated tiles.

-----------------------------------------------------------------------------

XDNA.EXE

--

USAGE :

  XDNA <ArtName.ART>

Notes :

  Builds TILESxxx.ART files from <ArtName.ART>
  <ArtName.ART> should be created using DNA.EXE
  DUKE3D.GRP must be in the current directory

--

XDNA.EXE builds the needed TILESxx.ART files from a DNA.EXE-made .ART file.
If a tile is not found in the DNA.EXE-made .ART file, XDNA.EXE extracts the
tile from DUKE3D.GRP.  DUKE3D.GRP must be in the current directory.

-----------------------------------------------------------------------------

TDNA.EXE

--

USAGE :

  TDNA <MapName.MAP>

Notes :

  Outputs explicitly used tiles in <MapName.MAP>

Examples Using E1L1.MAP :

  TDNA E1L1.MAP

  TDNA E1L1.MAP > E1L1.INI

--

TDNA.EXE identifies the tiles explicity used by a .MAP file.  The output is
formatted for a .INI file (for use with DNA.EXE).  The second example above
demostrates how to redirect output to a file.

-----------------------------------------------------------------------------

USAGE:

  AHEAD <INFILE.ART> <OUTFILE.ART>

Notes:

  Edits .ART file header to change animation information, etc.

--

This program is included as an extra.  AHEAD.EXE may be used to edit .ART
file animation numbers, animation speed, etc.  It is for those who want to
input exact data in the construction of a .ART file.

-----------------------------------------------------------------------------

NOTES

These programs were written in Turbo Pascal 7.0 and were compiled and run on
a 486DX2 66MHz machine with 20MB of RAM in a Windows '95 DOS box.  These
programs do NOT use any extended RAM, only conventional memory.

DNA.EXE is relatively fast, but XDNA.EXE does not run as quickly since it
may build up to 45MB worth of files.  A fast hard disk and disk cache will
boost XDNA.EXE's speed considerably.  On the above mentioned computer and
using _ZOO.MAP, DNA.EXE built _ZOO.ART in about 5 seconds.  XDNA.EXE then
took about 45 seconds to rebuild the needed TILESxxx.ART files.  .MAP files
with many different animated tiles will slow DNA.EXE down.

Send all bug reports, error numbers, comments, questions, etc. to the author
at the e-mail address provided.

Thank you!  Have fun playing Duke Nukem 3D.

-----------------------------------------------------------------------------

Author : Samiel
E-mail : samiel@fastlane.net
   URL : http://www.fastlane.net/~samiel

-----------------------------------------------------------------------------
