TweetFollow Us on Twitter

Jun 01 ADC Direct

Volume Number: 17 (2001)
Issue Number: 06
Column Tag: ADC Direct

Beyond QuickDraw: Quartz

by Travis W. Brown

A Brief Introduction to Mac OS X's New Imaging Model

For nearly two decades, Macintosh graphics have revolved around QuickDraw. QuickDraw was revolutionary, offering a unified imaging model that could be used for application drawing, printing, and providing a platform-wide graphics format. Unfortunately, today's applications frequently require graphic fun-ctionality that exceeds QuickDraw's reach. Developers frequently have to work around issues such as the lack of spline-based curves and text rotations. With the introduction of Mac OS X, a revolution-ary new imaging model—Quartz—is ready to meet the needs of cur-rent and future applications.

This article is a brief introduction to Quartz and will focus on its architecture and functionality. Where appropriate, this article will also call out various technical resources that will help you take advantage of what Quartz has to offer.

What is Quartz?

Quartz is a set of powerful graphics services that form the graphics component of Mac OS X's application services layer. In this role, Quartz pro-vides the rest of the system with a powerful 2-D render-ing engine that supports advanced vector graphics (complete with anti-aliasing and transparency support.) Quartz also implements the windowing system for Mac OS X and provides low-level services such as system-wide event handling. Quartz plays a key role in Mac OS X's printing architec-ture as well and provides rasterization and conversion services for print jobs.

The Quartz Architecture

As noted in Inside Mac OS X: System Overview, Quartz is actually composed of two separate parts that perform different functions: Quartz Compositor and Quartz 2D.

Quartz Compositor

The Quartz Compositor (formerly Core Graphics Services) is responsi-ble for providing windowing services for the Classic, Carbon, Cocoa, and Java application environments. These environments interact directly with the Quartz Compositor to automatically bring advanced windowing features, such as double-buffering and live window drag-ging, to applications. OpenGL and QuickTime rely on the Quartz Compositor to seamlessly mix hardware accelerated 3-D and multime-dia into a single visually consistent windowing environment. Finally, the Quartz Compositor helps create the hallmark Aqua user experi-ence by generating dynamic drop shadows and transparency effects for each open window.

Quartz 2D

Quartz 2D (formerly Core Graphics Rendering) is a two-dimen-sional graphics engine that allows any Mac OS X application to create graphics that were previously limited to high-end applica-tions. Quartz is based on the Portable Document Format (PDF) graphics model and features a rich set of drawing functions. These drawing functions are fully accessible by both Carbon and Cocoa developers.

Core Graphics API Functionality in Quartz 2D

The full power of the Quartz 2D engine is exposed through the Core Graphics API. What follows is a breakdown of the advanced features you can use to create new and exciting Mac OS X applications.

Drawing Functionality

The Core Graphics API contains a comprehensive set of functions that give you access to PostScript-like drawing features. Some of these features include path-based drawing operations (such as

Beziér curves), clipping paths, and transformable coordinate spaces that allow easy access to rotations, scales, and skews. The Quartz 2D engine draws using an advanced sub-pixel anti-aliasing algorithm that significantly enhances the visual appeal of both vectors and text. Additionally, Quart 2D's alpha compositing ability allows for trans-parency effects for vector shapes and supports alpha channels when drawing bitmaps. Detailed information on the Core Graphics API can be found in Inside Mac OS X: Drawing With Quartz, available from the Apple Developer Connection web site at:
http://developer.apple.com/quartz

PDF Support

The Quartz 2D engine is based on the PDF specification and is therefore able to parse and render most PDF files. Using the Core Graphics API, it is easy to add the ability to display PDF files to your application. This PDF support also allows applications to create PDF files by redirecting drawing calls into a file. The resultant PDF file can contain all types of graphic content, including fonts, text, vec-tors, and bitmaps. These capabilities make the PDF file an excellent replacement for the well-worn PICT file.

