cingb Code
Status: Alpha
Brought to you by:
cinek
Menu
▾
▴
Tree [07c375] master / History
Read Me
++++++++++++++++++++++++++++++++++++++++
****************************************
*** cingb - by Cinek ***
****************************************
++++++++++++++++++++++++++++++++++++++++
----------------------------------------
Revision 0.30ALPHA 2009/06/09 cinek
----------------------------------------
----------------------------------------
Supported systems
----------------------------------------
This release has been tested on:
- FreeBSD 7.x, 8.x
----------------------------------------
Makefile & compilation (Unix/Solaris)
----------------------------------------
This is quite an early release of cingb.
You may need to change the 'Makefile'
(after the execution of ./configure)
to compile the sources successfully.
So first start the configuration script with:
# ./configure
optionally you could configure your joypad
# ./cingb_conf
then run:
# make
If you want to install the binary for
regular use type:
# make install
After that (if "make" doesn't work):
(1) When did you start 'updatedb' last
time ?
Try to start 'updatedb' first,
if it's your PC (if you can access
root-rights).
Then try to reconfigure again
(type: './configure' etc... see above)
(2) Eventually, you need to adjust the
variable-definitions:
how to figure it out:
INCPATH locate stdlib.h
locate Xlib.h (without /X11)
LIBPATH locate libX11.a
Now, it should be possible to compile
the sources.
If you get errors, while running the
compiled cingb, try to comment out the
OPTMZ variable.
And don't forget to read README.FAQ.
........................................
Optional "make" syntax:
make, make standard standard version
supports:
- X
- framebuffer device
make glide glide version
(requires root access)
make debug like standard, but
implements debugger
Do not execute the 'debug' version in
framebuffer mode, it's not possible.
You will need the terminal screen, so it's only
possible in X.
----------------------------------------
Makefile & compilation (MS-DOS)
----------------------------------------
Requires:
Cygwin package from http://www.cygwin.com/
Just type 'make -f Makefile.dos'.
CINGB.EXE should be created.
----------------------------------------
Joypad configuration
----------------------------------------
cingb supports the sidewinder-joypad
and standard keyboards
current configuration:
gameboy keyboard sidewinder
up crsr up up
down crsr down down
left crsr left left
right crsr right right
A c B
B x A
SELECT d M
START s start
NOTE: You should select the keys like on
a real gameboy, so that's why
gameboy A = sidewinder B and
gameboy B = sidewinder A !!!
To configure other joypads, type:
# ./cingb_conf
----------------------------------------
Sound
----------------------------------------
WARNING:
(1) It still sounds crap (ALPHA-release) !
The gameboy sound chip has some more
features which aren't implemented, yet.
(2) On Sun Solaris the sound generation
is very slow. Better switch it off
with -n.
----------------------------------------
Syntax
----------------------------------------
There are 3 types of executables so far:
- cingb
- cingb_deb
- cingb_glide
cingb can be started in X or on the
framebuffer console.
cingb_deb can only be started in X.
The syntax of both versions is:
# ./cingb [-d][-n][-f value] romfilename
# ./cingb_deb [-d] romfilename
-d switches on the double-size mode
-n disables sound support
-f selects sound frequency
cingb_glide doesn't support "-d", it
will be ignored.
# ./cingb_glide [-n][-f] romfilename
This version eventually needs root
access rights.
Other options which are available to
all versions:
-o Force standard gameboy (B/W)
emulation
-a code add action-replay code
code is 8-digit hex-value
(further information below)
After starting the X-version can be
stopped by pressing 'Q'.
The framebuffer and Glide versions
can be stopped by pressing
CTRL+C, ESC, 'Q'.
Don't "kill -9" the emulator, or
else your last status won't be saved.
----------------------------------------
Action Replay Interface
----------------------------------------
I hope it works properly.
You can pass AR-codes by specifying:
"-a CODE -a CODE -a CODE ..." (up to
eight times)
At start, the codes are NOT toggled on.
To enable/disable them press RETURN
while playing.
The codes look like this:
VVVVVVVV
- eight characters
- every 'V' is a hex digit (0..9,A..F)
----------------------------------------
Compatibility
----------------------------------------
These are games that don't work properly:
Double Dragon 3
- joypad doesn't work (why?)
Alladin, Warioland 2 GB/GBC (playable)
- problems with window alignment
........................................
Known problems:
There is a small bug in the
graphical unit causing bugs
when displaying "gameboy windows".
You can have joypad emulation
problems while executing some games.
The sources won't compile, if you
don't have enough virtual memory.
----------------------------------------
Savegames (battery status)
----------------------------------------
The savegames will be stored in the same
directory as the roms.
They have the extension '.GBS', but
should be compatible to the '.SAV'-files
which are created by other emulators, so
just copy or rename them.
(I think, these are raw SRAM-images
without the last zeros.)
----------------------------------------
Have lots of fun.
Cinek
