Introduction to Quartz Programming Guide for QuickDraw Developers
Provides strategies to help Carbon programmers replace QuickDraw code with Quartz.
Who Should Read This Document?
Any developer who uses QuickDraw functions in their Mac OS X application will benefit from reading this document. This document assumes that the reader has programming experience with the QuickDraw API. It also assumes basic knowledge of the Quartz imaging model. Before starting this document, you may want to read the overview of Quartz in Quartz 2D Programming Guide . As you read this document, you may find it helpful to keep the programming guide as well as <!--a target="_self" -->Quartz 2D Reference Collection<!--/a--> handy.
Note: The QuickDraw API is deprecated in Mac OS X v10.4. That means that Apple no longer plans to develop QuickDraw software or documentation. There is no better time than now to completely remove QuickDraw code from your application.
Organization of This Document
This document is organized into the following chapters:
Strategies lists the tasks you should complete before rewriting your code and provides strategies for analyzing and revising your code. This chapter is important to read first, because it points to relevant sections in other chapters, or to other relevant resources.
Basic Drawing covers the fundamentals of drawing in Quartz with an emphasis on what’s different from QuickDraw.
Using Color discusses QuickDraw and Quartz colors and shows how to create color spaces.
Converting PICT Data shows how to convert PICT data so that it can be used in Quartz and shows how to move data to and from the pasteboard in Mac OS X.
Working With Bitmap Image Data shows how, using Quartz, to accomplish a variety of image manipulation tasks that are equivalent to the sorts of tasks you could accomplish using QuickDraw.
Masking , discusses how to replace mask regions in QuickDraw using masking techniques in Quartz.
Updating Regions provides strategies and code examples for how to update windows and use overlay windows in Quartz in place of updating regions in QuickDraw.
Hit Testing describes Quartz functions that are suited for hit testing and provides routines you can use for hit testing in Quartz.
Offscreen Drawing discusses how to use bitmap graphics contexts and CGLayer objects for offscreen drawing.
Performance outlines coding practices that ensure your code performs well.
Glossary lists common QuickDraw terms and defines them in terms of Quartz terminology.
See Also
You might find these items of value as you move QuickDraw code to Quartz:
JustDraw and MouseTracking code samples. These are available from the Graphics & Imaging Quartz Reference Library on the ADC website.
Color Management Overview . This document provides a brief introduction to the principles of color perception, color spaces, and color management systems. To use color effectively in Quartz, you’ll want to be familiar with the concepts related to color and color spaces.
Mailing lists. Join the quartz-dev mailing list to discuss problems using Quartz in Mac OS X. If you’re having a problem, chances are other developers have faced the same challenge and may be able to help you. Others like you are moving to Quartz from QuickDraw!
Technical notes and Technical Q&As. Keep up to date on the latest technical information by visiting the Graphics & Imaging Quartz Reference Library . Technical notes and Q&A documents typically provide solutions for thorny problems that don’t crop up too often. If you can’t find a solution in a programming guide, look at these.
Next
Copyright © 2004, 2006 Apple Computer, Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2006-09-05