StdText
void StdText(byteCnt, textAddr, numerPt, denomPt ); short byteCnt ; number of characters to draw
Ptr textAddr ; address of the buffer containing the text Point numerPt ; not really " points"; these specify the . . . Point denomPt ; . . . character scaling factor This is Quickdraw's default low-level routine for drawing text. It draws
starting at the pnLoc using txFont, txFace, txMode, and txSize specified in the
byteCnt specifies the number of characters to draw.
textAddr is the address of a buffer containing the characters to be drawn. The
buffer should contain at least byteCnt characters.
numerPt and . . .
denomPt specify the horizontal and vertical scaling factors to be applied to
each character. The character is scaled horizontally by the ratio of
numerPt.h / denomPt.h; it is scaled vertically by the ratio of
numerPt.v / denomPt.v.
Notes: Use StdText only if your application intercepts the Quickdraw bottleneck StdText performs no line-wrapping, nor does it take any special action for control codes, such as linefeed or carriage return. The first character
is drawn with its base line starting at the current value of pnLoc, and the
pen is advanced horizontally toward the right. Output is clipped to the
portBits.bounds, portRect, visRgn, and clipRgn. The text is drawn according to the txFont, txFace (style), txMode (a source
transfer mode), txSize (a font size in typo graphical points), and spExtra
(expand/condense factor) fields of the current grafPort. As a bonus, each
character is scaled by a horizontal and vertical ratio. To specify no scaling,
use the same non-zero values for numerPt and denomPt:; e.g.,
Point nPt, dPt;
char msg[]="this is a message
nPt.h =nPt.v = dPt.h = dPt.v = 1;
StdText( strlen(msg), msg, nPt,dPt ); Typical usage is to let the StdTxMeas function set or change the numerPt and denomPt values before making this call.
versions that handle only one or two fonts/sizes), an application may be
able to out-perform the default routines.