`iGS-Mac (improved XGS-Mac)`

`XGS-Mac 0.53 Port Notes`

`http://www.uiuc.edu/ph/www/m-bytnar/XGS-Mac/`

`What is it?...`

An Apple IIgs emulator originally written for X11 which has now been ported to
MacOS. See the other release notes for the status of the features/changes in
the emulator core. These notes will explain changes/additions to the Mac OS
front-end ONLY.

Please read this entire file!
Also see the other read me files for information on the emultor core.

`Current Features`

The user interface is improving each new release.
See "To-Do.MacOS" for interface changes&additions.

`File Descriptions`

"iGS-PPC" or "iGS-68K"	- The compiled port of XGS. Choose the archive that fits your CPU.
"xgs03.rom"	- The ROM03 image that you provide. See the file "Setup Procedures" for the ROM Extraction Procedure.
"xgs03.ram"	- The battery RAM file created by the emulator.
"xgs01.rom"	- The ROM01 image that you provide. See the file "Setup Procedures" for the ROM Extraction Procedure.
"xgs01.ram"	- The battery RAM file created by the emulator.
* You need at least one of the ROM files to boot XGS.

"Quick_Setup_Instructions.html"	- A file describing essential files to get XGS up and running quickly.
"README.MacOS.html"	- This read me file.
"ExtraDocs:00Setup-Procedures.txt"	- The file describing the procedures you must do to get XGS up and running.
"ExtraDocs:01Setup-ROM Extraction.txt"	- How to extract your ROM.
"ExtraDocs:02Setup-Disk Images.txt"	- How to create/find/use disk images.
"ExtraDocs:CHANGES.txt"	- The list of changes made to the core in the past.
"ExtraDocs:COMPATIBILITY.txt"	- The list of compatible programs.
"ExtraDocs:iGS-FAQ.txt"	- Commonly asked questions.
"ExtraDocs:iGS-History.txt"	- Revison History starting with iGS 0.53r2
"ExtraDocs:INSTALLATION.txt"	- The General XGS installation instructions file.
"ExtraDocs:rom01dump.exec"	- A helper file for extracting the GS ROM01 image.
"ExtraDocs:rom03dump.exec"	- A helper file for extracting the GS ROM03 image.
"ExtraDocs:TO-DO.txt"	- What is in the future of XGS's core.
"ExtraDocs:_Old_TO-DO.MacOS.txt"	- Revison History through XGS 0.50r3.

System Requirements

* A higher end PowerMac or a 68040 Macintosh.
Although I include a 68K version of this port, the emulation will be slow!
* Any Macintosh keyboard. (An Extended keyboard would be prefered,
so you can use the FKeys.)
* The IIGS ROM. (ROM01 or ROM03)
To legitimately run this emulator, you must own an Apple IIgs so that you
can extract the ROM (XGS supports both ROM versions.)
See the "Setup Procedures" for the ROM Extraction Procedure.
Do not ask me to send the IIGS ROM to you. It is copyrighted.
* A System Disk or some other disk to boot the GS.

Do not ask me to send a boot disk to you.
You can legitimately find GS/OS System 6.01 for FREE at:
ftp://ftp.support.apple.com/pub/apple_sw_updates/US/AppleII/
See the file "Setup Procedures" for the Disk Image Conversion Procedure.

New Features in iGS 0.53r2

(or features added since XGS-Mac 0.50r3):
* Drag & drop disk mounting!
* Disk selections are preserved between launches.
* iGS-Bug: A CPU core debugger to trace opcodes at a level lower
than the original GSBug.
* Menu settings preserved between launches.
* Settings dialog greatly improved over 0.50 and earlier releases.
* Choose between ROM 01 and ROM 03 roms from the Setup Dialog.
Missing ROM files: no ROMs = error message and quit.
Either ROM file not found: the corresponding menu item is disabled.
* Configurable RAM settings in the Settings dialog.
Yes! All the way up to 8MB, without changing the application
memory settings.
* RAM is now allocated in the System Heap, reducing the application
memory footprint by over 3.5MB.
* Copy GS Text Screen contents to the clipboard -as text-.
* During XGS init time, if a disk image is not found, the disk is
not attempted to be loaded. (This avoids hanging the application
and allows you to drop images into the drive window once it boots.)

Features:

* "Print", "Copy to Clipboard", and "Save to PICT"
commands for the GS Video screen.
* 16bit or 8bit sound at 28KHz.
* Record the sound output to disk.

Internal Improvements:

* Eliminated the "xgs40.fnt" and "xgs80.fnt" files.
* Added French font support into the code.
* Redesigned all of the client-related interfaces.

DISCLAIMER & LEGAL STUFF:

XGS-Mac also known as iGS or iGS-Mac (hereafter named "Software") is still in
development. Do not run this software on machines with important or critical
data. I cannot guarantee stability-this Software may crash your Mac... It may
even crash your virtual GS.
In any case, I am not liable for any data loss due to this Software. You have
been warned. However, in my testing, this Software has worked reliably. Your
usage of this Software constitutes an agreement to these terms.

You may distribute this Software so long as you do not sell it (selling a CD
of freeware and shareware does not qualify as selling it). All I ask is that
you keep this file intact.

Bugs, Comments, Questions, etc...

If you have any comments, questions, or suggestions regarding the
Mac OS port of XGS, feel free to email me at the below address.