DeSmuME Manual for the Linux Glade port

From DeSmuME
(Difference between revisions)
Jump to: navigation, search
(= File | print Screen)
(Completed adding descriptions to the menu options.)
Line 52: Line 52:
  
 
==== File | Load State ====
 
==== File | Load State ====
This option lets you load a previuosly saved state / condition of the emulator.
+
This option lets you load a previously saved state / condition of the emulator.
  
 
=== File | print Screen ===
 
=== File | print Screen ===
This option let's you take a quick screen porint of the current emulation windows.
+
This option let's you take a quick screen print of the current emulation windows.
  
 
==== File | Quit ====
 
==== File | Quit ====
 +
This option lets you exit the emu8lator
 +
  
 
=== Emulation Menu ===
 
=== Emulation Menu ===
 
  
 
==== Emulation | Execute ====
 
==== Emulation | Execute ====
 
+
This option start running, or emulating, the rom file you loaded via the file menu.
  
 
==== Emulation | Pause ====
 
==== Emulation | Pause ====
 
+
This option lets you pause or 'freeze' the emulation or execution of the current rom.
  
 
==== Emulation | Reset ====
 
==== 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 ====
 
==== 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 ====
 
==== 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 ====
 
==== Emulation | Size ====
 
+
This option lets you resize the desmume windows.
 
+
 
+
 
+
  
  
Line 88: Line 86:
  
 
==== Config | Saves ====
 
==== 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 ====
 
==== 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 ====
 
==== Config | Joystick controls ====
 
+
This option let's you configure your joystick.
  
 
==== Config | Audio on ====
 
==== Config | Audio on ====
 
+
This option lets you turn the audio emulation on or off.
  
 
==== Config | True Gap ====
 
==== 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 ====
 
==== Config | No Gap ====
 
+
This option disables the disoplay of a 'gap' between the two panels.
  
 
==== Config | Right Screen ====
 
==== 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  ====
 
==== Config | Rotate screen 0  ====
 +
This option disables screen rotation.
  
==== Config | Rotate screen 90 ====
+
==== Config | Rotate screen 90 ====
 +
This option rotates the panels 90 degrees.
  
 
==== Config | Rotate screen  180 ====
 
==== Config | Rotate screen  180 ====
 +
This option rotates the panels 180 degrees.
  
 
==== Config | Rotate screen  270 ====
 
==== Config | Rotate screen  270 ====
 +
This option rotates the panels 270 degrees.
  
  
Line 120: Line 122:
  
 
==== Tools | Io regs ====
 
==== Tools | Io regs ====
 
+
This option lets you view the IO registers of the emulated Nintendo DS.
  
 
==== Tools | View Memory ====
 
==== Tools | View Memory ====
 
+
This option lets you view the memory of the emulated Nintendo DS.
  
 
==== Tools | View Palette ====
 
==== Tools | View Palette ====
 
+
This option lets you view the palette of the emulated Nintendo DS.
  
 
==== Tools | View Tiles ====
 
==== Tools | View Tiles ====
 
+
This option lets you view the tiles of the emulated Nintendo DS.
  
 
=== ? Menu ===
 
=== ? Menu ===
  
 
==== ? | About ====
 
==== ? | About ====
 +
This option displays the version of desmume that you are using.

Revision as of 11:07, 10 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 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.

Personal tools