.\" $Xorg: xfd.man,v 1.3 2000/08/17 19:54:18 cpqbld Exp $
.\" Copyright 1989, 1994, 1998  The Open Group
.\" 
.\" All Rights Reserved.
.\" 
.\" 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 OPEN GROUP 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 Open Group 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 Open Group.
.\"
.\" 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 08 06:55:10 JST 1998
.\"         by Ito Hiromi <hiromi@marimo.or.jp>
.\" Updated Sun Oct 21 12:48:43 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/programs/xfd/xfd.man,v 1.7 2001/01/27 18:21:12 dawes Exp $
.\"
.TH XFD 1 "Release 6.5" "X Version 11"
.SH 名前
.\"0 xfd \- display all the characters in an X font
xfd \- X フォントの全ての文字を表示する
.SH 書式
.B xfd
[\-options ...] \fB\-fn\fP \fIfontname\fP
.SH 説明
.\"0 The \fIxfd\fP utility creates a window containing the name of the font being
.\"0 displayed, a row of command buttons, several lines of text for displaying
.\"0 character metrics, and a grid containing one glyph per cell.  The
.\"0 characters are shown in increasing order from left to right, top to
.\"0 bottom.  The first character displayed at the top left will be character
.\"0 number 0 unless the \fB\-start\fP option has been supplied in which case the
.\"0 character with the number given in the \fB\-start\fP option will be used.
\fIxfd\fP ユーティリティはウィンドウを作成する。このウィンドウには、表
示されたフォントの名前、コマンドボタンの列、文字のメトリックを表示する
テキストが数行、セル毎に 1 グリフを表示するグリッドが含まれる。フォン
トの文字は、左から右、上から下の順に表示される。左上に表示される最初の
文字は、文字番号 0 の文字である。ただし \fB\-start\fP オプションで使用
される番号によって変わる可能性がある。
.\"0 .PP
.\"0 The characters are displayed in a grid of boxes, each large enough to hold 
.\"0 any single character in the font.  Each character glyph is drawn using
.\"0 the PolyText16 request (used by the \fIXlib\fP routine \fBXDrawString16\fP).
.PP
フォント内の 1 文字を表示するのに十分な大きさのボックスのグリッド内に、
文字は表示される。各文字のグリフは、PolyText16 リクエストを用いて描画
される (\fIXlib\fP のルーチンである \fBXDrawString16\fP を使用する) 。
.\"0 If the \fB\-box\fP option is given, a rectangle will be drawn around each
.\"0 character, showing where an ImageText16 request (used by the \fIXlib\fP
.\"0 routine \fBXDrawImageString16\fP) would cause background color to be displayed.
\fB\-box\fP オプションが与えられている場合、各文字の周辺に長方形が描か
れる。これは、ImageText16 リクエスト (\fIXlib\fP ルーチンの
\fBXDrawImageString16\fP を使用する) が表示するバックグラウンドカラー
によって描かれる。
.\"0 .PP
.\"0 The origin of each glyph is normally set so that the character is drawn in
.\"0 the upper left hand corner of the grid cell.  However, if a glyph has a 
.\"0 negative left bearing or an unusually large ascent, descent, or right bearing 
.\"0 (as is the case with \fIcursor\fP font), some character may not appear in their
.\"0 own grid cells.  The \fB\-center\fP option may be used to force all glyphs to 
.\"0 be centered in their respective cells.
.PP
グリッドセルの左上角に文字が描画されるように、普通各グリフの原点が設定
される。ただし、グリフの left bearing が負である場合、または ascent、
descent、right bearing のいずれかが非常に大きい場合 (例えば
\fIcursor\fP フォント)、その文字のグリッドセルを外れて描画されるかもし
れない。\fB\-center\fP オプションは、全てのグリフを各セルの中央に配置
させることができる。
.\"0 .PP
.\"0 All the characters in the font may not fit in the window at once.
.\"0 To see the next page of glyphs, press the \fINext\fP button at the top 
.\"0 of the window.  To see the previous page, press \fIPrev\fP.  To exit \fIxfd\fP,
.\"0 press \fIQuit\fP.
.PP
フォントの全ての文字が、一度にウィンドウに入るとは限らない。ウィンドウ
の上部にある \fINext\fP ボタンを押すと、グリフの次のページを見ることが
できる。\fIPrev\fP を押すと前のページを見ることができ、また \fIQuit\fP
を押すと \fIxfd\fP を終了させることができる。
.\"0 .PP
.\"0 Individual character metrics (index, width, bearings, ascent and descent) can
.\"0 be displayed at the top of the window by clicking on the desired character.
.PP
個々の文字のメトリック (index, width, bearings, ascent, descent) は、
対象とする文字をクリックすることによってウィンドウの上部に表示される。
.\"0 .PP
.\"0 The font name displayed at the top of the window is the full name of the 
.\"0 font, as determined by the server.  See \fIxlsfonts\fP for ways to generate
.\"0 lists of fonts, as well as more detailed summaries of their metrics and
.\"0 properties.
.PP
ウィンドウの上部に表示されたフォント名は、サーバによって確定されたフォ
ントのフルネームである。メトリックとプロパティのより詳細な一覧だけでな
く、フォントのリストを表示するには、\fIxlsfonts\fP を参考にすること。
.SH オプション
.\"0 .PP
.\"0 .I xfd
.\"0 accepts all of the standard toolkit command line options along with
.\"0 the additional options listed below:
.\"0 .TP 8
.\"0 .B \-fn \fIfont\fP
.\"0 This option specifies the font to be displayed.  This can also be set with
.\"0 the FontGrid \fBfont\fP resource.  A font must be specified.
.PP
.I xfd 
は、標準のツールキットのコマンド行オプション全てを利用できる。さらに以
下に示した追加オプションも利用できる。
.TP 8
.B \-fn \fIfont\fP
表示するフォントを指定する。これは、FontGrid の \fBfont\fP リソースで
も設定できる。フォントは必ず指定しなければならない。
.\"0 .TP 8
.\"0 .B \-box
.\"0 This option indicates that a box should be displayed outlining the area
.\"0 that would be filled with background color by an ImageText request.
.TP 8
.B \-box
ImageText リクエストによって、バックグラウンドカラーで塗られた領域の輪
郭となる、ボックスの表示を指定する。
.\"0 This can also be set with
.\"0 the FontGrid \fBboxChars\fP resource.  The default is False.
これは、FontGrid の \fBboxChars\fP リソースでも設定することができる。
デフォルトは False である。
.\"0 .TP 8
.\"0 .B \-center
.\"0 This option indicates that each glyph should be centered in its grid.
.\"0 This can also be set with
.\"0 the FontGrid \fBcenterChars\fP resource.  The default is False.
.TP 8
.B \-center
各グリフがグリッドの中央に位置するように指定する。これは、FontGrid
の \fBcenterChars\fP リソースでも設定できる。デフォルトは False で
ある。
.\"0 .TP 8
.\"0 .B \-start \fInumber\fP
.\"0 This option specifies the glyph index of the upper left hand corner of the
.\"0 grid.  This is used to view characters at arbitrary locations in the font.
.TP 8
.B \-start \fInumber\fP
グリッドの左上角にある、グリフのインデックスを指定する。フォント内の
任意の位置にある文字を表示するために使用される。
.\"0 This can also be set with
.\"0 the FontGrid \fBstartChar\fP resource.  The default is 0.
これは、FontGrid の \fBstartChar\fP リソースでも設定できる。デフォル
トは 0 である。
.\"0 .TP 8
.\"0 .B \-bc \fIcolor\fP
.\"0 This option specifies the color to be used if ImageText boxes are drawn.
.TP 8
.B \-bc \fIcolor\fP
ImageText ボックスが描画される時に使用するカラーを指定する。
.\"0 This can also be set with
.\"0 the FontGrid \fBboxColor\fP resource.
これは、 FontGrid の \fBboxColor\fP リソースでも設定できる。
.\"0 .TP 8
.\"0 .B \-rows \fInumrows\fP
.\"0 This option specifies the number of rows in the grid.
.TP 8
.B \-rows \fInumrows\fP
グリッドの行数を指定する。
.\"0 This can also be set with
.\"0 the FontGrid \fBcellRows\fP resource.
これは、 FontGrid の \fBcellRows\fP リソースでも設定できる。
.\"0 .TP 8
.\"0 .B \-columns \fInumcols\fP
.\"0 This option specifies the number of columns in the grid.
.TP 8
.B \-columns \fInumcols\fP
グリッドの列数を指定する。
.\"0 This can also be set with
.\"0 the FontGrid \fBcellColumns\fP resource.
これは、FontGrid の \fBcellColumns\fP リソースでも指定できる。
.SH ウィジェット
.\"0 In order to specify resources, it is useful to know the 
.\"0 widgets which compose \fIxfd\fR.  In the notation below, indentation
.\"0 indicates hierarchical structure.  The widget class name is given first,
.\"0 followed by the widget instance name.
リソースを指定するために、\fIxfd\fR を構成するウィジェットを知っておく
と便利である。下の表記は、字下げが階層型構造を示している。ウィジェット
のクラス名が最初に記述され、続いてウィジェットのインスタンス名が記述さ
れている。
.\"0 The application class name is Xfd.
アプリケーションのクラス名は Xfd である。
.sp
.nf
.ta .5i 1.0i 1.5i 2.0i 2.5i 3.0i 3.5i 4.0i 4.5i 5.0i 5.5i 6.0i 6.5i 7.0i
Xfd  xfd
	Paned  pane
		Label  fontname
		Box  box
			Command  quit
			Command  prev
			Command  next
		Label  select
		Label  metrics
		Label  range
		Label  start
		Form  form
			FontGrid  grid
