summaryrefslogtreecommitdiff
path: root/emulators/vgb/pkg-descr
blob: 2ada70f18924de759d24dd145cbc1487c2b04197 (plain) (blame)
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
Virtual Game Boy is the Nintendo GameBoy(tm) emulator on X-Window.

  Test your VGB installation with the command(default):

	vgb /usr/X11R6/share/VGB/CART.GB

  If you want to know what the cartidge file is, type as:

	gblist <cartridge file>

  You buy the cartridges. GameBoy software is copyrighted and still sold. 
Therefore, its distribution is an act of piracy. Nothing prohibits you 
from backing up a cartridge you own and playing it on the emulator though.
To back up a GameBoy cartridge, you can use either SmartCard copier (about
$100 for a standalone version), or a self-built copier designed by Pascal 
Felber, description of which is available at:

           http://www.freeflight.com/fms/GameBoy/

GameBoy-related archives with technical and other info are located at:

                  http://www.freeflight.com/fms/GameBoy/
                  ftp://ftp.komkon.org/pub/GameBoy/

Usage: vgb [-option1 [-option2...]] <filename>
<filename> = name of file to load as cartridge [CART.GB]
[-option]   =
  -verbose <level>    - Select debugging messages [5]
                        0 - Silent           1 - Startup messages
                        2 - Illegal writes   4 - Illegal CPU ops
                        8 - Bank switching
  -vperiod <period>   - Set VBlank interrupts period [69905 cycles]
  -uperiod <period>   - Number of interrupts per screen update [2]
  -help               - Print this help page
  -cheat <GG code>    - Activate a GameGenie cheat
  -delay/-nodelay     - Delay/don't delay line interrupts [-nodelay]
  -crc/-nocrc         - Check/don't check cartridge CRC [-crc]
  -autoa/-noautoa     - Autofire/No autofire for button A [-noautoa]
  -autob/-noautob     - Autofire/No autofire for button B [-noautob]
  -logsnd <filename>  - Write soundtrack to a file [off]
  -trap <address>     - Trap execution when PC reaches address [FFFFh]
  -saver/-nosaver     - Save/don't save CPU when inactive [-saver]
  -colorN <name>      - Change color #N [white,#989898,#585858,black]
  -bcolorN <name>     - Change background color #N [same]
  -scolorN <name>     - Change sprite color #N [same]
  -wcolorN <name>     - Change window color #N [same]

Keyboard bindings:
  [SPACE] - A button (also: A,S,D,F,G,H,J,K,L)
  [LALT]  - B button (also: Z,X,C,V,B,N,M)
  [TAB]   - SELECT button
  [ENTER] - START button
  [ESC]   - Quit emulation (also: [F12])

  [F1]    - Go into built-in debugger
  [F2]    - Show LCD controller registers