名称

XSetFontPath, XGetFontPath, XFreeFontPath - フォント検索パスを設定し、獲得し、解放する

形式

XSetFontPath(display, directories, ndirs)
      Display ∗display;
      char ∗∗directories;
      int ndirs; char ∗∗XGetFontPath(display, npaths_return)
      Display ∗display;
      int ∗npaths_return;
 
XFreeFontPath(list)
      char ∗∗list;
 

引数

directoriesフォントを検索するために用いるディレクトリパスを指定します。 空のリストへのパスを設定すると、X サーバ用に定義されたデフォルトパス を復元します。

displayX サーバへのコネクションを指定します。

list解放したい文字列の配列を指定します。

ndirsパス内のディレクトリの数を指定します。

npaths_return
フォントパス配列中の文字列の数を返します。

解説

XSetFontPath 関数は、フォント検索用のディレクトリ検索パスを定義します。 1 クライアントごとにではなく、X サーバにつき検索パスはひとつだけ存在 します。 文字列のコードおよび解釈はインプリメンテーションにより異なりますが、 通常、リストに入れられた順序で、 ディレクトリまたはフォントサーバを検索するように指定します。 X サーバは、フォント情報を内部にキャッシュ（隠す）することができます。 例えば、ファイルからフォント全体をキャッシュし、 同じフォントを次にオープンする時に フォントファイルが変更されたかどうかをチェックしません。 しかし、フォントパスが変更された場合は X サーバは、 現在明示的な資源 ID が割り当てられていないフォント についての、キャッシュされた情報をフラッシュすることを保証します。 このリクエストによるエラーの意味は、インプリメンテーションにより 異なります。 XSetFontPath は、 BadValue エラーを生じることがあります。 XGetFontPath 関数は、検索パスを含んだ文字列の配列を割り当て、返します。 これらの文字列の内容は、インプリメンテーションにより異なり、 クライアントのアプリケーションには解釈されません。 フォントパス内のデータは、 必要なくなった場合、 XFreeFontPath を用いて解放されなければなりません。 XFreeFontPath 関数は、 XGetFontPath が割り当てたデータを解放します。

診断

BadValue ある数値が、許容範囲を超えた。 引数の値の範囲が明示されない限り、引数の型によって決まる最大の範囲ま で指定可能です。 選択形式の引数も、このエラーを生じることがあります。

関連事項

XListFont(3X11), XLoadFonts(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R