Legacy Document

Inside Macintosh: Text /

Chapter 3 - QuickDraw Text / QuickDraw Text Reference

Routines

Low-Level QuickDraw Text Routines

The QuickDraw text routines use two bottleneck routines extensively--one to draw text, and one to measure it. This section describes the StdText procedure that is used to draw text and the StdTxMeas function that is used to measure text. Although the high-level QuickDraw text routines provide most of the functionality needed to measure and draw text under most circumstances, you can call these low-level routines directly when necessary. However, if you need to call either StdText or StdTxMeas directly, you must first check the graphics port grafProc field to determine whether the bottleneck routines have been customized, and if so, you must call the customized routine instead of the standard one. The bottleneck routines are always customized
for printing.

If the grafProcs field contains NIL, the standard bottleneck routines have not been customized. If the grafProcs field contains a pointer, the standard bottleneck routines have been replaced by customized ones. A pointer (of type QDProcsPtr) in the grafProc field points to a QDProc record. This record contains fields that point to the bottleneck routine to be used for a specific drawing function. If the standard bottleneck routine has been customized, your application needs to use the customized routine indicated by the QDProcs record field.

The QuickDraw standard low-level bottleneck routines work properly for all script systems. For more information about replacing or customizing the bottleneck routines, see "Customizing QuickDraw's Text Handling" on page 3-58 and the QuickDraw chapters in Inside Macintosh: Imaging.

---

Subtopics

StdText

StdTxMeas