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-nor-
               mal--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-nor-
               mal--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-nor-
               mal--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-nor-
               mal--24-240-75-75-p-124-iso8859-1
               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-nor-
               mal--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-nor-
               mal--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-nor-
               mal--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

       Mark J. Kilgard (mjk@nvidia.com)