Programming with Quartz (eBook)

front cover 1
copyright 5
table of contents 8
front matter 16
Foreword 16
Preface 20
Our Objective 20
Outline 21
Conventions and Assumptions 23
Source Code 24
Header Files 25
Quartz Technologies 26
See Also 27
Acknowledgments 29
body 30
1 Introducing Quartz 2D 30
A Bit of History 30
Quartz 2D Overview 37
What Software Can Use Quartz 2D? 39
Summary 1 41
See Also 1 41
2 Quartz 2D Drawing Basics 44
Quartz Graphics Contexts 44
Filling a Rectangle 45
Stroking a Rectangle 47
The Order of Fill and Stroke Operations 49
Transforming the Coordinate System 52
Painting with Alpha 59
Making Dashed Lines 61
Clipping a Drawing 65
Drawing PDF Content 67
More About Graphics Contexts 70
Summary 2 71
See Also 2 72
3 Using Quartz 2D in Cocoa 74
Xcode Overview 75
Creating a Cocoa Xcode Project in Tiger 75
Creating a View in Interface Builder 78
Connecting the Interface to the Code 82
Obtaining a Graphics Context in Cocoa 84
Writing the Drawing Code 85
Examining the Drawing Output 87
Cocoa Framework Drawing and Quartz 88
Summary 3 91
See Also 3 91
4 Using Quartz 2D in Carbon 94
Creating a Carbon Xcode Project 95
Setting Up a Carbon Window 97
Creating an Event Handler 102
Examining the Drawing Output 105
Using QDBeginCGContext 108
Summary 4 110
See Also 4 111
5 The Quartz Coordinate System and Coordinate Transformations 112
User Space and Device Space 112
Coordinate Transformations 115
The Current Transformation Matrix 116
The Mathematics of Affine Transforms 117
Saving and Restoring a Coordinate System 120
Affine Transform Convenience Functions 123
Creating a Skewed Coordinate System 127
Summary 5 129
See Also 5 130
6 Drawing with Paths 132
Properties of Paths 133
Path Construction Primitives 134
Path Construction Convenience Functions 140
Stroking Paths 148
Filling Paths 155
Clipping with Paths 158
CGPath Objects (Jaguar) 160
Anti-aliasing 163
Path Utility Functions 166
Summary 6 173
See Also 6 173
7 Color, Alpha Transparency, and the Quartz Graphics State 176
Color and Color Spaces 177
Alpha Transparency 195
Graphics State Parameters 202
Summary 7 210
See Also 7 211
8 Data Providers and Data Consumers 214
Data Providers 215
Data Consumers 227
Summary 8 231
See Also 8 231
9 Drawing Images 232
Creating CGImage Objects 233
Best Practices for Working with Images 270
Image Utility Functions 273
Writing Image Data Using CGImageDestination (Tiger) 284
Exporting to JPEG Using a QuickTime Exporter 287
Summary 9 288
See Also 9 289
10 Image Masking 292
Creating an Image Mask 293
Masking an Image (Tiger) 302
Using Color as a Mask (Tiger) 308
Clipping to a Mask (Tiger) 311
Summary 10 316
See Also 10 316
11 Text 318
Text Drawing Parameters 319
Drawing Text Using Quartz 325
Drawing Text Using Cocoa 335
Drawing Text Using Carbon 353
Drawing Text in a Flipped Coordinate System 367
Summary 11 370
See Also 11 370
12 Creating Bits 374
Bitmap Graphics Context 375
CGLayers (Tiger) 400
Caching Drawing Offscreen 408
Replacing CopyBits 420
Summary 12 422
See Also 12 422
13 Opening and Drawing PDF Documents 426
PDF Document Properties 427
Opening a PDF Document 429
Using PDF as a Graphical Interchange 430
Drawing PDF Pages 435
Handling Protected PDF Documents (Jaguar) 453
PDF Document Utility Functions 458
Summary 13 460
See Also 13 460
14 Creating and Examining PDF Documents 464
Creating New PDF Documents 464
Copying PDF Content to a Pasteboard 472
Adding Content to Existing PDF Documents 476
Adding Links to PDF Documents (Tiger) 484
Creating Encrypted PDF Output (Tiger) 491
PDF Document Generation Issues 495
Examining PDF Document Content (Panther, Tiger) 496
Summary 14 507
See Also 14 507
15 Advanced Drawing Features 510
Drawing with Patterns 510
Drawing with Shadows (Panther) 541
Drawing with Transparency Layers (Panther) 551
Drawing with Shadings (Jaguar) 560
Summary 15 591
See Also 15 592
16 Supporting PostScript and EPS Data 594
Overview of the Conversion Process 595
Quartz Conversion Functions and Callbacks (Panther) 596
Creating a PDF Data File from PostScript Data 598
Using Converted PostScript Data in Your Application 604
PSConverter Advanced Issues 609
Printing Source EPS Data 611
Guidelines for Supporting EPS Data in Your Application 618
Summary 16 619
See Also 16 620
17 Performance and Debugging 622
Optimizing Performance 622
Debugging Your Drawing 642
Summary 17 655
See Also 17 656
18 Creating Quartz Tools and Python Scripts 660
Python Scripting with Quartz (Panther) 661
Using Quartz in UNIX Tools 666
The PDF Workflow in Printing (Jaguar) 668
Summary 18 675
See Also 18 675
index 676