out_gp2x/readme.txt

   1 =================================================================================\r
   2                      GPFCE - NES emulator for the GP2X\r
   3 =================================================================================\r
   4                          Ported by:        zzhu8192\r
   5                          Current version:  0.2\r
   6                          Email:            zzhu8192@yahoo.com\r
   7                          Web Site:         www.unicorn-jockey.com\r
   8                          Web Site Admin:   Lil-kun\r
   9 =================================================================================\r
  10 \r
  11 \r
  12 This is a gp2x port of the **great** Open Source NES emulator FCE Ultra:\r
  13 http://fceultra.sourceforge.net.   If you enjoyed using this emulator, please\r
  14 keep in mind that this would not have been possible without the hard work and\r
  15 dedication of the FCE Ultra developers.\r
  16 \r
  17 In case you don't know what the NES is about, see:\r
  18 http://en.wikipedia.org/wiki/Famicom.\r
  19 \r
  20 My main reasons for working on this port is to get some game programming \r
  21 experience on smaller devices.  Although coding/porting an emu is \r
  22 generally not the same thing, it's still pretty cool.\r
  23 I'm an Enterprise Java software developer by trade, so this is a nice side project\r
  24 for me, and a welcome change of pace.  I'm also planning to write some \r
  25 original games in Java for the GP2x.  This should be interesting....  \r
  26 \r
  27 \r
  28 ------------------------------------------------------------------\r
  29 What's new\r
  30 ------------------------------------------------------------------\r
  31 Current version number is now:  0.2\r
  32 \r
  33 Many usability features were added, thanks to some great input \r
  34 from developers and users on the gp32x.com board.  Some of the\r
  35 changes went into the selector frontend.\r
  36 \r
  37 (I have sent my selector customization changes to kounch, \r
  38  so hopefully the changes will make it into\r
  39  version 1.2 or later for other projects to use)\r
  40 \r
  41 There are now 4 executable scripts.\r
  42 gpfce\r
  43 gpfce_showfps\r
  44 gpfce_swapbuttons\r
  45 gpfce_showfps_swapbuttons\r
  46 \r
  47 showfps:  this means FPS is displayed on the upper left of the screen\r
  48           (in non-stretch mode only).   \r
  49 \r
  50 swapbuttons:  this means instead of Y/A as NES_B  and B/X as NES_A\r
  51               use  A/X as NES_B, and Y/B as NES_A.  (think NES MAX)\r
  52               \r
  53 Volume meter is now shown on the OSD when adjusted.\r
  54 \r
  55 \r
  56 See version history below for more details.\r
  57 \r
  58 Depending on feedback, speed and even more compability will \r
  59 probably be the major focus going forward.\r
  60 \r
  61 \r
  62 ------------------------------------------------------------------\r
  63 Current Features\r
  64 ------------------------------------------------------------------\r
  65 - .zip file support\r
  66 - 22050 Hz Mono Sound support with volume control support\r
  67 - OSD Volume bar\r
  68 - Load/Save state (up to 10 slots, pick by holding down R)\r
  69 - Hardware stretch (See controls)\r
  70 - Soft Reset\r
  71 - Savegame support\r
  72 - 60 FPS without frame skipping on many games\r
  73 - Configurable Turbo Fire (hold L to toggle)\r
  74 - Game genie/Cheat code (functionality already exists in FCEU 0.81)\r
  75 - Sorted display of 2048 roms per subdirectory (recommended 512-1024)?\r
  76 - Semi-Configurable button layout (startup only)\r
  77 - configurable FPS display on upper left hand side\r
  78 \r
  79 --------------------------------------------------------------------\r
  80  Version History\r
  81 --------------------------------------------------------------------\r
  82 \r
  83 \r
  84 ver 0.2   5/29/2006  MD5SUM: dd75fa3f090f9298f9f4afff01ab96f2 *gpfce\r
  85 \r
  86           - Sound output issue with stereo fixed, now using\r
  87             22050 khz 16-bit mono.  I've tried interpolating to \r
  88             44khz mono, but the results seemed similar.\r
  89           - selector supports up to 2048 files, sorted, with\r
  90             alpha scrolling via left/right in addition to \r
  91             page up/down via L/R.\r
  92           - additional startup scripts to select button and fps  \r
  93             configurations\r
  94           - can load FDS files, but does not seem to work yet\r
  95           - configurable buttons  (use swapbuttons version )\r
  96           - configurable fps (use showfps version)\r
  97           - Configurable turbo fire control\r
  98           - Selectable save slots from 0-9\r
  99           - Volume bar\r
 100           - compiled with GCC 4.1.0 -O3 with profiling\r
 101 \r
 102 \r
 103 ver 0.1   5/23/2006  MD5SUM: 13681f25713ad04c535c23f8c61f1e0b *gpfce\r
 104       \r
 105 \r
 106           - Initial version\r
 107           - Around 60 fps with sound\r
 108           - Load/Save State\r
 109           - Hardware Stretch\r
 110           - Soft reset support\r
 111           - No GUI, using selector with config\r
 112           - Hard coded 22050 audio, 16-bit, stereo\r
 113           - compiled with GCC 4.1.0 -O3 with profiling\r
 114           - Hard coded config path.  This is to prevent users\r
 115             from filling up the gp2x space by accident\r
 116 \r
 117 \r
 118 ------------------------------------------------------------------\r
 119 Usage\r
 120 ------------------------------------------------------------------\r
 121 1)  Untar the emulator tarball onto some directory on your SD card.\r
 122 2)  You must have a directory called /roms/nes on your SD card.\r
 123     Put the roms in there, i.e. /mnt/sd/roms/nes is the gp2x path.\r
 124     Rom files can be zipped.\r
 125 3)  The emulator will create a subdirectory under roms  \r
 126     /roms/nes/fceultra.  Save states etc. go here.\r
 127 4)  To start a different rom while running one, hit L+R+JOY.\r
 128     To exit the file selection menu, press start.\r
 129 5)  For FDS support, put disksys.rom in /mnt/sd/roms/nes/fceultra\r
 130     Note: FDS roms must not be zipped.\r
 131 6)  For GameGenie support, put gg.rom in /mnt/sd/roms/nes/fceultra\r
 132 \r
 133 ------------------------------------------------------------------\r
 134 Cheats\r
 135 ------------------------------------------------------------------\r
 136 \r
 137 gpfce uses the cheat mechanisms already provided by\r
 138 http://mednafen.com/documentation/cheat.html  Note this feature\r
 139 is untested on gpfce as of version 0.2\r
 140 \r
 141 To use game genie, place appropraite gg.rom into /mnt/sd/roms/nes/fceultra.\r
 142 Use -gg on commandline to activate the game genie rom.\r
 143 \r
 144 \r
 145 ------------------------------------------------------------------\r
 146 Controls\r
 147 ------------------------------------------------------------------\r
 148 \r
 149 Note: JOY means press in on the joystick (i.e. not up/down/left/right)\r
 150 \r
 151 \r
 152 In file selector mode\r
 153 (This is based on selector version 1.1)\r
 154 ----------------------------------------------\r
 155 Start        - EXIT file selector, back to main menu.\r
 156 B,A,X,Y, JOY - start rom\r
 157 L            - page up\r
 158 R            - page down\r
 159 UP           - scroll up one, wraps if at top\r
 160 DOWN         - scroll down one, wraps if at bottom\r
 161 LEFT         - jump up list by first letter of rom name\r
 162 RIGHT        - jump down list by first letter of rom name\r
 163                \r
 164 \r
 165 \r
 166 \r
 167 In game\r
 168 ------------------------\r
 169 Y         - NES B\r
 170 A         - NES B\r
 171 B         - NES A\r
 172 X         - NES A\r
 173 SELECT    - NES SELECT\r
 174 START     - NES START\r
 175 VOL +/-   - Vol control.  \r
 176 \r
 177 hold L    - toggles between  \r
 178             No Turbo Fire, \r
 179             Upper row of buttons turbo fire\r
 180             Lower row of buttons turbo fire  \r
 181              \r
 182 hold R    - cycles through save state slots\r
 183 \r
 184 L & JOY   - Save state\r
 185 R & JOY   - Load State\r
 186 SEL & JOY - Stretch screen toggle\r
 187 L & R     - Reset NES\r
 188 \r
 189 L + R + JOY - Exit back to menu\r
 190 \r
 191 \r
 192 FDS only\r
 193 -------------------------------\r
 194 L         - insert disk\r
 195 R         - eject disk\r
 196 JOY       - select disk\r
 197 \r
 198 \r
 199 \r
 200 ------------------------------------------------------------------\r
 201 Known issues\r
 202 ------------------------------------------------------------------\r
 203 1)  Stretch mode could use a better aspect ratio.  Looks a bit odd.\r
 204     Might look into some fancy non-2x filtering algorthms, if there are such things.\r
 205 2)  Not thoroughly QA'd\r
 206 3)  S-Video not working\r
 207 4)  FDS does not seem to be working\r
 208 5)  Some compatibility issues\r
 209 6)  Can't sustain 60fps on some games\r
 210 7)  Some clipping issues in some games\r
 211 8)  Game genie behaves a bit odd, although code works...\r
 212 \r
 213 ------------------------------------------------------------------\r
 214  Might have time to do list\r
 215 ------------------------------------------------------------------\r
 216 1) Fix more known issues\r
 217 2) Better looking stretch?\r
 218 3) File based Game genie support\r
 219 4) Cleaner build\r
 220 5) Full speed on all games.  (This may require some work)\r
 221 6) Better compability\r
 222 7) Multiplayer support via cable - this one is obviously pretty\r
 223    tricky.  Will need cables and a usb hub first.\r
 224    It's definitely possible, but is not a priority at this point.    \r
 225 \r
 226        \r
 227 ------------------------------------------------------------------\r
 228  Many thanks\r
 229 ------------------------------------------------------------------\r
 230 - To lots of talented developers on the http://www.gp32x.com/board/\r
 231   Reesy, Squidge, etc.  for responding to my technical questions.\r
 232 - Thanks to \r
 233 - Lil-kun - for the neat GPFCE logo and the Web Site (under construction) :D\r
 234 - Referenced source code from MameGP2X (Franxis) and FCEU-0.3 gp2x (Noname)\r
 235 - Awesome wiki: http://wiki.gp2x.org/wiki/Main_Page\r
 236 - Awesome gp2x site: http://www.gp32x.com/\r
 237 - ryleh's minimal lib - w/o which this wouldn't have worked\r
 238 - FCE Ultra developers (http://fceultra.sourceforge.net/) \r
 239   for the wonderful and feature rich NES emulator.\r
 240 - kounch for Selector frontend - works great for lazy developers like me.  :-D\r
 241   I have sent my changes to kounch, so hopefully the changes will make it into\r
 242   version 1.2 or later.\r
 243 - gp2x community - just plain rocks\r
 244 \r
 245 \r