.\" $XConsortium: xfontsel.man,v 1.14 94/06/10 14:39:10 gildea Exp $ .\" Copyright (c) 1994 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. .\" .\" $XFree86: xc/programs/xfontsel/xfontsel.man,v 1.3 2001/01/27 18:21:12 dawes Exp $ .\" .\" .\" 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 Wed Oct 28 23:10:28 JST 1998 .\" by FUJIWARA Teruyoshi .\" Updated Thu Jan 11 22:25:26 JST 2001 for XFree86 4.0.2 .\" by FUJIWARA Teruyoshi .\" Updated Sun Oct 21 12:51:14 JST 2001 for XFree86 4.1.0 .\" by FUJIWARA Teruyoshi .\" .de EX \"Begin example .ne 5 .if n .sp 1 .if t .sp .5 .nf .in +.5i .. .de EE .fi .in -.5i .if n .sp 1 .if t .sp .5 .. .TH XFONTSEL 1 "Release 6.5" "X Version 11" .SH 名前 .\"0 xfontsel \- point and click selection of X11 font names xfontsel \- X11 のフォント名をマウスで選択する .SH 書式 .PP \fBxfontsel\fP [-\fItoolkitoption\fP ...] [\fB-pattern \fIfontname\fP] [\fB-print\fP] [\fB-sample \fItext\fP] [\fB-sample16 \fItext16\fP] [\fB-sampleUCS \fItextUCS\fP] [\fB-scaled\fP] .PP .SH 説明 .PP .\"0 The \fIxfontsel\fP application provides a simple way to display .\"0 the fonts known to your X server, examine samples of each, and .\"0 retrieve the X Logical Font Description ("XLFD") full name for a font. \fIxfontsel\fP は、X サーバが認識しているフォントの表示や各フォントの サンプルの確認、フォントの X論理フォント記述(XLFD)における完全な名前の 取得を行うための簡単な方法を提供する。 .PP .\"0 If \fB-pattern\fP is not specified, all fonts with XLFD 14-part .\"0 names will be selectable. To work with only a subset of the .\"0 fonts, specify \fB-pattern\fP followed by a partially or fully .\"0 qualified font name; e.g., ``-pattern *medium*'' will .\"0 select that subset of fonts which contain the string ``medium'' .\"0 somewhere in their font name. Be careful about escaping .\"0 wildcard characters in your shell. \fB-pattern\fP が指定されていなければ、14項目からなるXLFD の名前を持つ フォントの全てが選択可能となる。フォントの一部だけを利用したいときには、 \fB-pattern\fP を指定し、その後に部分的または完全なフォント名を続け る。例えば ``-pattern *medium*'' を指定すると、フォント名のどこかに ``medium'' という文字列が含まれるフォントだけが選択される。シェルのワ イルドカード文字のエスケープには注意すること。 .PP .\"0 If \fB-print\fP is specified on the command line the selected .\"0 font specifier will be written to standard output when the \fIquit\fP .\"0 button is activated. Regardless of whether or not \fB-print\fP was .\"0 specified, the font specifier may be made the PRIMARY (text) .\"0 selection by activating the \fIselect\fP button. \fB-print\fP をコマンド行で指定した場合には、選択されたフォント指定子 は \fIquit\fP ボタンを押したときに標準出力に書き出される。\fB-print\fP オプションが指定されていたかどうかには関係なく、\fIselect\fP ボタンを 押すとフォント指定子は PRIMARY (テキスト)のセレクションにされる。 .PP .\"0 The \fB-sample\fP option specifies the sample text to be used to .\"0 display the selected font if the font is linearly indexed, .\"0 overriding the default. \fB-sample\fP オプションは、線形インデックスのフォントのサンプル表示に 使うテキストのデフォルト値を上書き指定する。 .PP .\"0 The \fB-sample16\fP option specifies the sample text to be used to .\"0 display the selected font if the font is matrix encoded, .\"0 overriding the default. \fB-sample\fP オプションは、行列形式にエンコードされたフォントのサンプ ル表示に使うテキストのデフォルト値を上書き指定する。 .PP .\"0 The \fB-sampleUCS\fP option specifies the sample text encoded in the UTF-8 .\"0 form to be used to display the selected font if the font has a .\"0 CHARSET_REGISTRY of ISO10646, overriding the default. \fB-sampleUCS\fP オプションは、フォントが ISO10646 の CHARSET_REGISTRY を持っている場合に、デフォルトのテキストでなく UTF-8 形式でエンコード されたサンプルテキストを使って選択されたフォントを表示させる。 .PP .\"0 The \fB-scaled\fP option enables the ability to select scaled fonts .\"0 at arbitrary pixel or point sizes. \fB-noscaled\fP は、スケーリング可能なフォントを任意のピクセルサイズや ポイントサイズで選択する機能を有効ににする。 .PP .\"0 .SH INTERACTIONS .SH 操作 .PP .\"0 Clicking any pointer button in one of the XLFD field names will pop up .\"0 a menu of the currently-known possibilities for that field. If .\"0 previous choices of other fields were made, only values .\"0 for fonts which matched the previously selected fields will be .\"0 selectable; to make other values selectable, you must deselect .\"0 some other field(s) by choosing the ``*'' entry in that field. XLFD のフィールド名のどれかをクリックすると、サーバが現在認識している 値のうち、そのフィールドに対して指定可能なものを選択するメニューがポッ プアップする。既に他のフィールドで選択を行っている場合には、その選択し たフィールドにマッチする値だけが選択可能となる。他の値を選択できるよう にするには、いくつかのフィールドで ``*'' を選択して選択解除しなければ ならない。 .\"0 Unselectable values may be omitted from the menu entirely as .\"0 a configuration option; see the \fBShowUnselectable\fP resource, below. 設定オプションを使って、選択できない値を完全にメニューから除外すること もできる。これについては、以下の \fBShowUnselectable\fP リソースの説明 を参照すること。 .\"0 Whenever any change is made to a field value, \fIxfontsel\fP will .\"0 assert ownership of the PRIMARY_FONT selection. Other applications .\"0 (see, e.g., \fIxterm\fP) may then retrieve the selected font specification. フィールドの値を変更すると \fIxfontsel\fP は必ず PRIMARY_FONT セレクションの所有権を要求する。他のアプリケーショ ン(\fIxterm\fP 等を参照)は、選択されたフォント指定を取得することができ る。 .PP .\"0 Scalable fonts come back from the server with zero for the pixel size, .\"0 point size, and average width fields. Selecting a font name with a .\"0 zero in these positions results in an implementation-dependent size. X サーバが返すスケーラブルフォントは、ピクセルサイズ、ポイントサイズ、 平均幅の各フィールドがゼロである。これらの位置にゼロをセットしてフォン ト名を選択したときに得るサイズは実装依存である。 .\"0 Any pixel or point size can be selected to scale the font to a particular .\"0 size. Any average width can be selected to anamorphically scale the font .\"0 (although you may find this challenging given the size of the average .\"0 width menu). フォントを特定の大きさにスケーリングするために、任意のピクセルサイズや ポイントサイズを選ぶことができる。フォントを変形してスケーリングするた めに、任意の平均幅を選択することができる(平均幅メニューで与えられたサ イズを使ってこの試みをしているだろう)。 .PP .\"0 Clicking the left pointer button in the \fIselect\fP widget will .\"0 cause the currently selected font name to become the PRIMARY text .\"0 selection as well as the PRIMARY_FONT selection. \fIselect\fP ウィジェット内で左ポインタボタンをクリックすると、現在選 択されているフォント名が PRIMARY_FONT セレクションに加え、PRIMARY テキ ストセレクションにもなる。 .\"0 This then allows you to paste the string into other .\"0 applications. The \fBselect\fP button remains .\"0 highlighted to remind you of this fact, and de-highlights when .\"0 some other application takes the PRIMARY selection away. The .\"0 \fIselect\fP widget is a toggle; pressing it when it is highlighted .\"0 will cause \fIxfontsel\fP to release the selection ownership and .\"0 de-highlight the widget. Activating the \fIselect\fP widget twice .\"0 is the only way to cause \fIxfontsel\fP to release the .\"0 PRIMARY_FONT selection. この機能を使って、フォント名文字列を他のアプリケーションに貼り込むこと ができる。この状態を示すために \fBselect\fP はハイライトされた状態にな り、他のアプリケーションが PRIMARY のセレクションを取得した時点でハイ ライトが解除される。\fIselect\fP ウィジェットはトグルボタンになってい る。ハイライトされているときにこのボタンを押すと、\fIxfontsel\fP はセ レクションの所有権を放棄し、ハイライトを解除する。\fIselect\fP ウィジェッ トを再びアクティブにすることは、\fIxfontsel\fP セレクションを解放させ る唯一の方法である。 .PP .SH リソース .PP .\"0 The application class is \fBXFontSel\fP. Most of the user-interface .\"0 is configured in the app-defaults file; if this file is missing .\"0 a warning message will be printed to standard output and the .\"0 resulting window will be nearly incomprehensible. アプリケーションクラスは \fBXFontSel\fP である。ユーザインタフェースの ほとんどの部分は app-defaults ファイルで設定される。このファイルが無け れば、警告メッセージが標準出力に出力される。この場合、アプリケーション のウィンドウはほとんど使いものにならないだろう。 .PP .\"0 Most of the significant parts of the widget hierarchy are documented .\"0 in the app-defaults file (normally /lib/X11/app-defaults/XFontSel, .\"0 where refers to the root of the X11 install tree.) ウィジェット階層の重要な部分については app-defaults ファイル(通常は /lib/X11/app-defaults/XFontSel, ただし は X11 をインス トールしたディレクトリ)内にほぼ記述されている。 .PP .\"0 Application specific resources: アプリケーション固有のリソース: .PP .TP 8 .B "cursor (\fPclass\fB Cursor)" .\"0 Specifies the cursor for the application window. アプリケーションウィンドウのカーソルを指定する。 .TP 8 .B "pattern (\fPclass\fB Pattern)" .\"0 Specifies the font name pattern for selecting a subset of .\"0 available fonts. Equivalent to the \fB-pattern\fP option. 利用可能なフォントのサブセットの選択に使うフォント名のパターンを指定す る。\fB-pattern\fPと等価である。 .\"0 Most useful patterns will contain at least one field .\"0 delimiter; e.g. ``*-m-*'' for monospaced fonts. 少なくとも1つのフィールド区切り文字を含むパターンは大変有効である。例 えば ``*-m-*'' はモノスペースのフォントを指定する。 .TP 8 .B "pixelSizeList (\fPclass\fB PixelSizeList)" .\"0 Specifies a list of pixel sizes to add to the pixel size menu, .\"0 so that scalable fonts can be selected at those pixel sizes. ピクセルサイズのメニューに追加するピクセルサイズのリストを指定する。こ れにより、そのピクセルサイズでスケーラブルフォントを選択できるようにな る。 .\"0 The default pixelSizeList contains 7, 30, 40, 50, and 60. デフォルトの pixelSizeList は 7, 30, 40, 50, 60 を含む。 .TP 8 .B "pointSizeList (\fPclass\fB PointSizeList)" .\"0 Specifies a list of point sizes (in units of tenths of points) to add to .\"0 the point size menu, so that scalable fonts can be selected at those .\"0 point sizes. The default pointSizeList contains 250, 300, 350, and 400. ポイントサイズのメニューに追加するポイントサイズ(10ポイント単位)のリス トを指定する。これにより、そのポイントサイズでスケーラブルフォントを選 択できるようになる。デフォルトの pointSizeList は 250, 300, 350, 400 を含む。 .TP 8 .B "printOnQuit (\fPclass\fB PrintOnQuit)" .\"0 If \fITrue\fP the currently selected font name is printed .\"0 to standard output when the quit button is activated. .\"0 Equivalent to the \fB-print\fP option. このリソース値が \fITrue\fP ならば、quit ボタンが押されたときに、選択 されているフォント名が標準出力に出力される。 .TP 8 .B "sampleText (\fPclass\fB Text)" .\"0 The sample 1-byte text to use for linearly indexed fonts. 線形インデックス形式のフォントに対して用いる1バイトテキストのサンプル を指定する。 .\"0 Each glyph index is a single byte, with newline separating lines. それぞれのグリフのインデックスは1バイトであり、各行は改行文字で区切ら れている。 .TP 8 .B "sampleText16 (\fPclass\fB Text16)" .\"0 The sample 2-byte text to use for matrix-encoded fonts. 行列形式でエンコードされているフォントに対して用いる2バイトテキストの サンプルを指定する。 .\"0 Each glyph index is two bytes, with a 1-byte newline separating lines. それぞれのグリフのインデックスは2バイトであり、各行は1バイトの改行文字 で区切られている。 .TP 8 .B "scaledFonts (\fPclass\fB ScaledFonts)" .\"0 If \fITrue\fP then selection of arbitrary pixel and point sizes for .\"0 scalable fonts is enabled. このリソース値に \fITrue\fP を指定すると、スケーラブルフォントに対して 任意のピクセルサイズやポイントサイズが選択できるようになる。 .PP .\"0 Widget specific resources: ウィジェット固有のリソース: .PP .TP 8 .B "showUnselectable (\fPclass\fB ShowUnselectable)" .\"0 Specifies, for each field menu, whether or not to show values that .\"0 are not currently selectable, based upon previous field selections. それぞれのフィールドのメニューに対して、前に行ったフィールドの選択に基 づいて決まる、現在選択することができない値を表示するかどうかを指定する。 .\"0 If shown, the unselectable values are clearly identified as such .\"0 and do not highlight when the pointer is moved down the menu. 表示する場合には、選択できない値はこのようにしてはっきりと識別され、ポ インタがメニュー上にあってもハイライトされない。 .\"0 The full name of this resource is \fBfieldN.menu.options.showUnselectable\fP, .\"0 class \fBMenuButton.SimpleMenu.Options.ShowUnselectable\fP; このリソースの完全な名前は \fBfieldN.menu.options.showUnselectable\fP であり、クラスは \fBMenuButton.SimpleMenu.Options.ShowUnselectable\fP である。 .\"0 where N is replaced with the field .\"0 number (starting with the left-most field numbered 0). ここで、N はフィールドの数に置き換えられる(最も左のフィールドの番号が0 である)。 .\"0 The default is True for all but field 11 (average width of characters .\"0 in font) and False for field 11. If you never want to see .\"0 unselectable entries, '*menu.options.showUnselectable:False' is .\"0 a reasonable thing to specify in a resource file. デフォルト値は、フィールド11(フォント中の文字の平均幅)以外に対しては True であり、フィールド11に対しては False である。選択できないエントリ を表示したくない場合には、リソースファイル中で \&'*menu.options.showUnselectable:False' と指定するとよい。 .PP .SH ファイル .PP $XFILESEARCHPATH/XFontSel .PP .SH 関連項目 xrdb(1), xfd(1) .PP .SH バグ .PP .\"0 Sufficiently ambiguous patterns can be misinterpreted and lead to an .\"0 initial selection string which may not correspond to what the user intended .\"0 and which may cause the initial sample text output to fail to match .\"0 the proffered string. Selecting any new field value will correct the .\"0 sample output, though possibly resulting in no matching font. あいまいすぎるパターンは間違って解釈され、最初に選択される文字列がユー ザの意図に一致しなかったり、最初のサンプルテキスト出力が提供された文字 列にマッチできなかったりすることになる。フィールドに新しい値を選択して サンプル出力を直すことができるが、マッチするフォントが無いこともある。 .PP .\"0 Should be able to return a FONT for the PRIMARY selection, not .\"0 just a STRING. PRIMARY セレクションには、単なる STRING ではなく FONT が返されるべきで ある。 .PP .\"0 Any change in a field value will cause \fIxfontsel\fP to assert .\"0 ownership of the PRIMARY_FONT selection. Perhaps this should .\"0 be parameterized. フィールドの値をどのように変えても、\fIxfontsel\fP が PRIMARY_SELECTION の所有権を取得する。これはパラメータで制御できるべき だと思われる。 .PP .\"0 When running on a slow machine, it is possible for the user to .\"0 request a field menu before the font names have been completely .\"0 parsed. An error message indicating a missing menu is printed .\"0 to stderr but otherwise nothing bad (or good) happens. 遅いマシンで実行すると、フォント名が完全に解析される前にユーザがフィー ルドメニューを要求することがあり得る。メニューが無いことを示すエラーメッ セージが標準エラー出力に出力されるが、それ以外には不都合は(良いことも) ない。 .PP .\"0 The average-width menu is too large to be useful. 平均幅のメニューは大きすぎて使いにくい。 .SH 著作権 Copyright 1989, 1991, X Consortium .br .\"0 See \fIX(7)\fP for a full statement of rights and permissions. 権利と許諾に関する完全な声明については \fIX(7)\fP を参照すること。 .SH 著者 .PP Ralph R. Swick, Digital Equipment Corporation/MIT Project Athena .br .\"0 Mark Leisher added the support for the UTF-8 sample .\"0 text. Mark Leisher は UTF-8 のサンプルテキストの 表示機能を追加した。