doc/ja_JP.eucJP/man/man1/grodvi.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$
.
.
.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
.el .ds tx TeX
.
.\" 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'dvi' .ft \\$1
..
.
.
.TH GRODVI 1 "1 May 2003" "Groff Version 1.19"
.SH 名称
grodvi \- groff の出力を TeX の dvi 形式に変換する
.
.
.SH 書式
.B grodvi
[
.B \-dlv
] [
.BI \-w n
] [
.BI \-F dir
] [
.BI \-p papersize
] [
.BI \-w n
] [
.IR files \|.\|.\|.\&
]
.PP
コマンドラインオプションとパラメータの間に、空白を置くことが可能です。
.
.
.SH 解説
.B grodvi
は
\*(tx
のdvi形式を出力する
.B groff
のドライバです。
.
通常
.BR groff\ \-Tdvi
と実行されます。
.
これは
.BR troff\ \-Tdvi
を実行するので、マクロ
.BR /usr/share/tmac/dvi.tmac
も読み込まれます。
.
.LP
.B grodvi
によって生成された dvi ファイルは、正しく設計された
どのような dvi ドライバででも表示できます。
.
troff の基本的な
描画機能は、tpic バージョン\~2 の特殊機能(special)を用いて実装されています。
.
dvi ドライバがこれらをサポートしていない場合は、
.B \[rs]D
コマンドは何も出力しません。
.
.LP
troff のものに加え、描画コマンドとして次のものが利用可能です:
.
.TP
.BI \[rs]D'R\  dh\ dv '
現在の位置と、現在の位置
.RI +( dh , dv )
とを対角とする罫線(黒く塗りつぶした矩形)を描きます。
.
描いた後の
現在位置は、対角点となります。
.
これは dvi ファイル内に
罫線を出力するため、他の
.B \[rs]D
コマンドと異なり、たとえドライバが tpic の特殊機能に対応して
いなくとも印刷することができます。
.
.LP
.BI \[rs]X' anything '
という groff のコマンドは、
\*(tx
で
.BI \[rs]special{ anything }
と記述した時と同様の dvi ファイル中コマンドに変換されます。
.I anything
に改行が入っていてはいけません。
.
.LP
EPS イメージファイルをインクルードするために、
.B grodvi
は
.B pspic.tmac
を自動的にロードし、
.B PSPIC
マクロを提供します。
.
詳細については
.BR groff_tmac (5)
を参照してください。
.
.LP
.B grodvi
の用いるフォントファイルは、
.BR tfmtodit (1)
によって tfm ファイルから作成できます。
.
フォント記述ファイルには以下のような追加情報が
含まれていなければなりません:
.
.Tp \w'\fBinternalname'u+2n
.BI internalname\   name
.IR name
は (拡張子
.B tfm
を除いた) tfm ファイル名です。
.
.TP
.BI checksum\  n
.IR n
は tfm ファイルのチェックサムです。
.
.TP
.BI designsize\  n
.IR n
は tfm ファイルのデザインサイズです。
.
.LP
これらは
.B tfmtodit
によって自動生成されます。
.
.LP
.B \[rs]m
と
.B \[rs]M
のデフォルト色は黒です。
.
現在のところ、
.B \[rs]D
コマンドの描画色は常に黒であり、充填する色は灰色に変換されます。
.
.LP
.B troff
では、エスケープシーケンス
.B \[rs]N
で指定することによって、対応する位置にある tfm ファイル内の文字を参照できます。
このようにして tfm ファイルの全ての文字を参照可能です。
.
.LP
デザイン的に、DVI フォーマットは出力媒体の物理的な大きさを考慮しません。
.
代りに
.B grodvi
は、\*(tx の
.BI \[rs]special{papersize= width , length }
と等価なものを最初のページに出力します。
.B dvips
(および他の DVI ドライバ) はこれに従ってページサイズを設定します。
.
ページ幅もしくはページ長が正でない場合、pagesize スペシャルは出力されません。
.
.
.SH オプション
.TP
.B \-d
描画コマンドを実現するのに tpic 特殊機能を使いません。
.
水平・垂直な直線は罫線で実現されます。
.
他の描画コマンドは無視されます。
.
.TP
.BI \-F dir
フォントとデバイス記述ファイルの検索パスの前に、ディレクトリ
.IB dir /dev name
を追加します。
.I name
はデバイス名であり、通常
.BR dvi
です。
.
.TP
.B \-l
ランドスケープの向きを指定します。
.
.TP
.BI \-p papersize
紙の大きさを指定します。
.
これは
.B DESC
ファイル中の
.BR papersize ,
.BR paperlength ,
.B paperwidth
コマンドに優先します。
これは、
.B papersize
コマンド (詳細は
.BR groff_font (5)
を参照してください) と同じ引数を受け付けます。
.
.TP
.B \-v
バージョン番号を表示します。
.
.TP
.BI \-w n
デフォルトの線の太さを M の横幅(em)の1000分の
.I n
にします。
本オプションを指定しないと、線の太さは 0.04\~em になります。
.
.
.SH 使用例
.BR R ,
.BR I ,
.BR B ,
.B BI
と呼ばれるスタイルが、フォント位置 1 から 4 にマウントされます。
フォントはファミリ
.B T
と
.B H\ \c
にまとめられ、これらのスタイル中にメンバを持ちます:
.
.RS
.TP
.B TR
.FT TR
CM Roman (cmr10)
.FT
.
.TQ
.B TI
.FT TI
CM Text Italic (cmti10)
.FT
.
.TQ
.B TB
.FT TB
CM Bold Extended Roman (cmbx10)
.FT
.
.TQ
.B TBI
.FT TBI
CM Bold Extended Text Italic (cmbxti10)
.FT
.
.TQ
.B HR
.FT HR
CM Sans Serif (cmss10)
.FT
.
.TQ
.B HI
.FT HI
CM Slanted Sans Serif (cmssi10)
.FT
.
.TQ
.B HB
.FT HB
CM Sans Serif Bold Extended (cmssbx10)
.FT
.
.TQ
.B HBI
.FT HBI
CM Slanted Sans Serif Bold Extended (cmssbxo10)
.FT
.RE
.
.LP
ファミリのメンバではない以下のフォントもあります:
.
.RS
.TP
.B CW
CM Typewriter Text (cmtt10)
.FT CW
.FT
.
.TQ
.B CWI
CM Italic Typewriter Text (cmitt10)
.FT CWI
.FT
.RE
.
.LP
特殊フォントには
.B MI
(cmmi10),
.B S
(cmsy10),
.B EX
(cmex10),
.B SC
(cmtex10 は
.BR CW
用のみ)
が含まれ、
.BR TR ,
.BR TI ,
.BR CW
もおそらく驚くことでしょうが
テキストフォントのフォントエンコードが異なるために含まれます。
.
イタリックフォント
.B CWI
は
.BR CW
の代りに使用されます。
.
.LP
最後に、American Mathematical Society のシンボルフォントが
特殊フォント
.B SA
(msam10) と
.B SB
(msbm10) として使用可能です。
.
これらの 2 個のフォントはデフォルトではマウントされません。
.
.LP
オプション
.B \-mec
(ファイル
.BR ec.tmac
をロード) を使うことで、EC と TC のフォントを使用可能です。
.
EC ファミリのデザインは、CM フォントのものと非常に似ています。
こちらは更に groff シンボルをより良くカバーしています。
.
言語固有ファイルの前に、
.B ec.tmac
を呼ぶ必要があることに注意してください。
このファイルは hcode 値を気にしません。
.
.
.SH 関連ファイル
.TP
.B /usr/share/groff_font/devdvi/DESC
デバイス記述ファイルです。
.
.TP
.BI /usr/share/groff_font/devdvi/ F
.IR F
というフォントに対する記述ファイルです。
.
.TP
.B /usr/share/tmac/dvi.tmac
.BR grodvi
と共に使われるマクロです。
.
.TP
.B /usr/share/tmac/ec.tmac
EC フォントへ切り替えるためのマクロです。
.
.
.SH バグ
.B grodvi
によって生成される dvi ファイルは、
\*(tx
によって生成されるものとは解像度が異なっています(1インチにつき57816単位)。
.
このため、dvi ファイルに指定されている解像度を参照せずに
\*(tx
で使われている解像度を想定しているような、正しく設計されていない
ドライバは、
.B grodvi
ではうまく動作しません。
.
.LP
箱状の表に対して
.B -d
オプションを使った場合、時に水平・垂直な直線が 1 ピクセル
突き出てしまうことがあります。
.
これは
\*(tx
の指定する方法で
罫線の縦横の長さを丸めているためです。
.
.
.SH 関連項目
.BR tfmtodit (1),
.BR groff (1),
.BR troff (1),
.BR groff_out (5),
.BR groff_font (5),
.BR groff_char (7),
.BR groff_tmac (5)