glutBitmapCharacter(3GLUT) GLUT glutBitmapCharacter(3GLUT)

NAME
glutBitmapCharacter - renders a bitmap character using
OpenGL.

SYNTAX
void glutBitmapCharacter(void *font, int character);

ARGUMENTS
font Bitmap font to use.

character Character to render (not confined to 8 bits).

DESCRIPTION
Without using any display lists, glutBitmapCharacter ren-
ders the character in the named bitmap font. The available
fonts are:

GLUT_BITMAP_8_BY_13
A fixed width font with every character fitting in
an 8 by 13 pixel rectangle. The exact bitmaps to
be used is defined by the standard X glyph bitmaps
for the X font named:

-misc-fixed-medium-r-
normal--13-120-75-75-C-80-iso8859-1

GLUT_BITMAP_9_BY_15
A fixed width font with every character fitting in
an 9 by 15 pixel rectangle. The exact bitmaps to
be used is defined by the standard X glyph bitmaps
for the X font named:

-misc-fixed-medium-r-
normal--15-140-75-75-C-90-iso8859-1

GLUT_BITMAP_TIMES_ROMAN_10
A 10-point proportional spaced Times Roman font.
The exact bitmaps to be used is defined by the
standard X glyph bitmaps for the X font named:

-adobe-times-medium-r-
normal--10-100-75-75-p-54-iso8859-1

GLUT_BITMAP_TIMES_ROMAN_24
A 24-point proportional spaced Times Roman font.
The exact bitmaps to be used is defined by the
standard X glyph bitmaps for the X font named:

-adobe-times-medium-r-
normal--24-240-75-75-p-124-iso8859-1

GLUT_BITMAP_HELVETICA_10
A 10-point proportional spaced Helvetica font. The
exact bitmaps to be used is defined by the stan-
dard X glyph bitmaps for the X font named:

-adobe-helvetica-medium-r-
normal--10-100-75-75-p-56-iso8859-1

GLUT_BITMAP_HELVETICA_12
A 12-point proportional spaced Helvetica font. The
exact bitmaps to be used is defined by the stan-
dard X glyph bitmaps for the X font named:

-adobe-helvetica-medium-r-
normal--12-120-75-75-p-67-iso8859-1

GLUT_BITMAP_HELVETICA_18
A 18-point proportional spaced Helvetica font. The
exact bitmaps to be used is defined by the stan-
dard X glyph bitmaps for the X font named:

-adobe-helvetica-medium-r-
normal--18-180-75-75-p-98-iso8859-1

Rendering a nonexistent character has no effect. glut-
BitmapCharacter automatically sets the OpenGL unpack pixel
storage modes it needs appropriately and saves and
restores the previous modes before returning. The gener-
ated call to glBitmap will adjust the current raster posi-
tion based on the width of the character.

EXAMPLE
Here is a routine that shows how to render a string of
ASCII text with glutBitmapCharacter:

void
output(int x, int y, char *string)
{
int len, i;

glRasterPos2f(x, y);
len = (int) strlen(string);
for (i = 0; i < len; i++) {
glutBitmapCharacter(GLUT_BITMAP_HELVETICA_18, string[i]);
}
}

SEE ALSO
glutBitmapWidth, glutStrokeCharacter

AUTHOR
Mark J. Kilgard (mjk@sgi.com)

GLUT 3.2 2