File: README

package info (click to toggle)
gngb 20060309-5
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, sid
  • size: 1,448 kB
  • sloc: ansic: 11,046; sh: 2,915; makefile: 9
file content (91 lines) | stat: -rw-r--r-- 2,542 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
Description :
-------------

Gngb is Color GameBoy(tm) for linux emulator wrinten in C using the SDL.
It emulate most of the GB and GBC roms.

Prerequisites :
---------------

You need a recent version of SDL (I use SDL-1.2.2). 
The 1.0 serie don't work, sorry.

Installation : 
--------------

./configure
make
make install

if you want to compile with a debuger

./configure --with-debuger
make
make install

Usage : 
------

gngb [OPTION]... FILE
Emulate the GameBoy rom pointed by FILE

  -h, --help                 print this help and exit
  -a, --autoframeskip        turn on autoframeskip
      --sleep_idle           sleep when idle
      --color_filter         turn on the color filter
  -r, --rumble               turn on the rumble simulation
      --filter=X             Set the filter to apply (only for standard mode)
                              0 = none
                              1 = scanline
                              2 = scanline 50%
                              3 = smooth
                              4 = pseudo cell shading
  -R, --res=WxH              set the resolution to WxH (for YUV and GL mode)
  -Y, --yuv                  turn YUV mode on
      --yuv_type             set the type of the YUV overlay
                              0 = YV12
                              1 = YUY2
  -o, --opengl               turn OpenGL mode on (if conpiled in)
  -f, --fullscreen           run gngb in fullscreen
      --fps                  show frame/sec
  -s, --sound                turn on sound
      --sample_rate=RATE     set the sample rate to RATE
  -C, --color_gb             force to color gameboy mode
  -G, --normal_gb            force to normal gameboy mode
  -S, --super_gb             force to super gameboy mode (experimental)
      --auto_gb              turn on automatique detection
  -j, --joy=N                use the Nth joystick
  -g, --gdma_cycle           cpu stop during gdma transfer (experimental)


Most options can be disabled whith --no-OPTION (Ex: --no-sound turn sound off)

Keybinding :
------------

Enter          : Start
Right Shift    : Select
W              : B
X              : A    

TAB            : Open menu

F9             : fullscreen on/off
F10            : show fps
F11            : reset
F12            : show keysym code

KeyPad 1-5: Change palette
            Palette must be define in your gngbrc file (see sample_gngbrc)

KeyPad 6  : Toggle color filter 


Configuration :
---------------

In the file $HOME/.gngb/gngbrc
a sample file is provide : sample_gngbrc