vMac 0.18e Win32
Win32 port by Weston Pawlowski, Bill Miller, and Ryan Hill

*SECTIONS*

-Introduction
-Requirements
-vMac Win32 Port Credits
-Changes
-Included Files
-Problems & Limitations
-More Information
-Legal Stuff

*INTRODUCTION*

vMac is a MacPlus emulator, which means it runs Macintosh programs on your
computer! This is a very early version (0.18), so there are a some problems,
but it can still run many Mac programs. This is the Win32 port, you can get
ports for other operating systems from the vMac Web Site.

Get current versions, info, and utilites for vMac from:
vMac Web Site: http://www.vMac.org

If that doesn't work, try:
http://Leb.net/vmac

Questions, suggestions, and bug reports for the Win32 port: WDP22@Juno.com
You can also send bug reports from the vMac Web Site.


<HFV Explorer>
You can read/write/format Mac disks, read Mac CD-ROMs, copy files between Mac
disks, copy files between Mac disks and your PC's drives, and more with a
great utility named HFV Explorer.

*REQUIREMENTS*

vMac Win32 should run on these operating systems:

-Windows 95 (works)
-Windows NT (works under 4.0, untested under other versions)

You need a bootable HFV/DSK file named disk1.dsk. It will run System 6.0.8,
and probably some other versions. You can get DSK files for free from the
vMac Application Site.

*Info: A HFV/DSK file is a disk image with out the first 84 bytes, a disk
image to HFV/DSK converter is available on the vMac Web Site.

You need a ROM image from a REAL MacPlus that YOU own in a file named
vMac.ROM. Get the program named CopyROM from the vMac Web site, then read the
file named vMac_ROM.txt for instructions. Once you get this ROM image, do NOT
distribute it!

Other System Requirements:
-486
-640x480 SuperVGA
-8MB RAM
-Mouse
-Installation of DirectX 2.0 or higher

*Info: Your hardware shouldn't have to be DirectX compatible, DirectX 2.0 or
higher just needs to be installed. You should be able to download the latest
version of DirectX from http://www.Microsoft.com/DirectX

Recommended:
-Pentium 133 or better computer
-16MB RAM
-The newest version of DirectX
-DirectX compatible graphics hardware

*VMAC WIN32 PORT CREDITS*

Win32 port by Weston Pawlowski, Bill Miller, and Ryan Hill

Other people who made stuff for vMac Win32:

This is not the credits for all of vMac. This is only an addition
to the vMac credits.

Philip "PC" Cummins - RTC code that uses the correct time and date
Bill Huey - Bug fix that lets us copy small files
Andre Masella - .inf installer script
Lauri Pesonen - 1.4MB Mac floppy and Mac CD-ROM code
Tommy Rinaldo - Original Word 6 (.DOC) ReadMe_W file
Yoav Shadmi - Interface for 1.4MB Mac floppy code
Adam Strohl - Graphics
Pat Suwalski - Graphics

See the splash screen for the vMac credits

*CHANGES*

<0.18e>

-Able to turn sound off
-Mode option for when vMac has trouble
-Fixed sound bug (vMac doesn't crash when it can't init the sound)
-Fixed ROM bug (All MacPlus ROMs should work now)
-Fixed error bug (vMac removes itself from memory after some errors are shown)
-Quiet floppy code (No more complaining about floppy drive problems)
-Able to copy small files between disks! (Thanks to Bill Huey)
 (Max file size is between 61k and 75k)
-Fixed floppy bug (Can write to real Mac floppies again)
-Fixed some UI bugs
-Small speed increase
-Right mouse button toggles mouse clipping

<0.18d>

-RTC uses the correct time and date
-Fixed memory bug! (2mb and 4mb work now)
-New Splash Screen
-New DSK file icon
-About shows the splash screen instead of a dialog box
-Emulated 1/60sec interrupts are timed properly, which can make vMac faster
-Full support for 1.4MB Mac floppies!
-Support for DirectX! (it makes vMac really fast)
-Rearranged this file
-Changed vMac.cfg to vMac.ini
-Minimal support for Mac CD-ROMs!
-Better keyboard support!
-Sound!
-New user interface!
-Auto shutdown feature
-Improved clicking, double clicking, and dragging
-Remembers window position
-Installer
-No more vMac.dat, everything is in the EXE
-Uses some assembly code to increase speed!
-Faster memory functions!
-User configurable interrupt timing
-User configurable maximum FPS (set emulation speed vs video smoothness)

<0.18c>

-Icon bar instead of vMac menu
-Shows a ROM with a flashing X on it when there is a problem with the ROM file
-After you run vMac Win32, it gives .ROM and .DSK files an icon
-Common dialog box for inserting disks (instead of inserting disks 1-4)
-Fixed bug that prevented using paths with spaces
-Draws splash screen faster
-No more Splash.dat, now its vMac.dat - it contains the splash screen, ROM
 pictures, and icon bar
-No longer runs on Windows 3.1/3.11 with Win32s - it always ran poorly under
 Win32s anyway
