ShuriZma
/
desmume
mirror of https://github.com/TASEmulators/desmume.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update general and windows READMEs

This commit is contained in:
shashClp 2009-01-04 16:05:14 +00:00
parent d99c069c8e
commit 6f8eda0414
2 changed files with 115 additions and 107 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
desmume/README
View File

@ -1,7 +1,7 @@
DeSmuME DeSmuME
_________________________________________ _________________________________________
Copyright (C) 2006 yopyop Copyright (C) 2006 yopyop
Copyright (C) 2006-2007 DeSmuME team Copyright (C) 2006-2007-2008-2009 DeSmuME team
1) Introduction.............................................13 1) Introduction.............................................13

218
desmume/README.WIN
View File

@ -1,7 +1,7 @@
DeSmuME DeSmuME
_________________________________________ _________________________________________
Copyright (C) 2006 yopyop Copyright (C) 2006 yopyop
Copyright (C) 2006-2007 DeSmuME team Copyright (C) 2006-2007-2008-2009 DeSmuME team
1) Compiling instructions...................................13 1) Compiling instructions...................................13
@ -12,16 +12,11 @@
1 Compiling instructions______________________________________ 1 Compiling instructions______________________________________
DeSmuME is written in C, using the DirectX 8.0, OpenGL, zlib, DeSmuME is written in C++, using the DirectX 8.0, OpenGL, zlib,
zziplib libraries, so you need a working C compiler(such as zziplib libraries, so you need a working C++ compiler, such as
mingw). Other supported compilers include Visual C++ 2005 and Visual C++ 2005, Visual C++ 2008 or Intel compiler. It should
dev-cpp. also be possible to compile it on dev-cpp, but it's currently
untested.
* You can find DirectX headers and libraries(for mingw) at
http://alleg.sourceforge.net/wip.html as the file
"dx80_mgw.zip". The actual runtime libraries(or
headers/libraries for MSVC) can be gotten from
http://www.microsoft.com/DirectX
* OpenGL should be included with your compiler, if it isn't, * OpenGL should be included with your compiler, if it isn't,
check on your compiler's website for links. check on your compiler's website for links.
@ -30,155 +25,168 @@ dev-cpp.
* zziplib can be found at http://zziplib.sourceforge.net * zziplib can be found at http://zziplib.sourceforge.net
mingw:
All you have to do now is go into your mingw shell
environment, go into the directory where you extracted DeSmuME,
and type: "./configure". Once that's done(and there was no
errors), type: "make". It should now take some time to compile so
go grab yourself a sandwich or beer - whatever suits your fancy
and it should be done in a few minutes. Now all you have to do is
type "./src/desmume" in order to run it.
dev-cpp:
Load the project file DeSmuME.dev in the src/windows directory,
compile, and you're set.
Visual C++: Visual C++:
Load the project file DeSmuME.vcproj in the src/windows directory, Load either the project file DeSmuME_2005.vcproj
compile, and you're set. or DeSmuME_2008.vcproj (depending on the VisualC++ version
you're using) in the src/windows directory, compile, and
you're set.
2 How to use DeSmuME__________________________________________ 2 How to use DeSmuME__________________________________________
Execute "desmume". A new window should pop up. The default Execute "desmume". A new window (and a information console)
settings should be fine for most people, but in case you need to should pop up. The default settings should be fine for most
adjust them, here's a brief explanation: people, but in case you need to adjust them, here's a brief
explanation:
Under the "Config", there are a number of items: Under the "Config", there are a number of items:
Save Type: Save Type:
Here you can select which type of Backup Memory DeSmuME should Here you can select which type of Backup Memory DeSmuME should
emulate. By default, Autodetect works fine, but in some cases emulate. By default, Autodetect works fine, but in some cases
DeSmuME doesn't correctly detect the Backup Memory. In that DeSmuME doesn't correctly detect the Backup Memory. In that
case, you will want to select the correct one. case, you will want to select the correct one.
3D Config:
Here you can change what will be used to emulate the 3D core
of the DS. By default it's on openGL, but you can also select
a Null device, that won't show any 3D.
Control Config: Control Config:
Here you can change the default key mappings. For now only the Here you can change the default key mappings. For now only the
keyboard is supported, but in the near future gamepads and keyboard is supported, but in the near future gamepads and
joysticks will be supported. joysticks will be supported.
Here are the default key mappings(they may be subject to change): Here are the default key mappings (they may be subject to
Up arrow - Up change):
Left arrow - Left Up arrow - Up
Down arrow - Down Left arrow - Left
right arrow - Right Down arrow - Down
v - A button right arrow - Right
b - B button v - A button
g - X button b - B button
h - Y button g - X button
c - Left Trigger h - Y button
n - Right Trigger c - Left Trigger
enter - Start button n - Right Trigger
space - Select button Enter - Start button
Space - Select button
Sound Settings: Sound Settings:
Here you can change the default sound settings. By default Here you can change the default sound settings. By default
DeSmuME uses Direct Sound, a buffer size of 2940, and DeSmuME uses Direct Sound, a buffer size of 2940, and volume
volume set to max. But if you want to mute the sound, you can set to max. But if you want to mute the sound, you can set the
set the sound core to none. Or if you want to save the sound sound core to none. Or if you want to save the sound to a
to a file, you can set the sound core to WAV write. If you find file, you can set the sound core to WAV write. If you find the
the sound is crackling a lot, try increasing the buffer size. On sound is crackling a lot, try increasing the buffer size. On
the other hand, if you find the sound somewhat delayed or jumpy, the other hand, if you find the sound somewhat delayed or
try decreasing the buffer size. jumpy, try decreasing the buffer size.
Firmware Settings:
Here you can change settings that are used as a customization
on the real DS: your name, birthday, favourite colour, etc...
Frame Skip: Frame Skip:
Here you can adjust the amount of frame draws to skip during Here you can adjust the amount of frame draws to skip during
emulation. Normally the emulator detects whether the emulator emulation. Normally the emulator detects whether the emulator
is running too fast or slow and skips a frame or more if it is running too fast or slow and skips a frame or more if it
needs to speed things up. However some people don't like the needs to speed things up. However some people don't like the
results of it, so here you can adjust that. results of it, so here you can adjust that.
After all the settings are set to your satisfaction, you can then Language:
load a ROM image by going into the "File" menu, and choosing Here you can change the emulator menus language. Currently we
"Open". Select which file you'd like to open, and the emulator only support English, French and Danish.
will automatically load and start running the selected ROM.
You can save the current emulation state by press shift + one of
the twelve F keys. To load, just press one of the twelve F keys
(without shift pressed).
Under the View menu there's also a few additional options you may
wish to change. After all the settings are set to your satisfaction, you can
then load a ROM image by going into the "File" menu, and
choosing "Open". Select which file you'd like to open, and the
emulator will automatically load and start running the
selected ROM.
You can save the current emulation state by press shift + one
of the twelve F keys. To load, just press one of the twelve F
keys (without shift pressed).
------------------------
Under the View menu there's also a few additional options you
may wish to change.
Rotation: Rotation:
Here you can adjust which angle of the display. Some programs Here you can adjust which angle of the display. Some programs
require that you normally turn the DS on its side. You can set it require that you normally turn the DS on its side. You can set
up in that manner using this. it up in that manner using this.
Magnify/DeMagnify: Window size:
With these options you can increase or decrease the window size. With these options you can increase or decrease the window
size.
Note: You can also adjust the window size by clicking on the edge Note: You can also adjust the window size by clicking on the
of the window, and dragging the mouse. edge of the window, and dragging the mouse.
Force Maintain Ratio: Force Maintain Ratio:
Sometimes when the window size is changed it's doesn't look Sometimes when the window size is changed it's doesn't look
correct on the screen. This option forces the window to maintain correct on the screen. This option forces the window to
a correct ratio so it looks correct. maintain a correct ratio so it looks correct.
Default size:
This option makes the emulator window go back to the default
size.
------------------------
GDB Debugger Stubs: GDB Debugger Stubs:
Source level debugging of ARM9 and/or ARM7 code is supported Source level debugging of ARM9 and/or ARM7 code is supported
using a GDB/Insight debugger. using a GDB/Insight debugger. The GDB stubs are enabled from
The GDB stubs are enabled from the command line using the the command line using the following options:
following options:
--arm9gdb=<PORT_NUM> (for the ARM9) --arm9gdb=<PORT_NUM> (for the ARM9)
--arm7gdb=<PORT_NUM> (for the ARM7) --arm7gdb=<PORT_NUM> (for the ARM7)
The PORT_NUM is the TCP port upon which the stub will listen for The PORT_NUM is the TCP port upon which the stub will listen
connections. Once enabled you can connect to the stub using the for connections. Once enabled you can connect to the stub
following command at the GDB debugger prompt (assuming GDB and using the following command at the GDB debugger prompt
DeSmuME are running on the same machine): (assuming GDB and DeSmuME are running on the same machine):
target remote :<PORT_NUM> target remote :<PORT_NUM>
NOTE: there are problems with the ARM support when stepping code NOTE: There are problems with the ARM support when stepping
with GDB versions prior to version 6.6. It is recommended that code with GDB versions prior to version 6.6. It is recommended
you use at least version 6.6 if possible. that you use at least version 6.6 if possible.
------------------------
GBAMP compact flash emulation: GBAMP compact flash emulation:
The default behaviour of DeSmumME is to attempt to emulate the The default behaviour of DeSmumME is to attempt to emulate the
FAT image for the contents of the directory where the running FAT image for the contents of the directory where the running
.nds file was located. .nds file was located.
This behaviour can be altered using the
--cflash=<DISK_IMAGE_FILE> command line option. Using this This behaviour can be altered using the --cflash=<DISK_IMAGE_FILE>
option DeSmuME will emulation a GBAMP and read and write sectors command line option. Using this option DeSmuME will emulation
from/to the disk image file. a GBAMP and read and write sectors from/to the disk image
The disk image file must be created and populated with files file. The disk image file must be created and populated with
using some external tool. files using some external tool.
NOTE: currently if desmume fails to open the disk image file it
will silently continue minus a working GBAMP emulation. NOTE: Currently if desmume fails to open the disk image file
it will silently continue minus a working GBAMP emulation.
3 Contact information_________________________________________ 3 Contact information_________________________________________
General inquiries should go to: General inquiries should go to:
E-mail: guillaume@desmume.org E-mail: guillaume@desmume.org
Web: http://www.desmume.org
Windows Port-related inquiries should go to: Forums: http://forums.desmume.org
E-mail:
Web: http://desmume.org
Please don't ask for roms, bios files or any other copyrighted Please don't ask for roms, bios files or any other copyrighted
stuff. stuff.
If you want to submit a bug report, please run desmume, go into If you want to submit a bug report, please run desmume, go
the "Help" menu, and click on "Submit a bug report". If you're into the "Help" menu, and click on "Submit a bug report". If
having trouble with it, please feel free to email. you're having trouble with it, please feel free to email.
4 Disclaimer__________________________________________________ 4 Disclaimer__________________________________________________