- Introduction
- Getting Started
- Disks & Images
- Quick Reference
- Getting Software
- Credits
- Release Notes

#

##

# Getting Started

To run Sweet16, you need a copy of the Apple IIgs ROM from either a ROM 01 or ROM 3 Apple IIgs system. For legal reasons regarding copyright law, you must extract a copy of the ROM from an Apple IIgs you personally own in order to legally use Sweet16. If you contact us asking for a ROM image, we'll delete your email and pretend you never asked.

## Creating a ROM Image File

The easiest way to create a ROM image file is to download GS ROM Grabber by Sarah Shepherd and run it on your real Apple IIgs to save a copy of your ROM to disk, then copy that to your Macintosh.
To create your ROM image file by hand, start by booting your real Apple IIgs into ProDOS 8, or by booting into GS/OS and then launching BASIC.SYSTEM to get into Applesoft BASIC.
If your computer is a ROM 01 system, enter the following command lines (keep in mind that the "]" and "*" characters are prompts; don't type them):
]call -151
*0/800<FE/0.7FFFM
*BSAVE APPLE2GS.ROM,A$800,L$8000
*0/800<FE/8000.FFFFM
*BSAVE APPLE2GS.ROM,A$800,L$8000,B$8000
*0/800<FF/0.7FFFM
*BSAVE APPLE2GS.ROM,A$800,L$8000,B$10000
*0/800<FF/8000.FFFFM
*BSAVE APPLE2GS.ROM,A$800,L$8000,B$18000
If your computer is a ROM 3 system, enter the following lines (again, keeping in mind that "]" and "*" are prompts):
]call -151
*0/800<FC/0.7FFFM
*BSAVE APPLE2GS.ROM2,A$800,L$8000
*0/800<FC/8000.FFFFM
*BSAVE APPLE2GS.ROM2,A$800,L$8000,B$8000
*0/800<FD/0.7FFFM
*BSAVE APPLE2GS.ROM2,A$800,L$8000,B$10000
*0/800<FD/8000.FFFFM
*BSAVE APPLE2GS.ROM2,A$800,L$8000,B$18000
*0/800<FE/0.7FFFM
*BSAVE APPLE2GS.ROM2,A$800,L$8000,B$20000
*0/800<FE/8000.FFFFM
*BSAVE APPLE2GS.ROM2,A$800,L$8000,B$28000
*0/800<FF/0.7FFFM
*BSAVE APPLE2GS.ROM2,A$800,L$8000,B$30000
*0/800<FF/8000.FFFFM
*BSAVE APPLE2GS.ROM2,A$800,L$8000,B$38000
You now have an APPLE2GS.ROM or APPLE2GS.ROM2 file for use with Sweet16. Transfer this file to your Macintosh using FTP or email, and put it in a convenient location on your hard disk.

## Starting for the First Time

Once you have a ROM image in place, you can enter the Apple II world by launching the Sweet16 application. A large window will appear, containing the Apple IIgs video display. This screen should flash to blue, the Apple IIgs power-up screen should appear, and then, after a moment, you should see the famous sliding apple screen:

If you don't see this screen, then either you forgot to install an Apple IIgs ROM image in the Sweet16 directory, or the ROM image is corrupted. Follow the instructions in the Creating a ROM Image File section again, carefully.
This screen is telling you that your emulated Apple IIgs is working just fine; you just need to find some disk images to use with it.
You can obtain Apple IIgs system software (System 6.0.1, all six disks) at http://www.apple2.org/EmuHelp/. Unlike the disks provided on Apple's FTP site, these DiskCopy 4.2 archives are compressed using Zip instead being in Mac-specific self-extracting archive files. This site is provided by Tony Diaz, who has a license from Apple to distribute the system software online.
You can even mount all of the System 6.0.1 disk images at once by holding down the option key while you drag them onto Sweet16; this causes them to be mounted on the CleverPort instead of as IWM floppy disks. Then you don't even have to switch disks while you install the system software!
For more information on places to get Apple IIgs software, and how to transfer it to your emulated IIgs, see the section Getting and Installing Software.