-Real Time Clock runs at real time
-Its a bit faster

<0.18b>

-Fixed system resource bug that causes ALL Mac apps to eventually crash
-Can have 4 disks, that you can insert into either of the 2 emulated drives
-New Icon

<0.18a>

-Runs faster! (Due to the faster screen and some other changes I made)
-Faster screen! (no longer draws Mac screen one pixel at a time)
-Can write to disks!
-Better mouse tracking and clicking (not perfect yet)
-Pull down menu where you can insert disks, interrupt, reset, or exit
-This file available in Plain Text (TXT) and Word 6/WordPad (DOC)

*USAGE*

There are some bugs, so you should see the section *PROBLEMS & LIMITATIONS*
if you have problems.

Some of these features also have commands on the pull down menu under windowed
mode. For example, to insert Mac floppies and/or CD-ROMs you can press F2, or
you can go to the File menu, and select Check for Mac floppies and CDs.

<Mode>

See the section *PROBLEMS & LIMITATIONS* for info.

<Mouse Clipping>

You can use the right mouse button to toggle the mouse clipping. When mouse
clipping is on, the mouse cursor will not move outside of the vMac screen,
when mouse clipping is off, the mouse cursor can move freely.

<DirectX>

To use DirectX mode, you must have DirectX 2.0 or higher installed, edit
vMac.ini and set DirectX = 1. When vMac is running, you can switch between
windowed mode and DirectX mode by pressing F8. Under Windowed mode you can
go to the File menu, and select DirectX mode.

<Mac Floppies>

To use Mac floppies, you must have a 1.4MB (high density) Macintosh floppy
in drive a: or b:. It will automatically scan for Mac floppies when it starts
the MacOS. You can also insert Mac floppies by pressing F2. If you use DSK
files that aren't bootable, it will try to boot from a Mac floppy, if there
is one in the drive. Once the MacOS has inserted a floppy, do NOT remove it
from the drive, until the MacOS ejects it. You can make the MacOS eject a
disk by dragging it's icon into the trash can. A message box will tell you
when you may safely remove the floppy disk.

<Mac CD-ROMs>

To use a Mac CD-ROM, put it in your CD-ROM drive. When vMac scans for Mac
floppies, it also scans for Mac CD-ROMs. So, it will scan for Mac CD's when
the MacOS is starting, and when you press F2. Once the MacOS has inserted a
CD, do NOT remove it from the drive, until the MacOS ejects it. You can make
the MacOS eject a CD by dragging it's icon into the trash can.  When a CD is
properly ejected, a message box will tell you that you may remove the CD from
the drive.

With most CD-ROM drives:
vMac will make it actually eject the CD, when the MacOS ejects it.

With most CD-ROM drives, under Windows 95:
When you insert a CD into your CD-ROM drive, vMac will detect it, and notify
the MacOS. Until you use the MacOS to eject the CD, vMac will attempt to keep
you from removing the CD from your CD-ROM drive. WARNING: If you eject a CD
without ejecting it using the MacOS first, the CD tray may come out and go
back in. If this happens, do NOT attempt to remove the CD from the drive, you
may damage your CD or CD-ROM drive, and you may get your hand or fingers
caught in your CD-ROM drive! When a CD is not properly ejected, it will show
a message box telling you to not remove the CD from the drive.

<Keyboard>

In the vMac.ini file, you can choose the key configuration. KeyConfig 1 is
the default, left control is command, and right control is option. KeyConfig 2
is for notebook computers that only have one control and one alt key, alt is
command, and control is option.

<Autoquit feature>

When vMac detects the "You may now switch off your Macintosh safely" screen,
it can automatically quit. This feature hasn't been fully tested, so if
vMac starts quitting when it's not supposed to, edit vMac.ini and set
AutoQuit = 0

<Options>

To set vMac options, edit the file vMac.ini (it will be automatically be
generated when vMac is run for the first time). The interrupt timing, max FPS,
and window position is stored in the registry. Under windowed mode, you can
adjust all of these.

*INCLUDED FILES*

vMacW32.exe - vMac program
CDEnable.vxd - File required for reading Mac CD-ROMs under Windows 95
               (MUST be in Windows\System folder. The installer should
                copy it to the Windows\System folder for you)
CDEnable.sys - File required for reading Mac CD-ROMs under Windows NT
               (MUST be in System32\Drivers folder. The installer should
                copy it to the System32\Drivers folder for you)
ReadMe_W.txt - This file
ReadMe_W.doc - This file in Word 6/WordPad format
vMac_ROM.txt - Instructions for getting a ROM image
WebSite.url - Short cut to the vMac Web Site

The below files aren't needed after you install vMac, and won't be
copied when vMac is installed:

READ ME FIRST.txt - Instructions for installing vMac
Setup.exe - Installation program
Install.inf - Installation script

*PROBLEMS & LIMITATIONS*

<Mode Option & Getting vMac to work>

The mode option is in the vMac.ini file, set it to 0 if everything is working.
Set it to 1 if vMac has problems, like it crashes, freezes, won't use your ROM
image, won't start, won't use Mac floppies, or won't use Mac CDs.

