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


Read the last section, "Legal Stuff", before you use this product. 


*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 Application Site (VAS), you can get vMac DSK files that contain
Mac applications or System software: http://www.hostus.com/vas/

Links to the vMac site, the vMac Application Site (VAS), HFV Explorer, and
other free stuff: http://www.vMac.org/~weston/


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

<Contact>

PLEASE CHECK THE PROBLEMS & LIMITATIONS SECTION BEFORE SENDING A BUG REPORT.
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, please 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 called HFV Explorer. There should be a link to the latest
version of HFV Explorer at: http://www.vMac.org/~weston/


*REQUIREMENTS*

vMac for Win32 should run on these operating systems:

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

Notice: vMac for Win32 will NOT run on Windows 3.1 with Win32s

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

People who aren't on the vMac credits, but helped with the Win32 port:

Andre Masella  - .inf installer script
Lauri Pesonen  - 1.4MB Mac floppy and Mac CD-ROM code
Hoshi Takanori - Bug fixes: keyboard & file copying/System 7
Jose Urena     - Help porting vMac 0.1.9

Everyone who gave suggestions and/or bug reports

See the splash screen for the vMac credits


*CHANGES*

<0.1.9.5>

-It's faster!
-Autoquit works
-Mac to PC clipboard code (Thanks to Bill Huey)
-Faster booting - skips memory test
-Fixed several major CD problems!!!
-SCSI emulation - increases compatibility (Thanks to Yoav Shadmi)
-Fixed threading - faster vMac and better timing (No need for Options - CPU)
-No disk warning messages (Can't get disk geometry/Can't reset controller)
-Fixed several mouse clipping problems
-Fixed problems with non-standard window size (Should fix Windows NT problem)
-Confirms force reset (Control - Reset)
-Better messages for ROM problems
-Ejecting the CD when the MacOS ejects it is now optional (in vMac.ini)
-Another option (in vMac.ini) for floppy and CD messages
-Fixed a bug in the debugger (AKA Interrupt)
-Some SCC emulation - slow modem and printer port support!!
-Puts name of currently running Mac application in the window caption
-Several minor bug fixes

<0.19 BETA>

-Renamed ReadMe_W to ReadMe
-Keyboard fixes from Hoshi Takanori (Modifier keys work better)
-New KeyConfig (#3) is now the default
-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


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

<Modem and Printer Ports>

To use real ports with vMac, edit the vMac.ini file and set ModemPort
or PrinterPort to the port name (COM1 to 4 or LPT1 to 3) that you want
to use as the Mac modem or printer port. Set it to 0 if you do not want
to use a real port. This has only been tested with modems and printers,
but it might also work with other serial or parallel port devices which
are compatibile with your computer's hardware.

So, if you wanted to use COM2 and the Mac modem port, you would use:
ModemPort = COM2

If you wanted to use LPT1 and the Mac printer port, you would use:
PrintPort = LPT1

You may use COM and LPT ports for either setting, but it is recommended
that you put use a modem for ModemPort and a printer for PrintPort.

Using a Modem:
To use a modem, just type in the name of the COM port that it is on.
If you do no know the COM port number that your modem is on, then go to
Windows' Control Panel, open Modems, click on the modem that you want to
use, and click the Properties button. Your modem's COM port should be
displayed in the port box (COM1 = 1, COM2 = 2, etc).

Using a Printer:
To use a printer, just type in the name of the port that it is on
(usually LPT1). If you do not know the port that your printer is on,
then go to Windows' Control Panel, open Printers, click once on the
printer that you want to use, go to File - Properties, and click the
Details tab. Your printer's port should be displayed in the box labeled
"Print to the following port:". You will need a Mac printer driver for
your printer to be installed under the MacOS.

<Clipboard>

When something is put in the Mac clipboard, it will be saved as a file on
your hard drive. If it is text, it will be a file named Clipboard.txt. If
it is not text, it will be a file named Clipboard. When a PICT is copied to
the clipboard, it is stored in a different format, so don't expect to be
able to open the Clipboard file as a PICT after you have copied a PICT to
the Mac clipboard.

<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. When in
DirectX mode, you can click the right mouse button to bring up a menu. You
can quit vMac by pressing Alt+F4 or by selecting Quit on the menu.

Note: There may be a delay when switching to DirectX mode. When starting in
DirectX mode, it may show a grey screen for a few seconds, and then a black
screen for a few seconds; this is perfectly normal, just give it a minute to
startup.

<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 those 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!
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 alt is
command, and control is option. KeyConfig 3 is the default, it is the same as
the key configuration of Executor: Left alt is command, right alt is option,
and control is control.

<Autoquit feature>

When vMac detects the "You may now switch off your Macintosh safely" screen,
it can automatically quit.

<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 max FPS and window
position is stored in the registry.


*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:

After vMac has quit, try deleting the vMac.PRAM file and starting vMac again.
If that doesn't work then try editing the vMac.ini file and setting Mode to 1.
If setting mode to 1 doesn't fix your problem, you should edit the vMac.ini
file, and set: ModemPort=0, PrintPort=0, 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.

<Known Problems>

-Modem and printer ports are very slow
We are working on this...

-Modem or printer port doesn't work
Read "Modem and Printer Ports" under the section Usage. If you still have
problems then try restarting your computer. If that doesn't work, then make
sure the port that you specified for the modem or printer port is valid,
the device connected to it is working, and no other programs are using that
port.

-It freezes when trying to boot System 7.x
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.

-There is no color
Sorry, vMac doesn't support color yet.

-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 full SCSI
emulation. For now, you should try them under System 7.x.

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

-Has trouble when running in the root (top-level) folder
vMac has a small bug which prevents it from working properly when it is
run from the root (top-level) folder of a drive, such as C:\,D:\,E:\,etc...
vMac shouldn't have this problem when it is run from inside a normal folder,
such as C:\vMac, C:\Program Files\vMac, or any other normal folder on any
drive. Note: this problem will probably occur if the "Start in" box of a link
is set to a root folder, so leave it blank or type in a normal folder.


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

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 (ALL RIGHTS RESERVED).
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 100% 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 ON ANY OF THE INCLUDED FILES OR ANYTHING ELSE!
WE ARE NOT RESPONSIBLE FOR PROBLEMS OR DAMAGES OF ANY KIND. THIS SOFTWARE
HAS BEEN TESTED, AND NO MAJOR PROBLEMS WERE FOUND, BUT WE ARE STILL NOT
RESPONSIBLE FOR ANY PROBLEMS OR DAMAGES OF ANY KIND. BY USING THIS SOFTWARE,
YOU AGREE TO THESE TERMS. IF YOU DO NOT AGREE THEN YOU MUST DESTROY ALL
COPIES OF THIS SOFTWARE WHICH ARE ON YOUR COMPUTER.

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

Executor may be a registered trademark of ARDI

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

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