## Enabling Printing Support

Sweet16 supports printing to printers accessible by your Macintosh, from Apple IIgs programs that use the Print Manager. This includes most desktop applications, such as GraphicWriter III, AppleWorks GS, and so forth). This works by using a special printer driver along with an extension on the IIgs, which sends the print job to the Preview application on Mac OS X to do the heavy lifting.
In order to enable printing support, you need to be using System 6.0.1 on your emulated IIgs; be sure you’ve installed the LaserWriter driver from the System 6.01 install disks. You'll create a patched version of the LaserWriter driver and install a new extension, following these easy steps:
First, choose the option "Mount Tools Disk" in the Setup menu. This will mount a special disk image that includes the utility that patches the LaserWriter driver, the extension, and a readme file that summarizes how to install these items.
Second, run the SweetLWPatch utility. Select the LaserWriter driver file, which should be visible immediately in the standard file dialog box that appears after launching the utility. Save the newly patched driver with a new name; we recommend SweetPrinter.
Then you can quit the patcher utility. The next thing you need to do is install the SweetPrinter extension, which is also on the tools disk. Just copy that into your System:System.Setup folder. Then you can restart your emulated IIgs.
Once your IIgs has been restarted, you're ready to set it up to print to the Mac via Preview. To do so, open the DC Printer control panel on the IIgs, and configure it to use the SweetPrinter driver, as shown in the figure.
Once this is all set up, any time you print from any Apple IIgs application that uses the Print Manager will send its output through to the Mac side, where it will open up in a Preview window. This works by grabbing the PostScript output from the LaserWriter driver and copying it to a temporary file on the Mac, which then opens it in Preview. Preview translates the file into PDF format and displays it in a window; from there, you can save it in PDF format, print it, or even fax it.
The SweetPrinter extension adds some other features as well.
It lets Sweet16 show the name of the currently running Apple IIgs application in the Sweet16 video window’s title bar. Also, if you’re presently sitting at the “It is now safe to turn off your Apple IIgs” screen, choosing Quit in Sweet16 will not ask for confirmation, but simply quit the program. In addition, that alert (when in a desktop environment) offers a Quit button that immediately quits Sweet16.
On top of all of that, SweetPrinter also enables support for the mouse wheel in Apple IIgs desktop programs -- both the horizontal and vertical mouse wheels, in fact.

## Enabling Networking Support

Sweet16 supports TCP/IP networking by emulating Ethernet over whatever network connection your Macintosh is using; it has been tested with wired Ethernet, AirPort, dialup, and Bluetooth connections to cellular phones.
To enable networking support, you need to first install Marinetti 3.0b1 or later on your Sweet16 system, then install the Sweet16 link layer file from the tools disk into the System:TCPIP folder on your IIgs startup disk.
Once you’ve done that, you can choose “Sweet16 Ethernet” in the TCPIP control panel and configure your network connection. Sweet16 uses an internal DHCP server and router to connect your emulated Apple IIgs to the network; it’s normal for the IP address reported by Sweet16 not to match your home network’s normal IP addresses.
Please note that the method Sweet16 uses for enabling networking support is not currently compatible with “listening” for network connections. This means that you can’t run servers (such as the Silver Platter web server) on your Apple IIgs. Similarly, you’ll need to use passive mode in FTP clients instead of the standard active mode.

## The GetClipboard and SendClipboard NDAs

If you’d like to be able to transfer the contents of the Apple IIgs clipboard into the Macintosh clipboard, and vice versa, install these two NDAs. This will copy the entire text contents of your clipboard back and forth so you can share text data between the host and emulated systems. This currently only works for text; in addition, if you have non-Mac ASCII characters in the clipboard on the Mac, the IIgs will crash due to the unexpected data. However, extended Mac characters, similar to those you get by holding down the Option key while typing on the Apple IIgs, will work fine.

## The Toggle Full Screen NDA

If you install the ToggleFullScr NDA file into your IIgs system’s System:Desk.Accs folder, you can use this option in the NDA menu to switch back and forth between full screen mode in Sweet16.