---------------------------------------------------------------------------------
MUPEN64PLUS Pandora, Release 1
---------------------------------------------------------------------------------
This is a Nintendo 64 emulator for the Open Pandora handheld. Mupen64plus is a
plugin based emulator, a plugin for graphics (gles2n64) and input (ppsp_input)
are provided.
---------------------------------------------------------------------------------
Installation
---------------------------------------------------------------------------------
1. place pnd in /pandora/desktop or /pandora/menu
2. execute pnd by clicking desktop icon or menu item
3. play
The first thing you probably want to do is goto Options->Configure->Rom Browser
and set the directory of your roms. Your roms should then show up in the main
window once it is finished searching (can take a little while).
---------------------------------------------------------------------------------
Default Input Plugin: PPSP_INPUT
---------------------------------------------------------------------------------
By default the controller is mapped:
+-------------------+-------------------+
| Pandora | N64 |
+-------------------+-------------------+
| Left Analog | Analog |
| Right Analog | C buttons |
| DPAD | DPAD |
| L | Z |
| R | R |
| B | A |
| X | B |
| START | Start |
| PANDORA BUTTON | Exit Emulator |
+---------------------------------------+
You can also remap the controls by going options->configure input. This will
start mousepad with the ppsp_input config file open. It is important that you
use the correct non-case sensitive syntax. The N64 Digital controls
can be mapped using the following sytax:
N64 <button>=<type> <name> {: <threshold>}
where:
+-----------+-------------------------------------------------------------------+
| <type> | possible <name> |
+-----------+-------------------------------------------------------------------+
|ANALOG | LEFT UP, LEFT DOWN, LEFT RIGHT, LEFT LEFT, RIGHT UP, RIGHT DOWN, |
| | RIGHT RIGHT, RIGHT LEFT |
|BUTTON | UP, DOWN, LEFT, RIGHT, DPAD UP, DPAD DOWN, DPAD LEFT, DPAD RIGHT, |
| | L, R, START, SELECT, MENU |
|KBOARD | A-Z, 0-9, F1-F12, ENTER, LEFTSHIFT, ENTER, SPACE, COMMA, DOT, |
| | BACKSPACE, ESC, MINUS, EQUAL, TAB, LEFTBRACE, RIGHT BRACE, |
| | SEMICOLON, APOSTROPHE, GRAVE, BACKSLASH, SLASH |
+-----------+-------------------------------------------------------------------+
If <type> is ANALOG you should also specify a threshold between 0 and 127. When the
analog is pushed past the threshold the button is pressed. The N64 analog can only
be mapped to three possible configurations at the moment.
N64 ANALOG = <type name> {: <velocity>}
where:
<type name>=ANALOG LEFT | ANALOG RIGHT | BUTTON DPAD
If BUTTON DPAD is specified you can supply an additional argument which
describes the rate at which the N64 analog responds to the DPAD being pressed.
ie. N64 ANALOG=BUTTON DPAD : 25.0
This would set the velocity to 25 (the default value). The last option is the
pandora analog controllers calibration curve. The curve desribes what value is
outputted as the left and right analogs are pressed. The syntax is:
CALIB <analog>[n]=<value>
where <analog>=LEFT | RIGHT, 0 <= n <= 3 and <value> is the c[n] value in the
below formula:
out=in*c[0] + in*in*c[1]+in*in*in*c[2]+in*in*in*in*c[3]
A linear mapping would set c = {1,0,0,0} this is not used by default because
the N64 Analog has far more travel than the Pandora's making them too sensitive,
by default a half linear half quadratic is used c={0.5,0.5,0,0}. This effect is
applied before any button mapping takes place.
---------------------------------------------------------------------------------
Default Graphics Plugin: GLES2N64
---------------------------------------------------------------------------------
.... TBC
---------------------------------------------------------------------------------
Source Code
---------------------------------------------------------------------------------
Parts of this release is based on GPL source code. The source code can be found
at the follwing addresses:
- dynarec/mupen64plus: http://bunnitude.com/ari64/mupen64plus-arm-20100627.tar.gz
- gles2n64: http://code.google.com/p/gles2n64/
- ppsp_input: http://code.google.com/p/ppsp-input/
.... I've just wacked a licence on it, its all rather dodgy. Thats why it cannot be included in the new mupen64plus, however a plugin called Arachnoid which is basically gln64 rewritten in C++ was given permission by the original gln64 author to release under GPL. I am considering porting across my changes.... though the original gln64 is much easier to modify. The best outcome would be if the original author of gln64 turned up, others have tried to contact him but to no avail. 
