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

FreeBSD Manual Pages


home | help
XSetFontPath(3)			XLIB FUNCTIONS		       XSetFontPath(3)

       XSetFontPath,  XGetFontPath, XFreeFontPath - set, get, or free the font
       search path

       int XSetFontPath(Display	*display, char **directories, int ndirs);

       char **XGetFontPath(Display *display, int *npaths_return);

       int XFreeFontPath(char **list);

		 Specifies the directory path used to look for a  font.	  Set-
		 ting the path to the empty list restores the default path de-
		 fined for the X server.

       display	 Specifies the connection to the X server.

       list	 Specifies the array of	strings	you want to free.

       ndirs	 Specifies the number of directories in	the path.

		 Returns the number of strings in the font path	array.

       The XSetFontPath	function defines the directory search  path  for  font
       lookup.	 There	is  only  one  search  path  per X server, not one per
       client.	The encoding and interpretation	of the strings are implementa-
       tion-dependent,	but typically they specify directories or font servers
       to be searched in the order listed.  An X server	is permitted to	 cache
       font information	internally; for	example, it might cache	an entire font
       from a file and not check on subsequent opens of	that font  to  see  if
       the  underlying	font file has changed.	However, when the font path is
       changed,	the X server is	guaranteed to  flush  all  cached  information
       about  fonts for	which there currently are no explicit resource IDs al-
       located.	 The meaning of	an error from this request is  implementation-

       XSetFontPath can	generate a BadValue error.

       The  XGetFontPath  function  allocates  and returns an array of strings
       containing the search path.  The	contents of these strings  are	imple-
       mentation-dependent  and	 are  not intended to be interpreted by	client
       applications.  When it is no longer needed, the data in the  font  path
       should be freed by using	XFreeFontPath.

       The XFreeFontPath function frees	the data allocated by XGetFontPath.

       BadValue	 Some numeric value falls outside the range of values accepted
		 by the	request.  Unless a specific range is specified for  an
		 argument,  the	 full  range defined by	the argument's type is
		 accepted.  Any	argument defined as a set of alternatives  can
		 generate this error.

       XListFont(3), XLoadFonts(3)
       Xlib - C	Language X Interface

X Version 11			 libX11	1.6.12		       XSetFontPath(3)


Want to link to this manual page? Use this URL:

home | help