NAME
XSetFontPath, XGetFontPath, XFreeFontPath - set, get, or free the font search path
SYNTAX
int XSetFontPath(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(Display *_d_i_s_p_l_a_y, int *_n_p_a_t_h_s___r_e_t_u_r_n);
int XFreeFontPath(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 are 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 containing 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 argument, 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
XListFont(3X11),
XLoadFonts(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e