The Makefile System

To use this GNU make based makefile system, Windows users may need Mingw and the following Mingw packages (some of our utilities use libpng which requires zlib.) See our instructions for how to get Mingw, install packages, and launch a Mingw-ready DOS prompt.

• Mingw libpng binaries package
• Mingw libpng development package
• Mingw zlib package

Linux users may need to get libpng 1.2.0:

• Go to www.libpng.org and click on Portable Network Graphics
• Click on Programming Resources then libpng home page
• In the version 1.2.0 table, download a .tar.gz from the source section
• Extract the archive
• Open a console and go to the libpng-1.2.0 directory
• Run the following commands:

  cp scripts/makefile.linux makefile
  make
  su -c "make install"
  su -c "cp /usr/local/lib/libpng.* /usr/lib"
  

  (The last two commands will require your super user password)

You should have a directory containing the following modules:

• Open Quartz utilities source (extract to "utils/qutils")
• Open Quartz game source (extract to "pak0")
• Hack and Slash game source (extract to "hands")
• and directories for other games using the makefile system

The latest source in development for each module can be checked out with CVS

• Check out the module with CVS
  • The modules are "utils", "pak0" and "hands"
  • The CVSROOT for "utils" and "pak0" is cvs.openquartz.sf.net:/cvsroot/openquartz
  • The CVSROOT for "hands" is cvs.hack-and-slash.sf.net:/cvsroot/hack-and-slash
• Update the module from CVS
• Copy the module to a Linux computer

Compile the Open Quartz game data compiling utilities (qutils):

• Open a console, terminal, command prompt or MS-DOS prompt
• Go into the utils/qutils folder using the "cd" command
• Run "make" (without quotes) to compile the utilities

Compile the PAK files for each specific game:

• Open a console, terminal, command prompt or MS-DOS prompt
• Go into that game's folder using the "cd" command
• Run "make" (without quotes) to make the pak files
• Copy the newly created pak files wherever you want to use them
• Run "make clean" (without quotes) to remove generated files

Create a Makefile for Hack and Slash:

• Quake-C compiling (progs.dat, qwprogs.dat)
• Sprites (.spr files)
• Hack and Slash Models
• Hack and Slash Maps
• Hack and Slash Pak files
• Data inherited from Open Quartz

Try the makefile system with Cygwin:

• utils/qutils
  • In the makefile, remove "-lm" from rules for linking qbsp and light (I have no idea what effect this has!)
  • Apps compiled with Cygwin may not run without Cygwin DLLs
    • You need cygwin1.dll to run any of the utilities
    • modelgen, qlumpy and sprgen also need cygpng2.dll and cygz.dll
    • If you run the utilities from Cygwin these DLLs are automatically in your path
  • To compile without needing cygwin1.dll
    • Change "CC=gcc" to "CC=gcc -mno-cygwin" in the makefile
    • modelgen, qlumpy and sprgen won't compile: "png.h: No such file or directory"
    • Need non-cygwin png headers and libs?
• pak0 - pak files won't compile, gamedir suspiciously lacks a final "/"

  ../utils/temp/bin/qfiles -pak 1
  qdir: /cygdrive/c/home/code_team/cvs/temp/
  gamedir: /cygdrive/c/home/code_team/cvs/temp
  132 sounds
   67 models
   64 files
  ************ ERROR ************
  Error opening /cygdrive/c/home/code_team/cvs/tempsound/ambience/brikhit2.wav: No such file or directory
  

• hands - no problems so far (pak file not yet implemented)