Copyright (C) 2000, 2001, 2002, 2003, 2004 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. .. . .do nr grn_C \n[.C] .cp 0 . . br . ns . TP \\$1 .. . Like TP, but if specified indent is more than half
the current line-length - indent, use the default indent.
. ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP . el .TP "\\$1" .. . .
It is possible to have whitespace between a command line option and its parameter.
Please note that currently only the -me macro package has support for .GS , .GE , and .GF .
The following command-line options are understood:
-T dev Prepare output for printer dev . The default device is @DEVICE@ . See groff (@MAN1EXT@) for acceptable devices.
-M dir Prepend dir to the default search path for gremlin files. The default path is (in that order) the current directory, the home directory, @SYSTEMMACRODIR@ , @LOCALMACRODIR@ , and @MACRODIR@ .
-F dir Search dir for subdirectories dev name ( name is the name of the device) for the DESC file before the default font directories @LOCALFONTDIR@ , @FONTDIR@ , and @LEGACYFONTDIR@ .
-C Recognize
.GS and
.GE (and
.GF ) even when followed by a character other than space or newline.
.TP
.B -s
This switch causes the picture to be traversed twice:
The first time, only the interiors of filled polygons (as borderless
polygons) are printed.
The second time, the outline is printed as a series of line segments.
This way, postprocessors that overwrite rather than merge picture elements
(such as Postscript) can still have text and graphics on a shaded
background.
-v Print the version number.
Commands that affect a picture's environment (those listed before default , see below) are only in effect for the current picture: The environment is reinitialized to the defaults at the start of the next picture. The commands are as follows:
1 N .TQ 2 N .TQ 3 N .TQ 4 N Set gremlin 's text size number 1 (2, 3, or 4) to N points. The default is 12 (16, 24, and 36, respectively).
roman f .TQ italics f .TQ bold f .TQ special f Set the roman (italics, bold, or special) font to @g@troff 's font f (either a name or number). The default is R (I, B, and S, respectively).
l f .TQ stipple f Set the stipple font to @g@troff 's stipple font f (name or number). The command stipple may be abbreviated down as far as `st' (to avoid confusion with special ). There is no default for stipples (unless one is set by the default command), and it is invalid to include a gremlin picture with polygons without specifying a stipple font.
x N .TQ scale N Magnify the picture (in addition to any default magnification) by N , a floating point number larger than zero. The command scale may be abbreviated down to `sc'.
narrow N .TQ medium N .TQ thick N Set the thickness of gremlin 's narrow (medium and thick, respectively) lines to N times 0.15pt (this value can be changed at compile time). The default is 1.0 (3.0 and 5.0, respectively), which corresponds to 0.15pt (0.45pt and 0.75pt, respectively). A thickness value of zero selects the smallest available line thickness. Negative values cause the line thickness to be proportional to the current point size.
pointscale <off/on> Scale text to match the picture. Gremlin text is usually printed in the point size specified with the commands 1 , 2 , 3 , or\~ 4 , regardless of any scaling factors in the picture. Setting pointscale will cause the point sizes to scale with the picture (within @g@troff 's limitations, of course). An operand of anything but off will turn text scaling on.
default Reset the picture environment defaults to the settings in the current picture. This is meant to be used as a global parameter setting mechanism at the beginning of the @g@troff input file, but can be used at any time to reset the default settings.
width N Forces the picture to be N inches wide. This overrides any scaling factors present in the same picture. ` width 0 ' is ignored.
height N Forces picture to be N inches high, overriding other scaling factors. If both `width' and `height' are specified the tighter constraint will determine the scale of the picture. Height and width commands are not saved with a default command. They will, however, affect point size scaling if that option is set.
file name Get picture from gremlin file name located the current directory (or in the library directory; see the -M option above). If two file commands are given, the second one overrides the first. If name doesn't exist, an error message is reported and processing continues from the .GE line.
When using @g@grn along with other preprocessors, it is best to run tbl before @g@grn , pic , and/or ideal to avoid overworking tbl . Eqn should always be run last.
A picture is considered an entity, but that doesn't stop @g@troff from trying to break it up if it falls off the end of a page. Placing the picture between `keeps' in -me macros will ensure proper placement.
@g@grn uses @g@troff 's number registers g1 through g9 and sets registers g1 and g2 to the width and height of the gremlin figure (in device units) before entering the .GS request (this is for those who want to rewrite these macros).
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 |
.T& |
css. |
Table 1. File examples |
gremlin File Format - Object Type Specification |
AED Number@SUN/X11 Name@Description |
0@BOTLEFT@bottom-left-justified text |
1@BOTRIGHT@bottom-right-justified text |
2@CENTCENT@center-justified text |
3@VECTOR@vector |
4@ARC@arc |
5@CURVE@curve |
6@POLYGON@polygon |
7@BSPLINE@b-spline |
8@BEZIER@B\['e]zier |
10@TOPLEFT@top-left-justified text |
11@TOPCENT@top-center-justified text |
12@TOPRIGHT@top-right-justified text |
13@CENTLEFT@left-center-justified text |
14@CENTRIGHT@right-center-justified text |
15@BOTCENT@bottom-center-justified text |
.T& |
css. |
Table 2. |
Type Specifications in gremlin Files |
1 -@@thin dotted lines |
2 -@@thin dot-dashed lines |
3 -@@thick solid lines |
4 -@@thin dashed lines |
5 -@@thin solid lines |
6 -@@medium solid lines |
1 -@@roman (R font in groff) |
2 -@@italics (I font in groff) |
3 -@@bold (B font in groff) |
4 -@@special (S font in groff) |
David Slattengren and Barry Roitblat wrote the original Berkeley @g@grn .
Daniel Senderowicz and Werner Lemberg modified it for
groff . .
.cp \n[grn_C]
.
Local Variables:
mode: nroff
End: