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

Duplicate Annihilator 5.7.5 - Find and d...
Duplicate Annihilator takes on the time-consuming task of comparing the images in your iPhoto library using effective algorithms to make sure that no duplicate escapes. Duplicate Annihilator... Read more
BusyContacts 1.0.2 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
Capture One Pro 8.2.0.82 - RAW workflow...
Capture One Pro 8 is a professional RAW converter offering you ultimate image quality with accurate colors and incredible detail from more than 300 high-end cameras -- straight out of the box. It... Read more
Backblaze 4.0.0.872 - Online backup serv...
Backblaze is an online backup service designed from the ground-up for the Mac.With unlimited storage available for $5 per month, as well as a free 15-day trial, peace of mind is within reach with... Read more
Little Snitch 3.5.2 - Alerts you about o...
Little Snitch gives you control over your private outgoing data. Track background activity As soon as your computer connects to the Internet, applications often have permission to send any... Read more
Monolingual 1.6.4 - Remove unwanted OS X...
Monolingual is a program for removing unnecesary language resources from OS X, in order to reclaim several hundred megabytes of disk space. If you use your computer in only one (human) language, you... Read more
CleanApp 5.0 - Application deinstaller a...
CleanApp is an application deinstaller and archiver.... Your hard drive gets fuller day by day, but do you know why? CleanApp 5 provides you with insights how to reclaim disk space. There are... Read more
Fantastical 2.0 - Create calendar events...
Fantastical is the Mac calendar you'll actually enjoy using. Creating an event with Fantastical is quick, easy, and fun: Open Fantastical with a single click or keystroke Type in your event details... Read more
Cocktail 8.2 - General maintenance and o...
Cocktail is a general purpose utility for OS X that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
Direct Mail 4.0.4 - Create and send grea...
Direct Mail is an easy-to-use, fully-featured email marketing app purpose-built for OS X. It lets you create and send great looking email campaigns. Start your newsletter by selecting from a gallery... Read more

Appy to Have Known You - Lee Hamlet Look...
Being at 148Apps these past 2 years has been an awesome experience that has taught me a great deal, and working with such a great team has been a privilege. Thank you to Rob Rich, and to both Rob LeFebvre and Jeff Scott before him, for helping me... | Read more »
MLB Manager 2015 (Games)
MLB Manager 2015 5.0.14 Device: iOS Universal Category: Games Price: $4.99, Version: 5.0.14 (iTunes) Description: Guide your favorite MLB franchise to glory! MLB Manager 2015, officially licensed by MLB.com and based on the award-... | Read more »
Breath of Light (Games)
Breath of Light 1.0.1421 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.1421 (iTunes) Description: Hold a quiet moment. Breath of Light is a meditative and beautiful puzzle game with a hypnotic soundtrack by... | Read more »
WWE WrestleMania Tags into the App Store
Are You ready to rumble? The official WWE WrestleMania app, by World Wrestling Entertainment, is now available. Now you can get all your WrestleMania info in one place before anyone else. The app offers details on superstar signings, interactive... | Read more »
Bio Inc's New Expansion is Infectin...
Bio Inc., by DryGin Studios, is the real time strategy game where you infect a human body with the worst virus your evil brain can design. Recently, the game was updated to add a whole lot of new features. Now you can play the new “Lethal”... | Read more »
The Monocular Minion is Here! Despicable...
Despicable Me: Minion Rush, by Gameloft, is introducing a new runner to the mix in their latest update. Now you can play as Carl, the prankster minion. Carl has a few new abilities to play with, including running at a higher speed from the start.... | Read more »
Dungeon of Madness (Games)
Dungeon of Madness 1.0.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.0 (iTunes) Description: Dungeon of Madness is an action game where you rotate tiles to create our own route. Help the hero by connecting the... | Read more »
Filters for iPhone (Photography)
Filters for iPhone 1.0 Device: iOS iPhone Category: Photography Price: $.99, Version: 1.0 (iTunes) Description: | Read more »
Jump'N'Shoot Attack (Games)
Jump'N'Shoot Attack 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: A mobile game for gamers! Join Louise Lightfoot, the legendary "Master of Jumping and Shooting", on her mission to save... | Read more »
Space Bounties Inc. (Games)
Space Bounties Inc. 1.4 Device: iOS Universal Category: Games Price: $1.99, Version: 1.4 (iTunes) Description: SuperGameDroid: 4/5 "Satisfying futuristic RPG combat, high replay value, and a heavy dose of nostalgia make Space... | Read more »

Price Scanner via MacPrices.net

iMacs on sale for up to $205 off MSRP
B&H Photo has 21″ and 27″ iMacs on sale for up to $205 off MSRP including free shipping plus NY sales tax only: - 21″ 1.4GHz iMac: $1019 $80 off - 21″ 2.7GHz iMac: $1189 $110 off - 21″ 2.9GHz... Read more
Färbe Technik Offers iPhone Battery Charge LI...
Färbe Technik, which manufactures and markets of mobile accessories for Apple, Blackberry and Samsung mobile devices, is offering tips on how to keep your iPhone charged while in the field: •... Read more
Electronic Recyclers International CEO Urges...
Citing a recent story on CNBC about concerns some security professionals have about the forthcoming Apple Watch, John Shegerian, Chairman and CEO of Electronic Recyclers International (ERI), the... Read more
Save up to $380 with Apple refurbished iMacs
The Apple Store has Apple Certified Refurbished iMacs available for up to $380 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 27″ 3.5GHz 5K iMac – $2119 $... Read more
Logitech Says MX Master Is Its Most Advanced...
Logitech’s new MX Master Wireless Mouse incorporates the best of Logitech’s many computer mouse innovations into a striking hand-sculpted design. The company claims that the MX Master creates a new... Read more
Save up to $300 on a new Mac, $30 on an iPad,...
Purchase a new Mac or iPad at The Apple Store for Education and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free,... Read more
Apple refurbished 2014 MacBook Airs available...
The Apple Store lowered prices on Apple Certified Refurbished 2014 MacBook Airs recently, with models now available starting at $679. An Apple one-year warranty is included with each MacBook, and... Read more
Mac Notebook Evolution; A Desktop Replacement...
More often than not right from the beginning, Apple’s Macs have tended to skew toward small. The original Macs were called “compacts,”, and notwithstanding a few exceptions like the honking Big Mac... Read more
13-inch 1.4GHz/128GB MacBook Air (Apple refur...
The Apple Store has Apple Certified Refurbished 2014 13″ 1.4GHz/128GB MacBook Airs available for $759 including free shipping plus Apple’s standard one-year warranty. Their price is $240 off original... Read more
YEP! Alternative Browser for iOS Now Supports...
Pfaeffikon, Switzerland based Power App AG has announced the release of an update to their Yep! Web Browser (v1.3.0) for iOS8 iPhone and iPad. Yep! hit the App Store shortly after the release of iOS... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Sr. Technical Services Consultant, *Apple*...
**Job Summary** Apple Professional Services (APS) has an opening for a senior technical position that contributes to Apple 's efforts for strategic and transactional Read more
Lead *Apple* Solutions Consultant - Retail...
**Job Summary** Job Summary The Lead ASC is an Apple employee who serves as the Apple business manager and influencer in a hyper-business critical Reseller's store Read more
*Apple* Pay - Site Reliability Engineer - Ap...
**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
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.