PC World 1999 June/PCWorld_1999-06_cd.bin/software/temacd/vmac/vMac-0_1_9_6-Win32.exe/ReadMe.txt

Text File | 1999-03-06 | 23KB | 558 lines

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


vMac is dedicated to the memory of Yoav Shadmi, our former DOS port author
and good friend who died while serving in the Israeli Army.


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


*SECTIONS*

-Introduction
-Coming Soon (What will be in the next version)
-Changes (What's new in this version)
-Included Files
-Requirements
-Win32 Port Credits
-Usage
-Problems & Limitations
-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 (Windows 95, 98, and NT) port, you can get ports for
other operating systems from the vMac Web Site.


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

The vMac Knowledge Base:
http://www.vMac.org/~suwalski/vkb.html

Get HFV Explorer, links to free stuff, and other Mac emulators from:
http://www.vMac.org/~weston/

Emulators, Inc. (makers of the Gemulator ROM board):
http://www.emulators.com

<Notice>

vMac requires a MacPlus ROM. You can either use a Gemulator ROM board or get
a ROM image. If you use a ROM image, this applies:

You MUST get the ROM image from a MacPlus that YOU own, and do NOT distribute
it unless you have permission from Apple. The vMac Team will NOT even consider
helping anyone pirate MacPlus ROM images or any other software, so don't ask!
The vMac Team is NOT responsible for what you do; YOU are 100% responsible
for your actions.

<Contact>

PLEASE CHECK THE PROBLEMS & LIMITATIONS SECTION AND THE VMAC KNOWLEDGE BASE
(http://www.vMac.org/~suwalski/vkb.html) BEFORE SENDING A BUG REPORT.

You can send bug reports from the vMac Web Site. When sending a bug
report, please include the version of vMac that you are using.

vMac for Win32 contact: Weston Pawlowski <[e-mail]>

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


*COMING SOON*
Here's what you can expect to see in the next version of vMac (0.2):

<Already Working>
-Mac SE emulation
-Mac Classic emulation
-Mac II emulation (with COLOR!)

<Planned>
-New user interface for Win32 port
-Possible merge of Win32 port and DOS port into one EXE (It will automatically
 run the Win32 port if Windows is running, otherwise it will run the DOS port)


*CHANGES*
(This version and the last two versions)

<0.1.9.6>

-Several minor changes
-Several small bug fixes
-Fixed memory leak in floppy code
-Added Floppy Auto Insert feature
-Updated Help File
-Can read Mac CD's under Windows 98! (Thanks to Lauri Pesonen)
-Fixed window caption problem
-BlockMove & BlockMoveData patched to increase speed (Thanks to Michael Hanni)
-Fixed a bunch of SCC bugs
-Sound emulation can now play at 11.025 kHz if 22.05 kHz is unavailable
 (This makes vMac compatilble with some *very* old sound boards. It also
  makes vMac able to play sound when other Win32 applications are recording
  at 11.025 kHz using a full-duplex sound board.)
-Fixed two potential memory leaks
-Added support for Gemulator ROM board
-Took out "Mode" option; F5 is always on, but no overriding the ROM check

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


*INCLUDED FILES*

vMacW32.exe - vMac program
ScanROM.exe - Use it to get vMac.ini settings for Gemulator ROM board
              (Details in "Gemulator ROM Board" of *USAGE* section)
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 - Shortcut 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


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

vMac should have the best performance under Windows 98.

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
various Mac emulation sites on the Internet.

vMac requires a MacPlus ROM. You can either use a Gemulator ROM board or get
a ROM image. If you use a ROM image, this applies:

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 download section of the vMac
Web site, then read the file named vMac_ROM.txt for instructions. Once you get
this ROM image, do NOT distribute it! Distribution without permission from
the copyright and/or patent owner (Apple) is illegal! The vMac Team is NOT
responsible for what you do; YOU are 100% responsible for your actions.


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:
-Windows 98
-166MHz MMX CPU or better
-16MB or more RAM
-8 bit 22 kHz 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
-Gemulator ROM board with MacPlus ROM set


*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  - Original .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
Darek Michocka - Info and sample code for Gemulator ROM board support

Everyone who gave suggestions and/or bug reports

See the splash screen for the vMac credits


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

<Gemulator ROM Board>

vMac supports the Gemulator ROM board. The Gemulator ROM board is available
from Emulators, Inc: http://www.emulators.com

In this version, vMac only supports Mac Plus ROM sets. A Mac Plus ROM set
consists of two Mac Plus ROM chips. Refer to information provided by
Emulators, Inc. for installation and other Gemulator ROM board information.

To use a Gemulator ROM board with vMac, you need to edit vMac.ini and set:

(You can get values for the below settings by running ScanROM.exe)

CurrentROMPath = G
GemulatorBase = (Set to base address of Gemulator ROM board, defualt = 240)
GemulatorSocket = (Set to socket number of Mac Plus ROM that you want to use)

You can either replace the existing values with the values above, or you can
simply add the values above to the *end* of the vMac.ini file.

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

<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/98:
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.


*PROBLEMS & LIMITATIONS*

<Getting vMac to work>

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

Press the F5 key 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 [e-mail]
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 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, 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. A fast Serial Driver emulation may be coming soon...

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

-System is unresponsive while or after vMac checks for disks
The most common cuase of this problem is when Norton AntiVirus is running.
This problem occurs with Norton AntiVirus 5.0, other versions have not
been tested. Other AntiVirus software may cause similar problems with vMac.

For Norton AntiVirus 5.0 users, this problem can be fixed but it WILL
COMPROMISE SECURITY AGAINST BOOT SECTOR VIRUSES ON FLOPPY DISKS. DO THIS
AT YOUR OWN RISK! If you still want to fix this problem, you can do so by
going to the pull-down menu "Tools", then "Options". Click on the
"Auto-Protect" tab, click the "Advanced" button, and under the section named
"Check Floppies", un-check "Check floppies for boot viruses upon access".


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

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


*LEGAL STUFF*

<Notice>

vMac requires a MacPlus ROM. You can either use a Gemulator ROM board or get
a ROM image. If you use a ROM image, this applies:

You MUST get the ROM image from a MacPlus that YOU own, and do NOT distribute
it unless you have permission from Apple. The vMac Team will NOT even consider
helping anyone pirate MacPlus ROM images or any other software, so don't ask!
The vMac Team is NOT responsible for what you do; YOU are 100% responsible
for your actions.

<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 MUST include all of the
files in the official distribution and you may NOT change any of those
files in any way without permission from the vMac Team. 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 vMac, I would like to
know, so please notify me by e-mail: [e-mail]. If you have any
questions about any of 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 from the vMac Web Site or
to [e-mail], so that we can attempt to fix it.

<Trademarks>

MacPlus, Mac SE, Mac Classic, Mac II, System, System 7, System 7.x, Mac, MacOS,
and Macintosh may be trademarks or registered trademarks of Apple Computer

486 may be a trademark or registered trademark of Intel

Executor may be a trademark or a registered trademark of ARDI

Gemulator may be a trademark or a registered trademark of Emulators, Inc.

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

Norton and Norton AntiVirus may be trademarks or registered trademarks of
Symantec

All product names mentioned may be trademarks or registered trademarks of
their respective owners.