Common Setup Procedures

Current Emulator Setup

Many of the settings are persistent. The sound, cycle timing, and video preferences are saved to a file "XGS-Mac Preferences" in your Preferences Folder.
The default disk image configuration set is saved to "iGS ConfigSet" in your Preferences Folder.

The emulator requires at least 5MB since, each 3.5" disk in s5dx can take up 2.6MB of RAM.

See the file "Setup01-ROM Extraction" for a description of how to extract the ROM image.
See the file "Setup02-Disk Images" for information on converting and creating disk images.


Common Naming Convention Suffixes

 "*.2mg" (the new'2IMG' format)
 "*.dc"  (DiskCopy 4.2 format)
 "*.dsk" (DOS 3.3 Order format) or "*.do"  (DOS 3.3 Order format)
 "*.po"  (ProDOS Order format)  or "*.raw" (ProDOS Order format)

The Mac OS port expects the file "xgs01.rom" and/or "xgs03.rom" to be in the XGS application directory.


Keyboard/Menu Layout

To use the Mac menu shortcuts, press Command-Shift and the desired shortcut key.
See the below chart for all implemented shortcuts and their purpose:

----File Menu-----
Command-Shift-A   Save As...: Save the Video screen to a PICT file.

Command-Shift-W   Close: Close the frontmost window.

Command-Shift-P   Print Window: Print the contents of the GS Video screen.

Command-Shift-Q   Quit: Exit XGS-Mac. This may be a problem if you attempt to run
(or control-end)        XGS-Mac from the BlueBox, since this will exit the BlueBox.

----Edit Menu-----
Command-Shift-C   Copy GS Video: Copies the contents of the GS Video to the Mac
                  Clipboard.

Command-Shift-T   Copy Text Screen Contents: Copies the contents of the GS text screen
                  to the Mac Clipboard.

-----CPU Menu-----
Command-Shift-H   Update Hardware More Often: When unchecked, XGS runs at a constant
                  clock period of 64 cycles, this may improve the performance on
                  slower computers. When checked, XGS attempts to update the video,
                  keyboard, and sound routines 50 times per second, so they are
                  better coordinated.

----Input Menu----
Command-Shift-M   Toggle Mouse: When checked, your mouse will act identically to 
(or F5)           an Apple IIGS mouse. When unchecked, your mouse will be returned to
                  a Mac cursor so you can navigate the menus (except when
                  Full Screen is activated).

Command-Shift-J   Toggle Joystick: When checked, your mouse will act identically to 
(or F6)           a joystick or paddle. When unchecked, your mouse will be returned to
                  a Mac cursor so you can navigate the menus (except when
                  Full Screen is activated).

----Sound Menu----
Command-Shift-S   Enable Sound: When checked, the GS's audio is emulated and you will
(or F8)           then be able to record sound samples to the gsSound.aiff file.
                  On slower computers, you may want to keep this unchecked. It will
                  bypass the sound routines which are fairly processor intense.

Command-Shift-R   Record GS Sound To AIFF: When checked, recording is in progress to
(or F7)           the gsSound.aiff file in the XGS-Mac application directory. When
                  unchecked, recording is paused until toggled again.

----Video Menu----
Command-Shift-U   No Video: In certain programs, selecting this option will 
(or F4)           improve sound output since the CPU can concentrate on sound output
                  instead of video redraw.

Command-Shift-M   Full Screen: When activated, XGS-Mac will directly draw to your
(or F3)           screen. This will improve video performance twofold. To go back to
                  using windows and menus, press Command-Shift-F again.


Emulator Keyboard Layout

The below is taken from the General "INSTALLATION" file.
Most of these options are implemented in the menus.

Control-End		         Quits (ends) XGS.
Control-Home		        Sends a "soft reset" or Control-Reset to the emulator.
Command-Control-Home	 Sends a "hard reset" or Command-Control-Reset to the emulator.
Control-PageUp		      Turns on trace mode. Does nothing for now.
Control-PageDown	     Turns off trace mode. Does nothing for now.

Pause/F15	Sends a Non-Maskable Interrupt (NMI) to
									 the emulator. This is a guaranteed way
							 		to get into the monitor and poke around.
						 			This also dumps a copy of banks $00 and $01
						 			into banks $E8 and $E9 for debugging	purposes.


FKey Mappings
F1			     Switch to a 640x400 window.
F2			     Switch to a window with a border.
F3			     Toggle full screen.
F4			     Toggle video redraw.

F5			     Toggle mouse.
F6			     Toggle joystick.
F7			     Toggle Record to AIFF.
F8			     Toggle Sound enable.

F9        Increment Frame Skip Rate.
F10       Decrement Frame Skip Rate.
F12       Hits the GS's Keypad Enter key.
F15       Throw NMI. (See above description)