名称

       groff_out - groff の中間出力フォーマット

解説

       このマニュアルページは、GNU  troff の出力フォーマットについて記述します。 GNU troff が使用
       する出力フォーマットは、 UNIX のデバイス非依存 troff が使用するものと似ています。 ここでは
       両者の差のみを記述します。

       s  コマンドへの引数はスケールドポイントです  (これは  ポイント/n  を意味します。 n は DESC
       ファイル中の sizescale コマンドへの引数です)。 x Height コマンドへの引数もまたスケールドポ
       イントです。

       最初の 3 つの出力コマンドは次のようになっていなければなりません:

              x T device
              x res n h v
              x init

       DESC  ファイル中に  tcommand 行が存在する場合には、troff は以下の 2 つのコマンドを使用しま
       す。

       txxx   xxx は、任意の文字のシーケンスであり、空白または改行を終端とします;  最初の文字を現
              在位置で印字し、  現在の水平位置を最初の文字の幅だけ増加させます。 続けて、同じ処理
              を各文字に対して実行します。   文字の幅は、フォントファイルにおいて与えられたものを
              現在のポイントサイズに応じて適切にスケーリングしてから、 水平解像度の倍数となるよう
              に丸めます。 特殊文字はこのコマンドでは印字できません。

       un xxx t コマンドと同様ですが、各文字の印字後に現在の水平位置に加えられるものが、 文字幅と
              n の和である点が違います。

       単一文字は 8 ビット目がセットされていてもかまわないことに注意してください。 これはフォント
       名や特殊文字名にもあてはまります。

       文字名やフォント名は任意の長さが許されます; ドライバはこれらの長さが 2  文字のみであると仮
       定してはなりません。

       文字を印字する時、その文字は常に現在のフォント中に存在します。 デバイス非依存 troff とは異
       なり、 ドライバがスペシャルフォントから文字を探す必要はありません。

       x デバイス制御コマンドが、拡張されました。

       x u n  n が 1 の場合、空白の下線付けを開始します。 n が 0 の場合、空白の下線付けを停止しま
              す。 これは、nroff モードの cu リクエストで必要であり、他の場合には無視されます。

       D 描画コマンドは拡張されています。 -n オプション指定時には、GNU pic はこれらの拡張を使用し
       ません。

       Df n\n オブジェクトの塗り潰しに使用する陰影を n に設定します; ここで n は 0 から 1000 の範
              囲の整数である必要があり、0 は白の塗り潰しを、 1000 は黒の塗り潰しを、 そしてそれら
              の間の値は中間の陰影を意味します。 この設定は、円の塗り潰し、楕円の塗り潰し、多角形
              の塗り潰しにのみ適用されます。  デフォルトでは  1000  が使用されます。 塗り潰しオブ
              ジェクトが色を持つ場合、 その色でそのオブジェクトの下の全てのものを完全に隠します。
              1000  より大きい値や 0 より小さい値も使用される可能性があります: これらの値を指定す
              ると、 現在線やテキストで使用している陰影で塗り潰すことを意味します。  通常はこれは
              黒ですが、 ドライバによってはこれを変更する手段を提供するものがあります。

       DC d\n 現在位置を最左端とする、半径 d の塗り潰された円を描画します。

       DE dx dy\n
              現在位置を最左端とする、水平半径  dx  垂直半径  dy の塗り潰された楕円を描画します。
              delim $$

       Dp $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$ $dy sub n$\n
              $i = 1 ,..., n+1$ に対し、 i 番目の頂点を現在位置 $+ sum from j=1 to i-1 ( dx sub j
              , dy sub j )$ とする多角形を描画します。 今のところ、GNU pic のみがこのコマンドを使
              用し、三角形と矩形を生成します。

       DP $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$ $dy sub n$\n
              Dp と同様ですが、多角形の外形のみの描画でなく、塗り潰しも行います。

       Dt n\n 現在の線の太さを n マシン単位に設定します。 伝統的に UNIX troff ドライバは、 現在の
              ポイントサイズに比例する線の太さを使用します;  Dt コマンドが指定されない場合や、 Dt
              コマンドに負の n が指定された場合は、ドライバはこの方法を使用する必要があります。 n
              に 0 を指定すると、利用可能な最小の線の太さを選択します。

       これらのコマンドを実行した後、  現在位置をどのように変更するのかという問題が生じます。 GNU
       pic が生成するコードはこの問題に依存しませんので、 これはたいして重要ではありません。

              \D′c $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x sub n$ $y sub n$′

       の形式、ただし c は c, e, l, a, ~ のいずれでもない描画コマンドが与えられた時、 UNIX  troff
       は各 $x sub i$ を水平の単位で扱い、$y sub i$ を垂直の単位で扱い、 描画されるオブジェクトの
       幅は $sum from i=1 to n x sub i$ であり、 高さは $sum from i=1 to n y sub i$  であると仮定
       します。  (高さに関する仮定は、このような D コマンドを \w エスケープシーケンス中で使用した
       後、 st レジスタおよび sb レジスタを検査することにより確認できます。) この規則は全てのオリ
       ジナルの描画コマンドにあてはまりますが、 De は例外です。 Df, Dt コマンドや、影響は少ないで
       すが DE コマンドにおいて、たとえ醜い結果となったとしても、 GNU troff  もまた互換性のために
       この規則に従います。 それゆえ、

              Dc $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x sub n$ $y sub n$\n

       の形式の  D コマンドを実行した後は、現在位置は $( sum from i=1 to n x sub i , sum from i=1
       to n y sub i )$ だけ増えます。

       x X コマンドへの引数に改行を含めることを許すという、  継続に関する取り決めがあります:  x X
       コマンドへの引数を出力する時、GNU troff は 引数中の + 文字付きの改行を辿ります (通常は改行
       で引数全体が終端されます); それゆえ、 x X コマンドを含む行の次行が +  で開始する場合には、
       x X コマンドを含む行の終端となっている改行は x X コマンドへの引数の一部として扱い、 + を無
       視し、行の + に続く部分を x X コマンドに続く行の部分として扱います。

関連項目

       groff_font(5)