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 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. 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 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): -Mac SE emulation -Mac Classic emulation -Mac II emulation (with COLOR!) -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. 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 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. 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. 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. 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. 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. 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. 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. 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. 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. When vMac detects the "You may now switch off your Macintosh safely" screen, it can automatically quit. 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* 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 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 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. -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* 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. 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. 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: Weston@vMac.org. If you have any questions about any of this, feel free to e-mail me about it. 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 Weston@vMac.org, so that we can attempt to fix it. 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.