gl_printf man page

gl_printf — write formatted output in graphic mode

Synopsis

#include <vgagl.h>

int gl_printf(int x, int y, const char *fmt, ...);

Description

gl_printf writes, like printf(3) a formatted string to position (x, y) using the currently selected font. If one or both of x and y is negative, the text printing continues at the last position. The special characters \b, \r, \n, \a, \t and \v have the usual effects.

Printing wraps at the screen borders. Nevertheless, behaviour is undefined if not a single characters fits on the screen or if the initial position is outside the screen.

The kind of text draw operation is set with gl_setwritemode(3).

BEWARE! Prior to the of use of gl_printf(3) you must set a font.

A good default initialization sequence is:

gl_setfont(8, 8, gl_font8x8);
gl_setwritemode(FONT_COMPRESSED + WRITEMODE_OVERWRITE);
gl_setfontcolors(0, vga_white());

Return Value

The number of characters printed.

Bugs

For compatibility reasons this function is not contained in a.out libraries.

See Also

printf(3), svgalib(7), vgagl(7), gl_colorfont(3), gl_expandfont(3), gl_font8x8(3), gl_setfont(3), gl_setfontcolors(3), gl_setwritemode(3), gl_write(3), gl_writechar(3), printftest(6).

Author

This function and manual page was written by Trek <trek00@freenet.hut.fi> <trek@mediaservice.net>.

Referenced By

gl_write(3), joystick_init(3), printftest(6), vgagl(7).

22 Feb 1997 Svgalib 1.3.0 Svgalib User Manual