Document Revision History

Added code that creates a dictionary and adds metadata to it. See Listing 13-4.

Renamed the Shadings chapter to Gradients and revised it to include information on the use of the CGGradientRef opaque data type.

In “Data Management” and a link and information about Image I/O Programming Guide.

Updated “Introduction to Quartz 2D Programming Guide” with recent, relevant related documentation and added a description of the revised “Gradients” chapter.

Revised “Quartz 2D Opaque Data Types” to include CGGradientRef and provided links to information on CGImageSourceRef and CGImageDestinationRef opaque data types which are part of the Image I/O framework.

Updated Table 2-1 with additional pixel formats.

Improved the wording in the first paragraph of “Gradients.”

Made a correction to the floating-point gray information in Table 2-1.

Corrected the declarations in Listing 14-5

Added cross references to the reference documentation for the constants listed in Table 2-1.

Removed information on using a CGGLContextRef object because the use of a graphics context for OpenGL rendering is not reliable and is not recommended.

Added thread safety information to “Creating a PostScript Converter Object.”

Changed Listing 2-9 so that is correctly frees the bitmap data.

Added cross references to “Creating an Image From Part of a Larger Image” and “Creating an Image From a Bitmap Graphics Context” that link to examples of creating graphics contexts.

Revised Figure 12-2 and the text that describes it.

Revised Figure 1-3 and the text that describes it.

Revised information in “Python Bindings for Quartz 2D.”

Add a “See Also” section to Listing 17-1.

Provided hyperlinks to the functions and methods discussed in “Data Management.”

Corrected a typographical error in Listing 2-5.

Made changes to code in Listing 12-1.

Revised introductory paragraphs in “Transforms.”

Revised several sentences in “How Quartz 2D Draws Text.”

Changed the title from Drawing With Quartz 2D to make it more consistent with the titles of similar documentation.

Revised the Introduction to reflect the new content.

Simplified the code in Figure 3-1.

Revised the introductions for “Color and Color Spaces,” “Transforms,” “Bitmap Images and Image Masks,” and “PDF Document Parsing.”

Made changes to code in “Code that uses layers to draw a flag” so that more appropriately-sized layers are used; substituted the function CGContextDrawLayerAtPoint for CGContextDrawLayerInRect.

Revised the section “Setting Blend Modes”; added figures that show actual output produced using blend modes.

Revised the section “Using Blend Modes With Images” and replaced the figures with better examples of drawing an image using different blend modes.

Replaced Figure 1-1 with a new figure.

Added information about Core Image and Core Video in the opening paragraphs of “Overview of Quartz 2D.”

Introduced the notion of CGLayer objects in the section “Drawing Destinations: The Graphics Context.”

Added the new Tiger opaque objects to “Quartz 2D Opaque Data Types.”

Added blend mode to “Graphics States.” Added information about using blend modes to “Paths” and “Bitmap Images and Image Masks.”

Added “Quartz Performance: A Look Under the Hood.”

Revised “Graphics Contexts” to show how to use HIView. Also added new figures to many sections and provided information on HIView coordinates as compared to Quartz coordinates.

Added Table 2-1 to show the supported color spaces and pixel formats.

Replaced Figure 2-8 to show an enlargement of aliased and antialiasing drawing and text.

Added “Ellipses” and revised discussions on “Painting a Path” and “Clipping to a Path” to reflect new Tiger content.

Changed “clipping region” to “clipping area” throughout the entire book.

Revised information on “Creating Color Spaces” to reflect Tiger content.

Added “Evaluating Affine Transforms” and “Getting the User to Device Space Transform.”

Revised the chapter formerly titled Data Providers and Data Consumers to contain information on image sources and image destinations, and how to move data between Quartz 2D and Core Image. Retitled the chapter “Data Management” to reflect the revised content.

Renamed the Bitmap Image chapter to “Bitmap Images and Image Masks” and substantially revised the content to reflect information about image sources, the new image creation functions, image masking function, and using blend modes to composite images.

Added the chapter “CGLayer Drawing.”

Added the chapter “PDF Document Parsing,” which contains some material from the old PDF Document chapter along with new material on scanners and content streams.

Added “Copying Font Variations” and “PostScript Fonts” to the Text chapter.

Revised for Mac OS X v10.3.

First version.