Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GLXUSEXFONT()							 GLXUSEXFONT()

NAME
       glXUseXFont - create bitmap display lists from an X font

C SPECIFICATION
       void glXUseXFont( Font font,
			 int first,
			 int count,
			 int listBase )

       delim $$

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	gener-
		 ated.

DESCRIPTION
       glXUseXFont generates count display lists, named	listBase through list-
       Base+count-1, each containing a single glBitmap command.	  The  parame-
       ters  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-lbear-
       ing, 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  dis-
       play-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

								 GLXUSEXFONT()

NAME | C SPECIFICATION | PARAMETERS | DESCRIPTION | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=glXUseXFont&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help