Documentation:

- Update the Read Me for Macintosh to reflect the current feature set.
- Fix Public Forum link in the Read Me for Macintosh.
- Add Improving Emulation Performance section in the Read Me for Macintosh.
This commit is contained in:
rogerman 2013-04-16 19:12:02 +00:00
parent b8c21dd0ad
commit 0fd7cdf6e8
1 changed files with 61 additions and 49 deletions

View File

@ -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