2007-05-03 15:44:52 +00:00
|
|
|
|
Compiling D1X-Rebirth Sourcecode on a *NIX System
|
|
|
|
|
|
|
|
|
|
This file describes how to compile D1X-Rebirth from Source.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Requirements
|
|
|
|
|
|
|
|
|
|
1.
|
|
|
|
|
C/C++ compiler (gcc/g++)
|
|
|
|
|
2.
|
|
|
|
|
SCons
|
|
|
|
|
3.
|
|
|
|
|
SDL(-devel)
|
|
|
|
|
4.
|
|
|
|
|
GLU/GL
|
|
|
|
|
5.
|
|
|
|
|
NASM (optional for Assembler-based Texture-mapper in non-OpenGL Build)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Compiling
|
|
|
|
|
|
|
|
|
|
The SConstruct file provides various options to compile this program.
|
|
|
|
|
To get a full list of all available commands, type scons -h within the Source directory.
|
|
|
|
|
|
|
|
|
|
Currently, the following variables are supported:
|
|
|
|
|
|
|
|
|
|
'sharepath=DIR' (*NIX only) use DIR for shared game data. (default: /usr/local/share/games/d1x-rebirth)
|
|
|
|
|
'sdl_only=1' don't include OpenGL, use SDL-only instead
|
|
|
|
|
'sdlmixer=1' (*NIX only) use SDL_Mixer for sound (includes external music support)
|
|
|
|
|
'shareware=1' build SHAREWARE version
|
2007-09-28 22:44:04 +00:00
|
|
|
|
'asm=1' use ASSEMBLER code (only with sdl_only=1, requires NASM and x86)
|
2007-05-03 15:44:52 +00:00
|
|
|
|
'debug=1' build DEBUG binary which includes asserts, debugging output, cheats and more output
|
|
|
|
|
'profiler=1' do profiler build
|
|
|
|
|
'editor=1' build editor !EXPERIMENTAL!
|
|
|
|
|
'arm=1' compile for ARM architecture
|
|
|
|
|
|
|
|
|
|
‘sdlmixer’ as well as ‘editor’ are currently *not* supported and may not work.
|
|
|
|
|
|
|
|
|
|
To compile the source, type:
|
|
|
|
|
|
|
|
|
|
scons
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
If you wish to add additional commands, just add them to the scons command.
|
|
|
|
|
Example:
|
|
|
|
|
|
2007-09-28 22:44:04 +00:00
|
|
|
|
scons sdl_only=1 asm=1
|
2007-05-03 15:44:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
To install the compiled binary to your system (/usr/local/bin/), type (as root):
|
|
|
|
|
|
|
|
|
|
scons install
|
|
|
|
|
|
|
|
|
|
You can also add the ‘install’ command while compile-time. SCons will compile and install the binary right after that.
|
|
|
|
|
|
|
|
|
|
To clean up the source directory after installation, type:
|
|
|
|
|
|
|
|
|
|
scons -c
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Needed files
|
|
|
|
|
|
|
|
|
|
Since D1X-Rebirth is a Sourceport of the Descent1-Engine you will need the Game-Content data files to run the game.
|
|
|
|
|
|
|
|
|
|
Following files are needed to run the game:
|
|
|
|
|
|
|
|
|
|
descent.hog
|
|
|
|
|
descent.pig
|
|
|
|
|
|
|
|
|
|
These files should be located on the Descent1 CD-Rom.
|
|
|
|
|
Note that those files must be patched to version 1.4a.
|
|
|
|
|
|
|
|
|
|
There is a patch suitable for *NIX systems (diff-files) available at:
|
|
|
|
|
http://www.dxx-rebirth.de/download/dxx/res/descent1_patch14a-linux.tar.gz
|
|
|
|
|
|
|
|
|
|
Patching can also be done from Windows/DOS using the DOS 1.4a-patch of Parallax, that will patch a common Descent1 installation.
|
|
|
|
|
DOS 1.4a patch: http://www.dxx-rebirth.de/download/dxx/res/descent1_patch14a.exe
|
|
|
|
|
|
|
|
|
|
Those files need to be copied to the Sharepath, which is (if not specified with the SCons ‘sharepath’-variable) /usr/local/share/games/d1x-rebirth/
|
|
|
|
|
|
|
|
|
|
To play the Multiplayer levelset “Total Chaos”, also copy the files
|
|
|
|
|
|
|
|
|
|
chaos.hog
|
|
|
|
|
chaos.msn
|
|
|
|
|
|
|
|
|
|
to the subdirectory ‘missions/’ in your Sharepath. These files should also be located on the Descent1 CD.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Optional files
|
|
|
|
|
|
|
|
|
|
D1X-Rebirth is expandable. You can add additional content to the game.
|
|
|
|
|
|
|
|
|
|
Supported content:
|
|
|
|
|
|
|
|
|
|
*
|
|
|
|
|
HiRes Briefing Images and Fonts
|
|
|
|
|
Available at:
|
|
|
|
|
http://www.dxx-rebirth.de/download/dxx/res/d1x-rebirth_hires-briefings_v2.zip
|
|
|
|
|
http://www.dxx-rebirth.de/download/dxx/res/d1x-rebirth_hires-fonts.zip
|
|
|
|
|
To add those, copy them to subdirectory ‘hires/’ of the Sharepath.
|
|
|
|
|
HiRes Briefings will be used automatically, HiRes Fonts can be activated with command-line switch ‘-hiresfont’.
|
|
|
|
|
|
|
|
|
|
*
|
|
|
|
|
Custom/AddOn missions
|
|
|
|
|
Those can be found on several websites. Add them to the game by copying them to subdirectoy ‘missions/’ of the Sharepath.
|
|
|
|
|
|
|
|
|
|
*
|
|
|
|
|
Language Packs
|
|
|
|
|
German translation: http://www.dxx-rebirth.de/download/dxx/res/D1XBDE01.zip
|
|
|
|
|
Copy the txb-files to the Sharepath. Will be activated automatically
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Launching the program
|
|
|
|
|
|
|
|
|
|
After compiling and installing, the program can be launched with the command
|
|
|
|
|
|
|
|
|
|
d1x-rebirth-gl
|
|
|
|
|
|
|
|
|
|
or - if it has been compiled with SCons parameter ‘sdl_only=1’ -
|
|
|
|
|
|
|
|
|
|
d1x-rebirth-sdl
|
|
|
|
|
|
|
|
|
|
To see a full list of available command-line options append ‘-h’, ‘-?’ to the command or refer file
|
|
|
|
|
|
|
|
|
|
d1x.ini
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The game will create a config-directory in the Home directory of the user called ‘.d1x-rebirth’.
|
|
|
|
|
It is used to read/save
|
|
|
|
|
|
|
|
|
|
*
|
|
|
|
|
Configuration files
|
|
|
|
|
*
|
|
|
|
|
Pilot profiles and Savegames
|
|
|
|
|
*
|
|
|
|
|
Demos
|
|
|
|
|
*
|
|
|
|
|
Screenshots
|
|
|
|
|
*
|
|
|
|
|
d1x.ini for parsing command-line arguments
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Appendix
|
|
|
|
|
|
|
|
|
|
http://DXX-Rebirth.de
|