.fi
.\"0 .SH FONTGRID RESOURCES
.SH "フォントグリッド リソース"
.\"0 The FontGrid widget is an application-specific widget, and a subclass
.\"0 of the Simple widget in the Athena widget set.  The effects and
.\"0 instance names of this widget's resources are given in the
.\"0 \fBOPTIONS\fP section.  Capitalize the first letter of the resource
.\"0 instance name to get the corresponding class name.
FontGrid ウィジェットは、Athena ウィジェットにおける Simple ウィジェッ
トのサブクラスであり、アプリケーション特有のウィジェットである。このウ
ィジェットのリソースの効果やインスタンス名は、\fBオプション\fP セクション
で述べられている。リソースのインスタンス名における最初の文字を大文字に
したものがクラス名である。
.\"0 .SH APPLICATION SPECIFIC RESOURCES
.SH "アプリケーション特有のリソース"
.\"0 The instance names of the application specific resources
.\"0 are given below.  Capitalize the first letter of the resource
.\"0 instance name to get the corresponding class name.
アプリケーションに特有なリソースのインスタンス名を以下に記述した。一致
するクラス名を得るには、リソースのインスタンス名の最初の文字を大文字で
書くこと。
.\"0 These resources are unlikely to be interesting unless you are localizing
.\"0 xfd for a different language.
これらのリソースは、異なる言語用に xfd をローカライズするのでなければ、
あまり興味を引くものではない。
.\"0 .TP 8
.\"0 .B selectFormat
.\"0 Specifies a printf-style format string used to display information
.\"0 about the selected character.  The default is "character 0x%02x%02x
.\"0 (%u,%u) (%#o,%#o)".  The arguments that will come after the format string are
.\"0 char.byte1, char.byte2, char.byte1, char.byte2, char.byte1, char.byte2.
.\"0 char.byte1 is byte 1 of the selected character.  
.\"0 char.byte2 is byte 2 of the selected character.  
.TP 8
.B selectFormat
選択された文字に関する情報の表示に際して、printf スタイルのフォーマッ
トである文字例の使用を指定する。
デフォルトは "character 0x%02x%02x (%u,%u) (%#o,%#o)" である。
フォーマットされた文字列の後に続く引き数は、char.byte1, char.byte2,
char.byte1, char.byte2, char.byte1, char.byte2 である。
char.byte1 は、選択された文字の 1 バイト目である。
char.byte2 は、選択された文字の 2 バイト目である。
.\"0 .TP 8
.\"0 .B metricsFormat
.\"0 Specifies a printf-style format string used to display character
.\"0 metrics.  The default is "width %d; left %d, right %d; ascent %d,
.\"0 descent %d (font %d, %d)".  The arguments that will come after the
.\"0 format string are the character metrics width, lbearing, rbearing,
.\"0 character ascent, character descent, font ascent, and font descent.
.TP 8
.B metricsFormat
文字のメトリックの表示に際して、printf スタイルのフォーマットである文
字列の使用を指定する。デフォルトは、 "width %d; left %d, right %d; 
ascent %d, descent %d (font %d, %d)" である。フォーマットされた文字列
の後に続く引き数は、文字のメトリック width, lbearing, rbearing,
character ascent, character descent, font ascent, font descent である。
.\"0 .TP 8
.\"0 .B rangeFormat
.\"0 Specifies a printf-style format string used to display the range of
.\"0 characters currently being displayed.  The default is "range:
.\"0 0x%02x%02x (%u,%u) thru 0x%02x%02x (%u,%u)".  The arguments that will
.\"0 come after the format string are the following fields from the
.\"0 XFontStruct that is returned from opening the font:
.\"0 min_byte1, min_char_or_byte2, min_byte1, min_char_or_byte2,
.\"0 max_byte1, max_char_or_byte2, max_byte1, max_char_or_byte2.
.TP 8
.B rangeFormat
現在表示される文字の範囲の表示に際して、printf スタイルのフォーマット
である文字列の使用を指定する。
デフォルトは、"range: 0x%02x%02x (%u,%u) thru 0x%02x%02x (%u,%u)" であ
る。フォーマットされた文字列の後に続く引き数は、フォントを開くと返される
XFontStruct の以下のフィールドである。
min_byte1, min_char_or_byte2, min_byte1, min_char_or_byte2,
max_byte1, max_char_or_byte2, max_byte1, max_char_or_byte2
.\"0 .TP 8
.\"0 .B startFormat
.\"0 Specifies a printf-style format string used to display information
.\"0 about the character at the upper left corner of the font grid.  The
.\"0 default is "upper left: 0x%04x (%d,%d)".  The arguments that will come
.\"0 after the format string are the new character, the high byte of the new
.\"0 character, and the low byte of the new character.
.TP 8
.B startFormat
フォントグリッド左上角にある、先頭の文字に関する情報の表示に際して、
printf スタイルのフォーマットである文字列の使用を指定する。
デフォルトは、"upper left: 0x%04x (%d,%d)" である。
フォーマットされた文字列の後に続く引き数は、新しい文字、新しい文字の上位
バイト、新しい文字の下位バイトである。
.\"0 .TP 8
.\"0 .B nocharFormat
.\"0 Specifies a printf-style format string to display when the selected
.\"0 character does not exist.  The default is "no such character
.\"0 0x%02x%02x (%u,%u) (%#o,%#o)".  The arguments that will come after the
.\"0 format string are the same as for the \fBselectFormat\fP resource.
.TP 8
.B nocharFormat
選択された文字が存在しないときに表示する、printf スタイルのフォーマッ
トである文字列を指定する。
デフォルトは、"no such character 0x%02x%02x (%u,%u) (%#o,%#o)" である。
フォーマットされた文字列の後に続く引き数は、\fBselectFormat\fP リソース
と同じである。
.SH 関連項目
.\"0 X(7), xlsfonts(1), xrdb(1), xfontsel(1),
.\"0 .I "X Logical Font Description Conventions"
X(7), xlsfonts(1), xrdb(1), xfontsel(1),
.I "X Logical Font Description Conventions"
.SH バグ
.\"0 The program should skip over pages full of non-existent characters.
プログラムは、文字が 1 つもないページを飛ばすべきである。
.SH 著者
.\"0 Jim Fulton, MIT X Consortium; previous program of the same name by 
.\"0 Mark Lillibridge, MIT Project Athena.
Jim Fulton, MIT X Consortium; 
Mark Lillibridge, MIT Project Athena (以前存在していた同名のプログラム
の著者)