


XSetFontPath(3X11)					   XSetFontPath(3X11)
X11R5									X11R5



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

SYNTAX
  XSetFontPath(_d_i_s_p_l_a_y,	_d_i_r_e_c_t_o_r_i_e_s, _n_d_i_r_s)
	Display	*_d_i_s_p_l_a_y;
	char **_d_i_r_e_c_t_o_r_i_e_s;
	int _n_d_i_r_s;

  char **XGetFontPath(_d_i_s_p_l_a_y, _n_p_a_t_h_s__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	int *_n_p_a_t_h_s__r_e_t_u_r_n;


  XFreeFontPath(_l_i_s_t)
	char **_l_i_s_t;


ARGUMENTS

  _d_i_r_e_c_t_o_r_i_e_s
	    Specifies the directory path used to look for a font.  Setting
	    the	path to	the empty list restores	the default path defined for
	    the	X server.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _l_i_s_t	    Specifies the array	of strings you want to free.

  _n_d_i_r_s	    Specifies the number of directories	in the path.

  _n_p_a_t_h_s__r_e_t_u_r_n
	    Returns the	number of strings in the font path array.

DESCRIPTION
  The _X_S_e_t_F_o_n_t_P_a_t_h 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 is implementation 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 allocated.  The meaning of an error
  from this request is implementation dependent.

  _X_S_e_t_F_o_n_t_P_a_t_h can generate a _B_a_d_V_a_l_u_e error.

  The _X_G_e_t_F_o_n_t_P_a_t_h function allocates and returns an array of strings con-
  taining the search path.  The	contents of these strings are implementation
  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	_X_F_r_e_e_F_o_n_t_P_a_t_h.

  The _X_F_r_e_e_F_o_n_t_P_a_t_h function frees the data allocated by _X_G_e_t_F_o_n_t_P_a_t_h.

DIAGNOSTICS

  _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of values accepted by
	    the	request.  Unless a specific range is specified for an argu-
	    ment, the full range defined by the	argument's type	is accepted.
	    Any	argument defined as a set of alternatives can generate this
	    error.

SEE ALSO
  XListFonts(3X11), XLoadFont(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e























































