Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 1 - QuickDraw GX and the Macintosh Environment / QuickDraw GX and the Macintosh Environment Reference

QuickDraw-to-QuickDraw GX Translator Functions / Installing and Removing the Translator

GXRemoveQDTranslator

You can use the GXRemoveQDTranslator function to terminate the translation of QuickDraw drawing commands.

translationStatistics GXRemoveQDTranslator(GrafPtr port,
                              gxTranslationStatistic *statistic);

port

A pointer to the QuickDraw graphics port in which the translator is currently installed.

statistic

A pointer to the location in which to return the translation statistics.

function result

The translation statistics.

DESCRIPTION

The GXRemoveQDTranslator function removes the translator from the QuickDraw graphics port in which it was installed, and flushes the internal translation buffer.

The translator keeps various statistics about the QuickDraw picture data it is translating. After removing the translator, you can examine the mask that describes these statistics if you are interested in this information. The flags in the translation statistics masks are defined in the gxTranslationStatistics enumeration. If you are not interested in this information, you should pass nil for the statistic parameter.

SPECIAL CONSIDERATIONS

Always be sure to call the GXRemoveQDTranslator function when you are finished translating.

EERRORS, WARNINGS, AND NOTICES

Warnings
translator_not_installed_on_this_grafport	(debugging version)

SEE ALSO

For an example of the use of this function, see Listing 1-5 on page 1-21.

Translation statistics flags from the gxTranslationStatistics enumeration are described in Table 1-3 on page 1-20.

To translate an entire QuickDraw picture, use the GXConvertPICTToShape function, described on page 1-34.

For a general description of the QuickDraw-to-QuickDraw GX translator, see the section "Using the QuickDraw-to-QuickDraw GX Translator" beginning on page 1-10.