HOOPS/3dGS I.M. Interface

     << Back      Full Index      Forward >>


Draw_Text


Functions

void Draw_Text (HT_Rendition *nr, HT_Text_Info *text_info)
void Draw_DC_Text (HT_Rendition *nr, HT_DC_Point *where, int count, const char *string)

Function Documentation

void Draw_Text HT_Rendition *  nr,
HT_Text_Info *  text_info
 

To draw text specified by an intermediate text information structure.

Parameters:
nr - Rendition. Passed by reference.
text_info - Text information structure. Passed by reference.

DETAILS

This is the standard default method for the "draw text" callback point, normally called only from a "draw text" callback function.

HIC_Draw_Text() reconciles the text attributes in the rendition nr with the capabilities of the requested font, and completes the computations needed to draw the text. In particular, it applies the per-character transformations when appropriate and the atmospheric attenuation when called for in the rendition. It may replace the font specified in the rendition by a stroked font if the former font does not admit the transformations that are called for.

If the text is finally to be drawn in a font provided by the hardware, the window system, or the driver, "draw text" eventually calls on a driver-level "draw dc text" method, which does not have a callback point in the current version of I.M.. Otherwise, "draw text" causes the text to be stroked out, using the ordinary geometry drawing provisions, through "draw 3d text strokes" and "draw 3d text areas" when per-character transformations are in effect, or through "draw dc text strokes" and "draw dc text areas" when they are not in effect.

NOTES

The text_info structure describes a text string that was inserted with HC_Insert_Text() , along with some information on how it is transformed to device coordinates. Normally, one would pass on to HIC_Draw_Text() the same text_info structure that is passed to the callback function, except that HOOPS I.M. lets the user reposition the string with HIC_Set_Text_Position() .

Users can query fields of the text_info structure with the function HIC_Set_Text_Position().

See also:

void Draw_DC_Text HT_Rendition *  nr,
HT_DC_Point *  where,
int  count,
const char *  string
 

Similar to Draw_Text() but allows the user to change the position of the text without calling HIC_Set_Text_Position().

Parameters:
nr - Rendition. Passed by reference.
where - Baseline of the text string. Passed by reference.
count - Number of characters.
string - Array of characters.

DETAILS

No additional details. See Draw_Text().
Main Index

HOOPS/3dGS I.M. Interface

     << Back      Full Index      Forward >>