Scroll to navigation

GLUTSTROKESTRING(3) Library Functions Manual (local) GLUTSTROKESTRING(3)

NAME

glutStrokeStringDraw a string of stroked characters.

LIBRARY

OpenGLUT - fonts

SYNOPSIS

#include <openglut.h>

void
glutStrokeString(void *fontID, const unsigned char *string);

PARAMETERS


fontID

A GLUT stroked font identifier.


string

A NUL-terminated ASCII string.

DESCRIPTION

This function draws a


string

in the font indicated by

fontID.

It is


almost

equivalent to calling glutStrokeCharacter() on each character in the

string,

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:
-


fontID

is out of range.
-

string

is

NULL


-


string

is empty

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

SEE ALSO

glutStrokeLength(3) glutStrokeCharacter(3) glutStrokeHeight(3) glutBitmapString(3)