portable documentation
[libpicofe.git] / gp2x / config.txt
diff --git a/gp2x/config.txt b/gp2x/config.txt
deleted file mode 100644 (file)
index 8be5239..0000000
+++ /dev/null
@@ -1,201 +0,0 @@
-As PicoDrive is multiplatform emulator, this is GP2X specific part of readme\r
-about configuration.\r
-\r
-If you have questions, you can use GP32X to ask for help.\r
-http://www.gp32x.com/board/index.php?showforum=48\r
-\r
-\r
-Configuration\r
--------------\r
-\r
-1. "Renderer"\r
-8bit fast:\r
-This enables alternative heavily optimized tile-based renderer, which renders\r
-pixels not line-by-line (this is what accurate renderers do), but in 8x8 tiles,\r
-which is much faster. But because of the way it works it can't render any\r
-mid-frame image changes (raster effects), so it is useful only with some games.\r
-\r
-Other two are accurate line-based renderers. The 8bit is faster but does not\r
-run well with some games like Street Racer.\r
-\r
-2. "Scaling"\r
-"hw" means GP2X hardware scaler, which causes no performance loss, but scaled\r
-image looks a bit blocky. "sw" means software scaling, which uses pixel\r
-averaging and may look a bit nicer, but blurry. Horizontal scaling is only for\r
-games which use so called "32 column mode" (256x224 or 256x240), and scales\r
-image width to 320 pixels. Vertical scales height to 240 for games which use\r
-height 224 (most of them).\r
-\r
-3. "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
-4. "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
-5. "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
-\r
-6. "Frameskip"\r
-How many frames to skip rendering before displaying another.\r
-"Auto" is recommended.\r
-\r
-7. "Enable sound"\r
-Does what it says. You must enable at least YM2612 or SN76496 (in advanced options,\r
-see below) for this to make sense.\r
-\r
-8. "Sound Quality"\r
-Sound rate and stereo mode. If you want 44100Hz sound, it is recommended to enable\r
-the second core (next option).\r
-\r
-9. "Use ARM940 core for sound"\r
-This option causes PicoDrive to use ARM940T core (GP2X's second CPU) for sound \r
-(i.e. to generate YM2612 samples) to improve performance noticeably.\r
-\r
-10. "6 button pad"\r
-If you enable this, games will think that 6 button gamepad is connected. If you\r
-go and reconfigure your keys, you will be able to bind X,Y,Z and mode actions.\r
-\r
-11. "Region"\r
-This option lets you force the game to think it is running on machine from the\r
-specified region, or just to set autodetection order. Also affects Sega/Mega CD.\r
-\r
-12. "Use SRAM/BRAM savestates"\r
-This will automatically read/write SRAM (or BRAM for Sega/Mega CD) savestates for\r
-games which are using them. SRAM is saved whenever you pause your game or exit the\r
-emulator.\r
-\r
-13. "Confirm savestate"\r
-Allows to enable confirmation on savestate saving (to prevent savestate overwrites),\r
-on loading (to prevent destroying current game progress), and on both or none.\r
-\r
-14. "Save slot"\r
-This is a slot number to use for savestates. This can also be configured to be\r
-changed with a button (see "key configuration").\r
-\r
-15. "GP2X CPU clocks"\r
-Here you can change clocks of both GP2X's CPUs. Larger values increase performance.\r
-There is no separate option for the second CPU because both CPUs use the same clock\r
-source. Setting this option to 200 will cause PicoDrive NOT to change GP2X's clocks\r
-at all (this is if you use external program to set clock).\r
-\r
-16. "[Sega/Mega CD options]"\r
-Enters Sega/Mega CD options menu (see below).\r
-\r
-17. "[advanced options]"\r
-Enters advanced options menu (see below).\r
-\r
-18. "Save cfg as default"\r
-If you save your config here it will be loaded on next ROM load, but only if there\r
-is no game specific config saved (which will be loaded in that case).\r
-You can press left/right to switch to a different config profile.\r
-\r
-19. "Save cfg for current game only"\r
-Whenever you load current ROM again these settings will be loaded (squidgehack and\r
-RAM settings will not take effect until emulator is restarted).\r
-\r
-\r
-Advanced configuration\r
-----------------------\r
-\r
-Enter [advanced options] in config menu to see these options.\r
-\r
-1. "Gamma correction"\r
-Alters image gamma through GP2X hardware. Larger values make image to look brighter,\r
-lower - darker (default is 1.0).\r
-\r
-2. "A_SN's gamma curve"\r
-If this is enabled, different gamma adjustment method will be used (suggested by A_SN\r
-from gp32x boards). Basically it makes difference for dark and bright colors.\r
-\r
-3. "Perfect vsync"\r
-This one adjusts the LCD refresh rate to better match game's refresh rate and starts\r
-synchronizing rendering with it. Should make scrolling smoother and eliminate tearing.\r
-\r
-4. "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
-sound to be able to play them.\r
-\r
-5. "Emulate YM2612 (FM)"\r
-This enables emulation of six-channel FM sound synthesizer chip, which was used to\r
-produce sound effects and music.\r
-\r
-6. "Emulate SN76496 (PSG)"\r
-This enables emulation of additional sound chip for additional effects.\r
-\r
-Note: if you change sound settings AFTER loading a ROM, you may need to reset\r
-game to get sound. This is because most games initialize sound chips on\r
-startup, and this data is lost when sound chips are being enabled/disabled.\r
-\r
-7. "gzip savestates"\r
-This will always apply gzip compression on your savestates, allowing you to\r
-save some space and load/save time.\r
-\r
-8. "Don't save last used ROM"\r
-This will disable writing last used ROM to config on exit (what might cause SD\r
-card corruption according to DaveC).\r
-\r
-9. "craigix's RAM timings"\r
-This overclocks the GP2X RAM chips, but may cause instability. Recommended if you\r
-use the second core for sound. Needs emulator restart to take effect.\r
-See this thread:\r
-http://www.gp32x.com/board/index.php?showtopic=32319\r
-\r
-10. "squidgehack"\r
-Well known way to improve the GP2X performance. You must restart the emulator\r
-for the change of this option to take effect.\r
-\r
-\r
-Sega/Mega CD options \r
---------------------\r
-\r
-1,2,3. "USA/EUR/JAP BIOS"\r
-These options just show if your BIOS files were correctly detected by the\r
-emulator (it shows the filename it is using). If so, you can press Start to\r
-test your BIOS.\r
-\r
-4. "CD LEDs"\r
-The Sega/Mega CD unit had two blinking LEDs (red and green) on it. This option\r
-will display them on top-left corner of the screen.\r
-\r
-5. "CDDA audio (using mp3s)"\r
-This option enables CD audio playback.\r
-\r
-6. "PCM audio"\r
-This enables 8 channel PCM sound source. It is required for some games to run,\r
-because they monitor state of this audio chip.\r
-\r
-7. "ReadAhead buffer"\r
-This option is for dealing with slow SD card access in GP2X, which makes FMV\r
-games unplayable. It will allow emulator not to access SD card for longer periods\r
-of time, but it will take more time to fill the buffer.\r
-\r
-8. "Save RAM cart"\r
-Here you can enable 64K RAM cart. Format it in BIOS if you do.\r
-\r
-9. "Scale/Rot. fx"\r
-The Sega/Mega CD had scaling/rotation chip, which allows effects similar to\r
-"Mode 7" effects in SNES. Unfortunately emulating it is slow, and very few games\r
-used it, so it's better to disable this option, unless game really needs it.\r
-\r
-10. "Better sync"\r
-This option is similar to "Perfect synchro" in Gens. Some games require it to run,\r
-for example most (all?) Wolfteam games, and some other ones. Don't use it for\r
-games which don't need it, it will just slow them down.\r
-\r
-\r
-Key configuration\r
------------------\r
-\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
-the right GP2X ones, which are assigned to them. If you bind 2 different GP2X buttons\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