glXUseXFont

glXUseXFont generates count display lists, named listBase through $\mathit{listBase}+\mathit{count}-1$ , each containing a single glBitmap command. The parameters of the glBitmap command of display list $\mathit{listBase}+\mathit{i}$ are derived from glyph $\mathit{first}+\mathit{i}$ . Bitmap parameters $\mathit{xorig}$ , $\mathit{yorig}$ , $\mathit{width}$ , and $\mathit{height}$ are computed from font metrics as $\mathit{descent}-1$ , $-\mathit{lbearing}$ , $\mathit{rbearing}-\mathit{lbearing}$ , and $\mathit{ascent}+\mathit{descent}$ , respectively. $\mathit{xmove}$ is taken from the glyph's $\mathit{width}$ metric, and $\mathit{ymove}$ is set to zero. Finally, the glyph's image is converted to the appropriate format for glBitmap .

Using glXUseXFont may be more efficient than accessing the X font and generating the display lists explicitly, both because the display lists are created on the server without requiring a round trip of the glyph data, and because the server may choose to delay the creation of each bitmap until it is accessed.

Empty display lists are created for all glyphs that are requested and are not defined in font . glXUseXFont is ignored if there is no current GLX context.

BadFont is generated if font is not a valid font.

GLXBadContextState is generated if the current GLX context is in display-list construction mode.

GLXBadCurrentWindow is generated if the drawable associated with the current context of the calling thread is a window, and that window is no longer valid.

glBitmap , glXMakeCurrent

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