Index for Section 3

Alphabetical listing for G

Bottom of page

glXUseXFont()
NAME
  glXUseXFont - create bitmap display lists from an X font

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

PARAMETERS
  font
      Specifies the font from which character glyphs are to be taken.

  first
      Specifies the index of the first glyph to be taken.

  count
      Specifies the number of glyphs to be taken.

  listBase
      Specifies the index of the first display list to be generated.

DESCRIPTION
  glXUseXFont() generates count display lists, named listBase through
  listBase+count-1, each containing a single glBitmap() command. The
  parameters of the glBitmap() command of display list listBase+i are derived
  from glyph first+i. Bitmap parameters xorig, yorig, width, and height are
  computed from font metrics as descent-1, -lbearing, rbearing-lbearing, and
  ascent+descent, respectively.	 xmove is taken from the glyph's width
  metric, and 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.

ERRORS
  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.

SEE ALSO
  glBitmap(), glXMakeCurrent()

Index for Section 3

Alphabetical listing for G

Top of page