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 renders the char-
       acter in the named bitmap font. The available fonts are:

       GLUTBITMAP8BY13
               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


       GLUTBITMAP9BY15
               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


       GLUTBITMAPTIMESROMAN100
               A 10-point proportional spaced Times Roman font. The exact bit-
               maps  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


       GLUTBITMAPTIMESROMAN24
               A 24-point proportional spaced Times Roman font. The exact bit-
               maps  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


       GLUTBITMAPHELVETICA100
               A 10-point proportional spaced Helvetica font. The  exact  bit-
               maps  to be used is defined by the standard X glyph bitmaps for
               the X font named:

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


       GLUTBITMAPHELVETICA12
               A 12-point proportional spaced Helvetica font. The  exact  bit-
               maps  to be used is defined by the standard X glyph bitmaps for
               the X font named:

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


       GLUTBITMAPHELVETICA18
               A 18-point proportional spaced Helvetica font. The  exact  bit-
               maps  to be used is defined by the standard 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.   glutBitmapCharacter
       automatically  sets  the  OpenGL  unpack  pixel  storage modes it needs
       appropriately and saves and restores the previous modes before  return-
       ing.  The  generated  call  to  glBitmap will adjust the current raster
       position based on the width of the character.

EXAMPLE
       Here is a routine that shows how to render a string of ASCI 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(GLUTBITMAPHELVETICA18, string[i]);
           }
         }


SEE ALSO
       glutBitmapWidth, glutStrokeCharacter

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



GLUT                                  3.7           glutBitmapCharacter(3GLUT)