home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xgetfontpath.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XSetFontPath(3X11)      XLIB FUNCTIONS       XSetFontPath(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XSetFontPath, XGetFontPath, XFreeFontPath - set, get, or
  9.        free the font search path
  10.  
  11. SSYYNNTTAAXX
  12.        XSetFontPath(_d_i_s_p_l_a_y, _d_i_r_e_c_t_o_r_i_e_s, _n_d_i_r_s)
  13.          Display *_d_i_s_p_l_a_y;
  14.          char **_d_i_r_e_c_t_o_r_i_e_s;
  15.          int _n_d_i_r_s;
  16.  
  17.        char **XGetFontPath(_d_i_s_p_l_a_y, _n_p_a_t_h_s___r_e_t_u_r_n)
  18.          Display *_d_i_s_p_l_a_y;
  19.          int *_n_p_a_t_h_s___r_e_t_u_r_n;
  20.  
  21.  
  22.        XFreeFontPath(_l_i_s_t)
  23.          char **_l_i_s_t;
  24.  
  25.  
  26. AARRGGUUMMEENNTTSS
  27.        _d_i_r_e_c_t_o_r_i_e_s
  28.          Specifies the directory path used to look for a
  29.          font.    Setting the path to the empty list
  30.          restores the default path defined for the X
  31.          server.
  32.  
  33.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  34.  
  35.        _l_i_s_t     Specifies the array of strings you want to free.
  36.  
  37.        _n_d_i_r_s     Specifies the number of directories in the path.
  38.  
  39.        _n_p_a_t_h_s___r_e_t_u_r_n
  40.          Returns the number of strings in the font path
  41.          array.
  42.  
  43. DDEESSCCRRIIPPTTIIOONN
  44.        The _X_S_e_t_F_o_n_t_P_a_t_h function defines the directory search
  45.        path for font lookup.  There is only one search path per X
  46.        server, not one per client.  The encoding and interpreta-
  47.        tion of the strings are implementation-dependent, but typ-
  48.        ically they specify directories or font servers to be
  49.        searched in the order listed.  An X server is permitted to
  50.        cache font information internally; for example, it might
  51.        cache an entire font from a file and not check on subse-
  52.        quent opens of that font to see if the underlying font
  53.        file has changed.  However, when the font path is changed,
  54.        the X server is guaranteed to flush all cached information
  55.        about fonts for which there currently are no explicit
  56.        resource IDs allocated.    The meaning of an error from this
  57.        request is implementation-dependent.
  58.  
  59.        _X_S_e_t_F_o_n_t_P_a_t_h can generate a _B_a_d_V_a_l_u_e error.
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSetFontPath(3X11)      XLIB FUNCTIONS       XSetFontPath(3X11)
  71.  
  72.  
  73.        The _X_G_e_t_F_o_n_t_P_a_t_h function allocates and returns an array
  74.        of strings containing the search path.  The contents of
  75.        these strings are implementation-dependent and are not
  76.        intended to be interpreted by client applications.  When
  77.        it is no longer needed, the data in the font path should
  78.        be freed by using _X_F_r_e_e_F_o_n_t_P_a_t_h.
  79.  
  80.        The _X_F_r_e_e_F_o_n_t_P_a_t_h function frees the data allocated by
  81.        _X_G_e_t_F_o_n_t_P_a_t_h.
  82.  
  83. DDIIAAGGNNOOSSTTIICCSS
  84.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  85.          values accepted by the request.  Unless a spe-
  86.          cific range is specified for an argument, the
  87.          full range defined by the argument's type is
  88.          accepted.  Any argument defined as a set of
  89.          alternatives can generate this error.
  90.  
  91. SSEEEE AALLSSOO
  92.        XListFont(3X11), XLoadFonts(3X11)
  93.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.