grn(1) FreeBSD 一般コマンドマニュアル

grn

前のページ 上に戻る 次のページ

grn



書式

       grn [ -Cv ] [ -Tdev ] [ -Mdir ] [ -Fdir ] [ file...  ]

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


解説

       grn は、 groff の入力中に gremlin 図を入れるためのプリプロ
       セッ サです。 grn は、 .GS.GE の間にはさまれた入力行の
       みを処理し、標準出力に書き出します。処理される行に は  grn
       コマンド (後述) が含まれていなくてはなりません。これらのコ
       マンドは、 gremlin ファイルを要求し、そのファイル中の図 を
       変 換 し troff の入力ストリームに置きます。 .GS リクエスト
       は、続けて C, L, R をとることができ、 gremlin 図全体を中央
       揃え、左揃え、あるいは右揃えにすることができます (デフォル
       トは中央揃えです)。 file が指定されていない場合は、標準 入
       力が読み込まれます。図の最後では、ページ内での位置は grem-
       lin 図の下になります。 grn エントリが .GE ではなく .GF  で
       終わっている場合は、ページ内での位置は図の左上になります。

       現在のところ、-me マクロパッケージだけが .GS, .GE, .GF  を
       サポートしていることに注意してください。

       次のコマンドラインオプションを理解します:

       -Tdev  プリンタ dev 用の出力を用意します。デフォルトのデバ
              イスは ps です。受け付け可能なデバイスにつ い て は
              groff(1) を参照してください。

       -Mdir  dir を、 gremlin ファイルのデフォルト検索パスの前に
              追加します。デフォルトパスは (順番に)、現在のディレ
              ク ト リ、 ホ ー ム ディレクトリ、 /usr/share/tmac,
              /usr/share/tmac, /usr/share/tmac (訳注: 重複して い
              ますが原文通りです) です。

       -Fdir  dir 中からサブディレクトリ devname (name はデバイス
              名です) を探し、通常の /usr/share/groff_font の前に
              読み込まれる DESC ファイルを探します。

       -C     たとえ空白や改行以外の文字が後に続いていても .GS お
              よび .GE (およびこれに相応する .GF) を認識します。

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


