TweetFollow Us on Twitter

LaserWriter CopyBits Support

Volume Number: 13 (1997)
Issue Number: 12
Column Tag: Develop

LaserWriter 8.5.1 Additional CopyBits Support: Transparent and Clipped Images

by David Gelphman, RBI Software Systems Inc. and Ingrid Kelly, Apple Computer Inc.

Overview

QuickDraw provides several APIs for copying bitmaps from one graphics port into another, the most flexible of which is CopyBits(). Most developers use CopyBits() because it can move offscreen images into an onscreen window, change colors in the pixmap, and resize images. This is a useful API, however, unfortunately, LaserWriter 8.4.x and earlier PostScript printer drivers from Apple have not supported all of the capabilities of the CopyBits() call to draw images. This TechNote describes where Apple has enhanced its handling of the CopyBits() call in LaserWriter 8.5.1 so that developers and users may take advantage of the improvements.

CopyBits()

The prototype for CopyBits() is:

void CopyBits(const BitMap *srcBits, const BitMap *dstBits, 
const Rect *srcRect, const Rect *dstRect, short mode, RgnHandle 
maskRgn);

In the mode parameter, many developers have tried to use the transparent transfer mode to achieve transparency; the LaserWriter driver, however, never supported this mode but instead treated it as a srcCopy mode. The LaserWriter driver also has not supported clips in the maskRgn parameter. This has all changed with the LaserWriter 8.5.1 release.

Transparent Mode

One transfer mode previously unsupported by the LaserWriter driver is the transparent transfer mode. This mode allows drawing of images other than 1-bit deep so that any sample in the source which is the transparent color (defined as the QuickDraw background color) will not be painted to the destination. The advantage of this mode is that it lets a deep (<> 1-bit) image have holes in it by coloring the holes in the image with the transparent color. Whereas previously the LaserWriter driver would paint these images as if the transfer mode were srcCopy, LaserWriter 8.5.1's new imaging code now handles the transparent mode.

maskRgn Clipping

Another previously unsupported feature of CopyBits() was the ability to pass in a mask (via the maskRgn field) to clip out portions of the destination image. Previous LaserWriter drivers completely ignored the maskRgn passed to CopyBits(). The new imaging code in LaserWriter 8.5.1 now supports the supplied maskRgn.

Note: While the LaserWriter 8.5.1 driver now handles a supplied maskRgn to a CopyBits call, we do not do any special handling of the clip provided in the grafPort. GrafPort clipping is still handled by clipping only to the bounding rectangle of the port's clipRgn, both for CopyBits calls as well as line art and text drawing. Apple considered more generalized support for the port clipRgn but has rejected it to date mainly due to compatibility concerns.

Limitations

There are some known limitations with the added CopyBits() support that you should be aware of. They are:

  • Extremely complex clipping regions may occasionally fail on Level 1 or Level 2 devices in low printer memory conditions. The result is that the output will not preserve the clip, and the image will print as if the maskRgn parameter is ignored.

    Specifically, for PostScript Level 1 printers, there is a hard coded limit to how complex a clip can be, regardless of the printer's installed memory. If the clip is more complex than this limit, the LaserWriter driver ignores the maskRgn parameter. For Level 2 printers, the limits are completely memory-based and generally much more flexible. However, once again, in low-memory conditions, the clip may still fail. On PostScript Level 3 printers, all clips should always print correctly regardless of the complexity of the clip since the driver uses the PostScript Level 3 masked image to support this feature.

  • Since the LaserWriter driver implements the transparent mode via clipping, complex transparent regions may occasionally fail on Level 1 or Level 2 devices in low-memory conditions as described above. The result is that the output does not preserve the transparency, and the pixels image with the background color instead.
  • For 2, 4, and 8-bit images with a color look-up table (CLUT), the LaserWriter 8.5.1 driver only supports one index which maps to the background color. Although the CLUT may contain many index values which have the background color and are therefore, in principle, transparent when displayed onscreen, the driver searches the look-up table for the first index which corresponds to the background color. Index samples with that index value are printed as transparent. Other index values which correspond to the background color are not treated as transparent but are printed as the background color.
  • In order to maintain compatibility with many applications, the LaserWriter 8.5.1 driver will ignore a maskRgn which is an empty region under some circumstances (e.g. some rotated text and graphics). Some applications have used the fact that previous drivers always ignored the maskRgn parameter to clip out certain data when printing to QuickDraw printers. Relying on this 'feature' is not recommended, and the fact that there are some edge cases where a zero clip is ignored for compatibility reasons may be a temporary 'feature' of the driver. To avoid accidentally encountering these cases, when you really want a zero clip, either do not draw the image (preferred) or use grafPort clipping to clip it.

Summary

