Utilities - Revision history

Hendricks266: /* Palettes (.DAT) */

2026-03-11T04:24:23Z

Palettes (.DAT)

← Older revision		Revision as of 21:24, 10 March 2026
Line 70:		Line 70:

	=== Palettes (.DAT) ===		=== Palettes (.DAT) ===
	The PALETTE.DAT and LOOKUP.DAT files hold the palettes, palettes swaps, shade and translucency (blending) tables for the game. This is one of the most loathed and untouched editable features of Duke3D. While incredibly difficult, it can come to good effect. The [[Build tools]] '''bsuite''', '''mkpalette''', and '''transpal''' can help you in this regard.		The PALETTE.DAT and LOOKUP.DAT files hold the palettes, palettes swaps, shade and translucency (blending) tables for the game.

			This is one of the most loathed and untouched editable features of Duke3D. While incredibly difficult, it can come to good effect. The [[Build tools]] '''bsuite''', '''mkpalette''', and '''transpal''' can help you in this regard.

			However, the modern def syntax of [[basepalette (DEF)\|basepalette]], [[palookup (DEF)\|palookup]], and [[blendtable (DEF)\|blendtable]] is simpler and superior than dealing with these old formats and tools.

			For further information, see: [[palette data files]]

	=== Sounds (.VOC/.WAV) ===		=== Sounds (.VOC/.WAV) ===

StrikerTheHedgefox at 20:04, 5 February 2020

2020-02-05T20:04:56Z

