名称

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.1C