----- ArghRad 3.00T9 by Tim Wright (Argh!) -----

----- TESTING VERSION, DO NOT REDISTRIBUTE -----

Modified from original source code by id Software

This is a project to recover compilable C++ source code for the arghrad Quake 2 lighting utility (arghrad300t9.exe).

The decompiled source code has been merged with the original Quake 2 tools source so it should be fairly readable.

The main tools used were Ghidra, Ida and windbg. The process of creating the initial release took about 4 weeks using my spare time.

1.02 New Features

• Fixed transparent textures not casting shadows.
• Fixed artifacts in shadows cast from transparent textures.
• Most settings can now be set in worldspawn as an alternative to being passed on the command line. Worldspawn key names are the same as the command line options, except they start with an underscore instead of a dash (e.g., -gamma becomes _gamma). For arguments with no value (e.g., -nocurve), the worldspawn value should be "1" to make it active, or "0" can be used to ignore that setting. Worldspawn settings can be disabled with the -noworldspawnsettings command line argument.

Current status / TODO:

• Lighting is working, including bounce and phong.
• Supports JPG, TGA, PCX and WAL. Not supported yet: M32 and M8 formats.
• The -update flag is not implemented yet.
• Performance test.
• Test sunlight, all command args and entity options.

Possible bugs to look for:

• Almost every line was ported by hand using the decompiler output as a reference point, so there is a good chance of finding a mistake anywhere.
• The ghidra decompiler likes to omit small patches of code, especially FPU code, so it is likely that some code is missing and needs to be found.
• Most conditional expressions using the FPU were decompiled by hand so I probably got some wrong.
• Larger functions are more likely to have bugs because they usually had lower quality decompilation results.

Building on linux:

Depends on g++, gcc, and make.

Build the jpeg support library (only need to do this once):

cd src/libjpeg
make

Build arghrad from the src directory:

make

Clean build from src (this does not rebuild libjpeg):

make clean
make