Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 1 - QuickDraw GX and the Macintosh Environment

Using the QuickDraw-to-QuickDraw GX Translator

The QuickDraw-to-QuickDraw GX translator converts QuickDraw drawing commands into QuickDraw GX shapes. There are two ways to use the translator:

• The first way is to pass the translator a handle to a QuickDraw picture. The translator returns a QuickDraw GX picture shape that approximates the original QuickDraw picture. The section "Using the Translator With QuickDraw Pictures" beginning on page 1-20 describes how to use the translator in this way.
• The second way is to use a pair of functions to install and remove the translator. After you install the translator in a given graphics port, it intercepts all subsequent QuickDraw drawing commands sent to that port and converts them to QuickDraw GX shapes. After you are finished converting, you remove the translator. The section "Installing and Removing the Translator" beginning on page 1-21 describes how to use the translator in this way.

The next section, "Factors in Translation," describes how translation works and how you can influence it by setting various translation parameters.

IMPORTANT

In order to use the QuickDraw-to-QuickDraw GX translator, you first must have called the GXInitPrinting function. The GXInitPrinting function is described in the core printing features chapter of Inside Macintosh: QuickDraw GX Printing.

---

Subtopics

Factors in Translation

Using the Translator With QuickDraw Pictures

Installing and Removing the Translator