doc/ja_JP.eucJP/man/man1/grops.1

.ig
Copyright (C) 1989-2000, 2001, 2002, 2003 Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be included in
translations approved by the Free Software Foundation instead of in
the original English.
..
.\" $FreeBSD$
.
.mso www.tmac
.
.
.\" Like TP, but if specified indent is more than half
.\" the current line-length - indent, use the default indent.
.de Tp
.  ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
.  el .TP "\\$1"
..
.
.de TQ
.  br
.  ns
.  TP \$1
..
.
.de FT
.  if '\\*(.T'ps' .ft \\$1
..
.
.
.TH GROPS 1 "1 May 2003" "Groff Version 1.19"
.
.
.SH 名称
grops \- groff 用 PostScript ドライバ
.
.
.SH 書式
.nr a \n(.j
.ad l
.nr i \n(.i
.in +\w'\fBgrops 'u
.ti \niu
.B grops
.
.de OP
.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\%\\$2" "\ ]"
.el .RB "[\ " "\\$1" "\ ]"
..
.
.OP \-glmv
.OP \-b n
.OP \-c n
.OP \-F dir
.OP \-p papersize
.OP \-P prologue
.OP \-w n
.RI "[\ " files\|.\|.\|. "\ ]"
.br
.ad \na
.
.PP
コマンドラインオプションとパラメータの間に空白を含めることが可能です。
.
.
.SH 解説
.B grops
は GNU
.B troff
の出力を PostScript に変換します。
.
通常
.B grops
は groff コマンドを
.B \-Tps
オプション付きで起動した時に起動されます。
.
.if 'ps'ps' (groff のデフォルトです。)
.
ファイルを指定しないと、
.B grops
は標準入力を読みます。
.
ファイル名
.B \-
を指定しても、
.B grops
は標準入力を読みます。
.
PostScript 出力は標準出力に書きます。
.
.B grops
を
.B groff
から起動する場合、
.B groff
.B \-P
により、オプションを
.B grops
に渡せます。
.
.
.SH オプション
.TP
.BI \-b n
不良なスプーラとプレビュアのための対処をします。
.
通常、
.B grops
は
Document Structuring Conventions version 3.0 を満たす
PostScript LanguageLevel\~2 出力を生成します。
.
このような出力を扱えない古いプリンタ、スプーラ、プレビュアがあります。
.
値
.I n
は、不良プログラムが受理可能な出力を
.B grops
が行うように制御します。
.
値 0 は grops に何も対処しないようにさせます。
.
.IP
.B %%Begin\%Document\%Setup
と
.B %%End\%Document\%Setup
のコメントを生成してはならない場合 1 を加えます;
初期バージョンの TranScript は
.B %%End\%Prolog
コメントと最初の
.B %%Page
コメントとの間で混乱させられましたので、これが必要です。
.
.IP
インクルードされたファイルで
.B %!
から始まる行を取り除かねばならない時には 2 を加えます;
Sun の pageview プレビュアで必要です。
.
.IP
インクルードされたファイルから
.BR %%Page ,
.BR %%Trailer ,
.B %%End\%Prolog
コメントを取り除かねばならない時には 4 を加えます;
.B %%Begin\%Document
と
.B %%End\%Document
のコメントを理解しないスプーラに対して必要です。
.
.IP
PostScript 出力の最初の行が
.B %!PS-Adobe-3.0
ではなく
.B %!PS-Adobe-2.0
でなければならない時には 8 を加えます;
Sun の Newsprint をページ逆順を要求するプリンタと共に使用する時に必要です。
.
.IP
媒体の大きさ情報を文書に含めてはならない時には 16 を加えます
(すなわち
.B %%Document\%Media
も
.B setpagedevice
PostScript コマンドも使用しないということです)。
.
これは、groff バージョン 1.18.1 以前の動作です。
PostScript LanguageLevel\~2 を理解しない古いプリンタでは必要です。
.
.IP
デフォルト値は
.
.RS
.IP
.BI broken\  n
.
.LP
コマンドを DESC ファイルに記述することで指定可能です。
.
そうでない場合はデフォルト値は 0 です。
.RE
.
.TP
.BI \-c n
各ページを
.I n
部ずつ印刷します。
.
.TP
.BI \-F dir
序文、フォント、デバイス記述ファイルの検索パスの前に、ディレクトリ
.IB dir /dev name
を追加します。
.I name
はデバイス名であり、通常
.BR ps
です。
.
.TP
.BI \-g
ページ長を予測します。
.
ページ長を予測する PostScript コードを生成します。
.
イメージ領域が垂直位置でページの中心に有る時のみ、予測は正しいはずです。
.
このオプションにより、変更無しで
letter (8.5\(mu11) と A4 の両方に印刷可能な文書を生成可能です。
.
.TP
.B \-l
文書をランドスケープ形式にて印刷します。
.
.TP
.B \-m
文書に対し手動フィードを有効にします。
.BI \-p paper-size
出力媒体の物理的な大きさを設定します。
.
これは、
.B DESC
ファイル中の
.BR papersize ,
.BR paperlength ,
.B paperwidth
のコマンドに優先します。
これは、
.B papersize
コマンドと同じ引数を受け付けます。
.
詳細は
.B groff_font (5)
を参照してください。
.
.TP
.BI \-P prologue-file
(フォントパス中の) ファイル
.I prologue-file
を、デフォルトの序文ファイル
.BR prologue
の代りに、序文として使用します。
.
本オプションは、環境変数
.SM GROPS_PROLOGUE
に優先します。
.
.TP
.BI \-w n
線の太さを M の横幅 (em) の 1000 分の
.I n
にて描画します。
本オプションを指定しないと、線の太さは 0.04\~em になります。
.TP
.B \-v
バージョン番号を表示します。
.
.
.SH 使用法
.BR R ,
.BR I ,
.BR B ,
.B BI
と呼ばれるスタイルがフォント位置 1 から 4 までにマウントされます。
.
フォントはファミリ
.BR A ,
.BR BM ,
.BR C ,
.BR H ,
.BR HN ,
.BR N ,
.BR P ,
.B T
にまとめられ、これらのスタイル中にメンバを持ちます:
.RS
.TP
.B AR
.FT AR
AvantGarde-Book
.FT
.
.TQ
.B AI
.FT AI
AvantGarde-BookOblique
.FT
.
.TQ
.B AB
.FT AB
AvantGarde-Demi
.FT
.
.TQ
.B ABI
.FT ABI
AvantGarde-DemiOblique
.FT
.
.TQ
.B BMR
.FT BMR
Bookman-Light
.FT
.
.TQ
.B BMI
.FT BMI
Bookman-LightItalic
.FT
.
.TQ
.B BMB
.FT BMB
Bookman-Demi
.FT
.
.TQ
.B BMBI
.FT BMBI
Bookman-DemiItalic
.FT
.
.TQ
.B CR
.FT CR
Courier
.FT
.
.TQ
.B CI
.FT CI
Courier-Oblique
.FT
.
.TQ
.B CB
.FT CB
Courier-Bold
.FT
.
.TQ
.B CBI
.FT CBI
Courier-BoldOblique
.FT
.
.TQ
.B HR
.FT HR
Helvetica
.FT
.
.TQ
.B HI
.FT HI
Helvetica-Oblique
.FT
.
.TQ
.B HB
.FT HB
Helvetica-Bold
.FT
.
.TQ
.B HBI
.FT HBI
Helvetica-BoldOblique
.FT
.
.TQ
.B HNR
.FT HNR
Helvetica-Narrow
.FT
.
.TQ
.B HNI
.FT HNI
Helvetica-Narrow-Oblique
.FT
.
.TQ
.B HNB
.FT HNB
Helvetica-Narrow-Bold
.FT
.
.TQ
.B HNBI
.FT HNBI
Helvetica-Narrow-BoldOblique
.FT
.
.TQ
.B NR
.FT NR
NewCenturySchlbk-Roman
.FT
.
.TQ
.B NI
.FT NI
NewCenturySchlbk-Italic
.FT
.
.TQ
.B NB
.FT NB
NewCenturySchlbk-Bold
.FT
.
.TQ
.B NBI
.FT NBI
NewCenturySchlbk-BoldItalic
.FT
.
.TQ
.B PR
.FT PR
Palatino-Roman
.FT
.
.TQ
.B PI
.FT PI
Palatino-Italic
.FT
.
.TQ
.B PB
.FT PB
Palatino-Bold
.FT
.
.TQ
.B PBI
.FT PBI
Palatino-BoldItalic
.FT
.
.TQ
.B TR
.FT TR
Times-Roman
.FT
.
.TQ
.B TI
.FT TI
Times-Italic
.FT
.
.TQ
.B TB
.FT TB
Times-Bold
.FT
.
.TQ
.B TBI
.FT TBI
Times-BoldItalic
.FT
.RE
.
.LP
ファミリのメンバではない以下のフォントもあります:
.
.RS
.TP
.B ZCMI
.FT ZCMI
ZapfChancery-MediumItalic
.FT
.RE
.
.LP
PS Symbol フォント用の
.B S
および PS Symbol から取られた斜体小文字のギリシャ文字を含む
.B SS
と呼ばれる特別なフォントも有ります。
.
Zapf Dingbats は
.BR ZD
として、逆バージョンの ZapfDingbats (シンボルが逆向き) は
.B ZDR
として使用可能です;
これらのフォントのほとんどの文字は名前が無いので、
.BR \[rs]N .
にてアクセスせねばなりません。
.
.LP
.B \[rs]m
と
.B \[rs]M
のデフォルト色は黒です。
`rgb' 色空間中で定義される色には
.B setrgbcolor
を使用し、`cmy' と `cmyk' には
.BR setcmykcolor
を、`gray' には
.BR setgray
を使用します。
.B setcmykcolor
は PostScript LanguageLevel\~2 コマンドであり、古いプリンタでは使えません。
.
.LP
.B grops
は
.B \[rs]X
エスケープシーケンスにより生成された様々な X コマンドを理解します;
.B grops
は
.B ps:
タグから始まるコマンドのみを翻訳します:
.
.TP
.BI \[rs]X'ps:\ exec\  code '
.I code
中の任意の PostScript コマンドを実行します。
.
.I code
実行前に PostScript の現在位置は
.B \[rs]X
の位置に設定されます。
原点はページの左上になり、y 座標はページを下ると増加します。
プロシージャ
.B u
は、groff の単位を有効な座標系のものに変更するように定義されます。
.
例えば、
.
.RS
.IP
.B
\&.nr x 1i
.br
.B
\[rs]X'ps: exec \[rs]nx u 0 rlineto stroke'
.br
.RE
.
.IP
は 1 インチ長の水平線を描画します。
.
.I code
はグラフィックステートを変更し得ますが、ページの終端までしか継続しません。
.
.B def
と
.B mdef
により指定される定義を含む辞書は、辞書スタックの頭に有るでしょう。
.
あなたのコードがこの辞書に定義を付加するなら、
.BI \[rs]X'ps\ mdef \ n '\fR.
.
を使用して、そのための空間を割り当てる必要が有ります。
.
定義はページの終りまでしか継続しません。
.B \[rs]Y
エスケープシーケンスをマクロを名付ける引数と共に使うと、
.I code
を複数行に渡らせることが出来ます。
.
例えば、
.
.RS
.IP
.nf
.ft B
\&.nr x 1i
\&.de y
\&ps: exec
\&\[rs]nx u 0 rlineto
\&stroke
\&..
\&\[rs]Yy
.fi
.ft R
.
.LP
は 1 インチ長の水平線を描画する別の方法です。
.RE
.
.TP
.BI \[rs]X'ps:\ file\  name '
.B exec
コマンドと同様ですが、コードをファイル
.I name
から読みます。
.
.TP
.BI \[rs]X'ps:\ def\  code '
.I code
の PostScript 定義をプロログ部に置きます。
.
.B \[rs]X
コマンドに対し最大 1 定義までです。
.
長い定義は複数の
.B \[rs]X
コマンドに渡り分割できます;
全ての
.I code
引数は、改行で区切られ、単純に連結されます。
.
定義は、
.B exec
コマンド実行時に辞書スタックに自動的にプッシュされる辞書に置かれます。
.
.B \eY
エスケープシーケンスをマクロを名付ける引数と共に使うと、
.I code
を複数行に渡らせることが出来ます。
.
.TP
.BI \[rs]X'ps:\ mdef\  n\ code  '
.B def
と同様ですが、
.I code
は
.I n
個まで定義を保持し得ます。
.
.B grops
は何個の定義を
.I code
が含むのかを知る必要が有るので、これらを含む適切な大きさの PostScript 辞書
を生成できます。
.
.TP
.BI \[rs]X'ps:\ import\  file\ llx\ lly\ urx\ ury\ width\ \fR[\fP\ height\ \fR]\fP '
PostScript グラフィックスを
.I file
からインポートします。
.
引数
.IR llx ,
.IR lly ,
.IR urx ,
.I ury
は、デフォルトの PostScript 座標系における
グラフィックのバウンディングボックスを与えます;
すべて整数である必要が有ります;
.I llx
と
.I lly
はグラフィックの左下の x y 座標です;
.I urx
と
.I ury
はグラフィックの右上の x y 座標です;
.I width
と
.I height
は整数であり、groff の単位でグラフィックの幅と高さを与えます。
.
グラフィックは延び縮みして、この幅と高さになり、
グラフィックの左下角は
.B \[rs]X
コマンドにて関連づけられた場所に位置します。
.
引数 height を省略すると、x y 方向が同等に縮尺され、
指定した幅になります。
.
.B \[rs]X
コマンドの内容は
.B troff
が解釈しないことに注意して下さい;
グラフィックのための垂直方向の空白は自動的に付加されず、
.I width
と
.I height
の引数にスケーリングインジケータを付加することは許されません。
.
PostScript ファイルが Adobe Document Structuring Conventions から成り、
.B %%Bounding\%Box
コメントを含む場合、
.B psbb
リクエスト実行により、groff 中でバウンディングボックスを自動的に取得可能です。
.
.IP
PostScript グラフィックスの高レベルインタフェースを提供する
.B PSPIC
マクロについては、
.BR groff_tmac (5)
を参照してください。
.TP
.B \[rs]X'ps:\ invis'
.TQ
.B \[rs]X'ps:\ endinvis'
これらの
.B \[rs]X
コマンドにて囲まれたテキストと描画コマンドは出力を生成しません。
.
このコマンドは、
.B troff
の出力を
.B grops
で処理する前に見るために有ります;
プレビュアがある文字または構造を表示できない時、
これらの
.B \[rs]X
コマンドで囲むことにより、
代わりの文字または構造をプレビュー用に使えます。
.
.RS
.LP
例えば、標準の X11 フォントには含まれませんので、
.B gxditview
は
.B \[rs](em
文字を正しく表示できません;
この問題は以下のリクエストを実行することにより解決できます。
.
.IP
.ft B
.nf
\&.char \[rs](em \[rs]X'ps: invis'\[rs]
\[rs]Z'\[rs]v'-.25m'\[rs]h'.05m'\[rs]D'l .9m 0'\[rs]h'.05m''\[rs]
\[rs]X'ps: endinvis'\[rs](em
.ft
.fi
.
.LP
この場合、
.B gxditview
は
.B \[rs](em
文字を表示できず線を引きますが、
.B grops
は
.B \[rs](em
文字を印刷し線を無視します
(このコードはファイル
.B Xps.tmac
中にあります。
.B grops
用の文書が
.BR gxditview
でプレビューされる場合にはロードされます)。
.RE
.
.LP
.B grops
への入力は
.B troff (1)
の出力形式である必要が有ります。
.
これは
.B groff_out (5)
に記載してあります。
.
また、使用するデバイスに関するデバイス及びフォントの記述ファイルは
仕様に合致する必要が有ります。
.
.B ps
デバイスに対して提供されているデバイス及びフォントの記述ファイルは
完全にこの仕様に合致します。
.
.BR afmtodit (1)
を使って AFM ファイルからフォントファイルを生成可能です。
.
解像度は、整数値かつ
.B sizescale
の 72 倍の倍数である必要が有ります。
.
.B ps
デバイスは解像度 72000 および sizescale 1000 を使用します。
.
.LP
デバイス記述ファイルは、正当な用紙サイズを含む必要があります。
更なる情報については
.BR groff_font (5)
を参照してください。
.
.LP
各フォント記述ファイルはコマンド
.IP
.BI internalname\  psname
.LP
を含む必要が有ります。これは PostScript におけるフォント名が
.I psname
であることを意味します。
.
また、コマンド
.IP
.BI encoding\  enc_file
.LP
を含む場合も有ります。これは PostScript フォントが
.I enc_file
に記載されたエンコード方式で再度エンコードする必要が有ることを意味します;
このファイルは以下の形式の行のシーケンスから成ります:
.IP
.I
pschar code
.LP
ここで
.I pschar
は PostScript における文字名であり、
.I code
はエンコードにおける位置を 10 進整数で表したものです。
正当な値の範囲は 0 から 255 です。
.
.B #
で開始する行と空行は無視されます。
.
フォントファイルにおいて与えられる各文字のコードは、
エンコードファイルにおける文字のコードに対応するか、
もしくは PostScript フォントが再度エンコードされていない場合は
デフォルトエンコードにおけるコードに対応する必要が有ります。
.
このコードを
.B \[rs]N
エスケープシーケンスと共に
.B troff
中で使うことにより文字を選択可能です。
これは、文字が groff での名前を持たなくても可能です。
.
フォントファイル中の全ての文字は PostScript フォント中に存在することが
必要であり、
フォントファイル中で与えられる幅は PostScript フォントで使用される幅に
マッチする必要が有ります。
.
.B grops
は、groff における名前が
.B space
である文字をブランク (ページ上に何も印を付けない) であるとしています;
これにより、効率の良い小さな PostScript 出力が得られます。
.
.LP
.B grops
は PostScript フォントのすべてのグリフを表示可能です。
256 個だけではありません。
.I enc_file
(エンコーディングが指定されない場合はデフォルトエンコーディング)
は、単に最初の 256 文字用のグリフの順番を指定するだけです。
他のグリフは、追加のエンコーディングベクタでアクセスされ、これは
.B grops
がオンザフライで生成します。
.
.LP
.B grops
は文書印刷に必要なダウンロード可能なフォントを自動的にインクルードします。
このようなフォントは PFA フォーマットであることが必要です。
.BR pfbtops (1)
を使って Type\~1 フォントを PFB フォーマットに変換してください。
要求時に
.B grops
にインクルードされるダウンロード可能な全てのフォントは
.B /usr/share/groff_font/devps/download
に列挙する必要が有ります;
これは以下の形式の複数の行から成ります。
.
.IP
.I
font filename
.
.LP
ここで
.I font
はフォントの PostScript における名前であり、
.I filename
はフォントを含むファイルの名前です;
.B #
から始まる行と空行は無視されます;
フィールドはタブもしくは空白により区切ります;
.I filename
の検索は、groff のフォントメトリックファイルの検索と同じ方式で行われます。
.
.B download
ファイル自身も同じ方式で検索されます;
現在のところ、フォントパス内で最初に見付かったファイルが使用されます。
.
.LP
ダウンロード可能なフォントもしくはインポートされた文書を含むファイルが
Adobe Document Structuring Conventions を満たす場合、
.B grops
はファイル中のコメントを十分解釈し、出力もこれを満たすようにします。
.
また、
.B download
ファイルに列挙された必要なフォントリソースおよびファイルリソースを提供します。
.
また、リソース間の依存関係を扱うことも可能です。
.
例えば、ダウンロード可能な Garamond フォントおよび
ダウンロード可能な Garamond-Outline フォントが有り、
後者が前者に依存すると仮定すると
(概して、後者は前者のフォント辞書をコピーして PaintType を変更したものと
定義されます)、PostScript 文書中で Garamond が Garamond-Outline より前に
現れる必要が有ります。
.
.B grops
がこれを自動的に扱うためには、
Garamond-Outline 用のダウンロード可能なフォントファイルが
Garamond に依存することを
Document Structuring Conventions を使用して示します。
例えば以下のように始めることで示します。
.
.IP
.B
%!PS-Adobe-3.0 Resource-Font
.br
.B
%%DocumentNeededResources: font Garamond
.br
.B
%%EndComments
.br
.B
%%IncludeResource: font Garamond
.
.LP
この場合、Garamond と Garamond-Outline を
.B download
ファイルに列挙する必要が有ります。
.
ダウンロード可能なフォントは、自身の名前を
.B %%Document\%Supplied\%Resources
コメントに含んではなりません。
.
.LP
.B grops
は
.B %%Document\%Fonts
コメントを解釈しません。
.
.BR %%Document\%Needed\%Resources ,
.BR %%Document\%Supplied\%Resources ,
.BR %%Include\%Resource ,
.BR %%Begin\%Resource ,
.BR %%End\%Resource
コメント
(もしくは古い
.BR %%Document\%Needed\%Fonts ,
.BR %%Document\%Supplied\%Fonts ,
.BR %%Include\%Font ,
.BR %%Begin\%Font ,
.BR %%End\%Font
コメント) は使用されます。
.
.
.SS TrueType フォント
TrueType フォントは、
まず
.B "Type 42"
フォーマットに変換することで
.B grops
で使えます。
これは特別な PostScript ラッパであり、
.BR pfbtops (1)
で述べられている PFA フォーマットと同じものです。
type42 ラッパを作成する数々の方法があり、
ほとんどの方法が Ghostscript \(em 
.BR gs (1)
参照 \(em のような PostScript インタプリタを使う方法です。
最も簡単な方法は、アプリケーション
.BR ttftot42
を使うものでしょう。
このプログラムは
.BR freetype (3)
(バージョン 1.3.1) を使用することで、
type42 フォントラッパと、適切なメトリックファイル作成のために
.BR afmtodit (1)
に食わせるためのよくできた AFM ファイルを生成します。
結果のフォントラッパを
.B download
ファイルに追加する必要があります。
.B ttftot42
ソースコードは
.URL ftp://\:www.giga.or.at/\:pub/\:nih/\:ttftot42/ \
     ftp://\:www.giga.or.at/\:pub/\:nih/\:ttftot42/
からダウンロード可能です。
.
.
.SH 環境変数
.TP
.SM
.B GROPS_PROLOGUE
.IR foo
に設定されている場合、
.B grops
は (フォントパス中の) ファイル
.I foo
をデフォルトの序文ファイル
.BR prologue
の代りに使用します。
.
オプション
.B \-P
は、この環境変数に優先します。
.
.
.SH 関連ファイル
.Tp \w'\fB/usr/share/groff_font/devps/download'u+2n
.B /usr/share/groff_font/devps/DESC
デバイス記述ファイル。
.
.TP
.BI /usr/share/groff_font/devps/ F
フォント
.I F
のフォント記述ファイル。
.
.TP
.B /usr/share/groff_font/devps/download
ダウンロード可能なフォントのリスト。
.
.TP
.B /usr/share/groff_font/devps/text.enc
テキストフォント用のエンコード方法。
.
.TP
.B /usr/share/tmac/ps.tmac
.B grops
が使用するマクロ;
.B troffrc
により自動的にロードされます。
.
.TP
.B /usr/share/tmac/pspic.tmac
.B PSPIC
マクロの定義。
.BR ps.tmac
から自動的にロードされます。
.
.TP
.B /usr/share/tmac/psold.tmac
古い PostScript プリンタには存在しない文字
(例えば `eth' や `thorn')
の使用を禁止するマクロ。
.
.TP
.B /usr/share/tmac/tmac.psnew
.B tmac.psold
の効果を打ち消すマクロ。
.
.TP
.BI /tmp/grops XXXXXX
一時ファイル。
.
.
.SH "関連項目"
.BR afmtodit (1),
.BR groff (1),
.BR troff (1),
.BR pfbtops (1),
.BR groff_out (5),
.BR groff_font (5),
.BR groff_char (7),
.BR groff_tmac (5)
.
.\" Local Variables:
.\" mode: nroff
.\" End: