Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 1 - QuickDraw GX and the Macintosh Environment

This chapter describes those aspects of QuickDraw GX that relate specifically to the Macintosh Toolbox, Macintosh programming environment, and Macintosh image data format. The chapter addresses the following topics:

• the Macintosh interface to QuickDraw GX
• the QuickDraw-to-QuickDraw GX translator

Before reading this chapter, you should be generally familiar with QuickDraw GX and QuickDraw GX objects, as described in the chapter "Introduction to QuickDraw GX" in Inside Macintosh: QuickDraw GX Objects. Additional specific information related to view ports and view devices is in the "View-Related Objects" chapter in Inside Macintosh: QuickDraw GX Objects.

Because this chapter describes the interface between QuickDraw GX and the rest of the Macintosh Toolbox, it uses many terms defined elsewhere. For a general picture of the Macintosh Toolbox, see the introductory chapter of Inside Macintosh: Macintosh Toolbox Essentials. For information on Macintosh windows, see the chapter "Window Manager" in Inside Macintosh: Macintosh Toolbox Essentials. Mouse location and mouse handling is described in the chapter "Event Manager" in Inside Macintosh: Macintosh Toolbox Essentials. QuickDraw, QuickDraw coordinates, the QuickDraw picture format, picture comments, graphics ports, and Macintosh graphics devices are all described in Inside Macintosh: Imaging With QuickDraw.

---

Chapter Contents

About QuickDraw GX and the Macintosh Environment

The Macintosh Interface

The QuickDraw-to-QuickDraw GX Translator

Using QuickDraw GX in the Macintosh Environment

Testing for the Presence and Version of QuickDraw GX

Using the Macintosh Interface Functions

Creating and Using View Ports with Macintosh Windows

Using View Devices With Graphics Devices

Converting From QuickDraw to QuickDraw GX Coordinates

Converting from QuickDraw Global to QuickDraw GX Local or Global Coordinates

Obtaining Mouse Location in Global Coordinates

Obtaining Mouse Location in Local Coordinates

Intercepting Drawing Calls to a View Port

Using the QuickDraw-to-QuickDraw GX Translator

Factors in Translation

Graphics Port and View Port

Scaling During Translation

Translation Options

How Option Settings Affect Translation of Lines

Translation of Fill Patterns

Translation of QuickDraw Picture Comments

Translation Statistics

Using the Translator With QuickDraw Pictures

Installing and Removing the Translator

QuickDraw GX and the Macintosh Environment Reference

Constants and Data Types

Gestalt Selectors and Attributes

Translator Options and Statistics

Macintosh Interface Functions

Associating View Ports With Macintosh Windows

Associating View Devices With Macintosh Graphics Devices

Converting From QuickDraw to QuickDraw GX Coordinates

Installing a View Port Filter

QuickDraw-to-QuickDraw GX Translator Functions

Converting a GrafPort Font and Face Specification

Converting QuickDraw Pictures

Installing and Removing the Translator

Application-Defined Functions

Filtering Drawing Calls to a View Port

Handling Translated QuickDraw Data

Summary of QuickDraw GX and the Macintosh Environment

Constants and Data Types

Gestalt Selectors and Attributes

Translator Options and Statistics

Macintosh Interface Functions

Associating View Ports With Macintosh Windows

Associating View Devices With Macintosh Graphics Devices

Converting From QuickDraw to QuickDraw GX Coordinates

Installing a View Port Filter

QuickDraw-to-QuickDraw GX Translator Functions

Converting QuickDraw Font and Style

Converting QuickDraw Pictures

Installing and Removing the Translator

Application-Defined Functions

Filtering Drawing Calls to a View Port

Handling Translated QuickDraw Data