184 lines
8.2 KiB
Plaintext
184 lines
8.2 KiB
Plaintext
Compiling the Source Code:
|
|
--------------------------
|
|
|
|
Well, for the moment, zsnes source may be a little hard to compile. Here
|
|
is a quick guide (based on my own experience and on a doc written by zsKnight)
|
|
explaining how to compile zsnes. With these tools, I can build both dos and
|
|
win version, I hope it will also work for you
|
|
|
|
Note to see the bottom of this document if you are compiling releases for
|
|
distribution as opposed to CVS/SVN/WIP for personal use.
|
|
|
|
First, you need the following software:
|
|
|
|
DOS port:
|
|
- NASM v0.98.39 or higher : http://nasm.sourceforge.net
|
|
- DJGPP v2.03 or higher, (GCC also installed) : http://www.delorie.com/djgpp/
|
|
using the zip picker, the default choices are ok if you
|
|
check C and C++ in the programming languages.
|
|
- zlib v1.2.3 or higher : http://www.zlib.net
|
|
- libpng : http://www.libpng.org/
|
|
Build the static versions of both of these libraries using
|
|
DJGPP and do a 'make install' to put them where DJGPP
|
|
can find them. Afterwards you can go ahead and delete
|
|
the source for them from your hard drive.
|
|
- PDCurses : http://pdcurses.sourceforge.net
|
|
Only needed if you compile with the debugger.
|
|
|
|
Then to build the executable, go to the src directory and type:
|
|
make -f makefile.ms PLATFORM=dos
|
|
|
|
You may also want to compress zsnes.exe with upx (http://upx.sourceforge.net),
|
|
it will divide its size by 10.
|
|
|
|
|
|
DOS port cross compiling:
|
|
-You need to get the DJGPP cross compiler and everything else mentioned above.
|
|
-You might need to edit makefile.ms and change
|
|
i386-pc-msdosdjgpp-gcc and i386-pc-msdosdjgpp-g++ to something else.
|
|
|
|
Then to build the executable, go to the src directory and type:
|
|
make -f makefile.ms PLATFORM=dos-cross
|
|
|
|
If you have any problems we will probably not help you as cross compiling
|
|
is an advanced feature only for people who know what they are doing.
|
|
|
|
|
|
|
|
Windows port with MSVC:
|
|
- GNU Make : http://unxutils.sourceforge.net/
|
|
- NASM v0.98.39 : http://nasm.sf.net/
|
|
- MSVC++ 6.0 or higher : not freely available, you'll have to buy it
|
|
You need to run VCVARS32.BAT. If you get an
|
|
out of environment space error, type 'command /e:32768'
|
|
(to create a new command.com entity with more
|
|
environment space)
|
|
I have been able to successfully build ZSNES using the
|
|
Intel C++ drop-in replacement for Microsoft's C++ compiler
|
|
that comes with MSVC++ 5 and above. Since ZSNES contains
|
|
relatively small amounts of C, I don't see how Intel's
|
|
compiler could provide any useful optimizations (maybe
|
|
for winlink.cpp?).
|
|
- DX8.0 SDK or higher : you can get it at microsoft.com. It is quite big.
|
|
Also, edit makefile.ms to set the correct path to your
|
|
SDK. I also had some problems with vc++ using its own
|
|
(old) directx headers instead of the sdk headers. I replaced
|
|
these old headers (in the include directory of vc++ dir)
|
|
with the newer ones.
|
|
- zlib v1.2.3 or higher : http://www.zlib.net
|
|
you need the Win9x/WinNT static library (the dll version
|
|
doesn't seem to work with zsnes). Rename the static version
|
|
to zlib.lib and put it somewhere where vc++ will find it
|
|
(for example, the lib directory in vc++ dir).
|
|
- libpng : http://www.libpng.org/
|
|
I'm not sure if the dynamically linked version of libpng
|
|
will work with ZSNES. To be safe I would recommend to just
|
|
go ahead and build the static version. Rename it to libpng.lib
|
|
and put it somewhere where MSVC++ will find it (usually the
|
|
lib subdirectory of your main MSVC++ directory).
|
|
- PDCurses : http://pdcurses.sourceforge.net
|
|
|
|
Then to build the executable, go to the src directory and type:
|
|
make -f makefile.ms PLATFORM=msvc
|
|
|
|
You may also want to compress zsnesw.exe with upx (http://upx.sourceforge.net),
|
|
it will divide its size by 10.
|
|
|
|
|
|
|
|
Windows port with MinGW:
|
|
- GNU Make (don't use included in mingw): http://unxutils.sourceforge.net/
|
|
- NASM v0.98.39 : http://nasm.sf.net/
|
|
- MinGW : http://www.mingw.org
|
|
- Latest Win32API : http://www.mingw.org
|
|
- DirectX 8+ for MinGW : Parts of it are included with Win32API, parts aren't.
|
|
Check http://www.talula.demon.co.uk/allegro/wip.html
|
|
and http://www.talula.demon.co.uk/allegro/wip.html
|
|
for the rest of DirectX for MinGW.
|
|
- zlib v1.2.3 or higher : http://www.zlib.net
|
|
- libpng : http://www.libpng.org/
|
|
- PDCurses : http://pdcurses.sourceforge.net
|
|
Only needed if you compile with the debugger.
|
|
|
|
Then to build the executable, go to the src directory and type:
|
|
make -f makefile.ms PLATFORM=win32
|
|
|
|
You may also want to compress zsnesw.exe with upx (http://upx.sourceforge.net),
|
|
it will divide its size by 10.
|
|
|
|
|
|
Windows port cross compiling:
|
|
-You need to get the MinGW cross compiler and everything else mentioned above.
|
|
-You might need to edit makefile.ms and change
|
|
i586-mingw32-gcc, i586-mingw32-g++, and i586-mingw32-windres
|
|
to something else.
|
|
|
|
Then to build the executable, go to the src directory and type:
|
|
make -f makefile.ms PLATFORM=win32-cross
|
|
|
|
If you have any problems we will probably not help you as cross compiling
|
|
is an advanced feature only for people who know what they are doing.
|
|
|
|
|
|
|
|
Linux/SDL/POSIX port:
|
|
I assume the standard development tools are installed (gcc, make, ...)
|
|
You'll also need :
|
|
- SDL (Simple DirectMedia Layer) : check www.libsdl.org to grab SDL 1.2.0 or
|
|
later. If you are using rpm packages, don't
|
|
forget the -devel package.
|
|
- NASM v0.98.39 : http://nasm.sf.net/
|
|
- zlib v1.2.3 or higher : http://www.zlib.net
|
|
it is probably already installed on your
|
|
system, maybe you are just missing the
|
|
development headers. Check in the
|
|
packages available with your distribution
|
|
or go to the page above
|
|
- libpng : http://www.libpng.org/
|
|
You might also need libpng, ZSNES will compile without
|
|
PNG support but I have found doing so to make ZSNES
|
|
unstable for some weird reason. If you don't have
|
|
libpng, either get it and install it or pass the
|
|
--without-png option to the 'configure' script.
|
|
- Curses/NCurses
|
|
Check your distro. One of these is needed if you compile with
|
|
the debugger enabled. You may also have to symlink ncurses.h
|
|
to curses.h in your include directory.
|
|
|
|
Then to build the executable, go to the src directory and type:
|
|
sh ./autogen.sh && gmake && gmake install
|
|
|
|
Note: This only covers SVN/WIP builds, for releases see instructions below.
|
|
|
|
Note: autogen.sh requires automake and autoconf installed. Any parse errors
|
|
you recieve about configure.in are due to those not being installed.
|
|
|
|
Note: you require root to install zsnes to the the default (/usr/local/*)
|
|
directory
|
|
|
|
Also Note: libpng (optional) needs to be recent, or zsnes will not use it
|
|
|
|
You may also want to compress the zsnes executable with upx
|
|
(http://upx.sourceforge.net), it will divide its size by 10.
|
|
|
|
|
|
Compiling for official builds:
|
|
Windows - MSVC: make -f makefile.ms PLATFORM=msvc RELEASE=yes
|
|
Windows - MinGW: make -f makefile.ms PLATFORM=win32 RELEASE=yes
|
|
DOS: make -f makefile.ms PLATFORM=dos RELEASE=yes
|
|
SDL - Package Maintainers: ./configure --enable-release --disable-cpucheck force_arch=i586
|
|
SDL - Personal: ./configure --enable-release
|
|
|
|
Note this is important to remove certain debug messages, as well
|
|
as provide heavy optimization (which could take up to an hour
|
|
to compile). It also ensures the builds will work with CPUs
|
|
matching i586 or higher.
|
|
If compiling for personal use, on DOS and Windows-MinGW, add
|
|
CPU=your_cpu, where your_cpu matches a GCC -march option.
|
|
You can use the archopt utility in tools/ to tell you what is
|
|
best. For SDL, remove --disable-cpucheck force_arch=i586.
|
|
|
|
If you are providing an SDL package for a particular arch
|
|
greater than i586, replace force_arch=i586 with the proper
|
|
one.
|