readme updated
[libpicofe.git] / base_readme.txt
index 7d0dcc3..71b2b5e 100644 (file)
@@ -58,7 +58,6 @@ If you are on 1.5, there is a separate KXploited version for it.
 Note that this emulator may require some tweaking of configuration settings to run\r
 some games well. For Genesis/MegaDrive, if you have any problems (game does not\r
 boot, sound is glitchy, broken graphics), try to:\r
-  * enable "Accurate timing" (options menu)\r
 #ifdef PSP\r
   * enable "accurate renderer"\r
 #else\r
@@ -81,10 +80,14 @@ EU: eu_mcd1_9210.bin eu_mcd2_9303.bin eu_mcd2_9306.bin
 JP: jp_mcd1_9112.bin jp_mcd1_9111.bin\r
 these files can also be zipped.\r
 \r
-The game must be dumped to ISO format, but BIN can be used too. If you want\r
-CD music, you must use ISO+mp3 files. Audio from BIN files won't be read at\r
-all. Also BIN files are usually larger, so it's better to use ISO. ISO+mp3\r
-files can be named similarly as for other emus.\r
+The game must be dumped to ISO format, but CUE/BIN can be used too. When using\r
+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
+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
+\r
+ISO+mp3 files can be named similarly as for other emus.\r
 Here are some examples:\r
 \r
 SonicCD.iso             data track\r
@@ -118,9 +121,8 @@ SonicCD_03.mp3
 Other important stuff\r
 ---------------------\r
 \r
-* If your Genesis/MD game hangs or has glitches, this is most likely because\r
-  "Accurate timing" option is not enabled, or fast renderer is used\r
-  (try the accurate one), or Z80 is disabled in "advanced options".\r
+* If your Genesis/MD game has graphical glitches, this is most likely because\r
+  "accurate renderer" is not enabled (see options).\r
 * Sega/Mega CD: If the game hangs after Sega logo, you may need to enable\r
   "better sync" and/or "Scale/Rot. fx" options, found in "Sega/Mega CD options"\r
   submenu, and then reset the game. Some other games may also require\r
@@ -136,6 +138,8 @@ Other important stuff
   Some games (like Snatcher) may hang in certain scenes because of this.\r
   Some mp3 rippers/encoders remove silence and beginning/end of audio tracks,\r
   what causes audio desyncs and/or mentioned problems.\r
+  If you have cue/bin rip, you can use the bin_to_cso_mp3 tool (included with\r
+  the emulator) to make a proper iso/mp3 rip.\r
 * Sega/Mega CD: If your games hangs at the BIOS screen (with planets shown),\r
   you may be using a bad BIOS dump. Try another from a different source.\r
 * Some Sega/Mega CD games don't use Z80 for anything, but they leave it active,\r
@@ -211,17 +215,6 @@ pixels wide. This option scales their width to 320 by using simple
 pixel averaging scaling. Works only when 16bit renderer is enabled.\r
 \r
 #endif\r
-@@0. "Accurate timing"\r
-This adds some more emulation precision, but slows the emulation down. Without\r
-this option some games do not boot (Red Zone for example), others have sound\r
-problems. This options has no effect for Sega/Mega CD emulation.\r
-\r
-@@0. "Accurate sprites"\r
-This option improves emulation of sprite priorities, it also enables emulation\r
-of sprite collision bit. If you see one sprite being drawn incorrectly above\r
-the other (often seen in Sonic 3D Blast), you can enable this to fix the problem.\r
-This only works with the accurate renderers (see first option).\r
-\r
 @@0. "Show FPS"\r
 Self-explanatory. Format is XX/YY, where XX is the number of rendered frames and\r
 YY is the number of emulated frames per second.\r
@@ -324,6 +317,12 @@ This one adjusts the LCD refresh rate to better match game's refresh rate and st
 synchronizing rendering with it. Should make scrolling smoother and eliminate tearing.\r
 \r
 #endif\r
