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

Capo 3.2 - Slow down and learn to play y...
Capo lets you slow down your favorite songs so you can hear the notes and learn how they are played. With Capo, you can quickly tab out your songs atop a highly-detailed OpenCL-powered spectrogram... Read more
OmniOutliner 4.2.3 - Organize your ideas...
OmniOutliner is a flexible program for creating, collecting, and organizing information. Give your creativity a kick start by using an application that's actually designed to help you think. It's... Read more
pwSafe 4.0.1 - Secure password managemen...
pwSafe provides simple and secure password management across devices and computers. pwSafe uses iCloud to keep your password databases backed-up and synced between Macs and iOS devices. It is... Read more
WALTR 1.5.4 - Drag-and-drop any media fi...
WALTR is designed to make it easy to upload and convert any music or video file to an iPad or iPhone format for native playback. It supports a huge variety of media file types, including MP3, MP4,... Read more
Audio Hijack 3.1 - Record and enhance au...
Audio Hijack (was Audio Hijack Pro) drastically changes the way you use audio on your computer, giving you the freedom to listen to audio when you want and how you want. Record and enhance any audio... Read more
PopChar 7.1 - Floating window shows avai...
We're also selling a 5-license family pack for only $25.99! PopChar helps you get the most out of your font collection. With its crystal-clear interface, PopChar X provides a frustration-free way to... Read more
BBEdit 11.1.1 - Powerful text and HTML e...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more
Picasa 3.9.139 - Organize, edit, and sha...
Picasa and Picasa Web Albums allows you to organize, edit, and upload your photos to the Web from your computer in quick, simple steps. Arrange your photos into folders and albums and erase their... Read more
Mac DVDRipper Pro 5.0.5 - Copy, backup,...
Mac DVDRipper Pro is the DVD backup solution that lets you protect your DVDs from scratches, save your batteries by reading your movies from your hard disk, manage your collection with just a few... Read more
NetShade 6.2 - Browse privately using an...
This promotion is for NetShade and 1 year of Proxy and VPN services NetShade is an anonymous proxy and VPN app+service for Mac. Unblock your Internet through NetShade's high-speed proxy and VPN... Read more

Block Fortress has a Big New Update for...
Block Fortress is a survival-style game that's as fun as it is blocky. It's also just gotten a rather sizeable update that adds a lot more cool stuff. [Read more] | Read more »
Simple and Surreal Star Base Sim rymdkap...
I really like rymdkapsel. Not just because I'm a sucker for games that are cleverly simple or highly stylisitc, but because it's fun and challenging. Actually it's extremely challenging, which is why I was excited to learn that it's getting a couple... | Read more »
Check out the anticipated Angel Stone in...
Fincon has finally revealed Angel Stone in action in the first ever official gameplay trailer for the anticipated hack and slasher. Angel Stone is set in a post-apocalyptic world in which humanity is in danger of being wiped out by the demonic... | Read more »
Moleskine Timepage is an All-New Calenda...
Moleskine Timepage is a bit of a departure for the notebook manufacturer (since it has little to do with notebooks), but it certainly carries their simple and elegant style quite well. [Read more] | Read more »
Jog on Over and Check Out the New Runtas...
Runtastic has put out a fair number of apps to help you sleep, track excercise, and train various parts of your body. Now it's time for your legs to have their own time in the spotlight with Runtastic Leg Trainer. [Read more] | Read more »
It's Lights Out in the Upcoming Pla...
Ember’s Journey is a stark puzzle platformer with a twist: the entire game is played in darkness. The only light you can see by is the one emanating from your own character. [Read more] | Read more »
MooVee - Your Movies Guru (Entertainmen...
MooVee - Your Movies Guru 1.0 Device: iOS iPhone Category: Entertainment Price: $1.99, Version: 1.0 (iTunes) Description: MooVee helps you effortlessly manage your movies, on your iPhone. | Read more »
Geometry Wars 3: Dimensions (Games)
Geometry Wars 3: Dimensions 1.0.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.0 (iTunes) Description: Enjoy the next chapter in the award-winning Geometry Wars franchise and enjoy stunning, console-quality... | Read more »
CHAOS RINGS Ⅲ (Games)
CHAOS RINGS Ⅲ 1.0.0 Device: iOS Universal Category: Games Price: $19.99, Version: 1.0.0 (iTunes) Description: The newest addition to the popular smartphone RPG series is finally here! ・CHAOS RINGS Overview | Read more »
The Popular Insight Series of Travel Gui...
Getting around in a country when you can't understand the primary language can be tough. Fortunately there are several options available to help wold travellers with the important stuff like giving directions to a cab driver or asking where the... | Read more »

Price Scanner via MacPrices.net

Apple restocks refurbished Mac minis for up t...
The Apple Store has restocked Apple Certified Refurbished 2014 Mac minis, with models available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz... Read more
13-inch 2.4GHz Retina MacBook Pro (refurbishe...
The Apple Store has 2013 Apple Certified Refurbished 13″ 2.4GHz/128GB Retina MacBook Pros available for $879–$320 off original MSRP. Apple’s one-year warranty is standard, and shipping is free: - 13... Read more
Apple refurbished iPad Air 2s now available f...
The Apple Store is now offering Apple Certified Refurbished iPad Air 2s for up to $140 off the price of new models. Apple’s one-year warranty is included with each model, and shipping is free: -... Read more
MacBook Airs on sale for up to $80 off MSRP
Save up to $80 on the purchase of a new 2015 13″ or 11″ 1.6GHz MacBook Air at the following resellers. Shipping is free with each model: 11" 128GB MSRP $899 11" 256GB... Read more
Free Glide Live Video Messaging App Brings Ne...
Glide, an Israeli startup whose popular live video messenger has attracted more than 15 million users, has released significant updates to its free iOS app. Glide for iOS now gives users more control... Read more
Top Markets Saturation To Slow Global Smartph...
According to a new mobile phone forecast from the International Data Corporation (IDC) Worldwide Quarterly Mobile Phone Tracker, smartphone shipments are expected to grow 11.3% in 2015 — down from 27... Read more
Apple’s Education discount saves up to $300 o...
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
13-inch 2.5GHz MacBook Pro (refurbished) avai...
The Apple Store has Apple Certified Refurbished 13″ 2.5GHz MacBook Pros available for $829, or $270 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.... Read more
Apple refurbished 2014 13-inch Retina MacBook...
The Apple Store has Apple Certified Refurbished 2014 13″ Retina MacBook Pros available for up to $400 off original MSRP, starting at $979. An Apple one-year warranty is included with each model, and... Read more
What Would the ideal Apple Productivity Platf...
For the past four years I’ve kept a foot in both the Mac and iPad camps respectively. my daily computing hours divided about 50/50 between the two devices with remarkable consistency. However, there’... Read more

Jobs Board

Senior Software Engineer - *Apple* SIM - Ap...
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
*Apple* Pay Support Readiness Project Manage...
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
*Apple* Retail - Multiple Positions (US) - A...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Program Manager, *Apple* Community Support...
**Job Summary** Apple Support Communities ( discussions. apple .com) helps customers get the most from their Apple products and services by providing access to Read more
Senior Data Scientist, *Apple* Retail - Onl...
**Job Summary** Apple Retail - Online sells Apple products to customers around the world. In addition to selling Apple products with unique services such as iPad Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.