1GLXUSEXFONT(3G)                  OpenGL Manual                 GLXUSEXFONT(3G)
2
3
4

NAME

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

C SPECIFICATION

9       void glXUseXFont(Font font, int first, int count, int listBase);
10

PARAMETERS

12       font
13           Specifies the font from which character glyphs are to be taken.
14
15       first
16           Specifies the index of the first glyph to be taken.
17
18       count
19           Specifies the number of glyphs to be taken.
20
21       listBase
22           Specifies the index of the first display list to be generated.
23

DESCRIPTION

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

ERRORS

46       BadFont is generated if font is not a valid font.
47
48       GLXBadContextState is generated if the current GLX context is in
49       display-list construction mode.
50
51       GLXBadCurrentWindow is generated if the drawable associated with the
52       current context of the calling thread is a window, and that window is
53       no longer valid.
54

SEE ALSO

56       glBitmap(), glXMakeCurrent()
57

59       Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed
60       under the SGI Free Software B License. For details, see
61       http://oss.sgi.com/projects/FreeB/.
62

AUTHORS

64       opengl.org
65
66
67
68opengl.org                        06/10/2014                   GLXUSEXFONT(3G)
Impressum