Build tools: Difference between revisions

From EDukeWiki
Jump to navigation Jump to search
← Older editNewer edit →
update binaries to r3122
update to r3164
Line 1: Line 1:
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 eduke32/build/src/util/ directory of the repository or packages.
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 [{{EDuke32 source path|build/src/util/}} eduke32/build/src/util/] and [{{EDuke32 source path|source/util/}} eduke32/source/util/] directories of the repository or packages.


__TOC__
==Command-Line Executables==
==Command-Line Executables==


Windows binaries of the executables can be found here: http://hendricks266.duke4.net/stuff/buildtools_r3122.7z
Windows binaries of the executables can be found here: http://hendricks266.duke4.net/stuff/buildtools_r3164.7z


To build them yourself, see [[Template:Distribution intro|the relevant information]] to set up the compiler. At the build/ subdirectory of the EDuke32 source code, type <code>make</code> followed by the name of the ''group'' of tool you want to build.
To build them yourself, see [[Template:Distribution intro|the relevant information]] to set up the compiler. Navigate to the directory for the desired side (engine: <code>eduke32/build/</code>, game: <code>eduke32/</code>). Type <code>make</code> followed by the name of the ''group'' of tool you want to build.


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


{| {{prettytable}}
{| {{prettytable}}
!Tool Name!!Main Author!!Group!!Description!!
!Tool Name!!Main Author!!Side!!Group!!Description!!
|-
|-
|kextract
|kextract
|[[Ken Silverman]]
|[[Ken Silverman]]
|engine
|utils
|utils
|extracts data from GRP "group files"
|extracts data from GRP "group files"
Line 19: Line 21:
|kgroup
|kgroup
|[[Ken Silverman]]
|[[Ken Silverman]]
|engine
|utils
|utils
|creates GRP "group files" out of specified files
|creates GRP "group files" out of specified files
Line 24: Line 27:
|transpal
|transpal
|[[Ken Silverman]]
|[[Ken Silverman]]
|engine
|utils
|utils
|generates shading/translucence tables from a palette
|generates shading/translucence tables from a palette
Line 29: Line 33:
|wad2art
|wad2art
|[[Ken Silverman]]
|[[Ken Silverman]]
|engine
|utils
|utils
|novelty utility for converting Doom art resources in WAD files to [[BUILD]] ART files, PALETTE.DAT, and NAMES.H
|novelty utility for converting Doom art resources in WAD files to [[BUILD]] ART files, PALETTE.DAT, and NAMES.H
Line 34: Line 39:
|wad2map
|wad2map
|[[Ken Silverman]]
|[[Ken Silverman]]
|engine
|utils
|utils
|novelty utility for converting Doom level maps in WAD files to [[BUILD]] map files
|novelty utility for converting Doom level maps in WAD files to [[BUILD]] map files
Line 39: Line 45:
|kmd2tool
|kmd2tool
|[[Ken Silverman]]
|[[Ken Silverman]]
|engine
|utils
|utils
|translates MD2 models along the z axis (zoffset)
|translates MD2 models along the z axis (zoffset)
Line 44: Line 51:
|md2tool
|md2tool
|[[Helixhorned]]
|[[Helixhorned]]
|engine
|utils
|utils
|query MD2 model info or change the scale/translate fields so that desired bounds are produced
|query MD2 model info or change the scale/translate fields so that desired bounds are produced
Line 49: Line 57:
|generateicon
|generateicon
|[[JonoF]]
|[[JonoF]]
|engine
|utils
|utils
|converts images (.ico? .bmp?) to .c files for the purpose of being embedded as icons in SDL executables
|converts images (.ico? .bmp?) to .c files for the purpose of being embedded as icons in SDL executables
Line 54: Line 63:
|cacheinfo
|cacheinfo
|[[JonoF]]
|[[JonoF]]
|engine
|utils
|utils
|engine cache information tool; scans all files in current directory
|engine cache information tool; scans all files in current directory
|-
|-
|arttool
|arttool
|[[JonoF]]
|[[JonoF]], [[Hendricks266]]
|engine
|utils
|utils
|constructs all attributes of ART files and can import art tiles in PCX and TGA formats
|constructs all attributes of ART files and can import art tiles in PCX and TGA formats
Line 64: Line 75:
|givedepth
|givedepth
|[[JonoF]]
|[[JonoF]]
|engine
|utils
|utils
|transforms a single image from an ART tile into a voxel with the image layered to a specified depth
|transforms a single image from an ART tile into a voxel with the image layered to a specified depth
Line 69: Line 81:
|mkpalette
|mkpalette
|[[JonoF]]
|[[JonoF]]
|engine
|utils
|utils
|inputs simple color ranges in HSV format and automatically generates a palette with shade steps
|inputs simple color ranges in HSV format and automatically generates a palette with shade steps
Line 74: Line 87:
|unpackssi
|unpackssi
|[[JonoF]]
|[[JonoF]]
|engine
|utils
|utils
|unpacks the SSI files employed to hold the data of Sunstorm Interactive expansion packs
|unpacks the SSI files employed to hold the data of Sunstorm Interactive expansion packs
|-
|-
|bsuite
|bsuite
|[[JonoF]] (porting by [[Hendricks266]])
|[[JonoF]], [[Hendricks266]]
|engine
|utils
|utils
|"Build Customization Suite", imports and extracts game palettes
|"Build Customization Suite", imports and extracts game palettes
Line 84: Line 99:
|enumdisplay
|enumdisplay
|[[JonoF]]
|[[JonoF]]
|engine
|dxutils
|dxutils
|Windows-only; enumerates all available display modes to '''enumdisplay.txt''' by default
|Windows-only; enumerates all available display modes to '''enumdisplay.txt''' by default
Line 89: Line 105:
|getdxdidf
|getdxdidf
|[[JonoF]]
|[[JonoF]]
|engine
|dxutils
|dxutils
|Windows-only; enumerates available inputs, from keyboard, mouse, and joystick to '''didf.txt'''
|Windows-only; enumerates available inputs, from keyboard, mouse, and joystick to '''didf.txt'''
Line 94: Line 111:
|makesdlkeytrans
|makesdlkeytrans
|[[JonoF]]
|[[JonoF]]
|engine
|sdlutils
|sdlutils
|SDL-only; builds a key translation table for compatibility purposes
|SDL-only; builds a key translation table for compatibility purposes
|-
|ivfrate
|[[Helixhorned]]
|game
|utils
|gets and sets the FPS of .ivf (VP8) files
|-
|-
|}
|}

Revision as of 23:14, 14 November 2012

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 eduke32/build/src/util/ and eduke32/source/util/ directories of the repository or packages.

Command-Line Executables

Windows binaries of the executables can be found here: http://hendricks266.duke4.net/stuff/buildtools_r3164.7z

To build them yourself, see the relevant information to set up the compiler. Navigate to the directory for the desired side (engine: eduke32/build/, game: eduke32/). Type make followed by the name of the group of tool you want to build.

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

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

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
Retrieved from "https://wiki.eduke32.com/w/index.php?title=Build_tools&oldid=11319"