DeSmuME Manual for the Linux GTK+ port

From DeSmuME
(Difference between revisions)
Jump to: navigation, search
(Config | Edit Controls)
(Tools | IO Regs view)
Line 100: Line 100:
  
 
==== Tools | IO Regs view ====
 
==== Tools | IO Regs view ====
 
+
This option lets you view some of the the ARM7 and ARM9 I/O registers.
 
+
  
 
=== Help Menu ===
 
=== Help Menu ===

Revision as of 10:15, 9 April 2009

Contents

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 gladde, and a desmume command line port. This manual is about the GTK+ port. You can start it by typing 'desmume' 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), you need to start the game. You can do so by choosing 'Emulation|Run' from themenu, or by clicking on the 'Run' button.


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

--opengl-2d

Enables using OpenGL for screen rendering

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

Disables the sound emulation

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

--cflash=PATH_TO_DISK_IMAGE

Enable disk image GBAMP compact flash emulation

-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 lets you browse to and selct a rom file to open in the emulator.

File | Take a screenshot

This option lets you take a quick screenshot of the curtrent display in the emulator windows.

File | Quit

Selecting this option terminates the emulator.

Emulation Menu

Emulation | Run

After you have opened a riom file, you need to start (run) it. This menu option does that. Alternatively, you can press the 'Run' button.

Emulation | Pause

Choosing this option causes the emulation to 'freeze', or pause.

Emulation | Reset

Selecting this option resets the rom file you opened, and makes it start at the very beginning just as if you just opened and ran the rom.

Emulation | Enable Audio

This option lets you choose, by placing a checkmark, if you want to hear audio or not.

Emulation | Frameskip

This option lets you select how many frames should not be displayed, in order to gain speed improvements. If you have speed problems, you could decide to skip (not display) one or more frames in order to improve the speed.

Emulation | Layers

This option lets you view the Layers one by one.

Config Menu

Config | Saves

This option lets you specify the save type of a particular game. The default is 'autodetect'. However, this is not fail-safe in all cases, so you might need to manually select one of the other savetypes.

Config | Edit Controls

This option lets you configure keyboard keys.

Tools Menu

Tools | IO Regs view

This option lets you view some of the the ARM7 and ARM9 I/O registers.

Help Menu

Help | About

Personal tools