* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* *
* zBoy - a full-featured GameBoy emulator for Linux and Windows *
* Copyright (C) Mateusz Viste 2010, 2011, 2012 *
* *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+----------------------------------------------------------------------------+
| Available keys: |
| |
| Joypad actions | Keys mapping (on default keyboard mapping) |
| UP | Up arrow |
| DOWN | Down arrow |
| LEFT | Left arrow |
| RIGHT | Right arrow |
| START | Enter (return) |
| SELECT | TAB |
| Button A | CTRL |
| Button B | ALT |
| |
| Emulator's functions (using default keys assignements: |
| F1 - enables/disables game's background |
| F2 - enables/disables game's sprites |
| F3 - enables/disables game's window |
| F5 - saves the current state of the game on disk (a.k.a. "QuickSave") |
| F7 - loads the saved state of the game from disk (a.k.a. "QuickLoad") |
| F8 - enables/disables autoscreenshot (does a screenshot every 10 seconds)|
| F9 - performs a PCX screenshot (snapshot saved to current directory) |
| F10 - resets the CPU (restarts the game) |
| ESC - quits the emulator |
+----------------------------------------------------------------------------+
+----------------------------------------------------------------------------+
| Command-line usage: |
| zboy [--option1 --option2 ...] file.gb |
| |
| Available options: |
| --bootlogo Boots over the Gameboy's internal ROM (which displays a |
| Nintendo logo), before executing the cartridge ROM. |
| --[no]colorization Activates or disables colorization. When enabled, |
| zBoy will colorize some games using special palettes. |
| --eaglescale x Scales the video screen x times using the EAGLE scaling |
| algorithm. Possible values are 2, 4, 6 or 8. |
| --fpslimit x Limit the FPS rendering to x frames per second. x must be |
| in the range 1..60 (defaults to 60 FPS). This option will |
| give odd results when combined with --nospeedlimit. |
| --scale x Scales the video screen x times. Possible values are |
| 1..8 (defaults to 4 = 640x576). |
| --scale2x x Scales the video screen x times using the Scale2x |
| algorithm. Possible values are 2, 4, 6 or 8. |
| --scale3x x Scales the video screen x times using the Scale3x |
| algorithm. Possible values are 3 or 6. |
| --palette name Use an alternative palette of colors. Possible palettes |
| are: gbmicro or peasoup. The default one is gbmicro. |
| --input keys Redefine keys used to emulate the GameBoy's joypad. Need |
| to be followed by the list of scancodes in this exact |
| order: Up Down Left Right Start Select A B TurboA TurboB |
| See the list of available scancodes below. |
| --fnkeys keys Redefine keys used for calling functions of the emulator. |
| Need to be followed by the list of scancodes in this exact|
| order: bgCtrl spriteCtrl windowCtrl Save Load Autoshot |
| Screenshot Reset Quit |
| See the list of available scancodes below. |
| --nocpuidle Do not try to idle the CPU when the emulator have some |
| spare time. This might give better results on hi-latency |
| systems, at the cost of using the CPU at full speed. |
| --nospeedlimit Runs zBoy at full (unlimited) speed. This is not a good |
| idea if you want to play games, but might be useful for |
| some benchmarking needs. |
| --showfps Shows the FPS counter (frames per second) in the title |
| bar of zBoy's window. |
| --noscreensaver Prohibits any screen saver to start while the emulator is |
| running. |
| --hiscoresmem This option will tell zBoy to memorize HiScores in games |
| that aren't able to do so by themselves (eg. Pipe Dream). |
| --rominfos Displays various informations about the ROM before start. |
| --netplay x Establish a 2 player session mode with the IP 'x'. |
| --bindaddr x In case of using --netplay, the --bindaddr parameter |
| allows to force the local IP (automatic by default). |
+----------------------------------------------------------------------------+
+----------------------------------------------------------------------------+
| List of available scancodes (useable with --input or --fnkeys) |
| |
| zBoy's key name | Description |
| ----------------+------------------------------ |
| kb.f1 | F1 key |
| kb.f2 | F2 key |
| kb.f3 | F3 key |
| kb.f4 | F4 key |
| kb.f5 | F5 key |
| kb.f6 | F6 key |
| kb.f7 | F7 key |
| kb.f8 | F8 key |
| kb.f9 | F9 key |
| kb.f10 | F10 key |
| kb.f11 | F11 key |
| kb.f12 | F12 key |
| kb.esc | Escape key |
| kb.tab | TAB |
| kb.lctrl | Left control key |
| kb.lalt | Left ALT key |
| kb.rctrl | Right control key |
| kb.ralt | Right ALT key |
| kb.spc | Space |
| kb.ret | Return (enter) |
| kb.bks | Backspace |
| kb.left | Left arrow |
| kb.right | Right arrow |
| kb.up | Up arrow |
| kb.down | Down arrow |
| kb.rshift | Right shift key |
| kb.lshift | Left shift key |
| kb.lwin | Left "Windows" key |
| kb.rwin | Right "Windows" key |
| kb.menu | "Menu" key |
| kb.pgup | Page up |
| kb.pgdw | Page down |
| kb.home | Home key |
| kb.end | End key |
| kb.ins | Insert key |
| kb.del | Delete key |
| kb.a | Key "a" |
| kb.b | Key "b" |
| kb.c | Key "c" |
| kb.d | Key "d" |
| kb.e | Key "e" |
| kb.f | Key "f" |
| kb.g | Key "g" |
| kb.h | Key "h" |
| kb.i | Key "i" |
| kb.j | Key "j" |
| kb.k | Key "k" |
| kb.l | Key "l" |
| kb.m | Key "m" |
| kb.n | Key "n" |
| kb.o | Key "o" |
| kb.p | Key "p" |
| kb.q | Key "q" |
| kb.r | Key "r" |
| kb.s | Key "s" |
| kb.t | Key "t" |
| kb.u | Key "u" |
| kb.v | Key "v" |
| kb.w | Key "w" |
| kb.x | Key "x" |
| kb.y | Key "y" |
| kb.z | Key "z" |
| kb.0 | Key "0" |
| kb.1 | Key "1" |
| kb.2 | Key "2" |
| kb.3 | Key "3" |
| kb.4 | Key "4" |
| kb.5 | Key "5" |
| kb.6 | Key "6" |
| kb.7 | Key "7" |
| kb.8 | Key "8" |
| kb.9 | Key "9" |
| joy1.a1pos | Axis #1 on joypad #1 (positive value of the axis) |
| joy1.a1neg | Axis #1 on joypad #1 (negative value of the axis) |
| joy1.a2pos | Axis #2 on joypad #1 (positive value of the axis) |
| joy1.a2neg | Axis #2 on joypad #1 (negative value of the axis) |
| joy1.a3pos | Axis #3 on joypad #1 (positive value of the axis) |
| joy1.a3neg | Axis #3 on joypad #1 (negative value of the axis) |
| joy1.a4pos | Axis #4 on joypad #1 (positive value of the axis) |
| joy1.a4neg | Axis #4 on joypad #1 (negative value of the axis) |
| joy1.b1 | Button #1 on joypad #1 |
| joy1.b2 | Button #2 on joypad #1 |
| joy1.b3 | Button #3 on joypad #1 |
| joy1.b4 | Button #4 on joypad #1 |
| joy1.b5 | Button #5 on joypad #1 |
| joy1.b6 | Button #6 on joypad #1 |
| joy1.b7 | Button #7 on joypad #1 |
| joy1.b8 | Button #8 on joypad #1 |
| joy1.b9 | Button #9 on joypad #1 |
| joy1.b10 | Button #10 on joypad #1 |
| joy1.b11 | Button #11 on joypad #1 |
| joy1.b12 | Button #12 on joypad #1 |
| joy1.b13 | Button #13 on joypad #1 |
| joy1.b14 | Button #14 on joypad #1 |
| joy1.b15 | Button #15 on joypad #1 |
| joy1.b16 | Button #16 on joypad #1 |
| joy2.a1pos | Axis #1 on joypad #2 (positive value of the axis) |
| joy2.a1neg | Axis #1 on joypad #2 (negative value of the axis) |
| joy2.a2pos | Axis #2 on joypad #2 (positive value of the axis) |
| joy2.a2neg | Axis #2 on joypad #2 (negative value of the axis) |
| joy2.a3pos | Axis #3 on joypad #2 (positive value of the axis) |
| joy2.a3neg | Axis #3 on joypad #2 (negative value of the axis) |
| joy2.a4pos | Axis #4 on joypad #2 (positive value of the axis) |
| joy2.a4neg | Axis #4 on joypad #2 (negative value of the axis) |
| joy2.b1 | Button #1 on joypad #2 |
| joy2.b2 | Button #2 on joypad #2 |
| joy2.b3 | Button #3 on joypad #2 |
| joy2.b4 | Button #4 on joypad #2 |
| joy2.b5 | Button #5 on joypad #2 |
| joy2.b6 | Button #6 on joypad #2 |
| joy2.b7 | Button #7 on joypad #2 |
| joy2.b8 | Button #8 on joypad #2 |
| joy2.b9 | Button #9 on joypad #2 |
| joy2.b10 | Button #10 on joypad #2 |
| joy2.b11 | Button #11 on joypad #2 |
| joy2.b12 | Button #12 on joypad #2 |
| joy2.b13 | Button #13 on joypad #2 |
| joy2.b14 | Button #14 on joypad #2 |
| joy2.b15 | Button #15 on joypad #2 |
| joy2.b16 | Button #16 on joypad #2 |
| none | No key assigned (useful if we don't need some keys) |
| |
+----------------------------------------------------------------------------+
homepage: http://www.viste-family.net/mateusz/software/zboy/