Adobe's Portable Document Format, v1.3 Reference Guide is the authoritative source of information on the PDF format. The "Graphics" section of the reference guide is particularly useful for understanding the PDF drawing model upon which Quartz 2D is based. You can find the complete guide at:
http://partners.adobe.com/asn/developer/acrosdk/docs/PDFRef.pdf

Color Management

The Quartz 2D engine works in concert with ColorSync to ensure everything it draws is color managed. This tight integration allows your application to participate in end-to-end color management with minimal effort on your part. At the most basic level, your application can programmatically specify colors in a variety of color spaces via the Core Graphics API. Quartz 2D will automati- cally call on ColorSync to ensure the requested color is matched to the display or printer. Color management is also automatically used when drawing PDFs and bitmap images. Lastly, the Quartz 2D engine also has full support for ICC color profiles and render-ing intents.

More information on color management and ColorSync can be found at:
http://developer.apple.com/techpubs/macos8/MultimediaGraphics/ColorSyncManager/colorsyncmanager.html

Fidelity

The Quartz 2D engine is resolution independent and is capable of rendering graphics for both screen and print. The Quartz 2D engine plays an important role in Mac OS X's printing architecture where it acts as the Raster Image Processor (RIP) for inkjet printers and other raster devices. The Quartz 2D engine is also capable of converting graphic streams into PostScript code for imaging on PostScript output devices. So, applications that use the Core Graphics API can easily output graphics to a full range of printers, from inexpensive inkjet printers to high-end PostScript devices, with excellent and consistent results.

Resources to Help You Take Full Advantage of Quartz

The Quartz technologies web site is the first place you should check for the latest information on Mac OS X's graphic technologies. The Quartz web site, which is part of the Apple Developer Connection, can be found at:
http://developer.apple.com/quartz/index.html

For compatibility with earlier versions of the Mac OS, Carbon applications use QuickDraw for two-dimensional graphics drawing by default. These applications can, however, access Quartz 2D's Core Graphics API. The Quartz Primer was created to help Carbon developers understand how to use this powerful tool. The primer is available at:
http://developer.apple.com/techpubs/macosx/SystemOverview/devessentials.html

Many Carbon developers have expressed interest in drawing text using Quartz 2D's advanced anti-aliasing. The Core Graphics API has basic support for text drawing, though. Higher-level services, such as ATSUI and MLTE, have been included in Mac OS X to draw text when working with Quartz. More information on Mac OS X's text services can be found at:
http://developer.apple.com/intl/index.html

Cocoa developers have a "free pass" to access the Quartz 2D engine. Three key classes–NSView, NSImage, and NSBezierPath– call through to the Quartz 2D engine. Developers may discover cases, though, in which directly accessing the Quartz 2D engine is desirable. To address this need, the Core Graphics API can easily be called from Cocoa and used in conjunction with a Cocoa View. Information contained within the Core Graphics header files is a good place to start. The header files can be found at:
/System/Library/Frameworks/ApplicationServices.framework/Frameworks/CoreGraphics.framework/ Headers

Other Quartz APIs of Interest

In addition to the Core Graphics API, Quartz also contains some specialized APIs that may be of inter-est to you.

Remote Operation

This API interacts with Quartz Compositor to enable applications to capture screen contents and push keyboard/mouse events into the system. If you are designing a screen capture program, a remote access application, or an accessibility aid then you should check out the CGRemoteOperation API. A well-documented header file is located at:
/System/Library/Frameworks/ApplicationServices.framework/Frameworks/CoreGraphics.framework/ Headers/CGRemoteOperation.h

Direct Display

This API allows applications to get direct access to the screen. Applications, such as games, can use this API to capture the display, set the display reso-lution, and gain direct access to the frame buffer. Information on CGDirectDisplay can be found in the header file that is located at:
/System/Library/Frameworks/ApplicationServices.framework/Frameworks/CoreGraphics.framework/ Headers/CGDirectDisplay.h

Summary

