NAME

XFontsOfFontSet, XBaseFontNameListOfFontSet, XLocaleOfFontSet, XContextDependentDrawing, XContextualDrawing, XDirectionalDependentDrawing - obtain fontset information

SYNTAX

int XFontsOfFontSet(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(XFontSet _f_o_n_t___s_e_t); char *XLocaleOfFontSet(XFontSet _f_o_n_t___s_e_t); Bool XContextDependentDrawing(XFontSet _f_o_n_t___s_e_t); Bool XContextualDrawing(XFontSet _f_o_n_t___s_e_t); Bool XDirectionalDependentDrawing(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.

Xlib does not guarantee that fonts are 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, their 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. White space 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 the drawing functions implement implicit text directionality or if text drawn with the font_set might include context-dependent drawing; otherwise, it returns _F_a_l_s_e.

The _X_C_o_n_t_e_x_t_u_a_l_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; otherwise, it returns _F_a_l_s_e.

The _X_D_i_r_e_c_t_i_o_n_a_l_D_e_p_e_n_d_e_n_t_D_r_a_w_i_n_g function returns _T_r_u_e if the drawing functions implement implicit text directionality; otherwise, it returns _F_a_l_s_e.

SEE ALSO

XCreateFontSet(3X11), XCreateOM(3X11), XCreateOC(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