If vMac won't use your ROM image:

Set mode to 1, and vMac will override the ROM check. It will allow you to use
any 128KB ROM image, even if it isn't for a MacPlus. But, only MacPlus ROM
images should work, other ROM images should not work and may cause problems.

If vMac won't use Mac floppies, or won't use Mac CDs:

Set mode to 1, press F3 before you have it check for disks and CDs, write down
all of that info. Insert the Mac floppy or CD, tell vMac to check for Mac
disks and CDs (press F2 or use menu), press F3, and write down all of that
info. Then, E-Mail all of the info you have written down to WDP22@Juno.com
and include a description of your problem, and information about your
computer. You can also do this by going to the bug report option on the
vMac Web Site.

If vMac crashes, freezes or won't start:

If setting mode to 1 doesn't fix your problem, you should edit the vMac.ini
file, and set: FrameRate=1, DirectX=0, Floppy=0, CD=0, FileIcons=0,
KeyConfig=1, AutoQuit=0, Sound=0, Mode=1, and RAMSize=1. If vMac works after
you do that, then change one option back to how you want it, and see if vMac
works. If vMac doesn't work, then you have found the problem. But, if vMac
still works, keep changing the options back to what you want, one at a time,
until you find the problem.

<Problems>

-It has trouble with clicking and double-clicking!
I'm working on fixing this, but for now you have to hold down the mouse
button a bit longer than normal. It is possible to double-click, but it may
be easier to go to File - Open or press Command O. Using the DirectX mode
can eliminate this problem.

-Modifier keys (Shift, Command, Option) don't work very well
This is because of the way the keyboard is currently implemented. A new
keyboard interface should be implemented soon, it will fix this problem.

-Can't use 800k Mac disks
It's impossible to read 800k Mac disks without special hardware, because of
a limitation in the floppy controller.

-Many Mac CD-ROMs don't work or have problems
The way that reading Mac CD-ROMs is currently implemented, makes them appear
the same as DSK files and Mac floppies. This is the cause for many problems
when using Mac CD-ROM's. I can implement it better when vMac has SCSI
emulation.

-Can't copy files between disks, format disks, or install the MacOS
It is being worked on, and hopefully, it will be completely fixed soon.

You can read/write/format Mac disks, read Mac CD-ROMs, copy files between Mac
disks, copy files between Mac disks and your PC's drives, and more with a
great utility named HFV Explorer.

-Can't use System 7 or higher
I believe that the reason vMac can't boot System 7 is because of the lack
of SCSI emulation. It is being worked on, and hopefully, it will be fixed
soon.

*MORE INFORMATION*

<vMac's Code>
vMac is written in C, some ports also use C++ and/or assembly. The Win32 port
was written mostly in C, but there is some C++ and a little assembly.

<CPU Emulation>
vMac uses the 68000 CPU emulation code from UAE, it is an interpreter written
in C. Some people on the vMac team are working on writing our own 68040 CPU
emulation core called IceCube, but I have no idea when that will be
implemented. Check the IceCube section on the vMac Web Site for more
information.

<24-bit>
vMac emulates a MacPlus, which is a 24-bit Macintosh. Versions of the MacOS
that are newer than System 7.5 require a 32-bit Macintosh. So, the newest
version of the MacOS that vMac could run is System 7.5.

*LEGAL STUFF*

<Notice>

You MUST get the ROM image from a MacPlus that YOU own, and do NOT distribute
it. The vMac Team will NOT even consider helping anyone pirate MacPlus ROM
images or any other software, so don't bother asking!

<Copyrights>

vMac is Copyright 1997 Philip Cummins and The vMac team. The UAE engine, which
vMac's core is based on, is copyrighted by the UAE team. In addition to vMac
core copyrights, each port author reserves the right to copyright his or her
respective port.

<Distribution Rights>

vMac is freeware, so please redistribute it! You may NOT disassemble/decompile
or change any of the included files in any way. If you distribute other files
along with vMac, YOU are responsible for those files. You may NOT charge for
vMac or to distribute vMac, unless you are bundling it with other files on
CD-ROM, DVD, or other media. I encourage bundling vMac, as long as you comply
with the above. If you bundle it, I would like to know, so please notify me
by E-Mail: WDP22@Juno.com. If you have any questions about this feel free to
E-Mail me about it.

<Disclaimer>

There are NO guarantees that this program will even work. We are NOT
responsible for problems or damage of any kind. It has been tested, and no
major problems were found, but we are still NOT resposible for any problems
or damages. If you have problems, please send a bug report to WDP22@Juno.com,
so we can attempt to fix it.

<Trademarks>

MacPlus, System, System 6.0.8, System 7, System 7.5, Mac, MacOS, and Macintosh
may be registered trademarks of Apple

Pentium is a registered trademark of Intel

DirectX, Word, Word 6, WordPad, Windows, Win32, Win32s, Windows 95 and
Windows NT may be registered trademarks of Microsoft
