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

NetNewsWire 5.1 - RSS and Atom news read...
NetNewsWire is the best way to keep up with the sites and authors you read most regularly. Let NetNewsWire pull down the latest articles, and read them in a distraction-free and Mac-like way. Native... Read more
FontExplorer X Pro 7.1.3 - Font manageme...
FontExplorer X Pro is optimized for professional use; it's the solution that gives you the power you need to manage all your fonts. Now you can more easily manage, activate and organize your... Read more
DiskCatalogMaker 8.2.5 - Catalog your di...
DiskCatalogMaker is a simple disk management tool which catalogs disks. Simple, light-weight, and fast Finder-like intuitive look and feel Super-fast search algorithm Can compress catalog data for... Read more
Skim 1.5.12 - PDF reader and note-taker...
Skim is a PDF reader and note-taker for OS X. It is designed to help you read and annotate scientific papers in PDF, but is also great for viewing any PDF file. Skim includes many features and has a... Read more
rekordbox 6.1.0.0030 - Professional DJ m...
rekordbox is the best way of preparing and managing your tracks, be it at home, in the studio, or even on the plane! It allows you to import music from other music-management software using the... Read more
iExplorer 4.4.0 - View and transfer file...
iExplorer is an iPhone browser for Mac lets you view the files on your iOS device. By using a drag and drop interface, you can quickly copy files and folders between your Mac and your iPhone or... Read more
OmniGraffle 7.17.5 - Create diagrams, fl...
OmniGraffle helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use Graffle to... Read more
Apple Configurator 2.13.1 - Configure an...
Apple Configurator makes it easy to deploy iPad, iPhone, iPod touch, and Apple TV devices in your school or business. Use Apple Configurator to quickly configure large numbers of devices connected to... Read more
OmniGraffle Pro 7.17.5 - Create diagrams...
OmniGraffle Pro helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use... Read more
FoldersSynchronizer 5.1.6 - Synchronize...
FoldersSynchronizer is a popular and useful utility that synchronizes and backs-up files, folders, disks and boot disks. On each session you can apply special options like Timers, Multiple Folders,... Read more

Latest Forum Discussions

See All

