New version:
If you have an existing appdata/gngb/.gngb/gngbrc file it will NOT be over written and you will have the previous key mappings, you can either delete or rename the gngbrc file or edit the map_key line.
<GnGB_ReadMeFile.txt>
Description & Credits:
-------------
GnGB is a GB and GBC emulator for Linux written in C using the SDL.
It runs most GB and GBC ROMs and also supports zipped (.zip) ROMs.
GnGB is written by Frogus and Pepone
http://m.peponas.free.fr/gngb
This PND version uses the PickleLauncher for ROM selection and
emulator configuration
http://sourceforge.n...picklelauncher/
PickleLauncher skin by Gruso with credit to Aidan Hornsby for graphical elements
http://www.aidanhornsby.com/ http://365psd.com/day/192/
This PND version uses Notaz's improved SDL Library
http://notaz.gp2x.de/dev.php
PickleLauncher and GnGB in this PND version were compiled using
freamon's C Dev Tools (cdevtools.pnd)
http://repo.openpand...s.freamon.40n8e
PickleLauncher keys:
-------------
Dpad Up and Down: Scroll list by single line
Dpad Right and Left: Scroll list by page
B: Enter Folder/Run ROM/Select
X: Go Back
Y: Edit ROM Options
A: Make selected Options Default for All ROMs
Y: Make selected Options for current ROM
Keyboard: Filter current list by typed text
ESC: Exit PickleLauncher
In-Game keys:
-------------
GB B button : Pandora X button
GB A button : Pandora B button
GB Select button : Pandora Select or A button
GB Start button : Pandora Start or Y button
Space or Tab: Toggle Menu to Load/Save States and Configure Emulator
Pandora B button or Enter: Select Menu Items
Pandora X button, Space, Tab, or ESC: Close Menu (ESC Exits Emulator if
No Menu is Open)
1-5: Switch Original GB 2-bit Color Palettes
6: Toggle GBC Color Filter
9: Pause Emulator, and 0: Un-Pause Emulator
F8: Toggle GBC Rumble simulation (screen shake)
F10: Show FPS
F11: Reset Emulator
F12: Show SDL Keycodes
ESC: Exit Emulator
Default Resolution:
-------------
To set the Default Options using PickleLauncher navigate to a ROM and
press Pandoras "Y" button or the onscreen "EDIT" button.
Several Options will be shown indicating the current selections.
A "Resolution=" setting will be shown indicating the current resolution.
Press Pandora's "B" button or the onscreen "SELECT" button to show the
available resolutions.
Resolution=160x144/Single : Native GB/GBC resolution (stamp sized)
Resolution=320x288/Double : 2x integer scaled
Resolution=480x432/Triple* : 3x integer scaled (Default)
Resolution=532x480/Stretch_porportional : Stretched to screen height
Resolution=800x480/Stretch_fullscreen : Stretched to full screen
The Default resolution is indicated by an asterisk.
Use the Dpad or touchscreen to select the desired resolution.
The selected resolution is indicated in bold with an arrow.
Press Pandoras "A" button or the onscreen "MAKE DEFAULT" button to
choose the selected resolution for all ROMs (indicated by an asterisk)
or press Pandoras "Y" button or the onscreen "SET" button to choose this
resolution only for the selected ROM (indicated by color change).
Press the press Pandoras "X" button or the onscreen "BACK" button once
to verify the change to the "Resolution" setting and press press
Pandoras "X" button or the onscreen "BACK" button again to return to
the main menu.
Repeat the procedure to adjust the other Options.
Other Options:
-------------
Video_scaler: Sharp or Blurred pixels in scaled video image.
GB_type: Force specific GB type for all ROMs (experimental
Super GB mode can also be enabled here)
Sound/Sample_rate: Toggle sound and set sample rate
Video_filter: Choose video effects (scanlines are best used with 2x
resolution)
GBC_rumble_simulation: Shakes screen in GBC games with rumble support
GBC_color_filter: Simulates GBC color screen with dull colors
To change other options navigate to a ROM and press Pandoras "Y" button
or the onscreen "EDIT" button.
Use the Dpad or touchscreen to select the desired Option.
The selected Option is indicated in bold with an arrow.
Press Pandoras "B" button or the onscreen "SELECT" button to show the
available settings.
Use the Dpad or touchscreen to select the desired setting.
The selected setting is indicated in bold with an arrow.
Press Pandora's "A" button or the onscreen "MAKE DEFAULT" button to
choose the selected setting for all ROMs (indicated by an asterisk)
or press Press Pandoras "Y" button or the onscreen "SET" button to
choose this setting only for the selected ROM (indicated by color
change).
Press the Pandora's "X" button or the onscreen "BACK" button once to
verify the change to the setting and press press Pandoras "X" button
or the onscreen "BACK" button again to return to the main menu.
Super GB
-------------
The Super GB is experimental and has graphical glitches.
The Super GB border will flicker when the GB_type=Auto-detect
Use GB_type=Super_GB to eliminate Super GB border flicker.
Zipped ROMs:
-------------
Zipped ROMs only use the default settings.
The Pandora's "Y" button or the onscreen "EDIT" button will work on
Zipped (.zip) ROMs, but only to change default option for ALL ROMs.
Only Pandora's "A" button or the onscreen "MAKE DEFAULT" button
can be used for applying settings when using Zipped ROMs.
Default In-Game Keys:
-------------
To change default keys:
Edit the gngbrc file located in the pandora\appdata\gngb\.gngb\ folder
on your SD card.
The .gngb folder may be hidden.
Enable "Show Hidden Files" (CTRL-h) on the "View" menu in the
File Manager.
To Set Default Keys:
edit [sD CARD]\pandora\appdata\gngb\.gngb\gngbrc
edit the map_key line with correspondig Pandora Keysym codes:
map_key line order:
UP,DOWN,LEFT,RIGHT,A,B,START,SELECT,START,SELECT
map_key 273,274,276,275,279,281,280,278,308,306
Use the last four places the map_key line to define multiple
START and SELECT buttons.
Some Pandora Keysym codes:
UP=273,DOWN=274,LEFT=276,RIGHT=275,A=278,Y=280,X=281,B=279
START=308,SELECT=306
Press F12 In-Game to Show the SDL Keysm code for any key you press.
gngb.pnd