SheppyWare

Universal Binary
Sweet16 for Mac OS X is a Universal Binary, running natively on both PowerPC and Intel processors.

Sound and Music
Sweet16 fully emulates the Ensoniq 5503 Digital Oscillator Chip that powers the Apple IIgs sound system. Play games and music with full-quality sound, including full stereo support.

Print from Desktop Applications
Desktop applications that use the Apple IIgs Print Manager can print using a custom LaserWriter driver (included). Printed output appears in the Mac OS X Preview application, from which you can save the output in PDF format or print it to any Mac-compatible printer. 

Disk Image Management
Create disk images right from within Sweet16. You can also eject, mount, lock, and unlock disk images using a simple user interface. Easily access recently-used disk images.

Use Your Favorite Software
Sweet16 should run almost anything you throw at it. Certain copy-protected games won't work correctly, but there are very, very few that won't.

Total Control
Pause and resume the emulator. Keep an eye on your Apple IIgs's progress even while the emulator window is minimized into the Dock. Control the Apple IIgs's system speed, with ZipGS™ accelerator emulation included. Or just let the emulated IIgs run at full speed. Your choice!

Screen Capture
Copy the contents of the text screen to the Mac OS X pasteboard, or grab the screen as a graphic screenshot to paste into your favorite graphics program. 

Emupacks
Create Emupacks -- self-contained Apple IIgs systems, complete with ROM, disk images, BRAM settings, and preferences -- and start them up by simply double-clicking them in the Mac Finder.

Clipboard Sharing
You can now transfer text between the Mac and Apple IIgs clipboards.

Joystick Support
The Apple IIgs can now use Mac joysticks and gamepads.                 

Q: Where do I get system disk images?
A: You can download them for free from Syndicomm's web site, including special versions customized for Sweet16 -- the custom versions have the extra software pre-installed.

Q: The keyboard in Sweet16 acts really strangely, with keys getting stuck or ignored sometimes. What's going on with that?
A: This almost certainly means that your emulated Apple IIgs has the "Easy Access" extension installed. Look in the System/System.Setup folder of your IIgs startup disk image and disable or delete this extension, then restart the emulated Apple IIgs.

Q: I can't get FTP or Silver Platter (Web serving) to work.
A: Sweet16 doesn't support "listening" for incoming networking connections. For FTP, you need to use passive mode. Unfortunately, you can't use Silver Platter on the current version of Sweet16.

Q: The emulated IIgs is running really slowly in Sweet16 2.0 or later. What's up?
A: The most frequent cause for this problem is that you've turned on debugging support in the preferences. This knocks about 50-60% off your emulated Apple IIgs performance. Just go into Preferences, choose the Other panel, and turn off debugger support.

Q: I'm trying to mount a CD-ROM in Sweet16 2.0 or later and it's not working.
A: There are a couple of possible reasons for this. First, Sweet16 only supports mounting off the first CD drive it finds. If you have multiple CD drives, try using a different one. In addition, you need to make sure the media on the CD-ROM is supported by the Apple IIgs. Install the HS.FST (for ISO 9660 support) and HFS FST (for Mac HFS support) from the System 6.0.1 disks.

Q: I'm using the Sweet16 2.0 or later and would like to resize the video window. How do I do it?
A: Hold down the Option key on your keyboard. You should see the little resize box appear in the lower-right corner of the video window. Click on that and drag the window size until it's the size you want. Once it's the size you want, release the mouse button and the Option key. Note that due to the way IIgs graphics are drawn, the display can have some interesting artifacts when it's at certain sizes. You can also use the View menu's options to select specific sizes.

Q: Sweet16 won't mount disk images that worked fine in Bernie/KeGS/insert emulator name here. What gives?

A: Make sure the image file has the correct extension at the end of the filename. Bernie didn't require extensions; it used the classic Mac OS filetype and creator type codes to identify image files. Unfortunately, that method doesn't work well on Mac OS X, so Sweet16 requires extensions. Some images that worked fine on Bernie may also have the wrong extension on them. When in doubt, check to be sure the right extension is on the file. I personally discovered when first working on Sweet16 that my hard disk images, which I thought were in Universal Disk Image format (and had .2mg extensions) were actually raw images, and needed the extension changed to .raw in order to work correctly.

Sweet16 2.0 does a much better job of automatically identifying disk image formats.

Q: When I choose "Restart" from the Setup menu, my Mac tries to reboot. What's going on?
A: This is a conflict with Unsanity's Application Enhancer. Configure Application Enhancer to ignore Sweet16.

