


XFontsOfFontSet(3X11)					XFontsOfFontSet(3X11)
X11R5									X11R5



NAME
  XFontsOfFontSet, XBaseFontNameListOfFontSet, XLocaleOfFontSet, XCon-
  textDependentDrawing - obtain	fontset	information

SYNTAX
  int XFontsOfFontSet(_f_o_n_t__s_e_t,	_f_o_n_t__s_t_r_u_c_t__l_i_s_t__r_e_t_u_r_n,
  _f_o_n_t__n_a_m_e__l_i_s_t__r_e_t_u_r_n)
	 XFontSet _f_o_n_t__s_e_t;
	 XFontStruct ***_f_o_n_t__s_t_r_u_c_t__l_i_s_t__r_e_t_u_r_n;
	 char ***_f_o_n_t__n_a_m_e__l_i_s_t__r_e_t_u_r_n;

  char *XBaseFontNameListOfFontSet(_f_o_n_t__s_e_t)
	XFontSet _f_o_n_t__s_e_t;

  char *XLocaleOfFontSet(_f_o_n_t__s_e_t)
	XFontSet _f_o_n_t__s_e_t;

  Bool XContextDependentDrawing(_f_o_n_t__s_e_t)
	XFontSet _f_o_n_t__s_e_t;

ARGUMENTS

  _f_o_n_t__s_e_t  Specifies the font set.

  _f_o_n_t__n_a_m_e__l_i_s_t__r_e_t_u_r_n
	    Returns the	list of	font names.

  _f_o_n_t__s_t_r_u_c_t__l_i_s_t__r_e_t_u_r_n
	    Returns the	list of	font structs.

DESCRIPTION
  The _X_F_o_n_t_s_O_f_F_o_n_t_S_e_t function returns a list of one or	more _X_F_o_n_t_S_t_r_u_c_t_s and
  font names for the fonts used	by the Xmb and Xwc layers, for the given font
  set.	A list of pointers to the _X_F_o_n_t_S_t_r_u_c_t structures is returned to
  font_struct_list_return.  A list of pointers to null-terminated fully
  specified font name strings in the locale of the font	set is returned	to
  font_name_list_return.  The font_name_list order corresponds to the
  font_struct_list order.  The number of _X_F_o_n_t_S_t_r_u_c_t structures	and font
  names	is returned as the value of the	function.

  Because it is	not guaranteed that a given character will be imaged using a
  single font glyph, there is no provision for mapping a character or default
  string to the	font properties, font ID, or direction hint for	the font for
  the character.  The client may access	the _X_F_o_n_t_S_t_r_u_c_t	list to	obtain these
  values for all the fonts currently in	use.

  It is	not required that fonts	be loaded from the server at the creation of
  an _X_F_o_n_t_S_e_t.	Xlib may choose	to cache font data, loading it only as needed
  to draw text or compute text dimensions.  Therefore, existence of the
  per_char metrics in the _X_F_o_n_t_S_t_r_u_c_t structures in the	_X_F_o_n_t_S_t_r_u_c_t_S_e_t is
  undefined.  Also, note that all properties in	the _X_F_o_n_t_S_t_r_u_c_t	structures
  are in the STRING encoding.

  The _X_F_o_n_t_S_t_r_u_c_t and font name	lists are owned	by Xlib	and should not be
  modified or freed by the client.  They will be freed by a call to
  _X_F_r_e_e_F_o_n_t_S_e_t with the	associated _X_F_o_n_t_S_e_t.  Until freed, its contents	will
  not be modified by Xlib.

  The _X_B_a_s_e_F_o_n_t_N_a_m_e_L_i_s_t_O_f_F_o_n_t_S_e_t function returns the original base font name
  list supplied	by the client when the _X_F_o_n_t_S_e_t	was created.  A	null-
  terminated string containing a list of comma-separated font names is
  returned as the value	of the function.  Whitespace may appear	immediately
  on either side of separating commas.

  If _X_C_r_e_a_t_e_F_o_n_t_S_e_t obtained an	XLFD name from the font	properties for the
  font specified by a non-XLFD base name, the _X_B_a_s_e_F_o_n_t_N_a_m_e_L_i_s_t_O_f_F_o_n_t_S_e_t
  function will	return the XLFD	name instead of	the non-XLFD base name.

  The base font	name list is owned by Xlib and should not be modified or
  freed	by the client.	It will	be freed by a call to _X_F_r_e_e_F_o_n_t_S_e_t with	the
  associated _X_F_o_n_t_S_e_t.	Until freed, its contents will not be modified by
  Xlib.

  The _X_L_o_c_a_l_e_O_f_F_o_n_t_S_e_t function	returns	the name of the	locale bound to	the
  specified _X_F_o_n_t_S_e_t, as a null-terminated string.

  The returned locale name string is owned by Xlib and should not be modified
  or freed by the client.  It may be freed by a	call to	_X_F_r_e_e_F_o_n_t_S_e_t with the
  associated _X_F_o_n_t_S_e_t.	Until freed, it	will not be modified by	Xlib.

  The _X_C_o_n_t_e_x_t_D_e_p_e_n_d_e_n_t_D_r_a_w_i_n_g function	returns	_T_r_u_e if	text drawn with	the
  font_set might include context-dependent drawing.

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






































