******* Virtual GameBoy ******* The Portable Nintendo GameBoy Emulator version 0.7 by Marat Fayzullin email: fms@freeflight.com IRC: RST38h WWW: http://www.freeflight.com/fms/ * AMIGA VERSION * by Lars Malmborg email: glue@df.lth.se IRC: Glue WWW: http://www.ludat.lth.se/~dat93lma/ (*) GameBoy is a registered trademark of Nintendo. PPC Version by MagicSN@Birdland.es.baewue.de (Joystick/Joypad support added since last version). lowlevel.library required. Parameter to activate it is joy ("vgb joy"). You can't use keyboard and joypad at the same time. THIS EMULATOR IS SLOW ON AGA !!! USE IT ON A GFX BOARD !!! What? ----- o Amiga-ized application, i.e. uses Amiga argument parsing o Features of the Unix version are implemented o Requires OS 3.0 Why? ---- Because the 0.3 version by Matthias Bethke & Michael Boese didn't work on my machine, so I had to make a new port. This port uses some of the Amiga specific code from that port, but I started off by porting the Unix 0.7, so it is more like a new port than an update of that port. The most important difference is that this port doesn't use the V40 'WriteChunkyPixels'. This will make the program run on more machines (f.ex. mine!) It has sucessfully been tested on the following machines: A1200/030 without graphics card. A3000/030 with CyberVision64 running CyberGraphX. A4000/040 without graphics card. A4000/040 with Picasso II running CyberGraphX. How? ---- This program uses the standard Amiga argument parsing. Enter 'AmigaVGB HELP' to show the options the program handles. Enter 'AmigaVGB ?' for options template. Options: Cartridge - name of file to load as cartridge Verbose - Select debugging messages (default: 5) 0 - Silent 1 - Startup messages 2 - Illegal writes 4 - Illegal CPU ops 8 - Bank switching Add numbers to activate multiple options! VPeriod - Set VBlank interrupts period (default: 10000ops) UPeriod - Number of interrupts per screen update (default: 2) Help - Print this help page Cheat - Activate a GameGenie cheat Delay - Delay line interrupts NoCRC - Don't check cartridge CRC AutoA - Autofire for button A AutoB - Autofire for button B Trap
(!) - Set address where to enter debug mode (default: $ffff) Colors - Change all colors. The palette consists of four colors enumerated from bright to dark. A palette more like a real Gameboy is: 102010,104010,106010,00a000 BColors - Change background colors SColors - Change sprite colors WColors - Change window colors ScaleUp - Double the size of the display PublicScreen - Open windows on the named public screen Screen - Open on a Screen (recommended for AGA) Nocgx - Use WPA8 even on a GFX Board (not recommended at all) (!) Trap is only valid if AmigaVGB is compiled with DEBUG defiend. If no cartridge is given as an argument, an ASL file requester will pop up, where you can select one. The 'Interleave' argument is present in the Amiga version only. It will speed up the game by not rendering all the lines of the display. F.ex. setting it to 2 will make the emulator only rendering every second line. Some examples: > AmigaVGB Cartridge demos/RPN.gb Colors 000000,004000,008000,00c000 AutoA > AmigaVGB CR demos/SPACE.gb BC 808080,404040,202020,000000 SC 000040,000080,008000,004000 WC ffff80,ffc000,a0a020,504000 > AmigaVGB 2 CR Pacman.gb BC 000000,ffff00,000080,ff8000 SC 000000,ffff00,ff0000,0000ff WC ffff00,000000,ff0000,0000ff While the emulation is running, the following keys are of interest: Help - Pop up a window showing key bindings as below Left Alt or '+' on key pad - 'A' Left Shift or '6' on key pad - 'B' Right Shift or '4' on key pad - 'Select' Return or '5' on key pad - 'Start' Cursorkeys - Joypad ESC - Quit emulation If AmigaVGB is compiled with DEBUG defined, the following keys are also used: F1 - Go into built-in debugger F2 - Show LCD controller registers F3 - Show sprite registers Kredz! Marat Fayzullin - VGB Matthias Bethke & Michael Boese - Amiga port of VGB 0.3 Stefan Burström - Testing and LOTS of general help Stefan Zivkovic - Testing and hints John Carehag - Testing Simeon Everitt - Testing Steffen Haeuser - PPC Port -Lars