vMac 0.19 *BETA* for Win32
Win32 port by Weston Pawlowski, Bill Miller, Ryan Hill, and Mike Voellinger

NOTICE: This beta does NOT have DirectX mode or some of the GUI. The final
release of vMac 0.19 for Win32 will have both of these.

*SECTIONS*

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

*INTRODUCTION*

vMac is a Macintosh emulator, which means it runs Macintosh programs on your
computer! vMac is freeware, so anyone can download it from the vMac Web Site
without paying anything to the vMac Team.

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

On the vMac Web Site, you can find links to other places where you can get
vMac DSK files that contain Mac applications or System software.

Questions, suggestions, and bug reports for the Win32 port: Weston@vMac.org
You can also send bug reports from the vMac Web Site. When sending a bug
report, plese include the version of vMac that you are using.

<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. There should be a link to the latest version
of HFV Explorer on the vMac Web Site.

*REQUIREMENTS*

vMac for Win32 should run on these operating systems:

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

You need a bootable disk image named disk1.dsk (it doesn't have to be named
disk1.dsk if you use vMac to select the file). It will run System 6, System 7,
and may also run versions up to System 7.5. You can get disk images from a
link 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 (version 2.0 or higher is required for DirectX mode)

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

Recommended:
-133MHz 586 or better (586 = AMD k5, Pentium, Cyrix 6x86)
-MMX processor (MMX = AMD k6, Pentium II, and other chips marked MMX)
-16MB or more RAM
-8 bit 22KHz sound board or better
-High density 3 1/2 inch (1.44MB) floppy drive
-CD or DVD drive
-DirectX compatible graphics hardware and the newest version of DirectX

*WIN32 PORT CREDITS*

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

Other people who made stuff for vMac's Win32 port:

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 - Implementing the UAE 0.69 CPU in vMac and bug fixes
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
Hoshi Takanori - Bug fixes: keyboard & file copying/System 7

See the splash screen for the vMac credits

*CHANGES*

<0.19 BETA>

NOTICE: This beta does NOT have DirectX mode or some of the GUI. The final
release of vMac 0.19 for Win32 will have both of these.

-Autoquit works better
-Renamed ReadMe_W to ReadMe
-Keyboard fixes from Hoshi Takanori (Modifier keys work better)
-New KeyConfig (#3) is now the default
-Fixed a bug in the CPU dialog box (Options - CPU)
-File copying bug completely fixed! You can copy files of any size now
 (Thanks to Hoshi Takanori and Bill Huey)
-Can run System 7.x!! (Thanks to Hoshi Takanori and Bill Huey)
-Rearranged and added shortcut keys
-Help file (Help - Contents)
-Can read disk images (You don't need an Image to HFV/DSK converter anymore)
-Can turn off messages about Floppy and CD-ROM
-Improved mouse tracking
-Fixed minimize bug
-Status bar
-Audio dialog box (Options - Audio)
-Much better sound - no more glitches!
-Improved keyboard - you can type faster now
-Minor bug fixes
-Control key (KeyConfig 3)
-CPU emulation from UAE 0.69
-It's faster!

<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 for 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 F3, or
you can go to the File menu, and select Check for Mac floppies and CDs.

<Shortcut Keys>

F1 = Insert DSK file 1 (DrivePath1)
F2 = Insert DSK file 2 (DrivePath2)
F3 = Insert 1.4MB Mac floppy and/or Mac CD-ROM
F4 = Switch between DirectX mode and windowed mode
F5 = Debugging info (See "Mode Option & Getting vMac to work" under the
                     section *PROBLEMS & LIMITATIONS*)
Alt+Enter = Switch between DirectX mode and windowed mode
Alt+F4 = Exit vMac

<Increasing Performance>

Go to Options - Video, and set the FPS so that it's low, but the video doesn't
appear jumpy when you move the mouse cursor around on the Mac screen.

Using DirectX mode usually helps performance.

<CPU Dialog Box>

The CPU dialog box no longer has a large affect on performance. You should
keep Real Time Interrupts enabled.

<Mode>

See "Mode Option & Getting vMac to work" under *PROBLEMS & LIMITATIONS*

<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 F4 or Alt+Enter. Under Windowed
mode you can also 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 F3. 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. When Floppy = 1 in vMac.ini,
a message box will tell you when you may safely remove the floppy disk. When
Floppy = 2 in vMac.ini, it won't show any floppy related messages.

<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 F3. 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 CD = 1 in
vMac.ini, a message box will tell you that you may safely remove the CD from
the drive. When CD = 2 in vMac.ini it will not tell you when you may safely
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! It will show a message box telling you to not
remove the CD from the drive, when the CD is not properly ejected.

<Keyboard>

In the vMac.ini file, you can choose the key configuration. KeyConfig 1 is
left control is command, and right control is option. KeyConfig 2 is the
default, 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 isn't perfect, 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.txt - This file
ReadMe.doc - This file in Word 6/WordPad format
vMac.hlp - vMac help file
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 F5 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 F3 or use menu), press F5, and write down all of that
info. Then, E-Mail all of the info you have written down to Weston@vMac.org
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 freezes at "Welcome to Macintosh" when trying to boot System 7
Delete vMac.PRAM and start vMac. If it still appears to be freezing, just
let it sit for a while, and it should boot (eventually).

-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. vMac can read 800k DSK files, but not
real 800k floppies.

-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.

-vMac ejects the wrong CD on systems with multiple CD drives
When vMac ejects a CD, it will eject the first (by drive letter) CD drive.
Systems with only one CD drive shouldn't have any problem. On systems with
multiple CD drives, you should put the CD that you want to use in the first
(by drive letter) CD drive.

*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 other ports can also emulate a 68010, 68020, or 68020 w/FPU.
Hopefully, the Win32 port will be able to do this also.

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 change any of the
included files in any way. If you distribute other files along with vMac,
YOU are totally 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: Weston@vMac.org. 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 of any kind. By using this software, you agree to these terms.

If you have problems, please send a bug report to Weston@vMac.org,
so we can attempt to fix it.

<Trademarks>

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

k5 and k6 may be registered trademarks of AMD

486, Pentium, Pentium II, and MMX may be registered trademarks of Intel

6x86 may be a registered trademark of Cyrix

68000, 68010, 68020, and 68040 may be registered trademarks of Motorola

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

Any other products mentioned may be trademarks of their respective owners.
