Tools

DM3split

DM3split is a tiny program to split DM3 files at level changes. It is not perfect but should be able to split most DM3 files. It can't work with the newer DM_66 and DM_67 file types, as they use Huffman compressed data.

This tool is really important for all the people who are organizing Quake III Arena tournaments, record all action but want to distribute only parts of it.

The program does not reveal any secret information on the internal structure of DM3 files (which I don't have anyway). Only the block structure of the file is known and used. I got permission from Todd Hollenshead himself, that I can distribute this tool as long as I don't sell it.

This program is only a toy. It serves mostly as a test platform for all future OpenDemo Perl and Java tools. So please send me now bug reports, as long as I can correct my build system without much effort.

Many thanks to Nick Ooka, who send me a non-working DM3 file and pointed me in the really important direction of different Perl implementations. Perl for Windows behaves a bit different (binary files must be marked with binmode() because of the stupid 0x0d 0x0a line endings) but DM3split can now cope with it. I checked the Perl script under Linux and with the Perl for Windows inside Wine (Windows emulator for Linux).

Get it from the download page.

DM3split started as Perl script, but even now exist some poor souls, who don't have it installed. So I reimplemented the basic idea in Java as the class com.machinima.opendemo.DM3split. I packed the DM3split.class file into a Java Archive (JAR) dm3split.jar. So you have many possibilities to run the Java application (not a Java applet):

• Modern Java implementations (1.2 and later) can start the JAR file directly:
  java -jar dm3split.jar dm3in dm3out
• You can place the JAR file into the CLASSPATH and start the class explicitly:
  java com.machinima.opendemo.DM3split dm3in dm3out
• You can unpack the JAR file (with the tool jar or any packer, which supports ZIP files), add the base directory (where the directory com is in) to your CLASSPATH and call the class directly:
  java com.machinima.opendemo.DM3split dm3in dm3out
• You can unpack the JAR file and put only the class file into your CLASSPATH. Then you have to call it with: java DM3split dm3in dm3out
• You can unpack the JAR file, go into the directory with the class file and and call:
  java DM3split dm3in dm3out
  This works, because the current directory will always be searched for class files.

Some words on the usage. DM3split must be called with exactly 2 command line parameters. The first is the DM3 input file and the second is the DM3 output file template. The levels will be numbered beginning with 1 and the template gives the resulting file name.

• In the Perl script, the template is a printf format string with a integer placeholder in it like foo%d.dm3 or bar%02i-death.dm3.
• In the Java class, the template must be a java.text.DecimalFormat pattern like foo0'.'dm3 or bar00-death'.'dm3. You have to quote the dot (.) because it is the placeholder for the decimal separator, which happens to be in Germany the comma (,). If you type it in at a UNIX prompt, you even have to requote the apostrophe itself, because it is a special shell character. So it must be bar00-death\'.\'dm3. I know, there exist a printf class for Java but it is just not necessary to add a 15kb class, if the actual program is less than 3kb.