.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining
.\" a copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish,
.\" distribute, sublicense, and/or sell copies of the Software, and to
.\" permit persons to whom the Software is furnished to do so, subject to
.\" the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of the X Consortium shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from the X Consortium.
.\"
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by
.\" Digital Equipment Corporation
.\"
.\" Portions Copyright \(co 1990, 1991 by
.\" Tektronix, Inc.
.\"
.\" Permission to use, copy, modify and distribute this documentation for
.\" any purpose and without fee is hereby granted, provided that the above
.\" copyright notice appears in all copies and that both that copyright notice
.\" and this permission notice appear in all copies, and that the names of
.\" Digital and Tektronix not be used in in advertising or publicity pertaining
.\" to this documentation without specific, written prior permission.
.\" Digital and Tektronix makes no representations about the suitability
.\" of this documentation for any purpose.
.\" It is provided ``as is'' without express or implied warranty.
.\" 
.\" Copyright (c) 1998, 2001 The X Japanese Documentation Project.
.\" 
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\" 
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\" 
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\" 
.\" X Window System is a trademark of The Open Group.
.\"
.\" Translated Tue Oct 27 00:00:00 JST 1998
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Corrected by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated Sun Sep 30 21:57:01 JST 2001 for XFree86 4.1.0
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" WORD: linear character index	線形文字インデックス
.\" WORD: 2-byte matrix format	2バイト行列形式
.\"
.\" $XFree86: xc/doc/man/X11/XLoadFont.man,v 1.2 2001/01/27 18:20:01 dawes Exp $
.\"
.ds xT X Toolkit Intrinsics \- C Language Interface
.ds xW Athena X Widgets \- C Language X Toolkit Interface
.ds xL Xlib \- C Language X Interface
.ds xC Inter-Client Communication Conventions Manual
.na
.de Ds
.nf
.\\$1D \\$2 \\$1
.ft 1
.\".ps \\n(PS
.\".if \\n(VS>=40 .vs \\n(VSu
.\".if \\n(VS<=39 .vs \\n(VSp
..
.de De
.ce 0
.if \\n(BD .DF
.nr BD 0
.in \\n(OIu
.if \\n(TM .ls 2
.sp \\n(DDu
.fi
..
.de FD
.LP
.KS
.TA .5i 3i
.ta .5i 3i
.nf
..
.de FN
.fi
.KE
.LP
..
.de IN		\" send an index entry to the stderr
..
.de C{
.KS
.nf
.D
.\"
.\"	choose appropriate monospace font
.\"	the imagen conditional, 480,
.\"	may be changed to L if LB is too
.\"	heavy for your eyes...
.\"
.ie "\\*(.T"480" .ft L
.el .ie "\\*(.T"300" .ft L
.el .ie "\\*(.T"202" .ft PO
.el .ie "\\*(.T"aps" .ft CW
.el .ft R
.ps \\n(PS
.ie \\n(VS>40 .vs \\n(VSu
.el .vs \\n(VSp
..
.de C}
.DE
.R
..
.de Pn
.ie t \\$1\fB\^\\$2\^\fR\\$3
.el \\$1\fI\^\\$2\^\fP\\$3
..
.de ZN
.ie t \fB\^\\$1\^\fR\\$2
.el \fI\^\\$1\^\fP\\$2
..
.de hN
.ie t <\fB\\$1\fR>\\$2
.el <\fI\\$1\fP>\\$2
..
.de NT
.ne 7
.ds NO Note
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
.ie n .sp
.el .sp 10p
.TB
.ce
\\*(NO
.ie n .sp
.el .sp 5p
.if '\\$1'C' .ce 99
.if '\\$2'C' .ce 99
.in +5n
.ll -5n
.R
..
.		\" Note End -- doug kraft 3/85
.de NE
.ce 0
.in -5n
.ll +5n
.ie n .sp
.el .sp 10p
..
.ny0
.TH XLoadFont 3X11 "Release 6.5" "X Version 11" "XLIB FUNCTIONS"
.SH 名前
.\"0 XLoadFont, XQueryFont, XLoadQueryFont, XFreeFont, XGetFontProperty, XUnloadFont, XCharStruct, XFontProp, XChar2b, XFontStruct \- load or unload fonts and font metric structures
XLoadFont, XQueryFont, XLoadQueryFont, XFreeFont, XGetFontProperty, XUnloadFont, XCharStruct, XFontProp, XChar2b, XFontStruct \- フォントのロードとアンロード、フォント寸法構造体
.SH 書式
Font XLoadFont\^(\^\fIdisplay\fP, \fIname\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      char *\fIname\fP\^;
.LP
XFontStruct *XQueryFont\^(\^\fIdisplay\fP, \fIfont_ID\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      XID \fIfont_ID\fP\^;
.LP
XFontStruct *XLoadQueryFont\^(\^\fIdisplay\fP, \fIname\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      char *\fIname\fP\^;
.LP
XFreeFont\^(\^\fIdisplay\fP, \fIfont_struct\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      XFontStruct *\fIfont_struct\fP\^;
.LP
Bool XGetFontProperty\^(\^\fIfont_struct\fP\^, \^\fIatom\fP\^, \^\fIvalue_return\fP\^)
.br
      XFontStruct *\fIfont_struct\fP\^;
.br
      Atom \fIatom\fP\^;
.br
      unsigned long *\fIvalue_return\fP\^;
.LP
XUnloadFont\^(\^\fIdisplay\fP, \fIfont\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      Font \fIfont\fP\^;
.SH 引き数
.IP \fIatom\fP 1i
.\"0 Specifies the atom for the property name you want returned.
求めるプロパティ名に対するアトムを指定。
.IP \fIdisplay\fP 1i
.\"0 Specifies the connection to the X server.
X サーバへの接続を指定。
.IP \fIfont\fP 1i
.\"0 Specifies the font.
フォントを指定。
.IP \fIfont_ID\fP 1i
.\"0 Specifies the font ID or the 
.\"0 .ZN GContext
.\"0 ID.
フォント ID か
.ZN GContext
ID を指定。
.IP \fIfont_struct\fP 1i
.\"0 Specifies the storage associated with the font.
フォントに対応する構造体を指定。
.IP \fIgc\fP 1i
.\"0 Specifies the GC.
GC を指定。
.IP \fIname\fP 1i
.\"0 Specifies the name of the font,
.\"0 which is a null-terminated string.
フォントの名前を指定。
これはNULLで終る文字列である。
.IP \fIvalue_return\fP 1i
.\"0 Returns the value of the font property.
フォントプロパティの値が返される。
.SH 説明
.\"0 The
.\"0 .ZN XLoadFont
.\"0 function loads the specified font and returns its associated font ID.
関数
.ZN XLoadFont
は指定したフォントをロードし、対応するフォントIDを返す。
.\"0 If the font name is not in the Host Portable Character Encoding,
.\"0 the result is implementation-dependent.
フォント名のエンコーディングがホストポータブル文字エンコーディングでな
い場合、実行結果は実装依存である。
.\"0 Use of uppercase or lowercase does not matter.
大文字や小文字の使用は問題ない。
.\"0 When the characters ``?'' and ``*'' are used in a font name, a
.\"0 pattern match is performed and any matching font is used.
フォント名に文字 ``?'' や ``*'' が用いられた時、パターンマッチングが行
われマッチしたフォントのどれかが使用される。
.\"0 In the pattern, 
.\"0 the ``?'' character will match any single character, 
.\"0 and the ``*'' character will match any number of characters.
パターン中で文字 ``?'' は任意の1文字にマッチし、文字 ``*'' は任意の数
の文字にマッチする。
.\"0 A structured format for font names is specified in the X Consortium standard 
.\"0 \fIX Logical Font Description Conventions\fP.
フォント名の構造化フォーマットはXコンソーシアム標準の
\fIX Logical Font Description Conventions\fP
で指定されている。
.\"0 If 
.\"0 .ZN XLoadFont
.\"0 was unsuccessful at loading the specified font, 
.\"0 a 
.\"0 .ZN BadName 
.\"0 error results.
.ZN XLoadFont
が指定したフォントのロードに失敗した場合、エラー
.ZN BadName
が起こる。
.\"0 Fonts are not associated with a particular screen 
.\"0 and can be stored as a component
.\"0 of any GC.
フォントは特定のスクリーンに関連づけされない。一方、任意の GC のコンポー
ネントとして格納することはできる。
.\"0 When the font is no longer needed, call 
.\"0 .ZN XUnloadFont .
フォントが不要になった場合は
.ZN XUnloadFont
を呼び出すこと。
.LP
.\"0 .ZN XLoadFont
.\"0 can generate
.\"0 .ZN BadAlloc 
.\"0 and
.\"0 .ZN BadName 
.\"0 errors.
.ZN XLoadFont
はエラー
.ZN BadAlloc ,
.ZN BadName 
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XQueryFont
.\"0 function returns a pointer to the
.\"0 .ZN XFontStruct
.\"0 structure, which contains information associated with the font.
.ZN XQueryFont
関数は
.ZN XFontStruct
構造体へのポインタを返す。
この構造体はフォントに関連する情報を持っている。
.\"0 You can query a font or the font stored in a GC.
クライアントはフォントやGCに格納されているフォントを問い合わせることが
できる。
.\"0 The font ID stored in the 
.\"0 .ZN XFontStruct
.\"0 structure will be the 
.\"0 .ZN GContext 
.\"0 ID, and you need to be careful when using this ID in other functions
.\"0 (see
.\"0 .ZN XGContextFromGC ).
.ZN XFontStruct
構造体に含まれるフォントIDは
.ZN GContext
のIDであり、他の関数でこの GC を使うときには注意する必要がある(
.ZN XGContextFromGC
を参照)。
.\"0 If the font does not exist,
.\"0 .ZN XQueryFont
.\"0 returns NULL.
フォントが存在しなければ
.ZN XQueryFont
は NULL を返す。
.\"0 To free this data, use
.\"0 .ZN XFreeFontInfo .
このデータを解放するには
.ZN XFreeFontInfo
を使用すること。
.LP
.\"0 .ZN XLoadQueryFont
.\"0 can generate a
.\"0 .ZN BadAlloc 
.\"0 error.
.ZN XLoadQueryFont
はエラー
.ZN BadAlloc 
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XLoadQueryFont
.\"0 function provides the most common way for accessing a font.
関数
.ZN XLoadQueryFont
はフォントにアクセスする手段のうち、最も一般的なものである。
.\"0 .ZN XLoadQueryFont
.\"0 both opens (loads) the specified font and returns a pointer to the
.\"0 appropriate
.\"0 .ZN XFontStruct
.\"0 structure.
.ZN XLoadQueryFont
は指定したフォントをオープン(ロード)し、適切な
.ZN XFontStruct
構造体へのポインタを返す。
.\"0 If the font name is not in the Host Portable Character Encoding,
.\"0 the result is implementation-dependent.
フォント名のエンコーディングがホストポータブル文字エンコーディングでな
い場合、実行結果は実装依存である。
.\"0 If the font does not exist,
.\"0 .ZN XLoadQueryFont
.\"0 returns NULL.
フォントが存在しない場合
.ZN XLoadQueryFont
は NULL を返す。
.LP
.\"0 The
.\"0 .ZN XFreeFont
.\"0 function deletes the association between the font resource ID and the specified 
.\"0 font and frees the
.\"0 .ZN XFontStruct
.\"0 structure.
関数
.ZN XFreeFont
はフォントのリソースIDと指定したフォントの関連を削除し、
.ZN XFontStruct
構造体を解放する。
.\"0 The font itself will be freed when no other resource references it.
フォントそのものは他のリソースから参照されなくなったときに解放される。
.\"0 The data and the font should not be referenced again.
このデータとフォントは再び参照してはならない。
.LP
.\"0 .ZN XFreeFont
.\"0 can generate a
.\"0 .ZN BadFont 
.\"0 error.
.ZN XFreeFont
はエラー
.ZN BadFont 
を起こすことがある。
.LP
.\"0 Given the atom for that property,
.\"0 the
.\"0 .ZN XGetFontProperty
.\"0 function returns the value of the specified font property. 
プロパティに対するアトムを与えると、
.ZN XGetFontProperty
は指定したフォントプロパティの値を返す。
.\"0 .ZN XGetFontProperty
.\"0 also returns 
.\"0 .ZN False
.\"0 if the property was not defined or 
.\"0 .ZN True
.\"0 if it was defined.
.ZN XGetFontProperty
はプロパティが定義されていなければ
.ZN False
を返し、定義されていれば
.ZN True
を返す。
.\"0 A set of predefined atoms exists for font properties,
.\"0 which can be found in
.\"0 .hN X11/Xatom.h .
フォントプロパティとして予め定義されているアトムがあり、これは
.hN X11/Xatom.h
で定義されている。
.\"0 This set contains the standard properties associated with
.\"0 a font.
これらのアトムにはフォントに関連する標準的なプロパティが含まれている。
.\"0 Although it is not guaranteed,
.\"0 it is likely that the predefined font properties will be present.
保証はされていないが、予め定義されているフォントプロパティはたいてい存
在する。
.LP
.\"0 The
.\"0 .ZN XUnloadFont
.\"0 function deletes the association between the font resource ID and the specified font.
関数
.ZN XUnloadFont
はフォントリソースIDと指定したフォントの関連を削除する。
.\"0 The font itself will be freed when no other resource references it.
フォントそのものは他のリソースから参照されなくなったときに解放される。
.\"0 The font should not be referenced again.
このフォントを再び参照してはならない。
.LP
.\"0 .ZN XUnloadFont
.\"0 can generate a
.\"0 .ZN BadFont 
.\"0 error.
.ZN XUnloadFont
はエラー
.ZN BadFont 
を起こすことがある。
.SH 構造体
.\"0 The
.\"0 .ZN XFontStruct
.\"0 structure contains all of the information for the font
.\"0 and consists of the font-specific information as well as
.\"0 a pointer to an array of
.\"0 .ZN XCharStruct
.\"0 structures for the
.\"0 characters contained in the font.
.ZN XFontStruct
構造体にはフォントの情報が全て含まれる。この構造体は、フォント固有の情
報や
.ZN XCharStruct
構造体(フォントに含まれる文字の情報)の配列へのポインタから構成されてい
る。
.\"0 The
.\"0 .ZN XFontStruct ,
.\"0 .ZN XFontProp ,
.\"0 and
.\"0 .ZN XCharStruct
.\"0 structures contain:
.ZN XFontStruct ,
.ZN XFontProp ,
.ZN XCharStruct
の各構造体の内容を以下に示す。
.LP
.IN "XCharStruct" "" "@DEF@"
.Ds 0
.TA .5i 3i
.ta .5i 3i
typedef struct {
	short lbearing;	
	short rbearing;	
	short width;	
	short ascent;	
	short descent;	
	unsigned short attributes;	
} XCharStruct;
.De
.LP
.IN "XFontProp" "" "@DEF@"
.Ds 0
.TA .5i 1i 3i
.ta .5i 1i 3i
typedef struct {
	Atom	name;
	unsigned long card32;
} XFontProp;
.De
.LP
.IN "XChar2b" "" "@DEF@"
.Ds 0
.TA .5i 3i
.ta .5i 3i
typedef struct {	
    unsigned char byte1;
    unsigned char byte2;
} XChar2b;
.De
.LP
.IN "XFontStruct" "" "@DEF@"
.Ds 0
.TA .5i 3i
.ta .5i 3i
typedef struct {
	XExtData *ext_data;	
	Font fid;	
	unsigned direction;	
	unsigned min_char_or_byte2;	
	unsigned max_char_or_byte2;	
	unsigned min_byte1;	
	unsigned max_byte1;	
	Bool all_chars_exist;	
	unsigned default_char;	
	int n_properties;	
	XFontProp *properties;	
	XCharStruct min_bounds;	
	XCharStruct max_bounds;	
	XCharStruct *per_char;	
	int ascent;	
	int descent;	
} XFontStruct;
.De
.LP
.\"0 X supports single byte/character, two bytes/character matrix,
.\"0 and 16-bit character text operations.
X は 1バイト/文字の形式、2バイト/文字の行列形式と、16ビット文字形式の
テキスト操作をサポートしている。
.\"0 Note that any of these forms can be used with a font, but a
.\"0 single byte/character text request can only specify a single byte
.\"0 (that is, the first row of a 2-byte font).
あるフォントはこれらの形式のいずれでも使用できるが、1バイト/文字のテキ
ストのリクエストだけが単独のバイト(つまり、2バイトフォントの最初の列)
を指定できる。
.\"0 You should view 2-byte fonts as a two-dimensional matrix of defined
.\"0 characters: byte1 specifies the range of defined rows and
.\"0 byte2 defines the range of defined columns of the font.
2バイトフォントは定義された文字の2次元行列として見るべきである。
byte1 はフォントの定義された列の範囲を指定し、byte2 は定義された行の範
囲を定義する。
.\"0 Single byte/character fonts have one row defined, and the byte2 range
.\"0 specified in the structure defines a range of characters.
1バイト/文字のフォントは列が1つ定義されており、構造体で定義された 
byte2 は文字の範囲を定義する。
.LP
.\"0 The bounding box of a character is defined by the 
.\"0 .ZN XCharStruct 
.\"0 of that character.
文字のバウンディングボックスは文字の
.ZN XCharStruct
によって定義される。
.\"0 When characters are absent from a font,
.\"0 the default_char is used.
フォントに含まれていない文字があるときにはデフォルト文字が使用される。
.\"0 When fonts have all characters of the same size,
.\"0 only the information in the
.\"0 .ZN XFontStruct
.\"0 min and max bounds are used.
フォントの全ての文字のサイズが同じであるとき、
.ZN XFontStruct
構造体の min_bounds と max_bounds の情報だけが使用される。
.LP
.\"0 The members of the 
.\"0 .ZN XFontStruct 
.\"0 have the following semantics:
.ZN XFontStruct 
のメンバは以下の意味を持つ。
.IP \(bu 5
.\"0 The direction member can be either 
.\"0 .ZN FontLeftToRight 
.\"0 or 
.\"0 .ZN FontRightToLeft . 
direction メンバは
.ZN FontLeftToRight 
か
.ZN FontRightToLeft
の値を持つ。
.\"0 It is just a hint as to whether most 
.\"0 .ZN XCharStruct 
.\"0 elements 
.\"0 have a positive 
.\"0 .Pn ( FontLeftToRight ) 
.\"0 or a negative 
.\"0 .Pn ( FontRightToLeft )
.\"0 character width 
.\"0 metric.
これは、
.ZN XCharStruct
要素の大部分が、正
.Pn ( FontLeftToRight )
あるいは負
.Pn ( FontRightToLeft )
の文字幅を持っていることを示す単なるヒントに過ぎない。
.\"0 The core protocol defines no support for vertical text.
コアプロトコルでは縦書きテキストのサポートは定義されていない。
.IP \(bu 5
.\"0 If the min_byte1 and max_byte1 members are both zero, min_char_or_byte2
.\"0 specifies the linear character index corresponding to the first element
.\"0 of the per_char array, and max_char_or_byte2 specifies the linear character
.\"0 index of the last element.
min_byte1 と max_byte1 メンバがいずれも 0 であれば、min_char_or_byte2
は per_char 配列の最初の要素に対応する線形文字インデックスを指定し、
max_char_or_byte2 は最後の要素の線形文字インデックスを指定する。
.IP
.\"0 If either min_byte1 or max_byte1 are nonzero, both
.\"0 min_char_or_byte2 and max_char_or_byte2 are less than 256, 
.\"0 and the 2-byte character index values corresponding to the
.\"0 per_char array element N (counting from 0) are:
min_byte1 か max_byte1 が 0 でなければ、min_char_or_byte2 と 
max_char_or_byte2 は256未満であり、per_char 配列要素 N(0から数える)に
対応する2バイト文字インデックス値は以下のようになる。
.IP
.nf
	byte1 = N/D + min_byte1
.br
	byte2 = N\\D + min_char_or_byte2
.IP
.fi
where:
.IP
.nf
        D = max_char_or_byte2 \- min_char_or_byte2 + 1
.\"0         / = integer division
.\"0         \\ = integer modulus
         / = 整数の商
         \\ = 整数の剰余
.fi
.IP \(bu 5
.\"0 If the per_char pointer is NULL, 
.\"0 all glyphs between the first and last character indexes
.\"0 inclusive have the same information,
.\"0 as given by both min_bounds and max_bounds.
per_char ポインタが NULL であれば、最初と最後の文字インデックスの間の
グリフは全て同じ情報を持つ。これは min_bounds と max_bounds で与えられ
る。
.IP \(bu 5
.\"0 If all_chars_exist is 
.\"0 .ZN True ,
.\"0 all characters in the per_char array have nonzero bounding boxes.
all_chars_exist
が
.ZN True
の場合、per_char 配列内の全ての文字は 0 でないバウンディングボックス
を持つ。
.IP \(bu 5
.\"0 The default_char member specifies the character that will be used when an
.\"0 undefined or nonexistent character is printed.  
default_char メンバは、未定義の文字や存在しない文字を表示するときに用
いられる文字を指定する。
.\"0 The default_char is a 16-bit character (not a 2-byte character).
default_char は(2バイト文字ではなく)16ビット文字である。
.\"0 For a font using 2-byte matrix format, 
.\"0 the default_char has byte1 in the most-significant byte
.\"0 and byte2 in the least significant byte.
2バイト行列形式を使うフォントの場合、default_char は byte1 を最上位バ
イト、byte2 を最下位バイトとする。
.\"0 If the default_char itself specifies an undefined or nonexistent character, 
.\"0 no printing is performed for an undefined or nonexistent character.
default_char 自身が未定義あるいは存在しない文字を指定した場合には、未
定義あるいは存在しない文字の表示は行われない。
.IP \(bu 5
.\"0 The min_bounds and max_bounds members contain the most extreme values of
.\"0 each individual 
.\"0 .ZN XCharStruct 
.\"0 component over all elements of this array
.\"0 (and ignore nonexistent characters).
min_bounds と max_bounds メンバは、この配列の全ての要素それぞれ(存在し
ない文字は除く)の
.ZN XCharStruct 
要素の最大値、最小値を持つ。
.\"0 The bounding box of the font (the smallest
.\"0 rectangle enclosing the shape obtained by superimposing all of the
.\"0 characters at the same origin [x,y]) has its upper-left coordinate at:
フォントのバウンディングボックス(全ての文字を同じ原点に置いて重ね合わ
せ、得られた形状を囲む最少の長方形)の左上の座標は次のようになる:
.Ds
	[x + min_bounds.lbearing, y \- max_bounds.ascent]
.De
.IP
.\"0 Its width is:
幅は以下のようになる:
.Ds
	max_bounds.rbearing \- min_bounds.lbearing
.De
.IP
.\"0 Its height is:
高さは以下のようになる:
.Ds
	max_bounds.ascent + max_bounds.descent
.De
.IP \(bu 5
.\"0 The ascent member is the logical extent of the font above the baseline that is
.\"0 used for determining line spacing.
ascent メンバは、ベースライン上部のフォントの論理的な広さで、行間を決
定するために用いられる。
.\"0 Specific characters may extend beyond
.\"0 this.
特定の文字はこれを越えることがある。
.IP \(bu 5
.\"0 The descent member is the logical extent of the font at or below the
.\"0 baseline that is used for determining line spacing.
descent メンバは、ベースライン下部のフォントの論理的な広さで、行間を決
定するために用いられる(0のこともある)。
.\"0 Specific characters may extend beyond this.
特定の文字はこれを越えることがある。
.IP \(bu 5
.\"0 If the baseline is at Y-coordinate y,
.\"0 the logical extent of the font is inclusive between the Y-coordinate 
.\"0 values (y \- font.ascent) and (y + font.descent \- 1).
ベースラインが Y座標 y にあるとき、フォントの論理的な広さは Y 座標
(y \- font.ascent) と (y + font.descent \- 1) の内側である。
.\"0 Typically,
.\"0 the minimum interline spacing between rows of text is given
.\"0 by ascent + descent.
通常はテキストの行間の最少の送り量は ascent + descent で与えられる。
.LP
.\"0 For a character origin at [x,y],
.\"0 the bounding box of a character (that is, 
.\"0 the smallest rectangle that encloses the character's shape)
.\"0 described in terms of 
.\"0 .ZN XCharStruct 
.\"0 components is a rectangle with its upper-left corner at:
原点が[x, y]にある文字について、
.ZN XCharStruct
コンポーネントを用いて記述される、文字のバウンディングボックス(つまり
文字の形を囲む最小の長方形)は、次のようになる:
.LP
.Ds
[x + lbearing, y \- ascent]
.De
.LP
.\"0 Its width is:
幅は次のようになる:
.LP
.Ds
rbearing \- lbearing
.De
.LP
.\"0 Its height is:
高さは次のようになる:
.LP
.Ds
ascent + descent
.De
.LP
.\"0 The origin for the next character is defined to be:
隣の文字の原点は次のように定義される:
.LP
.Ds
[x + width, y]
.De
.LP
.\"0 The lbearing member defines the extent of the left edge of the character ink
.\"0 from the origin.
lbearing メンバは原点から文字が実際に描画される部分の左端までの大きさ
を定義する。
.\"0 The rbearing member defines the extent of the right edge of the character ink
.\"0 from the origin.
rbearing メンバは原点から文字が実際に描画される部分の右端までの大きさ
を定義する。
.\"0 The ascent member defines the extent of the top edge of the character ink
.\"0 from the origin.
ascent メンバは原点から文字が実際に描画される部分の上端までの大きさを
定義する。
.\"0 The descent member defines the extent of the bottom edge of the character ink
.\"0 from the origin.
descent メンバは原点から文字が実際に描画される部分の下端までの大きさを
定義する。
.\"0 The width member defines the logical width of the character.
width メンバは文字の論理的な幅を定義する。
.SH 返り値
.TP 1i
.ZN BadAlloc
.\"0 The server failed to allocate the requested resource or server memory.
要求されたリソースかサーバメモリの割り当てにサーバが失敗した。
.TP 1i
.ZN BadFont
.\"0 A value for a Font or GContext argument does not name a defined Font.
引き数 Font か GContext の値が、定義されている Font を指していない。
.TP 1i
.ZN BadName
.\"0 A font or color of the specified name does not exist.
指定したフォントや色の名前が存在しない。
.SH 関連項目
XCreateGC(3X11),
XListFonts(3X11),
XSetFontPath(3X11)
.br
\fI\*(xL\fP