← Older revision		Revision as of 13:04, 5 February 2020
Line 37:		Line 37:

	=== Art Files (.ART) ===		=== Art Files (.ART) ===
	.ART files hold all the raw art data in a tidy manner. Once again, there are numerous programs available which can edit the .ART files. The most commonly used program is the one that came with Duke Nukem 3D: EditArt. It is a 16-bit DOS program, so the use of DOSBox is recommended. Other programs include [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-editart/bastART.zip bastART] and [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-editart/dukeresART.zip DukeResART]		.ART files hold all the raw art data in a tidy manner. Once again, there are numerous programs available which can edit the .ART files. The most commonly used program is the one that came with Duke Nukem 3D: EditArt. It is a 16-bit DOS program, so the use of DOSBox is recommended. Other programs include [https://m210.duke4.net/index.php/downloads/download/8-java/41-build-art-files-editor BAFed (Recommended)], [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-editart/bastART.zip bastART] and [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-editart/dukeresART.zip DukeResART]

	The [[Build tool]] '''arttool''' is handy for constructing ART files in a simple and well-defined manner, but be warned that it causes corruption of your art files in some circumstances that has yet to be debugged.		The [[Build tool]] '''arttool''' is handy for constructing ART files in a simple and well-defined manner, but be warned that it causes corruption of your art files in some circumstances that has yet to be debugged.
Line 44:		Line 44:

	There's also a replacement for art2tga/tga2art being written by [[User:Kraigose\|Kraigose]] based on their codebase which aims to replace these tools using the more well known PNG format with the simplicity of the TGA tools INI file syntax. A precompiled Win32 build and source can be found [http://www.kraigosestudios.com/programming/eduke32-art-tools/ here] at Kraigose's website. A readme file is included in the download, as well as color tables for Adobe Photoshop. Images must be 256-color PNGs at the moment, but that'll be fixed soon. It's usage syntax is similar to art2tga and tga2art, but it supports by default doing ''all'' ART files in batch. More development is expected.		There's also a replacement for art2tga/tga2art being written by [[User:Kraigose\|Kraigose]] based on their codebase which aims to replace these tools using the more well known PNG format with the simplicity of the TGA tools INI file syntax. A precompiled Win32 build and source can be found [http://www.kraigosestudios.com/programming/eduke32-art-tools/ here] at Kraigose's website. A readme file is included in the download, as well as color tables for Adobe Photoshop. Images must be 256-color PNGs at the moment, but that'll be fixed soon. It's usage syntax is similar to art2tga and tga2art, but it supports by default doing ''all'' ART files in batch. More development is expected.

			If you do not wish to finaggle with .art files and their tools, you can use PNG files directly and define them in the DEF language using "tilefromtexture" and related commands. See: [[DEF Language#8-Bit .ART File Replacements]]

	=== Animations (.ANM) ===		=== Animations (.ANM) ===

Hendricks266: /* GUI */

2020-01-26T05:21:16Z

GUI

← Older revision		Revision as of 22:21, 25 January 2020
Line 18:		Line 18:

	==== GUI ====		==== GUI ====
	There are other programs which can view art files inside the .GRP and play sound bytes. Other programs include Jonah Bishop's [~~http~~://~~archive.dukertcm~~.com/~~knowledge~~-~~base~~/~~downloads-~~rtcm/duke3d-tools-~~build~~/gfs31.zip Group File Studio] and Roma Loom's [~~http~~:~~//loomsday~~.~~com/?page_id=4~~ GRPViewer]		There are other programs which can view art files inside the .GRP and play sound bytes. Other programs include Jonah Bishop's [https://dukeworld.com/2001-current/rtcm/duke3d-tools-grp/gfs31.zip Group File Studio] and Roma Loom's [[:File:GViewer.zip\|GRPViewer]]

	For your own mods, it is highly recommended to use either .zip files or folders in conjunction with the -j command line parameter instead of GRP files.		For your own mods, it is highly recommended to use either .zip files or folders in conjunction with the -j command line parameter instead of GRP files.

Daedolon: /* Animations (.ANM) */ correct link to anim2pcx.zip

2017-05-19T18:33:32Z

Animations (.ANM): correct link to anim2pcx.zip

← Older revision		Revision as of 11:33, 19 May 2017
Line 46:		Line 46:

	=== Animations (.ANM) ===		=== Animations (.ANM) ===
	.ANM files hold raw .PCX files, which are added together and then played as an animation. In the game these are the animations you see at the end of a boss fight. The sounds for the animations are not included in the .ANM. One of the few .ANM compiling programs is [http://~~archive~~.~~dukertcm~~.~~com~~/~~knowledge-base/downloads-~~rtcm/duke3d-tools-editart/anim2pcx.zip Animation File Maker]		.ANM files hold raw .PCX files, which are added together and then played as an animation. In the game these are the animations you see at the end of a boss fight. The sounds for the animations are not included in the .ANM. One of the few .ANM compiling programs is [http://dukeworld.duke4.net/rtcm/duke3d-tools-editart/anim2pcx.zip Animation File Maker]

	[http://www.ffmpeg.org FFmpeg], since version 0.6, can also decode and play anm files.		[http://www.ffmpeg.org FFmpeg], since version 0.6, can also decode and play anm files.

Nexus: /* GUI */ grammar

2014-10-25T09:36:49Z

GUI: grammar

← Older revision		Revision as of 02:36, 25 October 2014
Line 18:		Line 18:

	==== GUI ====		==== GUI ====
	There are other programs, which can view art files inside the .GRP, and ~~listen to~~ sound bytes. Other programs include Jonah Bishop's [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-build/gfs31.zip Group File Studio] and Roma Loom's [http://loomsday.com/?page_id=4 GRPViewer]		There are other programs which can view art files inside the .GRP and play sound bytes. Other programs include Jonah Bishop's [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-build/gfs31.zip Group File Studio] and Roma Loom's [http://loomsday.com/?page_id=4 GRPViewer]

	For your own mods, it is highly recommended to use either .zip files or folders in conjunction with the -j command line parameter instead of GRP files.		For your own mods, it is highly recommended to use either .zip files or folders in conjunction with the -j command line parameter instead of GRP files.

Nexus: /* Group Files (.GRP) */ -remove pointless sentence fragment

2014-10-25T09:35:34Z

Group Files (.GRP): -remove pointless sentence fragment

← Older revision		Revision as of 02:35, 25 October 2014
Line 5:		Line 5:

	=== Group Files (.GRP) ===		=== Group Files (.GRP) ===
	~~.GRP files contain other,~~ They hold all of the relevant files for the game, and keep your folders tidy. There are several programs available for use.		They hold all of the relevant files for the game, and keep your folders tidy. There are several programs available for use.

	==== CLI ====		==== CLI ====

Hendricks266: /* Movies (.ivf) */

2014-06-16T13:23:05Z

Movies (.ivf)

← Older revision		Revision as of 06:23, 16 June 2014
Line 126:		Line 126:
	To encode video, including an uncompressed raw one, to IVF, use this command line syntax with [http://www.ffmpeg.org FFmpeg]:		To encode video, including an uncompressed raw one, to IVF, use this command line syntax with [http://www.ffmpeg.org FFmpeg]:

	ffmpeg -i <input> -an -vcodec libvpx -~~quality best~~ <output>.ivf		ffmpeg -i <input> -an -vcodec libvpx -crf 8 -b:v 2M <output>.ivf

	To extract VP8 video tracks from a WebM file into a IVF file, you can use:		See the [https://trac.ffmpeg.org/wiki/Encode/VP8 FFmpeg Encode/VP8 wiki page] for more information about fine-tuning a VP8 encode.

			To extract VP8 video tracks from a WebM file into an IVF file, you can use:

	ffmpeg -i <input>.webm -an -vcodec copy <output>.ivf		ffmpeg -i <input>.webm -an -vcodec copy <output>.ivf

	~~You can also use the program ''mkvextract'', part of MKVToolnix, available~~ [http://~~www~~.~~bunkus~~.~~org~~/~~videotools~~/~~mkvtoolnix here~~].		[http://ffmpeg.zeranoe.com/builds/ Windows binaries of FFmpeg] are available.

	~~mkvextract tracks <filename>.webm 1:<filename>.ivf~~

	=== Audio (.ogg/.flac) ===		=== Audio (.ogg/.flac) ===

Hendricks266 at 21:03, 18 January 2014

2014-01-18T21:03:41Z

← Older revision		Revision as of 14:03, 18 January 2014
Line 7:		Line 7:
	.GRP files contain other, They hold all of the relevant files for the game, and keep your folders tidy. There are several programs available for use.		.GRP files contain other, They hold all of the relevant files for the game, and keep your folders tidy. There are several programs available for use.

	=== CLI ===		==== CLI ====

	The preeminent command-line programs for this purpose, and what the original developers used, are kextract and kgroup, part of the [[Build tool]]s.		The preeminent command-line programs for this purpose, and what the original developers used, are kextract and kgroup, part of the [[Build tool]]s.
Line 17:		Line 17:
	While lacking a GUI, they get the job done.		While lacking a GUI, they get the job done.

	=== GUI ===		==== GUI ====
	There are other programs, which can view art files inside the .GRP, and listen to sound bytes. Other programs include Jonah Bishop's [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-build/gfs31.zip Group File Studio] and Roma Loom's [http://loomsday.com/?page_id=4 GRPViewer]		There are other programs, which can view art files inside the .GRP, and listen to sound bytes. Other programs include Jonah Bishop's [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-build/gfs31.zip Group File Studio] and Roma Loom's [http://loomsday.com/?page_id=4 GRPViewer]

Hendricks266 at 21:02, 18 January 2014

2014-01-18T21:02:56Z

← Older revision		Revision as of 14:02, 18 January 2014
Line 17:		Line 17:
	While lacking a GUI, they get the job done.		While lacking a GUI, they get the job done.

	== GUI ===		=== GUI ===
	There are other programs, which can view art files inside the .GRP, and listen to sound bytes. Other programs include Jonah Bishop's [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-build/gfs31.zip Group File Studio] and Roma Loom's [http://loomsday.com/?page_id=4 GRPViewer]		There are other programs, which can view art files inside the .GRP, and listen to sound bytes. Other programs include Jonah Bishop's [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-build/gfs31.zip Group File Studio] and Roma Loom's [http://loomsday.com/?page_id=4 GRPViewer]

Hendricks266 at 21:02, 18 January 2014

2014-01-18T21:02:12Z

← Older revision		Revision as of 14:02, 18 January 2014
Line 5:		Line 5:

	=== Group Files (.GRP) ===		=== Group Files (.GRP) ===
	.GRP files ~~are basically like a zip file~~, ~~they~~ hold all of the relevant files for the game, and keep your folders tidy. There are several programs available for use.		.GRP files contain other, They hold all of the relevant files for the game, and keep your folders tidy. There are several programs available for use.

			=== CLI ===

	The preeminent command-line programs for this purpose, and what the original developers used, are kextract and kgroup, part of the [[Build tool]]s.		The preeminent command-line programs for this purpose, and what the original developers used, are kextract and kgroup, part of the [[Build tool]]s.

	We can find a program called grpextract [svn://svn.icculus.org/duke3d/trunk here]. To build it, just do:		We can find a program called grpextract [svn://svn.icculus.org/duke3d/trunk here]. To build it, just do:
	~~<code>gcc grpextract.c -o grpextract</code>~~

	While lacking a GUI, they get the job done. There are other programs, which can view art files inside the .GRP, and listen to sound bytes. Other programs include Jonah Bishop's [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-build/gfs31.zip Group File Studio] and Roma Loom's [http://loomsday.com/?page_id=4 GRPViewer]		gcc grpextract.c -o grpextract

			While lacking a GUI, they get the job done.

			== GUI ===
			There are other programs, which can view art files inside the .GRP, and listen to sound bytes. Other programs include Jonah Bishop's [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-build/gfs31.zip Group File Studio] and Roma Loom's [http://loomsday.com/?page_id=4 GRPViewer]

	For your own mods, it is highly recommended to use either .zip files or folders in conjunction with the -j command line parameter instead of GRP files.		For your own mods, it is highly recommended to use either .zip files or folders in conjunction with the -j command line parameter instead of GRP files.
Line 20:		Line 26:
	For zip files, there are no better than [http://www.7-zip.org/ 7-Zip] (GUI) and [http://advsys.net/ken/utils.htm KZIP] (CLI).		For zip files, there are no better than [http://www.7-zip.org/ 7-Zip] (GUI) and [http://advsys.net/ken/utils.htm KZIP] (CLI).

	For ~~kicks~~, the .pk3 and .pk4 file extensions are also supported.		For novelty, the .pk3 and .pk4 file extensions are also supported.

	=== Control Files (.CON) ===		=== Control Files (.CON) ===
Line 44:		Line 50:
	[http://www.ffmpeg.org FFmpeg], since version 0.6, can also decode and play anm files.		[http://www.ffmpeg.org FFmpeg], since version 0.6, can also decode and play anm files.

	<u>Some examples :</u>		<u>Some examples:</u>

	~~Play the 'foo' animation file :~~

	~~<pre>ffplay foo.anm</pre>~~

	~~Extract all frames from the 'foo' animation file into the PNG format (works also with JPG, PCX, GIF, BMP ...)~~

	~~<pre>ffmpeg -i~~ foo~~.anm bar%03d.png</pre>~~		Play the 'foo' animation file:

	~~Encode the '~~foo~~' animation file into a MPEG-4 format :~~		ffplay foo.anm

	~~<pre>ffmpeg -i foo.anm bar.avi</pre>~~		Extract all frames from the 'foo' animation file into the PNG format (works also with PCX, and a number of other formats)

	~~Encode~~ the 'foo' animation file into a ~~WebM format :~~

	~~<pre>~~ffmpeg -i foo.anm ~~-threads 2~~ bar.~~webm</pre>~~		ffmpeg -i foo.anm bar%03d.png

	~~See 'ffmpeg -codecs' for all available codecs.~~

	It's not possible to encode into ANM format with FFmpeg.		It's not possible to encode into ANM format with FFmpeg.
Line 94:		Line 90:
	=== Textures (.png/.jpg/.tga/.dds) ===		=== Textures (.png/.jpg/.tga/.dds) ===
	EDuke32 supports true color textures. These can be made in any image editing program, including Adobe Photoshop, Corel Paint Shop Pro, and [http://www.gimp.org/ The GNU Image Manipulation Program (GIMP)]		EDuke32 supports true color textures. These can be made in any image editing program, including Adobe Photoshop, Corel Paint Shop Pro, and [http://www.gimp.org/ The GNU Image Manipulation Program (GIMP)]

			Keep in mind that JPEG and DDS are forms of [[Wikipedia:lossy compression\|lossy compression]]. Be sure to back up your image in two ways: one, in a PNG-exported final copy, and two, if applicable, in your image editor's source file (PSD/XCF/PSP).

	==== PNG Optimization ====		==== PNG Optimization ====
Line 123:		Line 121:
	=== Movies (.ivf) ===		=== Movies (.ivf) ===
	IVF files are an alternative to the ANM format utilizing a VP8 video stream, the same used in the WebM format but without the Vorbis audio stream.		IVF files are an alternative to the ANM format utilizing a VP8 video stream, the same used in the WebM format but without the Vorbis audio stream.

			To play it in-game, place the ivf file in a place EDuke32 will see and give it the same name as the .anm file that we want to replace (eg ''logo.ivf'' for the animation logo when the game starts).

	To encode video, including an uncompressed raw one, to IVF, use this command line syntax with [http://www.ffmpeg.org FFmpeg]:		To encode video, including an uncompressed raw one, to IVF, use this command line syntax with [http://www.ffmpeg.org FFmpeg]:

	~~<pre>~~ffmpeg -i <input> -an -vcodec libvpx -quality best <output>.ivf~~</pre>~~		ffmpeg -i <input> -an -vcodec libvpx -quality best <output>.ivf

			To extract VP8 video tracks from a WebM file into a IVF file, you can use:

	~~To extract VP8 video tracks from a WebM file into a IVF file, we can use the program ''mkvextract'', part of MKVToolnix, available [http://www~~.~~bunkus.org/videotools/mkvtoolnix here]~~.		ffmpeg -i <input>.webm -an -vcodec copy <output>.ivf

	~~Command line syntax to~~ use:		You can also use the program ''mkvextract'', part of MKVToolnix, available [http://www.bunkus.org/videotools/mkvtoolnix here].
	~~<pre>mkvextract tracks <filename>~~.~~webm 1:<filename>~~.~~ivf<~~/~~pre>~~

	~~To play it in-game now we just have to place it in a search path or in a custom mod directory and give it the same name as the~~ .~~anm file that we want to replace (eg ''logo~~.ivf~~'' for the animation logo when the game starts).~~		mkvextract tracks <filename>.webm 1:<filename>.ivf

	=== Audio (.ogg/.flac) ===		=== Audio (.ogg/.flac) ===