diff --git a/desmume/README.MAC b/desmume/README.MAC index e0af92803..cd262bc5a 100644 --- a/desmume/README.MAC +++ b/desmume/README.MAC @@ -1,15 +1,15 @@ DeSmuME _________________________________________ Copyright (C) 2006 yopyop - Copyright (C) 2006-2012 DeSmuME team - Last Updated: March 31, 2012 + Copyright (C) 2006-2013 DeSmuME team + Last Updated: April 16, 2013 Contents: 1) System Requirements ..................................................... 15 2) Quick Start Guide for Using DeSmuME for OS X ............................ 36 -3) Additional Documentation ............................................... 108 -4) Contact Information .................................................... 138 -5) License ................................................................ 257 +3) Additional Documentation ............................................... 137 +4) Contact Information .................................................... 167 +5) License ................................................................ 269 1) System Requirements ________________________________________________________ @@ -54,9 +54,8 @@ you need them. Using the DS Controller: Each DS controller button can be mapped to a button of your choice on your keyboard, gamepad, or joystick. You can view the mappings by clicking on Input -in DeSmuME > Preferences, and then clicking the Controller tab on the Input -page. To change a mapping, click on the DS control that you want to change, -then press the button on your input device to map it. +in DeSmuME > Preferences. To change a mapping, click on the DS control that you +want to change, then press the button on your input device to map it. By default, the DS controller is mapped to the following keys on your keyboard: Up - Up Arrow @@ -72,12 +71,18 @@ By default, the DS controller is mapped to the following keys on your keyboard: Start - Return Select - Tab Lid - Delete (Backspace) - Debug - \ - Microphone - ` + Microphone - ` (Accent) + +In addition, the following emulator functions are mapped to your keyboard by +default: + Execute/Pause - Forward Delete + Reset - Page Down + Set Speed to Half - - (Dash) + Set Speed to Double - = Using the DS Touch Pad: -Touch pad input is emulated using the left mouse button. Simply click in the -touch pad area of the DS display window to use the DS touch pad. +Touch pad input is emulated using the left mouse button by default. Simply click +in the touch pad area of the DS display window to use the DS touch pad. Rotating the DS Display: Some games require that the DS display be at a certain rotation in order to @@ -104,6 +109,30 @@ use to quickly freeze/restore the emulation state. - To quick restore the emulation state, choose File > Load State Slot > Slot #. The default hotkey for this is (#). +Improving Emulation Performance: +There are many settings you can change in order to improve DeSmuME's emulation +performance. All of the settings listed below affect performance the most. Use +the settings as shown for the best possible performance. All of these settings +may be found in DeSmuME > Preferences. + +- WARNING: Changing any Emulation setting may cause emulation glitches in + certain ROMs. Do not change these settings unless you are willing to + accept reduced ROM compatibility. + + Display: + Video Output: + Use Vertical Sync - Off + Video Filter - None + 3D Rendering: + 3D Rendering Engine - SoftRasterizer + Rendering Threads - Automatic + + Emulation: + Advanced Bus Level Timing - Off (May cause glitches) + Rigourous 3D Rendering Timing - On (May cause graphical glitches) + 3D Rendering Engine - Dynamic Recompiler (May reduce ROM compatibility) + Dynamic Recompiler Block Size - 100 (May cause glitches) + Use External BIOS Images - Off (May reduce ROM compatibility) 3) Additional Documentation ___________________________________________________ @@ -165,36 +194,19 @@ lot of other useful information about DeSmuME. You can comment on different posts telling us how you feel about DeSmuME. Is DeSmuME the best thing in your life? Is it making you cry? Or is it a bunch of blah? Let us know here! -* Public Forum: http://forum.desmume.org +* Public Forum: http://forums.desmume.org If you have a question about DeSmuME, then this is the place to ask it. But -before you ask it, be aware that your question may have already been -answered before, so try the following things first: +before you ask it, be aware that your question may have already been answered +before, so try the following things first: - Read the manual and the FAQ. A lot of questions people have are usually already answered in our documentation. - Do a forum search about your question. -If you still need to ask a question, then be sure to provide us the following -information: - -- DeSmuME app version -- Your operating system and OS version -- The name of the ROM (if a ROM is involved) -- The serial code of the ROM (if a ROM is involved) - -The app version can be found by choosing DeSmuME > About DeSmuME in the DeSmuME -app. Alternatively, you can select the DeSmuME app in the Finder and choose -File > Get Info. - -You can find your operating system and OS version by choosing About This Mac in -the Apple menu. - -The ROM name and serial can be found by choosing File > ROM Info in the DeSmuME -application. - -It is very important that you provide us with this information! If you don't, -then it will take much longer for us to respond to your question. +If you still need to ask a question, choose Help > Submit a Support Request in +the DeSmuME application. Follow the onscreen instructions on the Support +Request Form. * Live Developer Chat Channel: irc://irc.freenode.net/desmume @@ -204,13 +216,15 @@ that goes on behind the scenes. If you are interested in doing any sort of software programming, software testing, documentation, or graphics work, then please join our chat channel! We would love for you to join us! -* Bug Reports: http://sourceforge.net/tracker/?group_id=164579&atid=832291 +* Bug Reports: If you believe that you have found a bug, you may submit a bug report by -choosing Help > Submit a Bug Report in the DeSmuME application, or by -following the above link. This will take you to our bug tracker on SourceForge. -Do note that you will need a SourceForge account in order to submit a bug -report. +choosing Help > Submit a Bug Report in the DeSmuME application. Follow the +onscreen instructions on the Bug Report Form. + +When you click Go To Bug Report Webpage, you will be taken to our bug tracker +on SourceForge. Do note that you will need a SourceForge account in order to +submit a bug report. Bug submissions are very welcome and encouraged. However, when you submit a bug to us, you MUST provide the following information, or else your bug submission @@ -226,19 +240,17 @@ may be rejected: - A description of the exact behavior you observed - A description of the behavior you expected -You can find your Mac model identifier in the System Profiler app. The app is -located in the Applications/Utilities folder. +All of this information will be prepared for you if you use the Bug Report Form +from Help > Submit a Bug Report. When you write your description, make sure that they are as detailed as possible. The better your descriptions are, the faster we can test and fix -bugs. +bugs. For example, if you observed a bug in the game Golden Sun: Dark Dawn, then +the bug report could look something like this: -For example, if you observed a bug in the game Golden Sun: Dark Dawn, then the -bug report could look something like this: - - App Version: v0.9.8 - Operating System: OS X v10.6.8 - Mac Model Identifier: iMac 11,2 + App Version: v0.9.9 + Operating System: OS X v10.8.3 (12D78) + Mac Model Identifier: iMac11,2 ROM Name: GOLDENSUN_DD ROM Serial: NTR-BO5E-USA Observed Behavior: I tried to load a save state using the