6. Popup menu

By clicking the right button menu anywhere on the main window, you gain access to the functionnalities of the emulator. If you let your mouse cursor on the item during some while, a tooltip will appear.
On iPAQ, you have to touch-point on the LCD region.

The menu is organized as follow :


6.1 Link

This is a large topic which is covered elsewhere. See the corresponding section...

The Send file to TiEmu item will let you choose a file to load into the emulator. You can choose one or several files at a time.

The Link options item open a dialog box. This is discussed elsewhere.

The Receive file item let you enabled (checked) or disable (unchecked) the receiving of variables from TiEmu. Use it if your program access the linkport for sound.

6.2 Configuration and State

You can save or load a particular configuration. A configuration contains the current parameter of the emulator (emulator image to use, size of window, link cable type, ...). It does not contain any informations on the calculator state. The configuration is saved in the tiemu.ini file. This is a text file and its format is described in the command lin e section.

The calculator state can be saved, loaded or reverted. The state is saved in a file containing an image of the calculator content (LCD, registers, memory, ...).
This can be done at any time. The revert option is useful to reload the latest saved state.

6.3 Debugger

This is a large topic which is covered elsewhere. See the corresponding section...

Reset calc : this completely resets the calculator (erase all). This is like you removed batteries for a while.

Upgrade calc : allow you to load a TI's OS FLASH upgrade into the calculator without needing to send it. If you save the calculator state, TiEmu will remind the upgrade and load it after image at startup.

6.4 Options

Set ROM version : let you choose an existing image from a list. If you want to add an image, click the Import button to convert a ROM dump or a FLASH upgrade into an image.
Note : TiEmu scans the images folder whenever you run this box.



Misc options :
- restrict to actual speed : if checked, TiEmu will run hand-held at its nominal speed. Else, it will run it at the maximum the CPU is capable.
- HW protection : if checked, the HW protection device is enabled and emulated. TiEmu need to be restarted (or an image to be load) for changes to take effect.
- normal view : display skin and/or lcd with a 1x ratio,
- large view : same with 2x ratio (note: until I fix this, it's CPU intensive),
- full screen : display LCD only and make it fit the screen (note: until I fix this, it's limited to 3x ratio because excessively CPU intensive).

Skin for current calc : none, default, other.
The first option let you remove the skin to just display the LCD. In this mode, you keep access to the right menu but you have to use keyboard for TI keys :



The second option make TiEmu fall back on the built-in skin.
The third option let you choose a skin of your own. It must be a TiEmu compatible skin (see the Skin section) else it will be rejected.

6.5 Infos

Misc : give you access to this help and ManPage, ChangeLog, About.

Info : enumerates current calculator informations like this :



6.6 Exiting

Exit and save state : TiEmu will save both state and configuration before exiting.

Exit without saving state : no comment !