make OSS detect blocking, adjust audio API
[libpicofe.git] / base_readme.txt
index c6757ea..e4361c4 100644 (file)
@@ -56,6 +56,9 @@ If you are on 1.5, there is a separate KXploited version for it.
 Copy SIS and some ROMs to any directory in your memory stick, and install the SIS.\r
 Then load a ROM and enjoy! ROMs can be in .smd or .bin format and can be zipped.\r
 #endif\r
+#ifdef PANDORA\r
+Just copy the .pnd to <sd card>/pandora/menu or <sd card>/pandora/desktop.\r
+#endif\r
 #ifndef UIQ\r
 \r
 This emulator has lots of options with various tweaks (for improved speed mostly),\r
@@ -72,8 +75,13 @@ To play any game, you need BIOS files. These files must be copied to
 #ifdef UIQ\r
 D:\other\PicoDrive\ directory.\r
 #else\r
+#ifdef PANDORA\r
+<sd card>/pandora/appdata/PicoDrive/ directory\r
+(if you run PicoDrive once it will create that directory for you).\r
+#else\r
 the same directory as PicoDrive files.\r
 #endif\r
+#endif\r
 Files can be named as follows:\r
 \r
 US: us_scd1_9210.bin us_scd2_9306.bin SegaCDBIOS9303.bin\r
@@ -85,8 +93,14 @@ The game must be dumped to ISO/CSO+MP3/WAV or CUE+BIN format. When using
 CUE/BIN, you must load .cue file from the menu, or else the emu will not find\r
 audio tracks.\r
 CUE/BIN usually takes a lot of space, so it can be converted to cue/cso/mp3 by\r
+#ifdef PANDORA\r
+using bin_to_cso_mp3 tool, which can be downloaded from:\r
+http://notaz.gp2x.de/releases/misc/bin_to_cso_mp3.zip\r
+See readme in the bin_to_cso_mp3/ directory for details.\r
+#else\r
 using bin_to_cso_mp3 tool, which is included with the emulator. See readme in\r
 the bin_to_cso_mp3/ directory for details.\r
+#endif\r
 \r
 ISO+mp3 files can be named similarly as for other emus.\r
 Here are some examples:\r
@@ -234,6 +248,7 @@ Restores all options (except controls) to defaults.
 Display options\r
 ---------------\r
 \r
+#ifndef PANDORA\r
 @@1. "Renderer"\r
 #ifdef GP2X\r
 8bit fast:\r
@@ -258,6 +273,7 @@ line by line, like the accurate one does. But because of the way it works it
 can't render any mid-frame image changes (raster effects), so it is useful only\r
 for some games.\r
 #endif\r
+#endif\r
 \r
 #ifdef GP2X\r
 @@1. "Scaling"\r
@@ -332,7 +348,7 @@ Color gamma can be adjusted with this.
 This can be used to reduce unwanted "ghosting" effect for dark games, by making\r
 black pixels brighter. Use in conjunction with "gamma adjustment" for more effect.\r
 \r
-@@1. "Wait for vsync"\r
+@@1. "Wait for v-sync"\r
 Wait for the screen to finish updating before switching to next frame, to avoid tearing.\r
 There are 3 options:\r
 * never: don't wait for vsync.\r
@@ -348,6 +364,9 @@ Scale the image up, but keep 4:3 aspect, by adding black borders.
 @@1. "Set to fullscreen"\r
 Adjust the resizing options to make the game image fullscreen.\r
 #endif\r
+#ifdef PANDORA\r
+To be updated..\r
+#endif\r
 \r
 \r
 Sega/Mega CD options \r
@@ -456,21 +475,14 @@ Key configuration
 \r
 Select "Configure controls" from the main menu. Then select "Player 1" and you will\r
 see two columns. The left column lists names of Genesis/MD controller buttons, and\r
-#ifdef GP2X\r
-the right GP2X ones, which are assigned to them. If you bind 2 different GP2X buttons\r
-#endif\r
-#ifdef GIZ\r
-the right Giz ones, which are assigned to them. If you bind 2 different Giz buttons\r
+the right column your handheld ones, which are assigned.\r
+#ifndef PANDORA\r
+If you bind 2 different buttons to the same action, you will get a combo\r
+(which means that you will have to press both buttons for that action to happen).\r
 #endif\r
-#ifdef PSP\r
-the right PSP ones, which are assigned to them. If you bind 2 different PSP buttons\r
-#endif\r
-to the same action, you will get a combo (which means that you will have to press\r
-both buttons for that action to happen).\r
 \r
 There is also option to enable 6 button pad (will allow you to configure XYZ\r
 buttons), and an option to set turbo rate (in Hz) for turbo buttons.\r
-#endif\r
 #ifndef UIQ\r
 \r
 \r
@@ -615,6 +627,7 @@ Additional thanks
 * Haze for his research (http://haze.mameworld.info).\r
 * Lordus, Exophase and Rokas for various ideas.\r
 * Nemesis for his YM2612 research.\r
+* Many posters at spritesmind.net forums valuable information.\r
 * Mark and Jean-loup for zlib library.\r
 * ketchupgun for the skin.\r
 #ifdef GP2X\r
@@ -637,13 +650,34 @@ Additional thanks
   (http://www.inf.u-szeged.hu/symbian-gcc/) for their updated pre-SymbianOS9\r
   compile tools.\r
 * AnotherGuest for all his Symbian stuff and support.\r
-* Inder for the icons.\r
 #endif\r
+* Inder for some graphics.\r
 * Anyone else I forgot. You know who you are.\r
 \r
 \r
 Changelog\r
 ---------\r
+1.80beta2\r
+  * Pandora: updated documentation.\r
+\r
+1.80beta1\r
+  + Added pandora port.\r
+  * Internal refactoring for 32x/SMS support.\r
+  * Move mapper database to external file.\r
+  + Added preliminary SMS emulation.\r
+  + Added emulation of 32x peripherals including VDP. More work is needed here.\r
+  + ARM: Added new SH2 recompiler for 32x. Some unification with SVP one.\r
+  - Disabled most of the above bacause I'm not yet happy with the results.\r
+\r
+1.56\r
+  * Changed sync in Sega CD emulation again. Should fix games that\r
+    broke after changes in 1.51a.\r
+  * Fixed default keys rebinding when they shouldn't.\r
+  * Fixed sram being loaded from wrong game.\r
+  * Emu should no longer hang shortly after using fast-forward.\r
+  * Fixed save states sometimes no longer showing up in save state menu.\r
+  * ARM: some asm code refactoring for slight speed improvement.\r
+\r
 1.55\r
   + Added Wiz support. Now the same GP2X binary supports F100/F200 and Wiz.\r
   * Changed shadow/hilight handling a bit, fixes some effects in Pirates! Gold.\r