Commit | Line | Data |
---|---|---|
57807285 C |
1 | |
2 | ||
3 | ||
4 | GROFF_OUT(@MAN5EXT@) BSD Reference Manual GROFF_OUT(@MAN5EXT@) | |
5 | ||
6 | ||
7 | N\bNA\bAM\bME\bE | |
8 | groff_out - groff intermediate output format | |
9 | ||
10 | D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN | |
11 | This manual page describes the format output by GNU troff. | |
12 | The output format used by GNU troff is very similar to | |
13 | that used by Unix device-independent troff. Only the dif- | |
14 | ferences are documented here. | |
15 | ||
16 | The argument to the s\bs command is in scaled points (units | |
17 | of _\bp_\bo_\bi_\bn_\bt_\bs_\b/n_\b, where _\bn is the argument to the s\bsi\biz\bze\bes\bsc\bca\bal\ble\be com- | |
18 | mand in the DESC file.) The argument to the x\bx H\bHe\bei\big\bgh\bht\bt | |
19 | command is also in scaled points. | |
20 | ||
21 | The first three output commands are guaranteed to be: | |
22 | ||
23 | x\bx T\bT _\bd_\be_\bv_\bi_\bc_\be | |
24 | x\bx r\bre\bes\bs _\bn _\bh _\bv | |
25 | x\bx i\bin\bni\bit\bt | |
26 | ||
27 | If the t\btc\bco\bom\bmm\bma\ban\bnd\bd line is present in the DESC file, troff | |
28 | will use the following two commands | |
29 | ||
30 | t\bt_\bx_\bx_\bx _\bx_\bx_\bx is any sequence of characters terminated by a | |
31 | space or a newline; the first character should be | |
32 | printed at the current position, the the current | |
33 | horizontal position should be increased by the | |
34 | width of the first character, and so on for each | |
35 | character. The width of the character is that | |
36 | given in the font file, appropriately scaled for | |
37 | the current point size, and rounded so that it is a | |
38 | multiple of the horizontal resolution. Special | |
39 | characters cannot be printed using this command. | |
40 | ||
41 | u\bu_\bn _\bx_\bx_\bx This is same as the t\bt command except that after | |
42 | printing each character, the current horizontal | |
43 | position is increased by the sum of the width of | |
44 | that character and _\bn. | |
45 | ||
46 | Note that single characters can have the eighth bit set, | |
47 | as can the names of fonts and special characters. | |
48 | ||
49 | The names of characters and fonts an be of arbitrary | |
50 | length; drivers should not assume that they will be only | |
51 | two characters long. | |
52 | ||
53 | When a character is to be printed, that character will | |
54 | always be in the current font. Unlike device-independent | |
55 | troff, it is not necessary for drivers to search special | |
56 | fonts to find a character. | |
57 | ||
58 | ||
59 | ||
60 | ||
61 | Groff Version @VERSION@ @MDATE@ 1 | |
62 | ||
63 | ||
64 | ||
65 | ||
66 | ||
67 | ||
68 | ||
69 | ||
70 | GROFF_OUT(@MAN5EXT@) BSD Reference Manual GROFF_OUT(@MAN5EXT@) | |
71 | ||
72 | ||
73 | The D\bD drawing command has been extended. These extensions | |
74 | will only be used by GNU pic if the -\b-x\bx option is given. | |
75 | ||
76 | D\bDf\bf _\bn\n Set the shade of gray to be used for filling solid | |
77 | objects to _\bn; _\bn must be an integer between 0 and | |
78 | 1000, where 0 corresponds solid white and 1000 to | |
79 | solid black, and values in between correspond to | |
80 | intermediate shades of gray. This applies only to | |
81 | solid circles, solid ellipses and solid polygons. | |
82 | By default, a level of 1000 will be used. Whatever | |
83 | color a solid object has, it should completely | |
84 | obscure everything beneath it. A value greater | |
85 | than 1000 or less than 0 can also be used: this | |
86 | means fill with the shade of gray that is currently | |
87 | being used for lines and text. Normally this will | |
88 | be black, but some drivers may provide a way of | |
89 | changing this. | |
90 | ||
91 | D\bDC\bC _\bd\n Draw a solid circle with a diameter of _\bd with the | |
92 | leftmost point at the current position. | |
93 | ||
94 | D\bDE\bE _\bd_\bx _\bd_\by\n | |
95 | Draw a solid ellipse with a horizontal diameter of | |
96 | _\bd_\bx and a vertical diameter of _\bd_\by with the leftmost | |
97 | point at the current position. delim $$ | |
98 | ||
99 | D\bDp\bp $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx | |
100 | sub n$ $dy sub n$\n | |
101 | Draw a polygon with, for $i = 1 ,..., n+1$, the _\bi- | |
102 | th vertex at the current position $+ sum from j=1 | |
103 | to i-1 ( dx sub j , dy sub j )$. At the moment, | |
104 | GNU pic only uses this command to generate trian- | |
105 | gles and rectangles. | |
106 | ||
107 | D\bDP\bP $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx | |
108 | sub n$ $dy sub n$\n | |
109 | Like D\bDp\bp but draw a solid rather than outlined poly- | |
110 | gon. | |
111 | ||
112 | D\bDt\bt _\bn\n Set the current line thickness to _\bn machine units. | |
113 | Traditionally Unix troff drivers use a line thick- | |
114 | ness proportional to the current point size; | |
115 | drivers should continue to do this if no D\bDt\bt command | |
116 | has been given, or if a D\bDt\bt command has been given | |
117 | with a negative value of _\bn. A zero value of _\bn | |
118 | selects the smallest available line thickness. | |
119 | ||
120 | A difficulty arises in how the current position should be | |
121 | changed after the execution of these commands. This is | |
122 | not of great importance since the code generated by GNU | |
123 | pic does not depend on this. Given a drawing command of | |
124 | ||
125 | ||
126 | ||
127 | Groff Version @VERSION@ @MDATE@ 2 | |
128 | ||
129 | ||
130 | ||
131 | ||
132 | ||
133 | ||
134 | ||
135 | ||
136 | GROFF_OUT(@MAN5EXT@) BSD Reference Manual GROFF_OUT(@MAN5EXT@) | |
137 | ||
138 | ||
139 | the form | |
140 | ||
141 | \\b\D\bD'\b'_\bc $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ | |
142 | $x sub n$ $y sub n$' | |
143 | ||
144 | where _\bc is not one of c\bc, e\be, l\bl, a\ba or ~\b~, Unix troff will | |
145 | treat each of the $x sub i$ as a horizontal quantity, and | |
146 | each of the $y sub i$ as a vertical quantity and will | |
147 | assume that the width of the drawn object is $sum from i=1 | |
148 | to n x sub i$, and that the height is $sum from i=1 to n y | |
149 | sub i$. (The assumption about the height can be seen by | |
150 | examining the s\bst\bt and s\bsb\bb registers after using such a D\bD | |
151 | command in a \w escape sequence.) This rule also holds | |
152 | for all the original drawing commands with the exception | |
153 | of D\bDe\be. For the sake of compatibility GNU troff also fol- | |
154 | lows this rule, even though it produces an ugly result in | |
155 | the case of the D\bDf\bf, D\bDt\bt, and, to a lesser extent, D\bDE\bE com- | |
156 | mands. Thus after executing a D\bD command of the form | |
157 | ||
158 | D\bD_\bc $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x | |
159 | sub n$ $y sub n$\n | |
160 | ||
161 | the current position should be increased by $( sum from | |
162 | i=1 to n x sub i , sum from i=1 to n y sub i )$. | |
163 | ||
164 | There is a continuation convention which permits the argu- | |
165 | ment to the x\bx X\bX command to contain newlines: when out- | |
166 | putting the argument to the x\bx X\bX command, GNU troff will | |
167 | follow each newline in the argument with a +\b+ character (as | |
168 | usual, it will terminate the entire argument with a new- | |
169 | line); thus if the line after the line containing the x\bx X\bX | |
170 | command starts with +\b+, then the newline ending the line | |
171 | containing the x\bx X\bX command should be treated as part of | |
172 | the argument to the x\bx X\bX command, the +\b+ should be ignored, | |
173 | and the part of the line following the +\b+ should be treated | |
174 | like the part of the line following the x\bx X\bX command. | |
175 | ||
176 | S\bSE\bEE\bE A\bAL\bLS\bSO\bO | |
177 | g\bgr\bro\bof\bff\bf_\b_f\bfo\bon\bnt\bt(@MAN5EXT@) | |
178 | ||
179 | ||
180 | ||
181 | ||
182 | ||
183 | ||
184 | ||
185 | ||
186 | ||
187 | ||
188 | ||
189 | ||
190 | ||
191 | ||
192 | ||
193 | Groff Version @VERSION@ @MDATE@ 3 | |
194 | ||
195 | ||
196 | ||
197 | ||
198 |