Build tools

From EDukeWiki
Jump to navigation Jump to search

The Build tools are sub-components of EDuke32 and the BUILD Engine that assist the user in various editing functions. Their source code can be found in the source/tools/ directory of the repository or packages.

Command-Line Executables

Windows binaries of the executables can be found here: http://dukeworld.duke4.net/eduke32/tools/

To build them yourself, see the relevant information to set up the compiler. Type make tools. For scripting purposes, make printtools will output a list of all tool names that will be built for a corresponding invocation of make tools.

Note that the tools at the bottom of the list are separated due to cross-platform incompatibilities, and they may require specification of certain arguments to the Makefile.

Tool Name Main Author Domain Description
kextract Ken Silverman extracts data from GRP "group files"
kgroup Ken Silverman creates GRP "group files" out of specified files
transpal Ken Silverman generates shading/translucence tables from a palette
wad2art Ken Silverman novelty utility for converting Doom art resources in WAD files to BUILD ART files, PALETTE.DAT, and NAMES.H
wad2map Ken Silverman novelty utility for converting Doom level maps in WAD files to BUILD map files
map2stl Ken Silverman novelty utility for converting map files to Stereolithography (STL) format 3D models
kmd2tool Ken Silverman translates MD2 models along the z axis (zoffset)
md2tool Helixhorned query MD2 model info or change the scale/translate fields so that desired bounds are produced
generateicon JonoF converts images (.ico? .bmp?) to .c files for the purpose of being embedded as icons in SDL executables
cacheinfo JonoF cache information tool; scans all files in current directory
arttool JonoF, Hendricks266 constructs all attributes of ART files and can import art tiles in PCX and TGA formats
givedepth JonoF transforms a single image from an ART tile into a voxel with the image layered to a specified depth
mkpalette JonoF inputs simple color ranges in HSV format and automatically generates a palette with shade steps
unpackssi JonoF unpacks the SSI files employed to hold the data of Sunstorm Interactive expansion packs
bsuite JonoF, Hendricks266 "Build Customization Suite", imports and extracts game palettes
ivfrate Helixhorned gets and sets the FPS of .ivf (VP8) files
enumdisplay JonoF Windows-only enumerates all available display modes to enumdisplay.txt by default
getdxdidf JonoF Windows-only enumerates available inputs, from keyboard, mouse, and joystick to didf.txt
makesdlkeytrans JonoF SDL-only builds a key translation table for compatibility purposes

Bash Scripts

Tool Name Main Author Description
checkdefs.sh Helixhorned find wrongly-cased file names in defs (and cons hackishly) and optionally replace them with the proper names

Python Scripts

Tool Name Main Author Description
ase_import.py Plagman ASE importer for Blender 2.4x
md3_export.py Plagman MD3 exporter for Blender 2.4x
highpalookupmaker.py Plagman simplistic highpallookup generator using only math and the TGA data
prhighpal.py Helixhorned slightly more complex highpallookup generator requiring Python 2.6, NumPy and PIL