grodvi − groff の出力を TeX の dvi 形式に変換する

grodvi [ −dlv ] [ −wn ] [ −Fdir ] [ −ppapersize ] [ −wn ] [ files... ]

コマンドラインオプションとパラメータの間に、空白を置くことが可能です。

grodvi は TeX のdvi 形 式 を 出 力 する groff のドライバです。通常 groff −Tdvi と実行されます。これは troff −Tdvi を実行するので、マ ク ロ /usr/share/tmac/dvi.tmac も読み込まれます。

grodvi に よって生成された dvi ファイルは、正しく設計されたどのような dvi ドライバででも表示できます。 troff の基本的な描画機能は、tpic バー ジョン 2 の特殊機能(special)を用いて実装されています。 dvi ドライバがこ れらをサポートしていない場合は、 \D コマンドは何も出力しません。

troff のものに加え、描画コマンドとして次のものが利用可能です:

\D’R dh dv’

現在の位置と、現在の位置 +(dh,dv) とを対角とする罫線(黒く塗りつ ぶした矩形)を描きます。描いた後の現在位置は、対角点となります。 これは dvi ファイル内に罫線を出力するため、他の \D コマンドと異 な り、たとえドライバが tpic の特殊機能に対応していなくとも印刷 することができます。

\X’anything’ という groff のコマンドは、 TeX で \special{anything} と記 述した時と同様の dvi ファイル中コマンドに変換されます。 anything に改行 が入っていてはいけません。

EPS イメージファイルをインクルードするために、 grodvi は pspic.tmac を 自 動 的 に ロー ド し、 PSPIC マ ク ロ を提供します。詳細については groff_tmac(5) を参照してください。

grodvi の用いるフォントファイルは、 tfmtodit(1) によって tfm ファイルか ら 作成できます。フォント記述ファイルには以下のような追加情報が含まれて いなければなりません:

internalname name

name は (拡張子 tfm を除いた) tfm ファイル名です。

checksum n

n は tfm ファイルのチェックサムです。

designsize n

n は tfm ファイルのデザインサイズです。

これらは tfmtodit によって自動生成されます。

\m と \M のデフォルト色は黒です。現在のところ、 \D コマンドの描画色は常 に黒であり、充填する色は灰色に変換されます。

troff では、エスケープシーケンス \N で指定することによって、対応する位 置にある tfm ファイル内の文字を参照できます。このようにして tfm ファ イ ルの全ての文字を参照可能です。

デ ザ イ ン的に、DVI フォーマットは出力媒体の物理的な大きさを考慮しませ ん。代りに grodvi は、TeX の \special{papersize=width,length} と等価 な ものを最初のページに出力します。 dvips (および他の DVI ドライバ) はこれ に従ってページサイズを設定します。ページ幅もしくはページ長が正でない 場 合、pagesize スペシャルは出力されません。

−d

描画コマンドを実現するのに tpic 特殊機能を使いません。水 平・垂直な直線は罫線で実現されます。他の描画コマンドは無視さ れ ます。

−Fdir

フォントとデバイス記述ファイルの検索パスの前に、ディレク トリ dir/devname を追加します。 name はデバイス名であり、 通 常 dvi です。

−l

ランドスケープの向きを指定します。

−ppapersize

紙 の 大 き さを指定します。これは DESC ファイル中の papersize, paperlength, paperwidth コマンド に 優 先 し ま す。 こ れ は、 papersize コマンド (詳細は groff_font(5) を参照してください) と 同じ引数を受け付けます。

−v

バージョン番号を表示します。

−wn

デフォルトの線の太さを M の横幅(em)の1000分の n にします。 本オプションを指定しないと、線の太さは 0.04 em になります。

R, I, B, BI と呼ばれるスタイルが、フォント位置 1 から 4 にマウントされ ます。フォントはファミリ T と H にまとめられ、これらのスタイル中にメ ン バを持ちます:

TR

CM Roman (cmr10)

TI

CM Text Italic (cmti10)

TB

CM Bold Extended Roman (cmbx10)

TBI

CM Bold Extended Text Italic (cmbxti10)

HR

CM Sans Serif (cmss10)

HI

CM Slanted Sans Serif (cmssi10)

HB

CM Sans Serif Bold Extended (cmssbx10)

HBI

CM Slanted Sans Serif Bold Extended (cmssbxo10)

ファミリのメンバではない以下のフォントもあります:

CW

CM Typewriter Text (cmtt10)

CWI

CM Italic Typewriter Text (cmitt10)

特 殊 フォントには MI (cmmi10), S (cmsy10), EX (cmex10), SC (cmtex10 は CW 用のみ) が含まれ、 TR, TI, CW もおそらく驚くことでしょうがテキ ス ト フォ ントのフォントエンコードが異なるために含まれます。イタリックフォン ト CWI は CW の代りに使用されます。

最後に、American Mathematical Society のシンボルフォントが特殊フォン ト SA (msam10) と SB (msbm10) として使用可能です。これらの 2 個のフォント はデフォルトではマウントされません。

オプション −mec (ファイル ec.tmac をロード) を使うことで、EC と TC の フォントを使用可能です。 EC ファミリのデザインは、CM フォントのものと非 常に似ています。こちらは更に groff シンボルをより良くカバーしています。 言 語 固有ファイルの前に、 ec.tmac を呼ぶ必要があることに注意してくださ い。このファイルは hcode 値を気にしません。

/usr/share/groff_font/devdvi/DESC

デバイス記述ファイルです。

/usr/share/groff_font/devdvi/F

F というフォントに対する記述ファイルです。

/usr/share/tmac/dvi.tmac

grodvi と共に使われるマクロです。

/usr/share/tmac/ec.tmac

EC フォントへ切り替えるためのマクロです。

grodvi によって生成される dvi ファイルは、 TeX によって生成されるものと は 解像度が異なっています(1インチにつき57816単位)。このため、dvi ファイ ルに指定されている解像度を参照せずに TeX で使われている解像度を想定して い るような、正しく設計されていないドライバは、 grodvi ではうまく動作し ません。

箱状の表に対して -d オプションを使った場合、時に水平・垂直な直線が 1 ピ クセル突き出てしまうことがあります。これは TeX の指定する方法で罫線の縦 横の長さを丸めているためです。

tfmtodit(1), groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7), groff_tmac(5)