grn コマンド

       .GS.GE にはさまれた入力行はそれぞれ 1 つずつ grn コ マ
       ンドを持っています。コマンドは、1 つの文字列か、空白で区切
       られた 2 つの文字列でできています。最初の文字列はコマン ド
       であり、2 番目の文字列はオペランドです。コマンドは大文字小
       文字どちらでも良く、1 文字までに縮めることもできます。

       図の環境に影響を与えるコマンド (以降において default の 前
       special f
              ロ ーマン体 (イタリック体、ボールド体、あるいは特殊
              文字) のフォントを troff フォント f (フォント名ある
              いは番号) に設定します。デフォルトは R (I, B, S) で
              す。

       l f
       stipple f
              スティプル (stipple) フォントを troff のスティプ ル
              フォ ント f (フォント名あるいは番号) に設定します。
              コマンド stipple は、`st' までになら省略できます  (
              special との混乱を避けるためです)。スティプルフォン
              トにはデフォルトは ありません (default コマンドで設
              定されていない限りは)。スティプルフォントを指定しな
              いまま、ポリゴンを含んだ gremlin 図を取り込むことは
              不正です。

       x N
       scale N
              ( デフォルトの拡大処理に加えて) gremlin 図を N 倍に
              拡大します。ここで N は 0 より大きな浮動小 数 値 で
              す。 コ マ ンド scale は、`sc' までになら省略できま
              す。

       narrow N
       medium N
       thick N
              細線 (中間の太さの線、および太線) の太さを 0.15  ポ
              イ ント (この値は、コンパイル時に変更できます) の N
              倍に設定します。デフォルトは 1.0 (3.0, 5.0) で す。
              こ れは、0.15 ポイント (0.45 ポイントおよび 0.75 ポ
              イント) に対応しています。太さを表す値が 0 の と き
              は、 使用できる中で最も小さな値を選択します。負の値
              は、現在のポイントサイズに比例した、線の太さの指 定
              になります。

       pointscale <off/on>
              テ キストを図に合うようにスケーリングします。 grem-
              lin テキストは、通常、図のスケールファクタ に よ ら
              ず、コマンド 1, 2, 3, あるいは 4 で指定されるポイン
              トサイズで表示されます。 pointscale を設定する と、
              ポ イ ン トサイズが図に合わせて変更されます (もちろ
              ん、 troff の制限内で)。 off 以外のオペランドは何で
              あってもテキストのスケーリングを有効にします。

       default
              デ フォルトの図の環境を、現在の図の環境で、再設定し
              ます。このオプションは、 troff 入力ファイルの先頭で
              グ ローバルパラメータを設定するメカニズムとして使わ
              れることを意図していますが、デフォルト設定を再設 定
              したいときはいつでも使うことができます。

       file name
              カ レントディレクトリ (あるいはライブラリディレクト
              リ。前述の -M オプションを参照してください) に置 か
              れ た  gremlin   ファイル name から図を取得します。
              file コマンドが 2 つ与えられた場合、2 つめのコマ ン
              ド が最初のコマンドに優先します。 name が存在しない
              場合は、エラーメッセージが報告され、 .GE 行から処理
              が再開されます。


groff に関しての注意

       grn はプリプロセッサですので、現在のインデントやポイントサ
       イズ、余白や番号レジスタなどについては分かりません。そのた
       め、  .GS リクエストと .GE リクエストの間には troff への入
       力を置くことができません。しかしながら、 gremlin テキス ト
       は現在 troff で処理されます。そのため、 gremlin テキスト行
       にある troff への入力行はどれも正しいものになります (た だ
       し、 行 頭 に `.' ディレクティブを置くことは禁止されていま
       す)。そのため、 gremlin ファイル中に定義済みのデリミタ (例
       えば $$) で括った eqn 表記を埋め込むことによって、 gremlin
       図の中に等式を書くことができます。

       grn を他のプリプロセッサと一緒に使う場合、 tbl が仕事を し
       す ぎないようにするために、 grn, pic, ideal よりも前に tbl
       を呼び出すのが最も良いやり方です。 eqn は必ず最後に起動 さ
       せるべきです。

       図はひとつのエンティティとみなされますが、ページの末尾を越
       えてしまった場合、 troff は図を分割しようとしてし ま い ま
       す。 -me マクロ中で図を `keeps' 中に置くことで適切な位置決
       めができるようになります。

       grntroff の番号レジスタ g1 から g9 までを使い、そし て
       .GS リクエストを処理する前にレジスタ g1 および g2grem-
       lin 図の幅および高さ (デバイス単位) を設定します (これらの
       マクロを書き直したいと思っている人たちのためにそうしていま
       す)。


gremlin ファイル形式

       gremlin ファイル形式には 2 つの異なった形式があ り ま す。
       AED   グラフィック端末用バージョン由来のオリジナルの形式と
       SUN および X11 バージョンの形式です。負の座標を用いた参 照
       点を容認する SUN/X11 バージョンの拡張機能は、 AED バージョ
       ンとは互換性が B>あB>りB>まB>せB>ん。 gremlin ファイルに負の座標が含
       ま れていない限りは、どちらの形式のファイルも gremlin ある
       いは grn で読み込むことができます。他に SUN/X11 の形式が異
       なる点は、図のオブジェクトに対して番号を使うのではなく、名
       前 (例えば、POLYGON, CURVE) を使うことです。同じ図を 表 す
       ファイルを、それぞれの形式について 表 1 に示します。

                 sungremlinfile        gremlinfile
                 0 240.00 128.00       0 240.00 128.00
                 CENTCENT              2
                 0                     0
                 -1                    -1

                           表 1. ファイル例


       o      そ れ ぞ れ の  gremlin ファイルの 1 行目は、文字列
              gremlinfile (AED バージョン) あるい は  sungremlin-
              file (SUN/X11バージョン) のどちらかです。

       o      ファイルの 2 行目には点の位置を決めるための、方向、
              x および y の値が含まれており、各値は空白で区切られ
              ています。方向は、 0 あるいは 1 をとり、 SUN/X11 バ
              ージョンでは無視されます。 0 は、 gremlin 図が水 平
              方 向の形式で表示されることを意味しています (描画領
              域の幅が実際の図の高さよりも広くとられ、上 部 に メ
              ニューがつきます)。 1 は、 gremlin 図が垂直方向の形
              式で表示されることを意味しています (描画領域の高 さ
              が 実際の図の幅よりも高くとられ、左側にメニューがつ
              きます)。 x および y は浮動小数値であり、このファイ
              ル が他のファイルに読み込まれる際に、位置決め点を与
              えるために使用されます。この行の要素は、それほど 重
              要なものではありません。 ``1 0.00 0.00'' という値を
              推奨します。

       o      このファイルの残りの部分は 0 個以上の要素を記述した
              も のになっています。最後の要素を記述した後には、文
              字列 ``-1'' を持った行がきます。


要素の記述

       o      各要素の最初の行には、要素タイプを与える 10   進 数
              (AED  バージョンの場合) あるいは要素の ASCII 文字で
              の名称 (SUN/X11 バージョンの場合) が 1 つ含まれてい
              ます。表 2 を参照してください。

            gremlin ファイルフォーマット - オブジェクトタイプの仕様

             AED 番号      SUN/X11 名称              解説
                 0        BOTLEFT           左下揃えのテキスト
                 1        BOTRIGHT          右下揃えのテキスト
                 2        CENTCENT          中央揃えのテキスト
                 3        VECTOR            ベクトル
                 4        ARC               円弧
                 5        CURVE             曲線
                 6        POLYGON           ポリゴン
                10        TOPLEFT           左上揃えのテキスト
                11        TOPCENT           中央上揃えのテキスト
                12        TOPRIGHT          右上揃えのテキスト
                13        CENTLEFT          左中央揃えのテキスト
                14        CENTRIGHT         右中央揃えのテキスト
                15        BOTCENT           中央下揃えのテキスト

              は、 オ ブ ジェクトが描かれる際のスタイルを決定しま
              す。ベクトル、円弧、および曲線については、ブラシ の
              値として 6 個の正当な値があります:

                            1 -       細い点線
                            2 -       細い一点鎖線
                            3 -       太い直線
                            4 -       細い破線
                            5 -       細い直線
                            6 -       通常の直線

              ポリゴンに対しては、さらに 0 も正当な値となります。
              この値は、境界線の見えないポリゴンを指定するもの で
              す。 テキストに対しては、ブラシは次のようにフォント
              を選択します:

                1 -       ローマン体 (groff での R フォント)
                2 -       イタリック体 (groff での I フォント)
                3 -       ボールド体 (groff での B フォント)
                4 -       特殊文字 (groff での S フォント)

              図を groff に通すために grn を使っている場合は、 こ
              こでのフォントはただ開始時のフォントになるだけです:
              テキスト文字列には、 ``\fI'' や ``\d'' のよ う な、
              フォ ントを変更し得る (他のこともする) フォーマット
              用シーケンスを含んでも構いません。テキストでは、 サ
              イ ズフィールドは 1 から 4 までの 10 進数です。これ
              は、テキストが描画されるフォントサイズを選 択 し ま
              す。 ポリゴンに対しては、このサイズフィールドはポリ
              ゴン内部を埋めるために使われるスティプル番号と解 釈
              さ れます。この番号は、表示する際にスティプルフォン
              トに置き換えるインデックスとして使われます。

       o      各要素の最終行には、10 進数と文字列が空白文字 1  つ
              で 区切られて入っています。 10 進数は、文字列中の文
              字数をカウントしたものです。この情報はテキスト要 素
              に 対してのみ使われ、テキスト文字列が情報の中に含ま
              れています。テキスト内部には空白文字が入っていて も
              良 いです。円弧、曲線、およびベクトルについては、そ
              れぞれの要素が対応する行には文字列 ``0'' が入ってい
              ます。


座標についての注意

       gremlinAED 用に設計され、その座標系は AED の座標空間を
       反映したものになっています。垂直方向の図に対しては、x 値は
       116   から 511 までをとり、 y 値は 0 から 483 までをとりま
       す。水平方向の図に対しては、 x 値は 0 から 511 ま で を と
       り、  y 値は 0 から 367 までをとります。この範囲に必ずしも
       こだわることはありませんが、少なくともこの近傍にとどめてお
       け ば 最 良 の結果が得られるでしょう。さらに、点のリストは
       (-1, -1) で終わりますので、負の座標を使うことはで き ま せ
       ん。  gremlin 図は、``%f1.2'' という形式を使って座標を出力
       gremlin(1), groff(1), pic(1), ideal(1)


歴史

       David Slattengren と Barry Roitblat がオリジナルの  Berke-
       ley 版 grn を書きました。

       Daniel Senderowicz と Werner Lemberg が groff 用に書き直し
       ました。



Groff Version 1.17.2      6 August 2001                    GRN(1)

ABELNET VPSサービス