Infinity Mechs is an upcoming idle game...
Indie developer SkullStar studio has announced an upcoming idle mech game called Infinity Mechs. It draws inspiration from the mobile game Iron Saga and has been officially licensed by Game Duchy. It's set to launch for both iOS and Android on... | Read more »
PUBG Mobile Lite's latest update se...
PUBG Mobile Lite, the streamlined version of the popular battle royale that's designed to work on less powerful devices, sees the return of a popular game variant today, Survive Till Dawn mode. It arrives as part of the 0.19.0 content update. [... | Read more »
Matchy Catch, Jyamma Games’ new hyper-ca...
Matchy Catch is a new hyper-casual puzzler from Jyamma Games, the Italian studio behind the Pong-inspired puzzle-adventure Hi-Ball Rush. It’s only the developer’s second game for iOS and Android devices, but it promises to be every bit as fun and... | Read more »
Among Us! Imposter Guide - How to be a s...
Among Us! continues to be getting a lot of play in these parts, and since our first guide we've learned a thing or two about the game. This is especially true regarding the imposter role, as its a relatively rare opportunity that we've now put... | Read more »
Paladin's Story is an upcoming fant...
Paladin's Story is an upcoming fantasy RPG with an off-kilter sense of humour that's heading for iOS and Android. It will officially launch for both on September 16th though the game is already available on Google Play in Early Access. [Read more... | Read more »
Among Us! Guide - Tips for the uninitiat...
| Read more »
A Pretty Odd Bunny is a stealth-platform...
A Pretty Odd Bunny is a stealth-platformer from two-man team AJ Ordaz and René Rivera. It follows the story of a red-eyed rabbit who is allergic to carrots and instead has a penchant for devouring pigs. It's available now for Android devices. [... | Read more »
Apple Arcade: Ranked - Top 25 [Updated 9...
In case you missed it, I am on a quest to rank every Apple Arcade game there is. [Read more] | Read more »
The 5 Best Mobile Games Like Tony Hawk...
Tony Hawk’s Pro Skater 1+2 dropped last week, meaning you can get remastered versions of two of the most iconic “sports” games ever made and experience some of the highest watermarks set in games of generations’ past. [Read more] | Read more »
Bouncing Box is a challenging platformer...
In platformers, we often spend a large amount of time mindless destroying boxes by jumping onto or into them, whatever makes them splinter apart. Bouncing Box from developer The K Brothers aims to give those poor destructible cubes a chance to be... | Read more »

Price Scanner via MacPrices.net

Base 13″ 1.4GHz Apple MacBook Pros on sale fo...
Apple reseller Expercom is offering a $65-$75 discount on new 2020 13″ 1.4GHz MacBook Pros, depending on configuration. Shipping is free. Expercom estimates shipping in 3-5 days, as stock of Apple’s... Read more
Price drop! Get a 44mm Apple Watch Series 5 G...
Amazon has dropped their price on the 44mm Apple Watch Series 5 GPS + Cellular by $100 to $429 shipped. That’s $100 off Apple’s original MSRP for this model. For the latest prices and sales, see our... Read more
Verizon offers $200 discount on new Apple Wat...
Verizon will take up to $200 off the purchase of a new GPS + Cellular Apple Watch Series 6 or Apple Watch SE with select trade-in and the purchase of a new iPhone with service. The fine print: “Get... Read more
Verizon offers $250 discount on new 8th gener...
Verizon will take up to $250 off the price of an 8th generation 2020 Apple Cellular iPad with select trade-ins and a new iPhone purchase. Plus get Apple News+ free for 6 months. The fine print: “Save... Read more
Apple’s Implementation Of COVID-19 Exposure...
NEWS: 09.18.20 – The latest effort by Apple to embed exposure notifications for COVID-19 contact tracing right into its mobile operating system has some iPhone users weary of being exposed to... Read more
Here’s how to get a 16″ MacBook Pro for $300...
B&H Photo has new 16″ MacBook Pros on sale today for $250-$300 off Apple’s MSRP, starting at $2099. Expedited shipping is free to many addresses in the US: – 2019 16″ 2.6GHz 6-Core MacBook Pro... Read more
Apple has Certified Refurbished 16″ MacBook P...
Apple has Certified Refurbished 2019 16″ MacBook Pros available for up to $420 off the cost of new models, starting at $2039. Each model features a new outer case, shipping is free, and an Apple 1-... Read more
Price drops! Apple reseller B&H drops App...
B&H Photo has dropped prices on Apple Watch Series 5 models by $50-$70 off Apple’s original MSRP. Shipping is free. These are the same Apple Watch models sold by Apple in their retail and online... Read more
Apple extends their 2020 Back-to-School promo...
As part of their Back to School promotion for 2020, Apple will include one free pair Apple AirPods (with charging case) with the purchase of a MacBook Air, MacBook Pro, iMac, iMac Pro (Mac Pro and... Read more
Apple 7.9″ iPad minis are on sale today for $...
Amazon has new 7.9″ 64GB WiFi iPad minis on sale today for $50 off Apple’s MSRP, each including free shipping. Prices start at $349. These are the same iPad minis sold by Apple in their retail and... Read more

Jobs Board

Security Officer ($23.00/Hourly) - *Apple*...
**Security Officer \($23\.00/Hourly\) \- Apple Store** **Description** About NMS Built on a culture of safety and integrity, NMSdelivers award\-winning, integrated Read more
Platform - Workplace Eng - *Apple* Enterpri...
MORE ABOUT THIS JOB We are looking for an Apple Platform Engineer who will bring a unique engineering skill set, support, clarity, organization and above all else, Read more
*Apple* Certified Repair Technician - Utah S...
…selected candidate will work in the USU Campus Store Tech Department as an Apple Certified Repair Technician and floor associate. This position is for both summer Read more
Senior Data Engineer - *Apple* - Theorem, L...
Job Summary Apple is seeking an experienced, detail-minded data engineeringconsultant to join our worldwide business development and strategy team. If you are Read more
Desktop Support Technician - A+, *Apple* -...
Desktop Support Technician - A+, Apple **Ref No.:** 20-01604 **Location:** Miami, Florida **e** at http://www.excell.com/ **X** at http://www.excell.com/ **cell** at Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.