この関数は、name に一致する利用可能なフォント名のリストを返します。name には、Fontconfig、GTK+、または XLFD 形式のフォント名を含む文字列を指定します(The GNU Emacs Manual の Fonts を参照してください)。XLFD 文字列内では、ワイルドカード文字を使用できます。‘*’ 文字は任意の部分文字列に、‘?’ 文字は任意の1文字に一致します。フォント名の照合時には大文字と小文字は区別されません。
オプション引数 reference-face および frame が指定された場合、返されるリストには、フレーム frame に現在設定されている reference-face(フォント名)と同じサイズのフォントのみが含まれます。
オプション引数 maximum は、返却するフォント数の上限を指定します。これが nil 以外の場合、返却値は最初に一致した maximum
個のフォント以降で切り捨てられます。パターンに一致するフォントが多数存在する場合、maximum
に小さな値を指定することで、この関数の処理速度を大幅に向上させることができます。
オプション引数 width は、希望するフォント幅を指定します。これが nil 以外の場合、この関数は、文字の幅が(平均して)reference-face の width
倍であるフォントのみを返します。
この関数は、frame におけるファミリー family
で利用可能なフォントを記述したリストを返します。family が省略されているか、あるいは nil
が指定されている場合、このリストはすべてのファミリーに適用されるため、利用可能なすべてのフォントが含まれます。それ以外の場合、family は文字列である必要があり、ワイルドカード ‘?’ および ‘*’
を含めることができます。
このリストは frame が適用されている表示について記述しています。frame が省略されているか、あるいは nil
が指定されている場合は、選択されたフレームの表示に適用されます(入力フォーカス を参照)。
リストの各要素は、以下のような形式のベクトルです:
[family width point-size weight slant fixed-p full registry-and-encoding]
最初の5つの要素はフェイス属性に対応しており、フェイスにこれらの属性を指定すると、このフォントが使用されます。
最後の3つの要素は、フォントに関する追加情報を提供します。フォントが固定ピッチの場合、fixed-p は
non-nil となります。full
はフォントの正式名称であり、registry-and-encoding
はフォントのレジストリとエンコーディングを示す文字列です。