This text file was converted from MSW v6.0 - it may not be complete.
See the actual file contained inside of the xgs32_10.zip archive.


Running XGS/32

Once you have selected a boot disk image, click the RUN button. If you have not
installed XGS/32 properly, and error message will be displayed. If you followed
the directions above, and still get this error message, please email me, and I
will attempt to help you.

Ok, XGS/32 Is running, now what?

	Here is a keypress chart that summarizes what you can do...

		Special Key Mappings:
		
			PC Keyboard 		Apple IIgs Keyboard
			
			Alt			Open Apple
			F1			ESC
			F2			Closed Apple
			
		Special Function Keys:

			F8	Turns On Mouse
			F9	Turns Off Mouse
			F12 	Terminates Emulator	
			Pause	Switches Back to the Desktop (Emulator Becomes Inactive)
		

Known Problems


o Direct/X is funny on some machines. If you pause the emulator, and then
attempt to resume XGS will occassionally fail to redraw the screen. Intersting,
eh? 

o Slot based drive assignments do not work yet.

o Joystick does not work yet.

o Most everything doesn't work yet.


	If something doesn't work, EMAIL ME.

Contact Info

	If you need to get a hold of me for some reason...

		email: smentzer@ecom.net

	Look for updates at:

		http://members.ecom.net/~smentzer


XGS/32
Emulator Core Ehancements/Win32 Code/Usability
(c) 1998 Steven W. Mentzer/MudFlap! Software

Original Emulator Core
(c) 199? Josh Thompson

XGS/32 v1.0 Documentation


DISCLAIMER:

This software is VERY BETA. It is riddled with bugs and inconsistencies. It is
known to crash for no reason. Some people have even reported this software as
being a great way to euthanize small farm animals. I take no responsibility for
the actions of this software, or the little gremlins contained within.

Having said that, it should be noted that there is very *little* error checking
being done at this time. If you type in an incorrect file name, the software
will most likely crash. Deal with it.


What is XGS/32?

XGS/32 is a Win32 Native port of the original XGS core written by Josh
Thompson. The majority of the existing XGS core is still intact, but I have
made several improvements to the operation of the core in my quest for a Win32
based Apple IIgs emulator.

Over the next few months, several enhancements will be made to the XGS/32 core
which are detailed below:

System Requirement(s)

	o	Windows NT v4.0 (Service Pack 3)
	o	Pentium 133 or better
	o	32 MB RAM
	o 	~4MB hard disk space.
	o 	Installed Mouse
	o 	VGA card/monitor that can handle 800*600*256 running DirectX in full screen 
	    mode.
	o	A little patience.

	Note: This version of XGS/32 WILL NOT run under Windows 95/98. It will most likely
	never run under either of these platforms.

How Do I Install XGS/32?

Installing the XGS Server is simple. At this point, you should already have all
of the necessary files extracted to a directory some place on your hard disk. I
would recommend putting the XGS/32 files in the c:\xgs32 directory. You can
keep the files in any directory you want. But, it is best to keep things
simple.

Once you have the files in a suitable directory, there is a special support DLL
that you may need to register. I say that you may need to install it because
some machines have it pre-installed where some do not. This file is called
ATL.DLL, and is located in the XGS32 directory.

To determine whether or not you need to install it, go to the xgs32 directory,
and type "regsvr32 xgs32.dll" (without the quotes). If a dialog box presents
itself stating that "DLLRegisterServer xgs32.dll succeeded", then you are A-OK.
If not, you need to type the following from the command line.

"xcopy atl.dll c:\winnt\system32"  (without the quotes, where c:\winnt is where
you installed 	windows NT). "regsvr32 c:\winnt\system32\atl.dll"

Now, type "regsvr32 xgs32.dll". It should succeed. If not, please email me at
smentzer@ecom.net detailing the exact response the regsvr32 utility gave you.
If you do not provide this information, I propably cannot help you.

Once this is all done, set up a shortcut to the xgs32.exe program, and run it!

Configuring XGS/32

When you run XGS/32 for the first time, it will create a "default" configuration
for you. You will need to go to each of the sub-menus under "Options" and
change the settings to fit the directory where you installed xgs/32 to. Each
option is listed below.

	Hardware/Total RAM:	This is the amount of  RAM that is installed in the virtual 
	IIgs.
	Hardware/Enable Sound:	Turns on Sound if checked. Not recommended.
	Hardware/Pause Emul...:	When checked, the emulator will pause when not active.
	
	Files/ROM Image:	The ROM image file you want to use.
	Files/40 Column Font:	The filename that contains the 40 column font info.
	Files/80 Column Font:	The filename that contains the 80 column font info.
	Files/BRAM File:		The filename you want to use for battery-ram.
	
	Debug/Enable Debug..:	If checked, a DEBUG file is created. Not recommended.
	Debug/File Name:		The file name of the DEBUG file.

After the "options" have been configured, you must select a disk image to use. 
The default boot devi