GLUTSTROKESTRING

Section: C Library Functions (3)
Updated: LOCAL
Page Index

BSD mandoc

NAME

glutStrokeString - Draw a string of stroked characters.

LIBRARY

OpenGLUT - fonts

SYNOPSIS

In openglut.h Ft void Fn glutStrokeString void *fontID const unsigned char *string

PARAMETERS

Bf Em
fontID Ef
A GLUT stroked font identifier.

Bf Em
string Ef
A NUL-terminated ASCII string.

DESCRIPTION

This function draws a Bf Sy
string Ef
in the font indicated by Bf Sy
fontID. Ef
It is Bf Li
almost Ef
equivalent to calling glutStrokeCharacter() on each character in the Bf Sy
string, Ef
successively. Mostly, it is a convenience function to hide the loop, and to treat \n as a special symbol rather than a normal glyph.

The first character displays at the current model space origin, The origin changes by successive translations.

The newline character, \n (ASCII LF) is treated as a newline and resets the origin horizontally while advancing the line 1 font-height down the y-axis.

Does nothing if:
- Bf Sy
fontID Ef
is out of range.
- Bf Sy
string Ef
is Bf Sy
NULL Ef

- Bf Sy
string Ef
is empty

Unlike glutBitmapString(), there is little performance advantage to using glutStrokeString() as compared with calling glutStrokeCharacter() yourself for every character.