Debian Codegraph @

doc/html/ja/gra.html

raw
1 <!DOCTYPE html>
2 <html lang="ja">
3 <head>
4 <meta charset="UTF-8">
5 <link rel="stylesheet" href="../ngraph.css" media="screen" type="text/css"/>
6 <link rel="icon" href="../ngraph.svg" />
7 <title>GRA</title>
8 </head>
9 <body>
10 <div class="toc">
11 <a name="TOP">&nbsp;</a>
12 <h1><a href="./ngraph.html">GRAファイル</a></h1>
13 <ul>
14 <li><a href="#GRAFILE">概要</a>
15 <li><a href="#GRAFILESTRUCTURE">GRAファイルの構造</a>
16 <li><a href="#GRACOMMAND">GRAファイルのグラフィックスコマンド</a>
17 </ul>
18 </div>
19
20
21 <div class="chapter">
22 <h2><a name="GRAFILE">概要</a></h2>
23 <br>
24 <div>
25 <p>
26 GRAファイルは, 直線, 円などのグラフィックス命令を記述した, グラフのマージ等に使われるNgraph独自のファイル形式です。
27 </p>
28 <p>
29 また、External driverへグラフィックス命令を送るのにも使われます。
30 </p>
31 <h3>GRAファイルの互換性</h3>
32 <ul>
33 <li> Ngraph version 6.x の GRA ファイルは, DOS 版 Ngraph (version 5.x)
34 の GRA ファイルと僅かに異なるため,互換性はありません。
35 <li> ただしNgraph version 6.x で DOS 版 Ngraph (version 5.x) の GRA ファ
36 イルをマージすることは可能です。
37 <li> DOS 版 Ngraph の GRA ファイルの構造およびコマンドについては DOS 版
38 Ngraph に添付されているマニュアルを参照してください。
39 <li> Ngraph version 6.04 で H コマンド (フォントメトリック指定命令) が拡
40 張されました。 version 6.04 で作成した GRA ファイルはそれ以前のバー
41 ジョンで読み込むことはできません。
42 <li> Ngraph version 6.05 で C コマンド (楕円描画命令) と G コマンド(カラー
43 指定命令) が拡張されました。 version 6.05 で作成した GRAファイルは
44 それ以前のバージョンで読み込むことはできません。
45 </ul>
46 </div>
47
48
49
50
51 <h2><a name="GRAFILESTRUCTURE" >GRAファイルの構造</a></h2>
52 <br>
53 <div>
54 下にGRAファイルの例を示します。<br>
55 <pre>
56 %Ngraph GRAF
57 %Creator: Ngraph ver 6.00.01
58 I,5,0,0,21000,29700,10000
59 V,5,0,0,21000,29700,1
60 G,3,0,0,0
61 A,5,0,40,2,0,1000
62 L,4,3500,22000,17500,22000
63 L,4,3500,22000,3500,8000
64 L,4,3500,8000,17500,8000
65 L,4,17500,22000,17500,8000
66 E,0
67 </pre>
68
69 <p>GRAファイルの第一行はGRAファイルの識別子である次の文字列でなければなりません。
70 <pre>
71 %Ngraph GRAF
72 </pre>
73 <p>
74 第2行以降は1行に1つずつグラフィックスコマンドが記述されます。グラフィックスコマンドの形式を示します。
75 </p>
76 <pre>
77 command, n, arg1, arg2, ..., argn
78 </pre>
79 <ul>
80 <li>commandはグラフィックスコマンドを指定するアルファベット一文字で I, E, V, A, G, M, N, L, T, C, B, P, R, D, H のいずれかです。
81 <li>n は引数の数(整数)を現します。
82 <li>arg1, ..., argnはグラフィックスコマンドの引数(整数)です。
83 </ul>
84
85 <p>コマンドの区切りにはスペース, タブ, コンマが使えます。
86 ただしcommandが%, F, S の場合には次のようにコマンド直後に
87 文字列の引数(下の例ではthis is a string)を記述します。
88 </p>
89 <pre>Sthis is a string</pre>
90 <p>
91 この場合, 文字列引数の中のスペース・タブ・コンマは通常の文字として扱われます。
92 </p>
93 </div>
94
95 <h2><a name="GRACOMMAND">GRAファイルのグラフィックコマンド</a></h2>
96 <div>
97 <p>
98 グラフィックコマンドの引数は特に指定のない限り単位は0.01mmです。
99 X座標増加方向は右, Y座標増加方向は下です。
100 数値引数はすべて整数値でなければなりません。
101 </p>
102
103 <table border="1">
104 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
105 <tr><td>I</td><td>初期化命令</td><td>I,5,arg1,arg2,arg3,arg4,arg5</td></tr>
106 </table>
107 <dl>
108 <dt> arg1
109 <dd> 左マージン
110 <dt> arg2
111 <dd> 上マージン
112 <dt> arg3
113 <dd> 出力用紙幅
114 <dt> arg4
115 <dd> 出力用紙高
116 <dt> arg5
117 <dd> 拡大率(0.01%単位)
118 </dl>
119 <ul>
120 <li>出力デバイスの初期化を行う。1回の描画で初めに一度だけ呼ばれる。
121 </ul>
122
123 <table border="1">
124 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
125 <tr><td>E</td><td>終了命令</td><td>E,0</td></tr>
126 </table>
127 <ul>
128 <li>一回の描画で最後に一度だけ呼ばれる。出力デバイスの後処理を行う。
129 </ul>
130
131 <table border="1">
132 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
133 <tr><td>%</td><td>コメント</td><td>%comment</td></tr>
134 </table>
135 <ul>
136 <li>文字列引数(コメント)
137 </ul>
138
139 <table border="1">
140 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
141 <tr><td>V</td><td>クリッピング領域, 原点移動命令</td><td>V,5,arg1,arg2,arg3,arg4,arg5</td></tr>
142 </table>
143 <dl>
144 <dt> arg1
145 <dd> 左上X座標, 新しいX座標原点
146 <dt> arg2
147 <dd> 左上Y座標, 新しいY座標原点
148 <dt> arg3
149 <dd> 右下X座標
150 <dt> arg4
151 <dd> 右下Y座標
152 <dt> arg5
153 <dd>
154 <ul>
155 <li> 0:クリッピングオフ
156 <li> 1:クリッピングオン
157 </ul>
158 </dl>
159 <ul>
160 <li>この命令以降, V命令を除くすべての命令は原点をクリッピング領域左上としたものになる。
161 <li>パラメタは A4用紙左上を原点とする0.01mm単位で指定します。
162 <li>クリッピング処理は基本的にNgraph内部で行っているので必ずしも必要ではないが, クリッピングするのが望ましい(原点移動は必須)。
163 </ul>
164
165 <table border="1">
166 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
167 <tr><td>A</td><td>線属性指定命令</td><td>A,n,arg1,arg2,.... </td></tr>
168 </table>
169 <dl>
170 <dt> n
171 <dd> 点線要素の数+5
172 <dt> arg1
173 <dd> 0:実線 >1:点線要素の数
174 <dt> arg2
175 <dd> 線幅
176 <dt> arg3
177 <dd> 線端形状
178 <ul>
179 <li> 0:Butt
180 <li> 1:Round
181 <li> 2:Projecting
182 </ul>
183 <dt> arg4
184 <dd> 線交差形状
185 <ul>
186 <li> 0:Miter
187 <li> 1:Round
188 <li> 2:Bevel
189 </ul>
190 <dt> arg5
191 <dd> Miter limit
192 <dt> arg(i) - arg(i + 5) i = 1 - arg1
193 <dd> 点線要素
194 </dl>
195
196 <table border="1">
197 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
198 <tr><td>G</td><td>カラー指定命令</td><td>G,4,arg1,arg2,arg3,arg4 </td></tr>
199 </table>
200
201 <dl>
202 <dt> arg1
203 <dd> R(8bit)
204 <dt> arg2
205 <dd> G(8bit)
206 <dt> arg3
207 <dd> B(8bit)
208 <dt> arg4
209 <dd> A(8bit) (不透明度)
210 </dl>
211
212 <ul>
213 <li> arg4 は設定によって、あるいはドライバによって無視されることがある。
214 </ul>
215
216 <table border="1">
217 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
218 <tr><td>M</td><td>カレントポイント移動命令</td><td>M,2,arg1,arg2 </td></tr>
219 </table>
220 <dl>
221 <dt> arg1
222 <dd> X座標
223 <dt> arg2
224 <dd> Y座標
225 </dl>
226
227 <table border="1">
228 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
229 <tr><td>N</td><td>カレントポイント相対移動命令</td><td>N,2,arg1,arg2 </td></tr>
230 </table>
231 <dl>
232 <dt> arg1
233 <dd> X方向移動量
234 <dt> arg2
235 <dd> Y方向移動量
236 </dl>
237
238 <table border="1">
239 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
240 <tr><td>L</td><td>線描画命令</td><td>L,4,arg1,arg2,arg3,arg4 </td></tr>
241 </table>
242
243 <dl>
244 <dt> arg1
245 <dd> 始点X座標
246 <dt> arg2
247 <dd> 始点Y座標
248 <dt> arg3
249 <dd> 終点X座標
250 <dt> arg4
251 <dd> 終点Y座標
252 </dl>
253
254
255 <table border="1">
256 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
257 <tr><td>T</td><td>カレントポイント相対・線描画命令</td><td>T,2,arg1,arg2 </td></tr>
258 </table>
259
260 <dl>
261 <dt> arg1
262 <dd> 終点X座標, 新しいカレントポイントX座標
263 <dt> arg2
264 <dd> 終点Y座標, 新しいカレントポイントY座標
265 </dl>
266
267 <ul>
268 <li>本命令実行後, カレントポイントは終点に移動する。
269 </ul>
270
271 <table border="1">
272 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
273 <tr><td>C</td><td>楕円描画命令</td><td>C,7,arg1,arg2,arg3,arg4,arg5,arg6,arg7 </td></tr>
274 </table>
275
276 <dl>
277 <dt> arg1
278 <dd> 中心のX座標
279 <dt> arg2
280 <dd> 中心のY座標
281 <dt> arg3
282 <dd> X方向半径
283 <dt> arg4
284 <dd> Y方向半径
285 <dt> arg5
286 <dd> 楕円弧開始角度, 0.01度単位(0-36000)
287 <dt> arg6
288 <dd> 楕円弧開始角度, 0.01度単位(0-36000)
289 <dt> arg7
290 <dd>
291 <ul>
292 <li> 0:円の輪郭(内部は塗りつぶさない)
293 <li> 1:扇形内部を塗りつぶす
294 <li> 2:円弧内部を塗りつぶす
295 <li> 3:扇形に輪郭を描画
296 <li> 4:弓形に輪郭を描画
297 </ul>
298
299 </dl>
300
301 <ul>
302 <li>arg5から開始してarg6の角度だけ反時計回りに楕円弧を描く。
303 <li>角度は, 楕円 (x/a)^2+(y/b)^2=1 を x=a*cosθ, y=b*sinθ と媒介変数表示した時のθ。
304 </ul>
305
306 <table border="1">
307 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
308 <tr><td>B</td><td>四角形描画命令</td><td>B,5,arg1,arg2,arg3,arg4,arg5 </td></tr>
309 </table>
310
311 <dl>
312 <dt> arg1
313 <dd> X座標
314 <dt> arg2
315 <dd> Y座標
316 <dt> arg3
317 <dd> 対角のX座標
318 <dt> arg4
319 <dd> 対角のY座標
320 <dt> arg5
321 <dd>
322 <ul>
323 <li> 0:四角形の輪郭(内部は塗りつぶさない)
324 <li> 1:内部を塗りつぶす
325 </ul>
326
327 </dl>
328
329
330 <table border="1">
331 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
332 <tr><td>P</td><td>点描画命令</td><td>P,2,arg1,arg2 </td></tr>
333 </table>
334
335 <dl>
336 <dt> arg1
337 <dd> X座標
338 <dt> arg2
339 <dd> Y座標
340 </dl>
341
342
343 <table border="1">
344 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
345 <tr><td>R</td><td>多角形描画命令</td><td>R,n,arg1,arg2,... </td></tr>
346 </table>
347
348 <dl>
349 <dt> n
350 <dd> 座標点の数*2+1
351 <dt> arg1
352 <dd> 座標点の数
353 <dt> arg(i * 2 + 0) i = 1 - arg1
354 <dd> X座標
355 <dt> arg(i * 2 + 1) i = 1 - arg1
356 <dd> Y座標
357 </dl>
358
359
360 <table border="1">
361 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
362 <tr><td>D</td><td>閉多角形描画命令</td><td>D,n,arg1,arg2,... </td></tr>
363 </table>
364
365 <dl>
366 <dt> n
367 <dd> 座標点の数*2+2
368 <dt> arg1
369 <dd> 座標点の数
370 <dt> arg2
371 <dd>
372 <ul>
373 <li> 0:多角形の輪郭(内部は塗りつぶさない)
374 <li> 1:内部を塗りつぶす(EvenOddRule)
375 <li> 2:内部を塗りつぶす(WindingRule)
376 </ul>
377 <dt> arg(i * 2 + 1) i = 1 - arg1
378 <dd> X座標
379 <dt> arg(i * 2 + 2) i = 1 - arg1
380 <dd> Y座標
381 </dl>
382
383
384 <table border="1">
385 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
386 <tr><td>F</td><td>フォント選択命令</td><td>Ffont</td></tr>
387 </table>
388
389 <ul>
390 <li> 文字列引数(font フォントエイリアス名)
391 <li> 実際のフォントへのマッピングはドライバに依存
392 </ul>
393
394 <table border="1">
395 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
396 <tr><td>H</td><td>フォントメトリック指定命令</td><td>H,4,arg1,arg2,arg3,arg4 </td></tr>
397 </table>
398
399 <dl>
400 <dt> arg1
401 <dd> 文字のポイントサイズ, 0.01pt単位(1pt=1/72inch)
402 <dt> arg2
403 <dd> 文字スペーシング・ポイント量, 0.01pt単位
404 <dt> arg3
405 <dd> 描画方向, X軸から反時計回りに0.01度単位
406 <dt> arg4
407 <dd> スタイル, 0:normal, 1: bold, 2:italic の和
408 </dl>
409
410 <ul>
411 <li>文字は全てスケーラブルでなければなりません。
412 </ul>
413
414 <table border="1">
415 <tr><td>コマンド</td><td>機能</td><td>書式</td></tr>
416 <tr><td>S</td><td>文字列描画命令</td><td>Sstring </td></tr>
417 </table>
418 <ul>
419 <li> 文字列引数 (string は UTF-8 文字列)
420 </ul>
421 </div>
422
423 </div>
424 </body>
425 </html>