New imaging code in the LaserWriter has opened up some new functionality for the QuickDraw CopyBits() call. We encourage you to try LaserWriter 8.5.1 with your application and any PostScript device.

Further References

Acknowledgements

Thanks to John Blanchard, Tim Carroll and Paul Danbold.


David Gelphman seems to specialize in backwards reading programming languages. From programming in FORTH at the Stanford Linear Accelerator Center, he moved into PostScript at Adobe Systems and then to Telescript at General Magic. He does do most other things in a more or less forward direction, although he has been known to fall off a horse backwards. David, together with his colleague Richard Blanchard, co-designed Apple's LaserWriter 8 PostScript printer driver while working at Adobe Systems. After a stint at General Magic, David now works at RBI Software Systems (http://www.rbi.com) as a contractor to Apple and Adobe on their PostScript printer drivers. He does other contracting work as well, primarily in the area of PostScript printing.

Ingrid Kelly always dreamed of working for Apple Computer while she was growing up in Silicon Valley. What she did not realize back then was that all of her experience printing out school papers on an ImageWriter would turn into a job supporting printing and printer drivers for Apple's Developer Technical Support (DTS) group. After a few years in DTS, Ingrid has now learned to appreciate the black magic involved in printing.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

NetShade 6.3.1 - Browse privately using...
NetShade is an anonymous proxy and VPN app+service for Mac. Unblock your Internet through NetShade's high-speed proxy and VPN servers spanning seven countries. NetShade masks your IP address as you... Read more
Dragon Dictate 4.0.7 - Premium voice-rec...
With Dragon Dictate speech recognition software, you can use your voice to create and edit text or interact with your favorite Mac applications. Far more than just speech-to-text, Dragon Dictate lets... Read more
Persecond 1.0.2 - Timelapse video made e...
Persecond is the easy, fun way to create a beautiful timelapse video. Import an image sequence from any camera, trim the length of your video, adjust the speed and playback direction, and you’re done... Read more
GIMP 2.8.14p2 - Powerful, free image edi...
GIMP is a multi-platform photo manipulation tool. GIMP is an acronym for GNU Image Manipulation Program. The GIMP is suitable for a variety of image manipulation tasks, including photo retouching,... Read more
Sandvox 2.10.2 - Easily build eye-catchi...
Sandvox is for Mac users who want to create a professional looking website quickly and easily. With Sandvox, you don't need to be a Web genius to build a stylish, feature-rich, standards-compliant... Read more
LibreOffice 5.0.1.2 - Free, open-source...
LibreOffice is an office suite (word processor, spreadsheet, presentations, drawing tool) compatible with other major office suites. The Document Foundation is coordinating development and... Read more
f.lux 36.1 - Adjusts the color of your d...
f.lux makes the color of your computer's display adapt to the time of day, warm at night and like sunlight during the day. Ever notice how people texting at night have that eerie blue glow? Or wake... Read more
VirtualBox 5.0.2 - x86 virtualization so...
VirtualBox is a family of powerful x86 virtualization products for enterprise as well as home use. Not only is VirtualBox an extremely feature rich, high performance product for enterprise customers... Read more
File Juicer 4.43 - Extract images, video...
File Juicer is a drag-and-drop can opener and data archaeologist. Its specialty is to find and extract images, video, audio, or text from files which are hard to open in other ways. In computer... Read more
Apple MainStage 3.2 - Live performance t...
MainStage 3 makes it easy to bring to the stage all the same instruments and effects that you love in your recording. Everything from the Sound Library and Smart Controls you're familiar with from... Read more

