Provided by: manpages-ja_0.5.0.0.20060115-1_all bug

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

       図の環兇鳳洞舛鰺燭┐襯灰泪鵐           (以降において           default
       の前にリストされているもの)  は、現在の図に対して  のみ効果を持ちます。
       次の図が始まると、環兇魯妊侫ルトで再初期化されます。
       コマンドは次のとおりです:

       1 N
       2 N
       3 N
       4 N    gremlin  のテゥ好肇汽ぅ哉峭  1   (2,   3   または   4)   を   N
              ポイントに設定します。 デフォルトは 12 (16, 24, 36) です。

       roman f
       italics f
       bold f
       special f
              ローマン体    (イタリック体、ボールド体、あるいは特殊文字)    の
              フォントを    troff    フォント    f    (フォント名あるいは番号)
              に設定します。 デフォルトは R (I, B, S) です。

       l f
       stipple f
              スティプル  (stipple)  フォントを  troff  のスティプルフォント f
              (フォント名あるいは番号)   に設定します。    コマンド    stipple
              は、`st'         までになら省略でい泙         (         special
              との混乱を避けるためです)。   スティプルフォントにはデフォルトは
              _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>
              テゥ好箸鮨泙帽腓Δ茲Δ縫好院璽螢鵐阿靴泙后     gremlin     テ-
              ストは、通常、図のスケールファクタによらず、            コマンド
              1, 2, 3, あるいは 4   で指定されるポイントサイズで表示されます。
              pointscale
              を設定すると、ポイントサイズが図に合わせて変更されます
              (もちろん、          troff           の制限内で)。           off
              以外のオペランドは何であっても         テゥ好箸離好院璽螢鵐阿鰺-
              効にします。

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

       width N
              図を強制的に幅                N                 インチにします。
              このオプションは、同じ図中に存在する他のスケールファクタに優先します。
              `width 0' は、無視されます。

       height N
              他のスケールファクタに優先して、図を強制的に高さ               N
              インチにします。  `width'  と  `height' 両方が指定されていると-
              には、 図をより小さくする制約が図のスケールを決定します。 height
              および width コマンドは、 default コマンドでは保存はされません。
              しかしながら、
              ポイントサイズスケーリングが使用されている場合には、
              これに対する影響はあります。

       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    および    g2gremlin
       図の幅および高さ  (デバイス単位)   を設定します   (これらのマクロを書-
       直したいと思っている人たちのために そうしています)。

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

                        sungremlinfile        gremlinfile
                        0 240.00 128.00       0 240.00 128.00
                        CENTCENT              2
                        240.00 128.00         240.00 128.00
                        185.00 120.00         185.00 120.00
                        240.00 120.00         240.00 120.00
                        296.00 120.00         296.00 120.00
                        *                     -1.00 -1.00
                        2 3                   2 3
                        10 A Triangle         10 A Triangle
                        POLYGON               6
                        224.00 416.00         224.00 416.00
                        96.00 160.00          96.00 160.00
                        384.00 160.00         384.00 160.00
                        *                     -1.00 -1.00
                        5 1                   5 1
                        0                     0
                        -1                    -1

                                  表 1. ファイル例

       o      それぞれの gremlin ファイルの 1 行目は、 文字列 gremlinfile (AED
              バージョン)    あるいは    sungremlinfile    (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            中央下揃えのテゥ好

                                           表 2.
                         gremlin ファイルにおける要素タイプの仕様

       o      オブジェクトタイプの後には、可変数の行がい泙后
              各行は、オブジェクトの要素を表示するのに使われる点を指定します。
              各行には、x    座標および    y    座標が浮動小数値で入っており、
              それぞれは空白文字で区切られています。      点のリストは、文字列
              ``-1.0      -1.0''     を含んだ行     (AED     バージョンの場合)
              あるいはアスタリスク  ``*''  1  個  (SUN/X11   バージョンの場合)
              で終わります。

       o      点の後には、10      進数     2     個を含んだ行がい泙后これは、
              要素に対するブラシとサイズを与えます。
              ブラシは、オブジェクトが描かれる際のスタイルを決定します。
              ベクトル、円弧、および曲線については、ブラシの値として         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''
       という形式を使って座標を出力します。           ですので、           grn
       コードを変更したい場合には同じ形式を用いるのが
       おそらくは良い考えでしょう。

SUN/X11意
       SUN/X11                      バージョンの                       gremlin
       図では、オブジェクト生成に用いられる座標の範囲に 制限はもうありません。
       しかし、負の座標を持ったファイルでは、                              AED
       上で表示させようとすると問題が 。

ル
       /usr/share/groff_font/devname/DESC
              デバイス name 用のデバイス定義ファイル

目
       gremlin(1), groff(1), pic(1), ideal(1)

史
       David  Slattengren  と  Barry  Roitblat  がオリジナルの Berkeley 版 grn
       を書い泙靴拭

       Daniel Senderowicz と Werner Lemberg が groff 用に書つ召靴泙靴拭