1GLXUSEXFONT()                                                    GLXUSEXFONT()
2
3
4

NAME

6       glXUseXFont - create bitmap display lists from an X font
7
8

C SPECIFICATION

10       void glXUseXFont( Font font,
11                         int first,
12                         int count,
13                         int listBase )
14
15       delim $$
16

PARAMETERS

18       font      Specifies  the  font  from  which  character glyphs are to be
19                 taken.
20
21       first     Specifies the index of the first glyph to be taken.
22
23       count     Specifies the number of glyphs to be taken.
24
25       listBase  Specifies the index of the first display list  to  be  gener‐
26                 ated.
27

DESCRIPTION

29       glXUseXFont generates count display lists, named listBase through list‐
30       Base+count-1, each containing a single glBitmap command.   The  parame‐
31       ters  of  the  glBitmap  command of display list listBase+i are derived
32       from glyph first+i.  Bitmap parameters xorig, yorig, width, and  height
33       are computed from font metrics as descent-1, -lbearing, rbearing-lbear‐
34       ing, and ascent+descent, respectively.  xmove is taken from the glyph's
35       width  metric, and ymove is set to zero.  Finally, the glyph's image is
36       converted to the appropriate format for glBitmap.
37
38       Using glXUseXFont may be more efficient than accessing the X  font  and
39       generating the display lists explicitly, both because the display lists
40       are created on the server without requiring a round trip of  the  glyph
41       data,  and  because the server may choose to delay the creation of each
42       bitmap until it is accessed.
43
44       Empty display lists are created for all glyphs that are  requested  and
45       are not defined in font.  glXUseXFont is ignored if there is no current
46       GLX context.
47

ERRORS

49       BadFont is generated if font is not a valid font.
50
51       GLXBadContextState is generated if the current GLX context is  in  dis‐
52       play-list construction mode.
53
54       GLXBadCurrentWindow  is  generated  if the drawable associated with the
55       current context of the calling thread is a window, and that  window  is
56       no longer valid.
57

SEE ALSO

59       glBitmap, glXMakeCurrent
60
61
62
63                                                                 GLXUSEXFONT()