ReBoard: Revolutionary Keyboard (Utilit...
ReBoard: Revolutionary Keyboard 1.0 Device: iOS Universal Category: Utilities Price: $1.99, Version: 1.0 (iTunes) Description: Do everything within the keyboard without switching apps! If you are in WhatsApp, how do you schedule a... | Read more »
Tiny Empire (Games)
Tiny Empire 1.1.3 Device: iOS Universal Category: Games Price: $2.99, Version: 1.1.3 (iTunes) Description: Launch cannonballs and blow tiny orcs into thousands of pieces in this intuitive fantasy-themed puzzle shooter! Embark on an... | Read more »
Astropad Mini (Productivity)
Astropad Mini 1.0 Device: iOS iPhone Category: Productivity Price: $4.99, Version: 1.0 (iTunes) Description: *** 50% off introductory price! ​*** Get the high-end experience of a Wacom tablet at a fraction of the price with Astropad... | Read more »
Emo Chorus (Music)
Emo Chorus 1.0.0 Device: iOS Universal Category: Music Price: $1.99, Version: 1.0.0 (iTunes) Description: Realistic Choir simulator ranging from simple Chorus emulation to full ensemble Choir with 128 members. ### introductory offer... | Read more »
Forest Spirit (Games)
Forest Spirit 1.0.5 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.5 (iTunes) Description: | Read more »
Ski Safari 2 (Games)
Ski Safari 2 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: The world's most fantastical, fun, family-friendly skiing game is back and better than ever! Play as Sven's sister Evana, share... | Read more »
Lara Croft GO (Games)
Lara Croft GO 1.0.47768 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.47768 (iTunes) Description: Lara Croft GO is a turn based puzzle-adventure set in a long-forgotten world. Explore the ruins of an ancient... | Read more »
Whispering Willows (Games)
Whispering Willows 1.23 Device: iOS Universal Category: Games Price: $4.99, Version: 1.23 (iTunes) Description: **LAUNCH SALE 50% OFF** - Whispering Willows is on sale for 50% off ($4.99) until September 9th. | Read more »
Calvino Noir (Games)
Calvino Noir 1.1 Device: iOS iPhone Category: Games Price: $3.99, Version: 1.1 (iTunes) Description: The film noir stealth game. Calvino Noir is the exploratory, sneaking adventure through the 1930s European criminal underworld.... | Read more »
Angel Sword (Games)
Angel Sword 1.0 Device: iOS Universal Category: Games Price: $6.99, Version: 1.0 (iTunes) Description: Prepare to adventure in the most epic full scale multiplayer 3D RPG for mobile! Experience amazing detailed graphics in full HD.... | Read more »

Price Scanner via MacPrices.net

Big Grips Lift Handle For iPad Air and iPad A...
KEM Ventures, Inc. which pioneered the extra-large, super-protective iPad case market with the introduction of Big Grips Frame and Stand in 2011, is launching Big Grips Lift featuring a new super-... Read more
Samsung Launches Galaxy Tab S2, Its Most Powe...
Samsung Electronics America, Inc. has announced the U.S. release of the Galaxy Tab S2, its thinnest, lightest, ultra-fast tablet. Blending form and function, elegant design and multitasking power,... Read more
Tablet Screen Sizes Expanding as iPad Pro App...
Larger screen sizes are gaining favor as the tablet transforms into a productivity device, with shipments growing 185 percent year-over-year in 2015. According to a new Strategy Analytics’ Tablet... Read more
Today Only: Save US$50 on Adobe Elements 13;...
Keep the memories. lose the distractions. Summer’s winding down and it’s time to turn almost perfect shots into picture perfect memories with Elements 13. And get the power to edit both photos and... Read more
1.4GHz Mac mini on sale for $449, save $50
Best Buy has the 1.4GHz Mac mini on sale for $50 off MSRP on their online store. Choose free shipping or free local store pickup (if available). Price for online orders only, in-store price may vary... Read more
12-inch 1.1GHz Gold MacBook on sale for $1149...
B&H Photo has the 12″ 1.1GHz Gold Retina MacBook on sale for $1149.99 including free shipping plus NY sales tax only. Their price is $150 off MSRP, and it’s the lowest price available for this... Read more
27-inch 3.3GHz 5K iMac on sale for $1849, sav...
Best Buy has the 27″ 3.3GHz 5K iMac on sale for $1849.99. Their price is $150 off MSRP, and it’s the lowest price available for this model. Choose free shipping or free local store pickup (if... Read more
Worldwide Tablet Shipments Expected to Declin...
Does Apple badly need a touchscreen convertible/hybrid laptop MacBook? Yes, judging from a new market forecast from the International Data Corporation (IDC) Worldwide Quarterly Tablet Tracker, which... Read more
Continued PC Shipment Shrinkage Expected Thro...
Worldwide PC shipments are expected to fall by -8.7 percent in 2015 and not stabilize until 2017, according to the latest International Data Corporation (IDC) Worldwide Quarterly PC Tracker data. The... Read more
Imminent iPhone 6s Announcement Leads To 103%...
NextWorth Solutions, with its online and in-store electronics trade-in programs including http://NextWorth.com, reports that it has experienced a 103 percent surge in quoted trade-in values over the... Read more

Jobs Board

*Apple* Music, Business Operations - Apple I...
Changing the world is all in a day039s work at Apple . If you love innovation, here039s your chance to make a career of it. You039ll work hard. But the job comes with Read more
WW *Apple* Retail Online Store: Customer In...
**Job Summary** The Apple Retail - Online Store is seeking an experienced web merchandising analytics professional to join the Customer Insights Team. The Web Read more
Senior Payments Security Manager - *Apple*...
**Job Summary** Apple , Inc. is looking for a highly motivated, innovative and hands-on senior payments security manager to join the Apple Pay security team. You will Read more
Software QA Engineer, *Apple* Pay Security...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
Business Process Engineer ( *Apple* Online S...
**Job Summary** The Apple Online Support Planning team is looking for an experienced Business Process engineer to lead key business process improvement initiatives Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.