+@@1. "Disable sprite limit"\r
+The MegaDrive/Genesis had a limit on how many sprites (usually smaller moving\r
+objects) can be displayed on single line. This option allows to disable that\r
+limit. Note that some games used this to hide unwanted things, so it is not\r
+always good to enable this option.\r
+\r
 @@1. "Emulate Z80"\r
 Enables emulation of Z80 chip, which was mostly used to drive the other sound chips.\r
 Some games do complex sync with it, so you must enable it even if you don't use\r
@@ -434,6 +433,13 @@ Same as above, only for higher (320 pixel wide) resolution using games.
 If this is enabled, PSP hardware will apply bilinear filtering on the resulting image,\r
 making it smoother, but blurry.\r
 \r
+@@3. "Gamma adjustment"\r
+Color gamma can be adjusted with this.\r
+\r
+@@3. "Black level"\r
+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
 @@3. "Wait for vsync"\r
 Wait for the screen to finish updating before switching to next frame, to avoid tearing.\r
 There are 3 options:\r
@@ -604,6 +610,8 @@ Additional thanks
 * Tasco Deluxe for his reverse engineering work on SVP and some mappers.\r
 * Bart Trzynadlowski for his SSFII and 68000 docs.\r
 * Haze for his research (http://haze.mameworld.info).\r
+* Lordus, Exophase and Rokas for various ideas.\r
+* Nemesis for his YM2612 research.\r
 * Mark and Jean-loup for zlib library.\r
 * ketchupgun for the skin.\r
 #ifdef GP2X\r
@@ -615,7 +623,6 @@ Additional thanks
 * A_SN for his gamma code.\r
 * craigix for supplying the GP2X hardware and making this port possible.\r
 * Alex for the icon.\r
-* Exophase, Rokas and Lordus for various ideas.\r
 * All the people from gp32x boards for their support.\r
 #endif\r
 #ifdef GIZ\r
@@ -636,6 +643,42 @@ Additional thanks
 \r
 Changelog\r
 ---------\r
+1.50\r
+  + Added some basic support for Sega Pico, a MegaDrive-based toy.\r
+  + Added proper support for cue/bin images, including cdda playback.\r
+    .cue sheets with iso/cso/mp3/wav files listed in them are now\r
+    supported too (but 44kHz restriction still applies).\r
+  + Added bin_to_cso_mp3 tool, based on Exophase's bin_to_iso_ogg.\r
+    The tool can convert .cue/.bin Sega CD images to .cso/.mp3.\r
+  * Changed how scheduling between 68k and z80 is handled. Improves\r
+    performance for some games. Credits to Lordus for the idea.\r
+  * YM2612 state was not 100% saved, this should be better now.\r
+  * Improved renderer performance for shadow/hilight mode.\r
+  * Added a hack for YM2612 frequency overflow issue (bleep noises\r
+    in Shaq Fu, Spider-Man - The Animated Series (intro music), etc.)\r
+    Credits to Nemesis @ spritesmind forum. Works only sound rate\r
+    is set to 44kHz.\r
+  + Implemented some sprite rendering improvements, as suggested by\r
+    Exophase. Games with lots of sprites now perform better.\r
+  + Added better idle loop detection, based on Lordus' idea again.\r
+  * "accurate timing" option removed, as disabling it no longer\r
+    improves performance.\r
+  * "accurate sprites" was removed too, the new sprite code can\r
+    properly handle sprite priorities in all cases.\r
+  * Timers adjusted again.\r
+  * Improved .smd detection code.\r
+  * ARM: fixed a bug in DrZ80 core, which could cause problems in\r
+    some rare cases.\r
+  * ARM: fixed a problem of occasional clicks on MP3 music start.\r
+  * Minor general optimizations and menu improvements.\r
+  * Fixed a bug in Sega CD savestate loader, where the game would\r
+    sometimes crash after load.\r
+  * Fixed a crash of games using eeprom (introduced in 1.40b).\r
+\r
+1.40c\r
+  * Fixed a problem with sound in Marble Madness.\r
+  * GP2X: Fixed minor problem with key config.\r
+\r
 1.40b\r
   * Fixed sprite masking code. Thanks to Lordus for explaining how it works.\r
   + Added "disable sprite limit" option.\r