DeSmuME Manual for the Linux Glade port
Quick Getting Started Guide
Due to the numerous different distributions and hardware platforms Linux runs on, desmume for Linux is only offered in source code form. This means you have to build a binary (compile) Linux for yourself. If you do not know how to do this, please refer to Installing DeSmuME from source on Linux.
Once you have build and installed the binary, you will have 3 different Linux ports to choose from: desmume gtk+, desmume glade, and a desmume command line port. This manual is about the glade port. You can start it by typing 'desmume-glade' on the command line.
When you start the emulator for the first time, you probably just want to play a certain game. You can do this by going to 'File' in the menu, and selecting 'Open'. This will open up an explorer window, within which you can browse to the rom (nds file) that you wish to play. Once the game has finished loading (and this should only take a few seconds at most), the game will start automatically.
Command Line Options
This port of desume has several command line options, which will be listed here :
--load-slot=NUM
Loads savegame from slot NUM
--soft-convert
Use software colour conversion during OpenGL screen rendering. May produce better or worse frame rates depending on hardware.
--3d-engine=ENGINE
Select available 3d emulation: 0 = 3d disabled 1 = internal desmume software rasterizer (default) 2 = osmesa or gtkglext opengl (if available, depending on compilation options, see desmume --help)
--disable-limiter
Disables the 60 fps limiter
--arm9gdb=PORT_NUM
Enable the ARM9 GDB stub on the given port
--arm7gdb=PORT_NUM
Enable the ARM7 GDB stub on the given port
-h, --help
Show summary of options.
-v, --version
Show version of program.
Menu Layout
The rest of this manual will be spend on explaining all the other options in the menu.
File Menu
File | Open
This option let you open and start a commercial or homebrew application.
File | Save State
This option lets you savethe state / condition the emulator is currently in.
File | Load State
This option lets you load a previously saved state / condition of the emulator.
File | print Screen
This option let's you take a quick screen print of the current emulation windows.
File | Quit
This option lets you exit the emu8lator
Emulation Menu
Emulation | Execute
This option start running, or emulating, the rom file you loaded via the file menu.
Emulation | Pause
This option lets you pause or 'freeze' the emulation or execution of the current rom.
Emulation | Reset
This option resets the currently loaded rom right back to the start, as if you just opened and executed the rom.
Emulation | Layers
The Nintendo DS display is made up of several different 'layers', and this option lets you choouse which layers you do or don't want to see. This is especially usefull when debugging a problem, and finding out in which layer the bug occurs.
Emulation | Frameskip
This option lets you determine how many frames to 'drop', or not display during the emulation. The default is 'zero', which means display all frames. If you are experiencing speed problems, you can try to see if skipping frames helps speed up the execution, in favor of the accuracy of drawing all frames.
Emulation | Size
This option lets you resize the desmume windows.
Config Menu
Config | Saves
This option lets you select the savetype of the rom. The default is 'automatic', whihc is sufficient in most cases. However, the automatic detection option is not perfect, and you may find it necessary to set this option manually.
Config | Keyboard controls
This option let's you define the keyboard controls, and map the Nintendo DS controller buttons to buttons on the keyboard.
Config | Joystick controls
This option let's you configure your joystick.
Config | Audio on
This option lets you turn the audio emulation on or off.
Config | True Gap
This option displays a free space or 'gap' between the two panels. It is roughly the same size as on a real Nintendo DS.
Config | No Gap
This option disables the disoplay of a 'gap' between the two panels.
Config | Right Screen
Selecting this option moves the bottom panel to the right of the upper panel, instead of below it.
Config | Rotate screen 0
This option disables screen rotation.
Config | Rotate screen 90
This option rotates the panels 90 degrees.
Config | Rotate screen 180
This option rotates the panels 180 degrees.
Config | Rotate screen 270
This option rotates the panels 270 degrees.
Tools Menu
Tools | Io regs
This option lets you view the IO registers of the emulated Nintendo DS.
Tools | View Memory
This option lets you view the memory of the emulated Nintendo DS.
Tools | View Palette
This option lets you view the palette of the emulated Nintendo DS.
Tools | View Tiles
This option lets you view the tiles of the emulated Nintendo DS.
? Menu
? | About
This option displays the version of desmume that you are using.