Specifications

Apple IIGS
#72: QuickDraw II Quirks 1 of 2
Apple II
Technical Notes
Developer Technical Support
®
Apple IIGS
#72: QuickDraw II Quirks
Revised by: Dave Lyons May 1992
Written by: Dave Lyons & C. K. Haun <TR> November 1989
This Technical Note points out some things things you need to watch out for when using
QuickDraw II, especially with FastPort-aware and Shadowing modes.
Changes since November 1990: Removed some obsolete information on ScrollRect and on
shadowing. Noted that DrawPicture in 6.0 is now compatible with FastPort mode. Added a
warning about making QuickDraw II calls while QuickDraw II is not started.
Don’t Call QuickDraw II While It’s Inactive
Most QuickDraw II functions behave unpredictably if you call them while QuickDraw II is inactive,
so watch it! Don’t make QuickDraw II calls while QuickDraw II isn’t started, except as
documented. GrafOn and GrafOff are okay. (And so are QDStartUp, QDVersion, and
QDStatus.)
FastPort-Aware Anomaly
Before System 6.0, when the FastPort-aware bit is turned on in the MasterSCB parameter to
QDStartUp, DrawPicture did not notice changes in the pen pattern. If your application does
not require 6.0 and uses pictures, either directly or indirectly (i.e., by printing to the ImageWriter
driver), you may need to leave FastPort-aware mode turned off to get the expected behavior.
FastFont and Large Pixel Maps
FastFont does not work correctly when drawing past the first 64K of a pixel map. If you are
drawing text that uses FastFont (i.e., Shaston 8), you can avoid this problem by using a non-
rectangular clipRgn.
Don’t ShowPen While Collecting Polygons, Regions, or Pictures
The Macintosh QuickDraw documentation permits calling ShowPen after an OpenPoly,
OpenRgn, or OpenPicture call to cause drawing calls to contribute to a polygon, region, or
picture and draw to a pixel map at the same time.
The Apple IIGS QuickDraw II documentation does not say you can do that. In some cases, it
works, but it works “by accident” and it’s not one of the things Apple tests or guarantees in
QuickDraw II.