fgf_print() (Fastgraph/Fonts)

Win32 DirectX Fastgraph/Light

Prototype

void fgf_print (char *string, int length);

Sub fgf_print (ByVal string As String, ByVal length As Long)

procedure fgf_print (string : string; length : integer);

Description

The fgf_print() function displays characters from the current font in the active virtual buffer, without clipping. The characters appear in the current color, but you can place special color selection codes in the string to change colors. The current justification settings define the location of the string relative to the current graphics cursor position. The fgf_print() function leaves the graphics cursor positioned to the right and at the bottom of the last character displayed.

Parameters

string is the character string to display. If the string contains an option prefix code (ASCII decimal 127), fgf_print() treats the byte that follows as an option specifier. If this byte is an underscore character (ASCII decimal 95), underlining is toggled. If it is any other character, fgf_print() treats it as a color index and makes that color the current color.

length is the number of characters to consider in string, including any option prefix characters and option specifiers. It must be less than or equal to the physical string length.

Return value

none

Restrictions

If string contains color selection codes, the selected color remains in effect until another color selection code appears or until Fastgraph's fg_setcolor() or fg_setcolorrgb() function is called.

See also

fg_move(), fg_setcolor(), fg_setcolorrgb(), fgf_define(), fgf_justify(), fgf_kerning(), fgf_load(), fgf_printc(), fgf_select()

Examples

FGFW1, FGFW2, FGFW3, FGFW4, FGFW5, FGFW6, FGFW7