Q: Why is Sweet16 kind of slow on my PowerPC Macintosh? It's not as fast as Bernie ][ The Rescue was.
A: Make sure you're using the latest version of Sweet16. Although it's still not as fast as Bernie was, it's much faster now than earlier versions were.

Q: Sweet16 keeps getting my keystrokes wrong. Why?
A: Make sure you configure your emulated Apple IIgs with the appropriate keyboard layout using its Control Panel; it doesn't automatically inherit the layout configured on the Mac.

Q: When I try to initialize 800K disk images, I get I/O errors. How can I do this?
A: This is a long-standing glitch in the IWM emulation that dates all the way back to Bernie ][ The Rescue. You can work around it by mounting the 800K disk image on the CleverPort (by holding down the option key while mounting it). Then you can initialize it there.                  

Version 2.3.1 (July 31, 2011)

Note: The improvements to mouse wheel support rely on an updated version of the SweetPrinter extension; please install that if you want to use the mouse wheel features.

1. Improved the vertical mouse wheel support to be more reliable.
2. Added support for horizontal mouse wheel scrolling.
3. The emulator speed overlay now moves properly when the video window is resized.

Version 2.3 (July 22, 2011)

Note: Many of these features rely on updated versions of Apple IIgs components; be sure to install them from the embedded tools disk that you can mount using the option in the Setup menu.

1. Sweet16 now provides nice support for mouse wheels for vertical scrolling in desktop applicaitons.
2. Sweet16 now sets the appropriate I/O bits to differentiate between left and right clicks of the mouse (bug 121).
3. Fixed a crash that was occurring when trying to play disk eject sound effects.
4. Clearing of memory on reset is now more like on a real Apple IIgs (bug 104).
5. Fixed the "Clear Recent Disks" menu option so it no longer crashes (bug 105).
6. Replaced the broken "Get Clipboard from Mac" NDA on the embedded tools disk with an updated version that works (bug 120).
7. Rewrote the code to support the mouse wheel. Now instead of sending up and down arrow key events, it actually scrolls the contents of windows, TextEdit boxes, and other scrollable objects.
8. Rewrote all the sound code; now it uses Core Audio instead of the old and very obsolete Sound Manager (bug 101).
9. In order to make code that uses sound interrupts for timing work better, Sweet16 now fires two sound interrupts per oscillator they finish playing in one-shot mode, instead of just one. This makes the interrupts fire closer to the right timing (although still not correct). This helps games like Tass Times in Tonetown have music that sounds closer to the way they do on a real IIgs. I'm still trying to sort out the real cause of this problem (bug 111).
10. Changed the "Sound Support" option into a "Mute Sound" option. This no longer disables the sound code (which broke a lot of GS software), but instead simply sets the volume to zero (bug 125).
11. Improved the reliability of the 1-bit sound emulation code by removing the code that shuts off the sound engine while idle. This reduces sitations where the beginning of sounds was clipped off. This was supposed to improve performance (and might have way back on slower processors), but wasn't.
12. Also removed special code that shut off 1-bit sound processing while idle, for the same reason.
13. Removed the system information window, which only displayed emulated CPU speed. Instead, find an option in the View menu to show an overlay on the GS video window that tells you the emulated speed.
14. While in full screen mode, there's now a text notice in the GS screen border area explaining how to get back to windowed mode. This is typically only visible if you don't use the "native aspect ratio" mode.
15. If you install the SweetPrinter extension on your emulated IIgs, the shutdown dialog box in desktop applications now offers a "Quit" button that quits Sweet16, as well as the normal "Restart" button. You can just press "Q" to quit.
16. Pausing the emulator now dims the screen to make it obvious that you're paused (bug 102).
17. Cleaned up the about box to be a little nicer looking.
18. The preference window includes a note explaining that you need to quit and restart Sweet16 for changes to the ZipGS enable/disable preference to take effect.
19. Changed the default title of the video window.

Version 2.2.1 (September 16, 2010)

1. The CleverPort ROM now correctly stores $C7 in $07F8 when handling I/O.

Version 2.2 (July 18, 2010)

1. Sweet16 now defaults to having speed control enabled, with the GS set to a 40 MHz emulated speed. This prevents laptops from getting hot while running Sweet
2. You can easily turn off speed control to let your GS fly, using the preferences' CPU options panel.
3. You can now mount ProDOS-order (.po) disk images that are not floppy disk sizes.
4. When paused, Sweet16 no longer continues to use lots of your Mac's processor capacity.
5. Creating 1.4 MB disks using the Create Disk Image feature now creates disk images that are actually 1.4 MB, rather than 1.6 MB.

Version 2.1.3 (August 29, 2009)

1. Adjusted the CPU emulation loop, resunting in a substantial emulated IIgs speed increase, especially on PowerPC.
2. Fixed the CPU speed control feature to work on PowerPC.
3. Rewrote the Recent Disks menu code to only show the names of the disk image files, instead of full URLs, in the Recent Disks submenu.
4. The Control-H keystroke no longer resets the emulated Apple IIgs. Oops.
5. Removed some stray debug output.

Version 2.1.2 (August 26, 2009)

1. Fixed several errors in the French keyboard support.
2. Creating any size disk image, including floppy disk sizes, now has the same speed improvement that hard disk image creation received in Sweet16 2.1.1.
3. Removed an obsolete error message.
4. Fixed an error message that was coming up blank when trying to create an invalidly-sized DiskCopy 4.2 image.
5. The disk image size now tracks correctly in the "Create Disk Image" window, so the size you get actually matches the size you picked all the time; there were cases in which that wouldn't necessarily be the case.

Version 2.1.1 (August 4, 2009)

1. Reworded the alert that appears when trying to mount a CD-ROM when no CD-ROM is found, since the same alert is used both when there is no CD-ROM media available as well as when there is no CD-ROM drive available.
2. Memory no longer gets leaked when controls in the Create Disk Image and Create Emupack file panels are clicked on.
3. The Create Disk Image panel now lets you create DiskCopy 4.2 images at 1.4 MB.
4. The Create Disk Image panel's size popup no longer wanders out of view when you resize the panel.
5. Enabled some new optimizations that noticeably improves performance on PowerPC systems.
6. Removed some unnecessary debug output.
7. The SpiderMonkey JavaScript runtime is now weak-linked, so that Sweet16 really does now run on PowerPC G3 systems (albeit without debugger support).
8. The Create Disk Image panel now lets you choose a disk image format on Mac OS X 10.4; previously this popup window didn't do anything prior to Mac OS X 10.5.
9. Creating disk images of even 1 MB sizes (5 MB, 10 MB, 32 MB, 100 MB, for example) now goes much, much faster, since instead of writing out 512 bytes at a time, these are written 1 MB at a time. A future update will provide a similar performance improvement for floppy size image creation.
10. Clicks in the video window are no longer ignored when the System Information window is open.
11. Removed some unnecessary mutual exclusion code in the networking support, speeding up networking substantially.
12. Rewrote the video timing code to be more precise.
13. The main event loop now does sleeps instead of busy-loops, dramatically reducing wasted CPU cycles; Sweet16 plays much more nicely with other running processes now.

Version 2.1 (July 23, 2009)

1. Added the new View menu and its options for half, normal, and double sizes.
2. Moved the Full Screen option to the View menu.
3. Fixed a serious GS memory trashing bug in the included "Get Clipboard from Mac" NDA.

Version 2.0 (July 23, 2009)

1. Added to the help menu links to several useful Apple II related web sites.
2. Improved the algorithm for detecting DiskCopy and DiskCopy 6 images to hopefully work better.
3. Fixed a bug that would cause a crash if an error occurred while trying to allocate the buffers for full screen mode; now full screen mode is simply disabled if this happens.
4. Instead of giving up and ejecting the CD-ROM if an error occurs, now the first nine partitions are all tried, and if any of them succeed, the disk is considered mounted. This lets it work with disks that have "free space" and unrecognized partitions.
5. Removed some dead code.
6. Fixed the EMUBYTE softswitch to correctly return $16 as the product ID; this has been broken for a very long time.
7. Rewrote the networking code. The new networking code is both faster and no longer requires annoying authentication and so forth to use it. There is a new link layer that must be installed to use the updated networking code successfully.
8. Removed Sparkle support for automatic updating; the Carbon version of this is a fourth-party patch and I decided I'd rather not worry about it.
9. The debugger should now be disabled on G3 systems; I still haven't figured out why the debugger makes Sweet16 crash on launch on G3 systems, so at least now Sweet16 should work, but the debugger will silently do nothing.
10. Fixed the data displayed in the Finder's Get Info window to correctly show Sweet16's version number where you expect it to be.
11. Gamepads are now supported for game control.
12. Fixed a bug that caused screenshots captured under certain circumstances to have garbage at the bottom.
13. Disk images that are exactly 819,200 bytes long are now assumed to be 800K raw disk images, regardless of their type and/or extension.
14. The disk eject code has been updated to no longer crash while trying to redraw the online disks window.
15. Added support for, and implemented, two new NDAs: GetClipboard and SendClipboard; these let you copy the Mac clipboard to the IIgs clipboard and vice versa.
16. Added Emupacks — self contained packages including disk images, ROM, and preferences that can all be opened and enabled at once, simply by double-clicking the Emupack in the Mac Finder.
17. Fixed the preference for disabling the mouse in text modes so it actually works.
18. Removed the window that says Sweet16 is recalculating DiskCopy 4 checksums; it didn't stay onscreen long enough to be helpful, and would sometimes crash because it was being opened from background threads.
19. The Close option in the File menu is now disabled if the video window is frontmost, since you can't close it.

Version 2.0b18 (Public Beta 2; August 11, 2008)

1. The SpiderMonkey JavaScript library has been recompiled to run on both PowerPC G4 and G5 chips instead of only G5s. G3 support should be coming soon.

Version 2.0b17 (Public Beta 2; August 10, 2008)

1. If no joystick is connected, the joystick routines now report that they're dead center.
2. If the memory for the screen shot buffer can't be allocated, screen shots are disabled, instead of letting it try and crash.
3. You can now paste text from the Mac clipboard into the Apple IIgs. Only ASCII characters are supported at present.
4. Added a System Information window to show the CPU speed.
5. Programmers can access the OpenGL buffer used to draw the Apple IIgs screen in banks $E2 through $E9 of Apple IIgs memory. This is a 640x400 pixel buffer in 16-bit color.
6. The Sparkle framework is now used to provide automatic updates. In addition, there's a preference that lets you enable and disable automatic updates, as well as one that lets you subscribe to receive the extra-risky test updates.
7. Added mutex to fix problems with crashes adding and removing disks to the online disks windows.
8. Added a new Toggle Full Screen NDA so you can toggle full screen within the IIgs environment.
9. Fixed a crash that occurred when changing the window title from the CPU thread; it is now done in the UI thread.
10. Fixed a problem with color palettes that affected colors in DreamGrafix, Wolfenstein 3D, and other applications.
11. You can now mount disk images by dragging them to the application's icon.
12. Added joystick support; USB joysticks are now supported (but not gamepads).
13. Fixed a crash that occurred when ejecting disks by moving the resize of the online disks window into the UI thread.
14. If GS/OS is shut down and you're at the "It's now safe to shut off your Apple IIgs" screen, quitting Sweet16 no longer asks for confirmation, since it's safe to quit.
15. Added a new preference that lets Sweet16 automatically switch to 1 MHz when booting 5.25" disk images.
16. If the first character of a disk image name you're creating isn't a letter, it's replaced with an "x" when naming the ProDOS volume written onto it.
17. Implemented TCP/IP networking support over Ethernet.
18. Strings are now in the localizable.strings file so they can be localized.
19. Replaced the application icon with something less dorky looking.
20. Added a sweet new debugger.
21. Fixed the title of the About window to get rid of some junk characters.
22. You can now mount ISO format disk images; these may require the High Sierra (ISO) FST to be installed, depending on the format of the contents.
23. You can now mount CD-ROM disks into Sweet
24. Sweet16 will attempt to mount all partitions on the disc. Ejecting the disk from the emulator physically ejects it from the computer.
25. Added the "Open CDA Menu" option to the Setup menu; this lets you open the CDA menu if you don't remember the keys to do it, or if they conflict with some other software running on your Mac.

Version 2.0 Public Beta 1 (July 20, 2007)

1. Graphics are now drawn using OpenGL, and color is 16-bit for truer color fidelity.
2. Removed tons of unused code.
3. Added a routine that makes it possible for IIgs code to output text to the Mac console.
4. The video window's title bar now indicates the name of the Apple II application currently running -- if you've installed the latest version of the SweetPrinter extension from the tools disk, as described in the documentation.
5. Added full screen graphics support.
6. Added a preference that lets you specify whether 800K disk images mount on the CleverPort or IWM by default.
7. You can now resize the video window to any size by holding down option and clicking and dragging in the resize box that appears in the bottom right corner of the window.
8. Switched to using the more modern Carbon Event Manager, which improves performance and makes certain tasks easier to accomplish in the code.
9. The Mac mouse cursor now hides and shows more reliably as it passes in and out of the video window, courtesy of Carbon Event Manager mouse tracking.
10. You can now switch between 16:10 (typical emulated Apple IIgs aspect ratio) and 4:3 (real Apple II aspect ratio) using the preferences.
11. Fixed a bug that was causing empty ROM and other files to be created if they couldn't be found.
12. The toolbar has been removed; the CPU speed indicator is not currently available but will return before the final version of Sweet16 2.0.
13. Removed the Real Time dock icon update option; this was hurting system performance when selected. Added an "Every second" option to replace it.
14. DiskCopy 4.2, HDRV, and Universal Disk Image files are now recognized by their Mac file type information if it's present.
15. Universal Disk Image files are identified by their internal signature if no other type information is found.
16. The mouse scroll wheel now sends key up and down events, to let you use the scroll wheel to some extent in GS applications.

Version 1.7.3 (September 12, 2006)

1. Fixed timing problems with time-based interrupts such as the quarter-second and 1-second interrupts, which makes time-based games tend to work much better.
2. Choosing the Dvorak and French Canadian keyboard layouts in the Control Panel no longer crashes Sweet16, and should actually provide the correct keyboard layout.
3. Removed some unneeded data.
4. Speed control now works correctly on PowerPC machines; it had previously been fixed only on Intel processors.

Version 1.7.2 (August 28, 2006)

1. You can now write to 5.25" disk images.
2. You can now drag multiple disk images at once to the Disks window to mount them all at once.

Version 1.7.1 (August 18, 2006)

1. Holding down the option key while mounting 800K disk images now mounts them as CleverPort devices instead of as IWM floppy disks; this lets you mount lots of 3.5" disk images at once, which makes installing the system software, for example, incredibly easy.
2. Updated the URL in the documentation that's presented for where to go to download system disks.
3. Aliases to files now resolve correctly, so you can drop aliases to your disk images into the Disk Images folder, instead of moving the images themselves.
4. The Reset command in the Setup menu now works correctly.
5. Optimized more PowerPC code, resulting in a small additional performance boost over version 1.7.
6. Fixed a bug that prevented Recent Disks from mounting.
7. Items in the Eject submenu now display the name of the disk correctly; this broke in version 1.7 due to the UTF-8 change.
8. Ejecting a disk then inserting a new one now properly redraws the contents of the disks window if it's visible. Previously, it was possible for the contents of the window to become somewhat confused in this situation.
9. Fixed a bug that caused the mouse cursor to bounce around the screen when Default Folder X is installed. This also slightly improves the response performance of the mouse in Sweet16.
10. Fixed a couple of problems that caused crashes when clicking in the disks window under certain circumstances.
11. The Control-Command-M keyboard combination now properly issues the Mount Disk Image command.
12. Fixed a memory leak when initializing the Recent Disks menu.
13. Added a "Clear Recent Disks" command to the Recent Disks menu. This empties the recent disks list.
14. Fixed a bug that caused new DiskCopy 4.2 images to have invalid names in their DiskCopy 4.2 headers.
15. Fixed a bug that caused the progress window used when creating disk images or calculating the checksum on a DiskCopy 4.2 image to crash.
16. Fixed HTML markup problem in the documentation that made the instructions on copying the ROM from a IIgs unreadable.
17. Fixed the error dialog box that appears if you try to mount too many disks (or too many of a given type) so it actually contains text.
18. Fixed the "allow 14 MB" checkbox and the other controls in the Memory panel in the Preferences window to stay in sync properly.
19. Fixed the memory size preference so it resets to 8 MB if you turn off the "allow 14 MB" checkbox with the memory size set above 8 MB.

Version 1.7 (August 14, 2006)

1. Pathnames are now kept in UTF-8 format instead of in ASCII, which improves compatibility for non-English users.
2. Added a preference to automatically cause the mouse to be disabled when in text modes.
3. Fixed the speed control checkbox so that toggling it takes effect immediately instead of usually requiring you to quit and restart Sweet16.
4. Optimized performance on PowerPC systems, improving speed by up to 30%.
5. DiskCopy 4.2 images created and marked as being Mac format disks will now work in Sweet16.
6. Sound effects are now played when ejecting floppy disk images.
7. The font in the disks window is now Lucida Grande.

Version 1.6.1 (August 1, 2006)

1. The Disks window no longer disappears when Sweet16 isn't in the foreground, which makes it an easier target for drag & drop of disk images.
2. DiskCopy 4.2 disk images are now recognized for mounting even if they don't have an extension.
3. Fixed a problem that caused an empty error dialog box if you tried to mount a disk image that's already mounted by Sweet16.
4. Dragging disk images into the disks window now displays the fancy arrow with a green plus cursor.
5. Enabled some optimizations when compiling that I hadn't been using before. These may or may not have any noticeable impact on performance, but it probably doesn't hurt.
6. By default, the speed used when you turn on speed control is now 2.6 MHz instead of the strange 0.5 MHz it was set to before.

Version 1.6 (July 19, 2006)

1. Initial release.Version 2.3 (July 22, 2011)

   Note: Many of these features rely on updated versions of Apple IIgs components; be sure to install them from the embedded tools disk that you can mount using the option in the Setup menu.

3. Sweet16 now provides nice support for mouse wheels for vertical scrolling in desktop applicaitons.