XSetFontPath(3X11)

名前
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 サーバに設定されたデフォルトのパスが復 元される。

display
    X サーバへの接続を指定。

list
    解放する文字列の配列を指定。

ndirs
    パス中のディレクトリの数を指定。

npaths_return
    フォントパスの配列内の文字列の数が返される。

説明
関数 はフォントを探すためのディレクトリ検索パスを定義する。 検索パスは X サーバごとに1つずつだけあり、クライアントは検索パスは持た ない。 エンコーディングと文字列の解釈は実装依存であるが、一般的には順序リスト としてディレクトリかフォントサーバを指定する。 X サーバはフォント情報を内部的にキャッシングすることが認められている。 例えば、ファイルからフォント全体をキャッシュし、それより後にそのフォン トをオープンしたときには元のファイルが変更されたかどうかのチェックを行 わないこともある。 しかしフォントパスが変更されれば、X サーバは現在キャッシュしているフォ ント情報をすべてフラッシュすることになっている。ただし、その時点でリソー ス ID が明示的に割り当てられているフォントはフラッシュされない。 このリクエストからのエラーの意味は実装依存である。

はエラー を起こすことがある。

関数 は検索パスの文字列配列をアロケートして返す。 この文字列の内容は実装依存であり、クライアントアプリケーションによって 解釈されることは想定されていない。 文字列が必要なくなったときには、 を呼び出してフォントパスのデータを解放すること。

関数 は がアロケートしたデータを解放する。

返り値

指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
    して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。

関連項目
XListFont(3X11), XLoadFonts(3X11)
Xlib - C Language X Interface