134 lines
4.2 KiB
Plaintext
134 lines
4.2 KiB
Plaintext
-----
|
|
Developing GSport
|
|
-----
|
|
David Schmidt (david__schmidt at users dot souceforge dot net)
|
|
-----
|
|
|
|
Developing GSport
|
|
|
|
Information, mosly concerning building, about various platforms:
|
|
|
|
* General build instructions
|
|
|
|
You need to build with a <<<make>>> utility.
|
|
There's a default Makefile, which should work for nearly any environment.
|
|
The Makefile includes a file called <<<vars>>> which defines the platform-
|
|
dependent variables. You need to make <<<vars>>> point to (or be) the appropriate
|
|
file for your machine.
|
|
|
|
* Win32
|
|
|
|
There is a different port of KEGS by Chea Chee Keong (akilgard) called
|
|
KEGS32. It was originally available from {{{http://web.archive.org/web/20071107082448/http://www.geocities.com/akilgard/kegs32/}http://www.geocities.com/akilgard/kegs32}},
|
|
but geocities has since closed.
|
|
The Win32 code in GSport is leveraged from KEGS32.
|
|
|
|
GSport can be compiled with {{{http://www.mingw.org/}Mingw}}
|
|
and {{{http://www.cygwin.com/}Cygwin}} as well as via standard Microsoft compiler suites.
|
|
|
|
In order to compile:
|
|
|
|
------------------
|
|
cd into the src/ directory
|
|
rm vars
|
|
ln -s vars_win32 vars
|
|
./make_win
|
|
------------------
|
|
|
|
You need to have a ROM file (named
|
|
ROM, ROM.01, or ROM.03) in the same directory.
|
|
|
|
To quit, either click the close box, or force quit the application.
|
|
You can also middle-click (if you have a 3-button mouse) or
|
|
Shift-F6 to get the debugger in the terminal window, and then type "q".
|
|
|
|
* Mac OS X
|
|
|
|
Use the <<<vars_mac>>> file:
|
|
|
|
-------------------------------------
|
|
rm vars; ln -s vars_mac vars
|
|
make
|
|
-------------------------------------
|
|
|
|
After the <<<make>>> has finished, it will create the application <<<GSportMac>>>.
|
|
|
|
* X86 Linux
|
|
|
|
Use the <<<vars_x86linux>>> file:
|
|
|
|
-------------------------------------
|
|
rm vars; ln -s vars_x86linux vars
|
|
make
|
|
-------------------------------------
|
|
|
|
The resulting executable is called <<<gsportx>>>.
|
|
|
|
The build scripts assume perl is in your path. If it is somewhere else,
|
|
you need to edit the "PERL = perl" line in the vars file and make it point
|
|
to the correct place.
|
|
|
|
For audio, GSport needs access to <<</dev/dsp>>>. If the permissions do not allow
|
|
GSport to access <<</dev/dsp>>>, it can fail with a cryptic error message. As root,
|
|
just do: <<<chmod 666 /dev/dsp>>> .
|
|
|
|
If you do not have the <<</dev/dsp>>> device, GSport will not start unless you
|
|
tell it to disable audio with the following command-line argument:
|
|
<<<./gsportx -audio 0>>>
|
|
|
|
* PowerPC Linux
|
|
|
|
Use the <<<vars_linuxppc>>> file:
|
|
|
|
-------------
|
|
rm vars; ln -s vars_linuxppc vars
|
|
make
|
|
---------
|
|
|
|
The build scripts assume perl is in your path. If it is somewhere else,
|
|
you need to edit the "PERL = perl" line in the vars file and make it point
|
|
to the correct place.
|
|
|
|
Audio is currently disabled by default, but you can try turning it on
|
|
by runnning the command: <<<gsportx -audio 1>>>. It sounds horrible, but sounds do
|
|
come out.
|
|
|
|
* Solaris SPARC
|
|
|
|
Use the <<<vars_solaris>>> file:
|
|
|
|
-------------------------------------
|
|
rm vars; ln -s vars_solaris vars
|
|
make
|
|
-------------------------------------
|
|
|
|
The build scripts assume perl is in your path. If it is somewhere else,
|
|
you need to edit the "PERL = perl" line in the vars file and make it point
|
|
to the correct place.
|
|
|
|
Audio is currently disabled by default, but you can try turning it on
|
|
by runnning the command: <<<gsportx -audio 1>>>
|
|
|
|
* Solaris x86
|
|
|
|
Use the <<<vars_x86solaris>>> file:
|
|
|
|
-------------------------------------
|
|
rm vars; ln -s vars_x86solaris vars
|
|
make
|
|
-------------------------------------
|
|
|
|
The build scripts assume perl is in your path. If it is somewhere else,
|
|
you need to edit the "PERL = perl" line in the vars file and make it point
|
|
to the correct place.
|
|
|
|
Audio is currently disabled by default, but you can try turning it on
|
|
by runnning the command: <<<gsportx -audio 1>>>
|
|
|
|
* Other platforms - "C"
|
|
|
|
If you are porting to an X-windows and Unix-based machine, it should be
|
|
easy. Start with <<<vars_x86linux>>> if you are a little-endian machine, or
|
|
<<<vars_linuxppc>>> if you are big endian. Don't define <<<-DKEGS_LITTLE_ENDIAN>>>
|
|
unless your processor is little-endian (x86, Alpha). Mac, Sun, MIPS,
|
|
HP, Motorola, and IBM are big-endian. |