Quartz is a powerful new graphics system that performs two vital roles in Mac OS X. The Quartz Compositor provides windowing services to all of Mac OS X. The Quartz 2D engine is responsible for creating visually rich graphic content on-screen and ensuring high-fidelity output to all classes of printers. Of primary interest to develop-ers is the Core Graphics API. This API offers devel-opers exciting opportunities to create new and powerful graphic applications by leveraging the Quartz 2D engine's PostScript-style drawing, color management, and PDF file support.


Project Builder Tips and Tricks

  • The malloc library on Mac OS X has a bunch of features that can help you track down memory smashers, buffer overruns, and other Stupid Pointer Tricks(tm). Check out
    /Developer/Documentation/ReleaseNotes/ MallocOptions.html to learn how to use these features.
  • Don't put all your application's user interface into one nib. When a nib file is open all objects are instantiated at once. Breaking up your user interface among multiple nibs will make your application launch faster and use less memory. It will also be easier to reuse part of your application.
  • Interface Builder
    Option Drag knobs: Makes matrices in Cocoa
    Command: Inverts guide activation
    Double Click to open editors
    Shift-arrow: nudge widgets by 10 instead of 1 pixels
    Drag custom views into the document for use as accessory views
    Option drag views into New Palettes

New Mac OS X Related Releases

  • Mac OS X 10.0.2 and iTunes 1.1.1
    Mac OS X 10.0.2 and iTunes 1.1.1 together add the ability to burn custom music CDs to Macintosh computers with CD-R drives. Mac OS X also features improvements in overall application stability and the latest version of the Internet file transfer service (ftpd), which features important security improvements.
    http://asu.info.apple.com/swupdates.nsf/artnum/n12181/
    http://asu.info.apple.com/swupdates.nsf/artnum/n12186/
  • CarbonLib 1.3.1 SDK
    The CarbonLib 1.3.1 SDK (Software Development Kit) for Mac OS X is now available to all developers. This SDK provides all the files needed to begin Carbon development. Contact Software Licensing to distribute CarbonLib 1.3.1 with your product.
    http://developer.apple.com/sdk/
  • Disk First Aid 8.6.1 (US and Int'l English)
    Disk First Aid 8.6.1 (US and Int'l English) is a utility that verifies and repairs some problems that may occur on Mac OS Extended format hard disk drives. This version of repairs certain types of master directory block damage on Mac OS Extended format volumes. It also improves the compatibility of Mac OS Extended format hard disks with Mac OS X.
    http://asu.info.apple.com/swupdates.nsf/artnum/n12187/
  • Software Update 1.3.1
    Software Update 1.3.1 is a multicountry update for the Mac OS X Software Update control panel.
    http://asu.info.apple.com/swupdates.nsf/artnum/n12165/
  • Darwin 1.3.1
    Darwin 1.3.1 is the open source core of Mac OS X. This open source project allows developers to customize and enhance key Apple software. The Darwin kernel is based on FreeBSD and Mach 3.0 technologies and provides protected memory and pre-emptive multitasking.
    http://www.opensource.apple.com/projects/darwin/

    Developer Documentation

    The following new and updated documentation is available to help with successful Mac OS X application and peripheral development at:
    http://developer.apple.com/techpubs/

    iBook Developer Note


    TN2018 - Importing animated GIFs
    TN2017 - Using Launch Services for discovering document binding and launching applications
    QA1034 - How to define a plst resource in a .r file
    QA1033 - Targeting DebuggingCarbonLib asserts
    QA1032 - Late breaking news for the MacsBug gdb plugin
    QA1031 - OpenGL Texture Sharing Between Contexts
    QA1030 - Getting NSWindow's toolbar actions to show up in Interface Builder
    QA1029 - How to get custom views to show up in NSToolbarItems
    QA1028 - ICLaunchURL, "file:///" URLs and Mac OS X
    QA1027 - Improving ATSUI text drawing performance
    QA1026 - Calling AppleScript from an Application
    QA1023 - The installer turns my application into a folder
    QA1022 - Where should I install my help book, and how does Help Viewer locate it?
    QA1021 - Cocoa-Java quit/cancel-quit header bug in Mac OS X 10.0
    QA1015 - Why am I drawing directly to the screen?
    QA1011 - How do I use QuickDraw with CGDirectDisplay?
    QA1010 - SynCGContextOriginWithPort
    QA1009 - Why are my Core Graphics calls drawing updside down?---

    Sample Code - More than thirty new Mac OS X code samples were posted to the ADC web site since the last issue. Please visit the URL below for a complete list of sample code.
    http://developer.apple.com/samplecode/


Did You Know?

Quartz Documentation

The technical writers at Apple are hard at work preparing Quartz documentation for software developers. Already available is the "Quartz Primer," a short document that summarizes Quartz features and concepts, discusses how to incorporate the graphics-rendering capabilities of Quartz into Carbon code, and includes examples of using Quartz APIs. You can get this document at
http://developer.apple.com/techpubs/macosx/SystemOverview/devessentials.html

In the works is Inside Mac OS X: Drawing With Quartz. This book is intended to be an essential resource for any software developer interested in learning about and using the advanced two-dimensional graphics capabilities of Mac OS X. It will discuss the following topics:

  • graphics contexts, coordinates, transformation matrices, graphics state, and transfer modes
  • transparency and anti-aliased drawing
  • drawing shapes with paths
  • drawing text
  • working with color
  • drawing images and PDF documents

Upcoming Seminars and Events

For more information on Apple developer events please visit the developer Events page at:
http://developer.apple.com/events/

Training and Seminars

R/com Offers Mac OS X Developer Training Online
R/com, also known as Media School, has partnered with Apple Developer Connection to create online training for Mac OS X developers. The first cours-es include "Application Development for Mac OS X," "Carbon Development for Mac OS X," and "Cocoa: The Object-Oriented Application Solution." Check out to take a free virtual seminar, learn more about current and upcoming courses, and find out about the significant discounts offered to Premier, Select, and student members of the Apple Developer Connection.
http://www.mediaschool.com/adc

Apple iServices 5-day Cocoa Training
For application developers who want to learn how to develop Mac OS X applications using Cocoa, Apple iServices offers a five-day comprehensive, hands-on Cocoa training course. This course uses real-world examples and is perfect for developers who have a general understanding of object-oriented concepts and practical experience with the C programming language or a C-derived language (Object-C, Java, or C++). The course costs US $2,495
http://www.apple.com/iservices/technicaltraining/cocoadev.html

AppleScript Intensive Workshop
Four-day interactive experience for intermediate and advanced scripters June 4-7 in Chicago IL (DATES CHANGED) June 12-15 in Santa Monica CA
http://www.mainevent.com/intensive.html

Developer Related Conferences


QuickTime BootCamp Authoring Conference in Europe
Held June 6 and 7 in Cologne, Germany
http://www.qtbootcamp.de

MacHack Conference Dearborn, MI
June 21-23
MacHack, in its sixteenth year, remains centered around cutting edge soft- ware development. MacHack's uniqueness derives from the informal feel and the LIVE coding that occurs around-the-clock during the conference.
http://www.machack.com/

MACWORLD Expo, New York 2001
July 17-20 in Jacob Javits Convention Center, NYC
Discounted exhibitor packages available
http://developer.apple.com/mkt/mwny2001.html


Travis W. Brown is the Imaging Technology Manager for Mac OS X in Apple's Worldwide Developer Relations. Travis has been involved in digital imaging for the past decade, working on various products, ranging from drivers for color printers and digital photographic imaging systems to PostScript interpreters.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Geekbench 4.4.0 - Measure processor and...
Geekbench provides a comprehensive set of benchmarks engineered to quickly and accurately measure processor and memory performance. Designed to make benchmarks easy to run and easy to understand,... Read more
CleanMyMac X 4.4.4 - Delete files that w...
CleanMyMac makes space for the things you love. Sporting a range of ingenious new features, CleanMyMac lets you safely and intelligently scan and clean your entire system, delete large, unused files... Read more
TeamViewer 14.4.2669 - Establish remote...
TeamViewer gives you remote control of any computer or Mac over the Internet within seconds or can be used for online meetings. Find out why more than 200 million users trust TeamViewer! Free for non... Read more
Paperless 3.0.6 - $69.95
Paperless is a digital documents manager. Remember when everyone talked about how we would soon be a paperless society? Now it seems like we use paper more than ever. Let's face it - we need and we... Read more
BetterTouchTool 3.141 - Customize multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom)... Read more
TextMate 2.0.rc.29 - Code/markup editor...
TextMate is a versatile plain text editor with a unique and innovative feature set which caused it to win an Apple Design Award for Best Mac OS X Developer Tool in August 2006 A rapidly growing... Read more
Little Snitch 4.4.1 - 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
Little Snitch 4.4 - Alerts you about out...
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
MPlayer OSX Extended 16 - Multimedia pla...
MPlayer OSX Extended is the future of MPlayer OSX. Leveraging the power of the MPlayer and FFmpeg open source projects, MPlayer OSX Extended aims to deliver a powerful, functional and no frills video... Read more
Google Chrome 75.0.3770.142 - Modern and...
Google Chrome is a Web browser by Google, created to be a modern platform for Web pages and applications. It utilizes very fast loading of Web pages and has a V8 engine, which is a custom built... Read more

Latest Forum Discussions

See All

TEPPEN guide - Tips and tricks for new p...
TEPPEN is a wild game that nobody asked for, but I’m sure glad it exists. Who would’ve thought that a CCG featuring Capcom characters could be so cool and weird? In case you’re not completely sure what TEPPEN is, make sure to check out our review... | Read more »
Dr. Mario World guide - Other games that...
We now live in a post-Dr. Mario World world, and I gotta say, things don’t feel too different. Nintendo continues to squirt out bad games on phones, causing all but the most stalwart fans of mobile games to question why they even bother... | Read more »
Strategy RPG Brown Dust introduces its b...
Epic turn-based RPG Brown Dust is set to turn 500 days old next week, and to celebrate, Neowiz has just unveiled its biggest and most exciting update yet, offering a host of new rewards, increased gacha rates, and a brand new feature that will... | Read more »
Dr. Mario World is yet another disappoin...
As soon as I booted up Dr. Mario World, I knew I wasn’t going to have fun with it. Nintendo’s record on phones thus far has been pretty spotty, with things trending downward as of late. [Read more] | Read more »
Retro Space Shooter P.3 is now available...
Shoot-em-ups tend to be a dime a dozen on the App Store, but every so often you come across one gem that aims to shake up the genre in a unique way. Developer Devjgame’s P.3 is the latest game seeking to do so this, working as a love letter to the... | Read more »
Void Tyrant guide - Guildins guide
I’ve still been putting a lot of time into Void Tyrant since it officially released last week, and it’s surprising how much stuff there is to uncover in such a simple-looking game. Just toray, I finished spending my Guildins on all available... | Read more »
Tactical RPG Brown Dust celebrates the s...
Neowiz is set to celebrate the summer by launching a 2-month long festival in its smash-hit RPG Brown Dust. The event kicks off today, and it’s divided into 4 parts, each of which will last two weeks. Brown Dust is all about collecting, upgrading,... | Read more »
Flappy Royale is an incredibly clever ta...
I spent the better part of my weekend playing Flappy Royale. I didn’t necessarily want to. I just felt like I had to. It’s a hypnotic experience that’s way too easy to just keep playing. | Read more »
Void Tyrant guide - General tips and tri...
Void Tyrant is a card-based dungeon-crawler that doesn’t fit in the mold of other games in the genre. Between the Blackjack-style combat and strange gear system alone, you’re left to your own devices to figure out how best to use everything to your... | Read more »
Webzen’s latest RPG First Hero is offici...
You might be busy sending your hulking Dark Knight into the midst of battle in Webzen’s other recent release: the long-anticipated MU Origin 2. But for something a little different, the South Korean publisher has launched First Hero. Released today... | Read more »

Price Scanner via MacPrices.net

Amazon drops prices, now offers clearance 13″...
Amazon has new dropped prices on clearance 13″ 2.3GHz Dual-Core non-Touch Bar MacBook Pros by $200 off Apple’s original MSRP, with prices now available starting at $1099. Shipping is free. Be sure to... Read more
2018 15″ MacBook Pros now on sale for $500 of...
Amazon has dropped prices on select clearance 2018 15″ 6-Core MacBook Pros to $500 off Apple’s original MSRP. Prices now start at $1899 shipped: – 2018 15″ 2.2GHz Touch Bar MacBook Pro Silver: $1899.... Read more
Price drop! Clearance 12″ 1.2GHz Silver MacBo...
Amazon has dropped their price on the recently-discontinued 12″ 1.2GHz Silver MacBook to $849.99 shipped. That’s $450 off Apple’s original MSRP for this model, and it’s the cheapest price available... Read more
Apple’s 21″ 3.0GHz 4K iMac drops to only $936...
Abt Electronics has dropped their price on clearance, previous-generation 21″ 3.0GHz 4K iMacs to only $936 shipped. That’s $363 off Apple’s original MSRP, and it’s the cheapest price we’ve seen so... Read more
Amazon’s Prime Day savings on Apple 11″ iPad...
Amazon has new 2018 Apple 11″ iPad Pros in stock today and on sale for up to $250 off Apple’s MSRP as part of their Prime Day sale (but Prime membership is NOT required for these savings). These are... Read more
Prime Day Apple iPhone deal: $100 off all iPh...
Boost Mobile is offering Apple’s new 2018 iPhone Xr, iPhone Xs, and Xs Max for $100 off MSRP. Their discount reduces the cost of an Xs to $899 for the 64GB models and $999 for the 64GB Xs Max. Price... Read more
Clearance 13″ 2.3GHz Dual-Core MacBook Pros a...
Focus Camera has clearance 2017 13″ 2.3GHz/128GB non-Touch Bar Dual-Core MacBook Pros on sale for $169 off Apple’s original MSRP. Shipping is free. Focus charges sales tax for NY & NJ residents... Read more
Amazon Prime Day deal: 9.7″ Apple iPads for $...
Amazon is offering new 9.7″ WiFi iPads with Apple Pencil support for $80-$100 off MSRP as part of their Prime Day sale, starting at only $249. These are the same iPads found in Apple’s retail and... Read more
Amazon Prime Day deal: 10% (up to $20) off Ap...
Amazon is offering discounts on new 2019 Apple AirPods ranging up to $20 (10%) off MSRP as part of their Prime Day sales. Shipping is free: – AirPods with Charging Case: $144.99 $15 off MSRP –... Read more
Amazon Prime Day deal: $50-$80 off Apple Watc...
Amazon has Apple Watch Series 4 and Series 3 models on sale for $50-$80 off Apple’s MSRP as part of their Prime Day deals with prices starting at only $199. Choose Amazon as the seller rather than a... Read more

Jobs Board

*Apple* Systems Architect/Engineer, Vice Pre...
…its vision to be the world's most trusted financial group. **Summary:** Apple Systems Architect/Engineer with strong knowledge of products and services related to Read more
*Apple* Graders/Inspectors (Seasonal/Hourly/...
…requirements. #COVAentryleveljobs ## Minimum Qualifications Some knowledge of agricultural and/or the apple industry is helpful as well as the ability to comprehend, Read more
Best Buy *Apple* Computing Master - Best Bu...
**710003BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Store Associates **Location Number:** 000171-Winchester Road-Store **Job Description:** Read more
Best Buy *Apple* Computing Master - Best Bu...
**709786BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Sales **Location Number:** 000430-Orange Park-Store **Job Description:** **What does a Read more
Geek Squad *Apple* Master Consultation Agen...
**709918BR** **Job Title:** Geek Squad Apple Master Consultation Agent **Job Category:** Services/Installation/Repair **Location Number:** 000106-Palmdale-Store Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.