Important: The information in this document is obsolete and should not be used for new development.
Chapter 3 - QuickDraw Drawing
This chapter describes routines common to both basic QuickDraw and Color QuickDraw that you can use to draw lines, rectangles, rounded rectangles, ovals, arcs, wedges, polygons, and regions, and to copy images from one graphics port to another. This chapter also describes the routines that you can use to perform calculations and other manipulations of these shapes--including comparing them and finding their unions and intersections, and moving, shrinking, and expanding them.Read this chapter to learn how to draw on all models of Macintosh computers. All of the routines described in this chapter depend on your application to create a graphics port drawing environment as described in the previous chapter, "Basic QuickDraw." As noted in this chapter, many of these routines have additional capabilities when performed in the more sophisticated color drawing environments described in the next chapter in this book, "Color QuickDraw." However, if your application does not use color, or uses only a few colors, you may find it unnecessary to create the drawing environment described in the chapter "Color QuickDraw."
This chapter also describes how to copy a bit image from one onscreen graphics port to another onscreen graphics port. To prevent the choppiness that can occur when you build complex images onscreen, your application should use the drawing routines described in this chapter to create complex images in offscreen graphics worlds. Your application can then copy these images to onscreen graphics ports, as described in the chapter "Offscreen Graphics Worlds" in this book.
QuickDraw also supports the creation and manipulation of pictures and text. The chapter "Pictures" in this book describes the routines for drawing pictures. For information about drawing text, see the chapter "QuickDraw Text" in Inside Macintosh: Text.
This chapter describes how to
- use the graphics pen
- create, draw, and manipulate the shapes supported by QuickDraw
- draw a copy of a bit image from one graphics port into another graphics port
- use the eight-color system supported by basic QuickDraw
- customize QuickDraw's drawing operations
Chapter Contents
- About QuickDraw Drawing
- The Graphics Pen
- Bit Patterns
- Boolean Transfer Modes With 1-Bit Pixels
- Lines and Shapes
- Defining Lines and Shapes
- Framing Shapes
- Painting and Filling Shapes
- Erasing Shapes
- Inverting Shapes
- Other Graphic Entities
- The Eight Basic QuickDraw Colors
- Drawing With QuickDraw
- Drawing Lines
- Drawing Rectangles
- Drawing Ovals, Arcs, and Wedges
- Drawing Regions and Polygons
- Performing Calculations and Other Manipulations of Shapes
- Copying Bits Between Graphics Ports
- Customizing QuickDraw's Low-Level Routines
- QuickDraw Drawing Reference
- Data Structures
- Routines
- Managing the Graphics Pen
- Changing the Background Bit Pattern
- Drawing Lines
- Creating and Managing Rectangles
- Drawing Rectangles
- Drawing Rounded Rectangles
- Drawing Ovals
- Drawing Arcs and Wedges
- Creating and Managing Polygons
- Drawing Polygons
- Creating and Managing Regions
- Drawing Regions
- Scaling and Mapping Points, Rectangles, Polygons, and Regions
- Calculating Black-and-White Fills
- Copying Images
- Drawing With the Eight-Color System
- Determining Whether QuickDraw Has Finished Drawing
- Getting Pattern Resources
- Customizing QuickDraw Operations
- Resources
- The Pattern Resource
- The Pattern List Resource
- Summary of QuickDraw Drawing
- Pascal Summary
- Constants
- Data Types
- Routines
- C Summary
- Constants
- Data Types
- Functions
- Assembly-Language Summary
- Data Structures
- Global Variables