223 lines
6.7 KiB
Plaintext
223 lines
6.7 KiB
Plaintext
===========
|
|
D2X
|
|
===========
|
|
|
|
http://icculus.org/d2x
|
|
|
|
|
|
Linux/Unix:
|
|
===========
|
|
|
|
Required tools:
|
|
* GCC 2.95
|
|
* SDL 1.1.0 or higher
|
|
* NASM 0.98 (OPTIONAL but RECOMMENDED for x86)
|
|
* A thread safe X server.
|
|
* Make, sed, etc...
|
|
|
|
Build instructions:
|
|
Install all of the components above. Next, from the d2x directory:
|
|
|
|
./configure
|
|
./configure --help will show you the available options.
|
|
If you have a 3d graphics card, use --with-opengl
|
|
|
|
VPATH builds also work (i.e., you can put the source in one directory
|
|
and build in another. Just execute the configure script from the
|
|
build directory like so:
|
|
mkdir d2x-build
|
|
cd d2x-build
|
|
../d2x-source/configure
|
|
|
|
make
|
|
make install
|
|
|
|
see installation.txt for info on where to put your datafiles, etc.
|
|
|
|
Known bugs/issues:
|
|
|
|
* Serial support doesn't work. (UDP and IPX networking does (btb: it
|
|
does? UDP?!))
|
|
|
|
|
|
* Sound glitches (due to stuff I haven't implemented)
|
|
* The mouse support is at the same level as it was in d1x (as in, it
|
|
kind of works) (btb: works pretty good for me.)
|
|
|
|
|
|
Win32:
|
|
======
|
|
|
|
Required tools:
|
|
* Cygwin
|
|
d2x doesn't use Cygwin, but it makes building it easier (to me).
|
|
You can probably build it with just MinGW, but I haven't tried yet.
|
|
* SDL 1.1.0 or higher
|
|
* NASM 0.98 (OPTIONAL but RECOMMENDED)
|
|
|
|
You will probably have to compile SDL from source.
|
|
Download the source code tarball from http://www.libsdl.org/
|
|
|
|
tar zxf SDL-x.x.x.tar.gz
|
|
cd SDL-x.x.x
|
|
./configure
|
|
make
|
|
make install
|
|
|
|
Note that SDL.dll needs to be in your executable PATH, since that is
|
|
where windows looks for dlls.
|
|
I recommend copying or moving it to /usr/local/bin:
|
|
cp /usr/local/lib/SDL.dll /usr/local/bin
|
|
|
|
If you need to run autogen.sh (e.g. to rebuild the configure scripts,
|
|
or to build from cvs) sdl.m4 will have to be somewhere where aclocal
|
|
can find it.
|
|
You can fix this by setting the ACLOCAL_FLAGS variable like this:
|
|
export ACLOCAL_FLAGS=/usr/local/share/aclocal
|
|
|
|
You should also install NASM, for compiling assembler files. Download
|
|
it from http://www.web-sites.co.uk/nasm/where.html and place nasmw.exe
|
|
somewhere in your path (e.g. /usr/local/bin):
|
|
unzip nasm-0.98-win32.zip
|
|
mv nasmw.exe /usr/local/bin
|
|
|
|
Now you can configure d2x as normal. i.e.
|
|
./configure
|
|
or
|
|
./configure --with-opengl
|
|
|
|
automake/autoconf in cygwin has a problem with not always putting the
|
|
.exe extentions where they need to be. So you may have to run make
|
|
twice, like so:
|
|
make && make d2x-sdl.exe
|
|
or
|
|
make && make d2x-gl.exe
|
|
|
|
Then just copy your executable and SDL.dll into the descent2 directory.
|
|
|
|
|
|
MS-DOS:
|
|
=======
|
|
|
|
Dos support isn't a high priority right now, so things may be a little
|
|
messed up.
|
|
|
|
Required tools:
|
|
* DJGPP v2
|
|
The following DJGPP packages are ALL REQUIRED (newer versions are ok)!
|
|
v2/
|
|
djdev203.zip
|
|
v2gnu/
|
|
bnu281b.zip gcc2952b.zip mak3781b.zip bsh1147b.zip sed302b.zip
|
|
m4-14b.zip acnf213b.zip gwk304b.zip txt20b.zip grep22b.zip dif272b.zip
|
|
So many packages are needed to support the autoconf build system that d2x
|
|
uses. (Sorry! =)
|
|
* NASM v0.98 or better is REQUIRED
|
|
|
|
|
|
Build instructions:
|
|
Install all of the djgpp packages above. Make sure that DJGPP is properly
|
|
configure (see the DJGPP docs for more information).
|
|
Make a copy of bash.exe in your djgpp bin/ directory. Call it "sh.exe". This
|
|
step is VERY IMPORTANT (otherwise all the scripts will fail).
|
|
|
|
Now, run the following from the d2x directory:
|
|
djgpp.bat
|
|
make
|
|
|
|
Hopefully things will work out and the package will build correctly for you.
|
|
|
|
Known bugs/issues:
|
|
* Serial and network support missing.
|
|
* Sound support missing.
|
|
|
|
|
|
|
|
Reporting bugs/feedback:
|
|
========================
|
|
|
|
There are two ways to report bugs and give feedback:
|
|
1) Get on the descent-source mailing list by sending an email to
|
|
majordomo@warpcore.org with the body as: "subscribe descent-source
|
|
<your email address>". Discussions about the source code in general
|
|
are available here, and is the main list that d2x and d1x, a similar
|
|
project for descent 1 is discussed on. Patches and questions can be
|
|
posted there, as well.
|
|
|
|
2) Send feedback directly to me, bradleyb@u.washington.edu. I'll try
|
|
to get back to you ASAP, depending on real-life concerns =)
|
|
|
|
/* THE OLD README FOLLOWS */
|
|
Legal Stuff:
|
|
|
|
THE COMPUTER CODE CONTAINED HEREIN IS THE SOLE PROPERTY OF PARALLAX
|
|
SOFTWARE CORPORATION ("PARALLAX"). PARALLAX, IN DISTRIBUTING THE CODE TO
|
|
END-USERS, AND SUBJECT TO ALL OF THE TERMS AND CONDITIONS HEREIN, GRANTS A
|
|
ROYALTY-FREE, PERPETUAL LICENSE TO SUCH END-USERS FOR USE BY SUCH END-USERS
|
|
IN USING, DISPLAYING, AND CREATING DERIVATIVE WORKS THEREOF, SO LONG AS
|
|
SUCH USE, DISPLAY OR CREATION IS FOR NON-COMMERCIAL, ROYALTY OR REVENUE
|
|
FREE PURPOSES. IN NO EVENT SHALL THE END-USER USE THE COMPUTER CODE
|
|
CONTAINED HEREIN FOR REVENUE-BEARING PURPOSES. THE END-USER UNDERSTANDS
|
|
AND AGREES TO THE TERMS HEREIN AND ACCEPTS THE SAME BY USE OF THIS FILE.
|
|
COPYRIGHT 1993-1999 PARALLAX SOFTWARE CORPORATION. ALL RIGHTS RESERVED.
|
|
|
|
We make no warranties as to the usability or correctness of this code.
|
|
|
|
============================================
|
|
Message from Matt Toschlog & Mike Kulas:
|
|
|
|
Descent fans:
|
|
|
|
Here, finally, is the source for Descent II. We've been so busy with
|
|
Descent 3, Mercenary, FreeSpace, FreeSpace 2, and several other
|
|
projects that we haven't given much thought to this old code. But we
|
|
know that many of you are eager to get it, so here you go.
|
|
|
|
We were amazed and impressed at the cool things people did with
|
|
the Descent source we released a few years ago. It touches us
|
|
deeply how devoted some people are to the Descent series, and we
|
|
look forward to seeing what people can do with this Descent II
|
|
source.
|
|
|
|
Matt Toschlog Mike Kulas
|
|
Outrage Entertainment Volition, Inc.
|
|
|
|
============================================
|
|
|
|
About the Source Code:
|
|
|
|
Included is almost all the source code to Descent 2, ver. 1.2. We removed
|
|
all code to which we did not own the copyright. This mainly involved low-
|
|
level sound and modem code and the movie code.
|
|
|
|
The Descent Network has agreed to provide a list of mirror locations where
|
|
this code can be downloaded. The location is:
|
|
|
|
http://www.descent2.com/ddn/sources/descent2
|
|
|
|
The following tools were used in the development of Descent:
|
|
Watcom C/C++, version 9.5
|
|
Microsoft Macro Assembler, version 6.1x
|
|
Opus Make, version 6.01
|
|
|
|
Have fun with the code!
|
|
Parallax Software Corporation
|
|
12/14/1999
|
|
|
|
|
|
As Packaged the code currently will not compile. Some code had to be removed
|
|
to release it, therefore you will get some missing file errors when building.
|
|
|
|
Much of this code is very close to the Descent 1 source code. Many people have
|
|
put effort into porting that code, so if you are interested in porting D2, you
|
|
should be able to take advantage of some of that work.
|
|
|
|
A few good web sites to check out are:
|
|
|
|
The D1X Project:
|
|
http://d1x.warpcore.org
|
|
|
|
The Descent Network:
|
|
http://www.descent-network.com
|
|
|