vMac 0.19 versions
vMac 0.19b for Mac OS 8.1 on 68k to Mac OS 9 on PPC
vMac is a Mac Plus emulator for the Macintosh. It allows old macintosh
softwares to run without modification on the latest systems.
The vMac source code is included with the program. Code optimizations
and bug fixes are always welcome - feel free to send them to me at
[
[email protected]][1] so they can be included in the next release
of vMac. Please read the "Source Code Read Me" before trying to use
the code, however.
The latest version of vMac can always be obtained from
<
http://www.bannister.org/software/>.
New in this version
\- Sound emulation (note - speed is capped to 100% when sound is
turned on).
\- Larger video sizes (up to 800*600).
\- Lots and lots of bug fixes.
Special thanks to both MDH and Paul Pratt who submitted code patches
that have been included in this release. It was their work that
finally motivated me to sit down and write the sound emulation code
that I've been thinking about for over a year!
vMac.ROM
This program will not work without a copy of vMac.ROM.
vMac.ROM must be an image of the original Mac Plus ROM (v1, v2, or v3
are supported). No other Mac ROMs will work at this time. This can be
copied from your Mac Plus using the CopyROM utility, which is
available from <
http://www.vmac.org/>. You can also read the ROM files
from a Mac Plus if you have an EPROM reader.
Do not ask me to send you this file - and do not ask me where to get
it. It is copyright by Apple Computer, and must not be distributed.
Using software
vMac accepts disk images in DiskDup+ format only. DiskCopy 6 disk
images will not work at all. DiskDup+ can be found on the 'net.
There is a bug in the disk image handling on the MacOS that causes the
boot sector of images to be irreversably damaged if a disk image is
mounted under the host machine. For this reason, do not mount bootable
disk images outside of the emulator.
In addition, be very careful not to "insert" a disk image under the
emulator while it is mounted under the MacOS. This can cause
unpredictable results. You have been warned.
The Insert command in the emulator will not work until the Sony driver
has been initialised by the emulated system. This typically occurs
just as the Disk with blinking question mark screen appears. This
screen does not appear when vMac is set to larger video sizes - you
have been warned!
Resetting the emulator
When you reset the emulated Mac, all disks will be ejected. This is
the same behaviour as on a real Mac Plus.
Shutting down the emulator
The emulated mac is able to write to disk images. For this reason, it
is vitally important to always shut the emulated Mac down properly.
Failure to do so can mean your disk images will become corrupt and
will no longer work properly. It is a good idea to eject disk images
from the emulated Mac before shutting down the emulator.
What do those menu items mean?
Frame Rate - Select the number of frames that vMac will skip. A frame
rate of 1 means that vMac will draw every single frame.
Full Screen - With this option enabled, vMac will hide the Macintosh
Desktop.
Page Setup - Set up your printer for printing from vMac.
Print Video - Print a copy of the current vMac screen to your printer.
Copy Video - Send a copy of the current vMac screen to the clipboard
so you can paste it into another application.
Save Screenshot - Save a copy of the current vMac screen to a file in
PICT format.
Reset - Resets the emulator. This is equivalent to pressing the
"programmer's switch" - a hard reset is performed, and all unsaved
data will be lost. This is not recommended - you should reset the Mac
through the emulated environment instead.
Interrupt - Triggers MacsBug, the system debugger.
Insert Disk/Eject Disk - Hopefully these options will be self-
explanatory! Note that these commands will be dimmed until the
emulated Mac initialises the disk driver. This happens when the
emulator shows the disk with the blinking question mark.
Memory - You can choose between 1Mb, 2Mb, and 4Mb of emulated RAM -
beware that the actual amount you get depends on how much free memory
your Mac has.
Hog CPU - Makes the emulator run 10-15% faster, but totally prevents
any programs in the background from working normally.
Troubleshooting
\- The sound sounds faint/wrong.
Make sure you have the Mac Plus volume turned up to top volume by
going into the Control Panel (on the Mac Plus). For some reason the
Mac Plus initialises itself to volume 3 the first time it boots. The
volume will be correctly saved in the vMac.PRAM file after the initial
bootup.
\- The sound breaks up.
Your Mac is not fast enough to run vMac at full speed. Sorry. Sound
emulation has slowed down vMac significantly, to the point that you
need a G3 or better to make the most of it. Hopefully someone will
take a look at the source code at some point and find some way to
speed it up again.
Copyright Issues
vMac is � 1998 by Philip Cummins and corresponding port authors. The
Mac port is � 1998-2000 Richard F. Bannister.
The 68000 CPU Engine used in vMac is from the Ubiquitous Amiga
Emulator v0.6.9, (C) 1995, 1996 by Bernd Schmidt & contributors.
You are free to download, distribute and copy the source code and
binaries of the ports available for a non-commercial purpose,
providing they are in an unmodified form. The source code may not be
used in any commercial project under any circumstances. If you wish to
use the code in any other program, you must release the -full- source
code to the program using it.
The vMac.ROM file is not included as it is copyright Apple Computer,
Inc. Do not distribute, copy or download this file.
Downloading
You can download vMac from <
http://www.vmac.org/>,
<
http://www.bannister.org/software/>, or any of the related mirror
sites linked in to the main site.
Contacts for MacOS Port
Richard Bannister - [
[email protected]][1]
MacOS Port Author
Philip 'PC' Cummins - [
[email protected]][2]
Project Co-ordinator and core coder
vMac 0.19c
PPC carbonized for Mac OS 8.6 or later.
All upload of vMac from Richard Bannister archive for mac.
Other vMac pages:
[vMac 0.1.9.X][3]
See also Mini vMac:
[Mini vMac (Source Code)][4]
[Mini vMac Extras][5]
[Mini vMac II Color Builds for Mac OS][6]
[Mini vMac 3.5 Build Environment][7]
[Mac System 6.0.8 for Mini vMac][8]
[Mini vMac (Ready to Go)][9]
[Mini vMac 3.3.2 alpha (68k)][10]
[Mini vMac 128K with full Sony DC42 support][11]
[Mini vMac 128k (Macintosh 1984)][12]
[Mini vMac 1.0.0][13]
[Mini vMac 3.2.3 iOS (JAILBREAK APP)][14]
[Mini vMac II for Android, OS X, Windows][15]
Compatibility
Architecture: 68k PPC PPC (Carbonized)
68k and PPC
[1]: mailto:
[email protected]
[2]: mailto:
[email protected]
[3]:
http://macintoshgarden.org/apps/vmac-195
[4]:
http://macintoshgarden.org/apps/mini-vmac-source-code
[5]:
http://macintoshgarden.org/apps/mini-vmac-extras
[6]:
http://macintoshgarden.org/apps/mini-vmac-ii-color-builds-mac-os
[7]:
http://macintoshgarden.org/apps/minivmac-35-build-environment
[8]:
http://macintoshgarden.org/apps/mac-system-608-minivmac-mac-plus
[9]:
http://macintoshgarden.org/apps/mini-vmac-ready-go
[10]:
http://macintoshgarden.org/apps/minivmac-332-alpha-68k
[11]:
http://macintoshgarden.org/apps/mini-vmac-128k-full-sony-dc42-support
[12]:
http://macintoshgarden.org/apps/apple-macintosh-1984
[13]:
http://macintoshgarden.org/apps/mini-vmac-100
[14]:
http://macintoshgarden.org/apps/minivmac-323-ios-jailbreak-app
[15]:
http://macintoshgarden.org/apps/minivmac-230-android