Revision | 20 (tree) |
---|---|
Time | 2004-12-04 00:15:15 |
Author | |
This commit was manufactured by cvs2svn to create tag 'v0_3'.
@@ -0,0 +1,385 @@ | ||
1 | +<?xml version="1.0" encoding="EUC-JP"?> | |
2 | + | |
3 | +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | |
4 | + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ | |
5 | + | |
6 | +]> | |
7 | + | |
8 | +<article lang="ja"> | |
9 | + <articleinfo> | |
10 | + <title>AutoCoast マニュアル</title> | |
11 | + <author lang="ja"> | |
12 | + <surname>村上</surname> | |
13 | + <firstname>卓弥</firstname> | |
14 | + <affiliation> | |
15 | + <address> | |
16 | + <email>tmurakam at users.sourceforge.jp</email> | |
17 | + </address> | |
18 | + </affiliation> | |
19 | + </author> | |
20 | + | |
21 | + <pubdate>4 December 2004</pubdate> | |
22 | + | |
23 | + <revhistory> | |
24 | + <revision> | |
25 | + <revnumber>1.1</revnumber> | |
26 | + <date>2004-12-4</date> | |
27 | + <revremark>AutoCoast ver 0.3</revremark> | |
28 | + </revision> | |
29 | + <revision> | |
30 | + <revnumber>1.0</revnumber> | |
31 | + <date>2004-11-27</date> | |
32 | + <revremark>初版</revremark> | |
33 | + </revision> | |
34 | + </revhistory> | |
35 | + </articleinfo> | |
36 | + | |
37 | + <sect1 id="intro"> | |
38 | + <title>はじめに</title> | |
39 | + <para> | |
40 | + AutoCoast は、海岸線のシーナリを自動生成するツールです。 | |
41 | + </para> | |
42 | + <para> | |
43 | + AutoCoast は | |
44 | + <ulink url="http://www.soest.hawaii.edu/wessel/gshhs/gshhs.html">GSHHS (Global Self-consistant Hierarchical High-resolution Shorelines)</ulink> | |
45 | + を用いて海岸線を自動生成します。 | |
46 | + </para> | |
47 | + </sect1> | |
48 | + | |
49 | + <sect1 id="install"> | |
50 | + <title>インストール</title> | |
51 | + | |
52 | + <sect2> | |
53 | + <title>必要環境</title> | |
54 | + <para> | |
55 | + 以下のものが必要です。別途入手してください。 | |
56 | + </para> | |
57 | + <itemizedlist> | |
58 | + <listitem> | |
59 | + <para> | |
60 | + GSHHS データ: | |
61 | + <ulink url="http://www.soest.hawaii.edu/wessel/gshhs/gshhs.html">こちら</ulink> | |
62 | + からGSHHS のデータを入手します。gshhs_1.3.zip ファイルです。 | |
63 | + </para> | |
64 | + </listitem> | |
65 | + <listitem> | |
66 | + <para> | |
67 | + BGL Compiler : | |
68 | + <ulink url="http://www.microsoft.com/games/flightsimulator/fs2002_downloads_sdk.asp"> | |
69 | + FS2002 SDK</ulink> | |
70 | + の BGL Compiler (BGLC.EXE) が必要です。 | |
71 | + </para> | |
72 | + <note> | |
73 | + <para>FS2004 SDK ではありません</para> | |
74 | + </note> | |
75 | + </listitem> | |
76 | + </itemizedlist> | |
77 | + </sect2> | |
78 | + | |
79 | + <sect2> | |
80 | + <title>インストール手順</title> | |
81 | + <para> | |
82 | + AutoCoast のファイルを展開して、適当なフォルダに展開してください。 | |
83 | + </para> | |
84 | + <para> | |
85 | + ついで、GSHHS のデータファイルも展開します。これも上記と同じフォルダに置いてください。 | |
86 | + また、BGL Compiler のプログラムファイル (BGLC.EXE) も同じフォルダに置いてください。 | |
87 | + </para> | |
88 | + </sect2> | |
89 | + </sect1> | |
90 | + | |
91 | + <sect1 id="usage"> | |
92 | + <title>使用方法</title> | |
93 | + | |
94 | + <sect2> | |
95 | + <title>GSHHS データファイルから必要なデータを抜き出す</title> | |
96 | + <para> | |
97 | + GSHHS のデータには全世界の海岸線データが入っているので、非常にサイズが大きく | |
98 | + このままでは処理に時間がかかります。そこで、必要なデータだけを抜き出します。 | |
99 | + </para> | |
100 | + <para> | |
101 | + AutoCoast のツールはすべてコマンドプロンプトから起動します。 | |
102 | + 「すべてのプログラム」→「アクセサリ」→「コマンドプロンプト」を開き、以下のように | |
103 | + 入力してフォルダを移動します。 | |
104 | + </para> | |
105 | + <programlisting> | |
106 | + cd <replaceable>AutoCoastをインストールしたフォルダ名</replaceable> | |
107 | + </programlisting> | |
108 | + <para> | |
109 | + ついで、GshhsExtractor ツールを使ってデータを抜き出します。 | |
110 | + </para> | |
111 | + <programlisting> | |
112 | + GshhsExtractor <replaceable>[オプション] GSHHSデータファイル名 最小経度 最大経度 最小緯度 最大緯度</replaceable> | |
113 | + </programlisting> | |
114 | + <para> | |
115 | + GSHHS データファイルには何種類かありますが、もっとも精細なデータを使うなら | |
116 | + 'gshhs_f.b' ファイルを指定してください。緯度/経度は度単位で入力してください。 | |
117 | + </para> | |
118 | + <para> | |
119 | + 例: 日本周辺のデータを取り出すときは、'GshhsExtractor gshhs_f.b 125 150 25 50' と | |
120 | + します。 | |
121 | + </para> | |
122 | + <para> | |
123 | + 西/南半球を指定する場合は、負の値を使用してください。 | |
124 | + </para> | |
125 | + <caution> | |
126 | + <para>グリニッジ子午線をまたいでデータを取り出すことはできません。</para> | |
127 | + </caution> | |
128 | + | |
129 | + <para> | |
130 | + この他、オプションをいくつか指定することができます(通常は指定する必要はありません)。 | |
131 | + </para> | |
132 | + | |
133 | + <sect3> | |
134 | + <title>-n : スムージングの抑止</title> | |
135 | + <para> | |
136 | + GSHHS の海岸線データは、かなりがたつきがあるためそのままシーナリにすると | |
137 | + あまり見栄えがよくありません。 | |
138 | + このため、GsshsExtractor は海岸線データをスムージング(平滑化)するように | |
139 | + なっています。 | |
140 | + </para> | |
141 | + <para> | |
142 | + -n オプションをつけると、このスムージング処理を行わないようにすることができます。 | |
143 | + </para> | |
144 | + </sect3> | |
145 | + | |
146 | + <sect3> | |
147 | + <title>-i : 特定ポリゴンの除外</title> | |
148 | + <para> | |
149 | + 海岸線データの処理にはかなりの時間がかかることがあります(数十分〜数時間)。 | |
150 | + もし、ユーラシア大陸のデータが不要ならば、'-i 0' のようにオプションをつけることで、 | |
151 | + 0 番ポリゴン(ユーラシア大陸のポリゴン)を除外するとかなり高速化されます。 | |
152 | + </para> | |
153 | + </sect3> | |
154 | + | |
155 | + </sect2> | |
156 | + | |
157 | + <sect2> | |
158 | + <title>シーナリデータファイルを生成する</title> | |
159 | + <para> | |
160 | + シーナリデータファイルを生成します。これには autocoast ツールを使います。 | |
161 | + 使い方は以下の通り。 | |
162 | + </para> | |
163 | + | |
164 | + <programlisting> | |
165 | + autocoast <replaceable>[オプション] min_x min_y max_x max_y</replaceable> | |
166 | + </programlisting> | |
167 | + | |
168 | + <para> | |
169 | + 引数を使って、シーナリを生成する「セル」の範囲を決めます。 | |
170 | + 「セル」は海岸線シーナリで使われるエリアの単位で、全世界の東西方向に 768、 | |
171 | + 南北方向に 512、計 768 x 512 = 393,216個のセルが地球表面上に存在します。 | |
172 | + </para> | |
173 | + <para> | |
174 | + autocoast では、セルのX座標(東西方向)、Y座標(南北方向)の範囲を指定することで、 | |
175 | + 生成するシーナリの範囲を決定します。 | |
176 | + </para> | |
177 | + | |
178 | + | |
179 | + <para> | |
180 | + なお、セルの X / Y 座標は以下の式で求められます。 | |
181 | + </para> | |
182 | + <itemizedlist> | |
183 | + <listitem> | |
184 | + <para>X = (東経 + 180) / 360 x 768</para> | |
185 | + </listitem> | |
186 | + <listitem> | |
187 | + <para>Y = (90 - 北緯) / 180 x 512</para> | |
188 | + </listitem> | |
189 | + </itemizedlist> | |
190 | + <para> | |
191 | + 自分で計算するのが面倒な場合は、Coast Line Maker などのツールに計算機がついているので | |
192 | + それを使うとよいでしょう。 | |
193 | + </para> | |
194 | + | |
195 | + <para> | |
196 | + 例を示します。 | |
197 | + </para> | |
198 | + | |
199 | + <programlisting> | |
200 | + autocoast 675 156 676 158 | |
201 | + </programlisting> | |
202 | + | |
203 | + <para> | |
204 | + オプションには以下のものを使用することができます。 | |
205 | + </para> | |
206 | + | |
207 | + <sect3> | |
208 | + <title>-d : 緯度/経度指定</title> | |
209 | + <para> | |
210 | + -d オプションを指定すると、セル番号の代わりに緯度/経度をそのまま指定することが | |
211 | + できます。この場合、引数には最小経度、最大緯度、最大経度、最小緯度の順に指定します。 | |
212 | + </para> | |
213 | + </sect3> | |
214 | + | |
215 | + <sect3> | |
216 | + <title>-l : 地表エリアの幅指定</title> | |
217 | + <para> | |
218 | + 海岸線の内側の一定幅のエリアを陸地ポリゴンで埋めます。 | |
219 | + このオプションは、海岸線内部に予期しない水面ができてしまったときに使用します。 | |
220 | + </para> | |
221 | + <para> | |
222 | + 1つのセルは 32 x 32 個のエリアからなっています。 | |
223 | + 海岸線の内側に向かって、-l オプションで指定した距離のエリアまでを | |
224 | + 陸地ポリゴンで埋めます。デフォルト値は2になっています。 | |
225 | + </para> | |
226 | + </sect3> | |
227 | + | |
228 | + <sect3> | |
229 | + <title>-t : VTP テクスチャ名の指定</title> | |
230 | + <para> | |
231 | + 海岸線を描画するときに使用する VTP ポリゴンのテクスチャ名を指定します。 | |
232 | + </para> | |
233 | + <para> | |
234 | + デフォルト値は "1029" です。これは波効果のある砂浜のテクスチャです。 | |
235 | + </para> | |
236 | + </sect3> | |
237 | + | |
238 | + <sect3> | |
239 | + <title>-w : VTP テクスチャ幅の指定</title> | |
240 | + <para> | |
241 | + 海岸線を描画するときに使用する VTP ポリゴンのテクスチャの幅をメートル単位で指定します。 | |
242 | + </para> | |
243 | + <para> | |
244 | + デフォルト値は 80m です。 | |
245 | + </para> | |
246 | + </sect3> | |
247 | + | |
248 | + <sect3> | |
249 | + <title>使用例</title> | |
250 | + <para> | |
251 | + 例を示します。 | |
252 | + </para> | |
253 | + <programlisting> | |
254 | + autocoast -l 1 -t 1032 -w 50 -d 135 55 155 30 | |
255 | + </programlisting> | |
256 | + </sect3> | |
257 | + </sect2> | |
258 | + | |
259 | + <sect2> | |
260 | + <title>コンパイルして BGL ファイルを生成する</title> | |
261 | + <para> | |
262 | + autocoast は、シーナリデータを lwm_*.asm と vtp_*.asm の2つのファイル出力します。 | |
263 | + これは、BGL Compiler のソースファイルなので、コンパイルしてやらなければなりません。 | |
264 | + コンパイルを行うには compile.bat ファイルを実行します。このファイルは自動的に生成 | |
265 | + されています。 | |
266 | + </para> | |
267 | + <programlisting> | |
268 | + compile.bat | |
269 | + </programlisting> | |
270 | + <para> | |
271 | + これで、lwm_*.bgl と vtp_*.bgl の2つのファイルが生成されます。 | |
272 | + これを Flight Simulator のシーナリデータベースに登録すれば、シーナリが表示されます。 | |
273 | + </para> | |
274 | + </sect2> | |
275 | + </sect1> | |
276 | + | |
277 | + <appendix id="restrictions"> | |
278 | + <title>制限事項</title> | |
279 | + <para> | |
280 | + 本バージョンはβ版のため、動作上問題があることがあります。 | |
281 | + </para> | |
282 | + <para> | |
283 | + 一部、陸地が正しく生成されない箇所があります。これは Land Class が指定されていない | |
284 | + ためで、AutoCoast だけでは対処できません。 | |
285 | + </para> | |
286 | + </appendix> | |
287 | + | |
288 | + <appendix id="changelog"> | |
289 | + <title>改版履歴</title> | |
290 | + <programlisting> | |
291 | + 04/12/4: ver 0.3 | |
292 | + - バグ修正: 西半球におけるバグを修正 | |
293 | + | |
294 | + 04/11/27: ver 0.2 | |
295 | + - GshhsExtractor: | |
296 | + - -i/-n オプションを追加 | |
297 | + - ポリゴンの平滑化処理を追加 | |
298 | + - クリッピング速度を改善 | |
299 | + - 西半球におけるポリゴン処理を改善 | |
300 | + - AutoCoast | |
301 | + - -d/-l/-t/-w オプションを追加 | |
302 | + - LWM cell ID のアトリビュートを修正 | |
303 | + - バグ修正: LWMDataAreaDrawPolygonsEx | |
304 | + - バグ修正: VTP ポリゴン生成処理を修正 | |
305 | + | |
306 | + 04/11/11: ver 0.1 | |
307 | + - 初版 | |
308 | + </programlisting> | |
309 | + </appendix> | |
310 | + | |
311 | + <appendix id="license"> | |
312 | + <title>ライセンス</title> | |
313 | + <para> | |
314 | + 本ソフトウエアの利用条件は | |
315 | + <ulink url="http://www.opensource.org/licenses/bsd-license.php">BSD Licence</ulink> | |
316 | + に従います。 | |
317 | + </para> | |
318 | + | |
319 | + <para> | |
320 | + 本ソフトウェアは | |
321 | + <ulink url="http://www.cs.man.ac.uk/aig/staff/alan/software/">Generic Polygon Clipper</ulink> | |
322 | + ライブラリを用いており、このライブラリが商用利用を禁じているため、 | |
323 | + 本ソフトウェアも商用利用は禁止となります。 | |
324 | + (このため本ソフトウェアは、厳密にはフリーソフトウェアではありません。) | |
325 | + </para> | |
326 | + <para> | |
327 | + Generic Polygon Clipper の Copyright 表示は以下の通り。 | |
328 | + </para> | |
329 | + <programlisting> | |
330 | + Copyright: (C) 1997-1999, Advanced Interfaces Group, | |
331 | + University of Manchester. | |
332 | + | |
333 | + This software is free for non-commercial use. It may be copied, | |
334 | + modified, and redistributed provided that this copyright notice | |
335 | + is preserved on all copies. The intellectual property rights of | |
336 | + the algorithms used reside with the University of Manchester | |
337 | + Advanced Interfaces Group. | |
338 | + | |
339 | + You may not use this software, in whole or in part, in support | |
340 | + of any commercial product without the express consent of the | |
341 | + author. | |
342 | + | |
343 | + There is no warranty or other guarantee of fitness of this | |
344 | + software for any purpose. It is provided solely "as is". | |
345 | + </programlisting> | |
346 | + <para> | |
347 | + なお、本ソフトウェアを使って生成したデータには、上記ライセンスは一切影響しません。 | |
348 | + </para> | |
349 | + </appendix> | |
350 | + | |
351 | + <appendix id="source"> | |
352 | + <title>ソースコード</title> | |
353 | + <para> | |
354 | + ソースコードは、<ulink url="http://sourceforge.jp/projects/autocoast/">http://sourceforge.jp/projects/autocoast/</ulink> から CVS 経由で入手できます。 | |
355 | + </para> | |
356 | + </appendix> | |
357 | + | |
358 | + <appendix id="acknowledgements"> | |
359 | + <title>謝辞</title> | |
360 | + <para> | |
361 | + GSHHS のデータを作成/公開されている Paul Wessel、Walter H. F. Smith 両氏に感謝します。 | |
362 | + </para> | |
363 | + <para> | |
364 | + AutoCoast は、Alan Murta 氏作成の <ulink url="http://www.cs.man.ac.uk/aig/staff/alan/software/">Generic Polygon Clipper</ulink> を使用しています。 | |
365 | + </para> | |
366 | + <para> | |
367 | + Richard Ludowise 氏作 の TDFMacros.inc と TDFHeaders.inc を使用しています。 | |
368 | + </para> | |
369 | + <para> | |
370 | + <ulink url="http://flightinfo.ens.ne.jp/pja/cgi-bin/desboard.cgi">シーナリデザイン会議室</ulink>にて助言をくださったすべての方に感謝します。 | |
371 | + </para> | |
372 | + </appendix> | |
373 | + | |
374 | + <appendix id="contact"> | |
375 | + <title>連絡先</title> | |
376 | + <itemizedlist> | |
377 | + <listitem> | |
378 | + <para><ulink url="http://autocoast.sourceforge.jp">http://autocoast.sourceforge.jp</ulink></para> | |
379 | + </listitem> | |
380 | + <listitem> | |
381 | + <para><ulink url="http://flightinfo.ens.ne.jp/tmurakam/">http://flightinfo.ens.ne.jp/tmurakam/</ulink></para> | |
382 | + </listitem> | |
383 | + </itemizedlist> | |
384 | + </appendix> | |
385 | +</article> |
@@ -0,0 +1,348 @@ | ||
1 | +<?xml version="1.0" encoding="EUC-JP"?> | |
2 | + | |
3 | +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | |
4 | + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ | |
5 | + | |
6 | +]> | |
7 | + | |
8 | +<article lang="en"> | |
9 | + <articleinfo> | |
10 | + <title>AutoCoast Manual</title> | |
11 | + <author lang="en"> | |
12 | + <surname>Muakami</surname> | |
13 | + <firstname>Takuya</firstname> | |
14 | + <affiliation> | |
15 | + <address> | |
16 | + <email>tmurakam at users.sourceforge.jp</email> | |
17 | + </address> | |
18 | + </affiliation> | |
19 | + </author> | |
20 | + | |
21 | + <pubdate>4 December 2004</pubdate> | |
22 | + | |
23 | + <revhistory> | |
24 | + <revision> | |
25 | + <revnumber>1.1</revnumber> | |
26 | + <date>2004-12-4</date> | |
27 | + <revremark>AutoCoast ver 0.3</revremark> | |
28 | + </revision> | |
29 | + <revision> | |
30 | + <revnumber>1.0</revnumber> | |
31 | + <date>2004-11-27</date> | |
32 | + <revremark>Initial release</revremark> | |
33 | + </revision> | |
34 | + </revhistory> | |
35 | + </articleinfo> | |
36 | + | |
37 | + <sect1 id="intro"> | |
38 | + <title>Introduction</title> | |
39 | + <para> | |
40 | + AutoCoast is a tool to automatically generate shore line scenery. | |
41 | + </para> | |
42 | + <para> | |
43 | + AutoCoast generates scenery with | |
44 | + <ulink url="http://www.soest.hawaii.edu/wessel/gshhs/gshhs.html">GSHHS (Global Self-consistant Hierarchical High-resolution Shorelines)</ulink> | |
45 | + data. | |
46 | + </para> | |
47 | + </sect1> | |
48 | + | |
49 | + <sect1 id="install"> | |
50 | + <title>Installation</title> | |
51 | + | |
52 | + <sect2> | |
53 | + <title>Requirements</title> | |
54 | + <para> | |
55 | + You needs followings: | |
56 | + </para> | |
57 | + <itemizedlist> | |
58 | + <listitem> | |
59 | + <para> | |
60 | + GSHHS Data: Get gshhs_1.3.zip file from | |
61 | + <ulink url="http://www.soest.hawaii.edu/wessel/gshhs/gshhs.html">here.</ulink> | |
62 | + </para> | |
63 | + </listitem> | |
64 | + <listitem> | |
65 | + <para> | |
66 | + BGL Compiler : You need BGL Compiler (BGLC.EXE) in | |
67 | + <ulink url="http://www.microsoft.com/games/flightsimulator/fs2002_downloads_sdk.asp"> | |
68 | + FS2002 SDK</ulink> | |
69 | + </para> | |
70 | + <note> | |
71 | + <para>Not FS2004 SDK!</para> | |
72 | + </note> | |
73 | + </listitem> | |
74 | + </itemizedlist> | |
75 | + </sect2> | |
76 | + | |
77 | + <sect2> | |
78 | + <title>Installation</title> | |
79 | + <para> | |
80 | + Expand all files in AutoCoast zip file and copy to some folder. | |
81 | + </para> | |
82 | + <para> | |
83 | + Next, place all GSHHS data and BGLC.EXE into the same folder. | |
84 | + </para> | |
85 | + </sect2> | |
86 | + </sect1> | |
87 | + | |
88 | + <sect1 id="usage"> | |
89 | + <title>Usage</title> | |
90 | + | |
91 | + <sect2> | |
92 | + <title>Extract data from GSHHS dat file</title> | |
93 | + <para> | |
94 | + GSHHS data is very huge, so you must extract necessary data from data file. | |
95 | + </para> | |
96 | + <para> | |
97 | + Start command prompt, then change directory (folder): | |
98 | + </para> | |
99 | + <programlisting> | |
100 | + cd <replaceable>folder name in which AutoCoast is installed</replaceable> | |
101 | + </programlisting> | |
102 | + <para> | |
103 | + Next, extract data with GshhsExtractor tool: | |
104 | + </para> | |
105 | + <programlisting> | |
106 | + GshhsExtractor <replaceable>[options] GSHHS_data_file_name min_longitude max_longitude min_latitude max_latitude</replaceable> | |
107 | + </programlisting> | |
108 | + <para> | |
109 | + There are 4 types of GSHHS data files. You should use 'gshhs_f.b' file which is | |
110 | + most detailed one. | |
111 | + </para> | |
112 | + <para> | |
113 | + Exsample: To extract data around Japan, type 'GshhsExtractor gshhs_f.b 125 150 25 50'. | |
114 | + </para> | |
115 | + <para> | |
116 | + You can use minus value for west/south hemisphere. | |
117 | + </para> | |
118 | + <caution> | |
119 | + <para>You can't extract data crossing greenwich.</para> | |
120 | + </caution> | |
121 | + | |
122 | + <para> | |
123 | + You can specify some options (usually, you don't need them): | |
124 | + </para> | |
125 | + | |
126 | + <sect3> | |
127 | + <title>-n : Suppress polygon smoothing</title> | |
128 | + <para> | |
129 | + By default, GshhsExtractor smoothes shoreline polygon, because | |
130 | + GSHHS shore lines are a bit 'rough'. | |
131 | + </para> | |
132 | + <para> | |
133 | + To suppress this, specify '-n'. | |
134 | + </para> | |
135 | + </sect3> | |
136 | + | |
137 | + <sect3> | |
138 | + <title>-i : Exclude some polygons</title> | |
139 | + <para> | |
140 | + You can 'exclude' some GSHHS polygons to speed up processing | |
141 | + by specifying the maximun number of | |
142 | + the polygon. For example, you can exclude No.0 polygon (Eurasia) with '-i 0' option. | |
143 | + </para> | |
144 | + </sect3> | |
145 | + | |
146 | + </sect2> | |
147 | + | |
148 | + <sect2> | |
149 | + <title>Generate scenery data</title> | |
150 | + <para> | |
151 | + Generate scenery data with AutoCoast tools: | |
152 | + </para> | |
153 | + | |
154 | + <programlisting> | |
155 | + autocoast <replaceable>[options] min_x min_y max_x max_y</replaceable> | |
156 | + </programlisting> | |
157 | + | |
158 | + <para> | |
159 | + You must specify 'cell' range. | |
160 | + Cell is a unit of coast line scenery. There are 768 x 512 = 393,216 cells | |
161 | + on the surface of the globe. | |
162 | + </para> | |
163 | + | |
164 | + <para> | |
165 | + You can calculate cell coordinates with following expressions: | |
166 | + </para> | |
167 | + <itemizedlist> | |
168 | + <listitem> | |
169 | + <para>X = ([East longigude] + 180) / 360 x 768</para> | |
170 | + </listitem> | |
171 | + <listitem> | |
172 | + <para>Y = (90 - [North latitude]) / 180 x 512</para> | |
173 | + </listitem> | |
174 | + </itemizedlist> | |
175 | + <para> | |
176 | + You can use the calculator with Coast Line Maker. | |
177 | + </para> | |
178 | + | |
179 | + <para> | |
180 | + Example: | |
181 | + </para> | |
182 | + | |
183 | + <programlisting> | |
184 | + autocoast 675 156 676 158 | |
185 | + </programlisting> | |
186 | + | |
187 | + <para> | |
188 | + You can specify following options: | |
189 | + </para> | |
190 | + | |
191 | + <sect3> | |
192 | + <title>-d : Specify latitude/longitude in degree</title> | |
193 | + <para> | |
194 | + You can specify latitude/longitude in degree instead of cell coordinates. | |
195 | + </para> | |
196 | + </sect3> | |
197 | + | |
198 | + <sect3> | |
199 | + <title>-l : Specify width of land area</title> | |
200 | + <para> | |
201 | + This option tells the autocoast tool to fill some areas within each coast line. | |
202 | + You should this option when you see unexpected 'water' within land. | |
203 | + </para> | |
204 | + <para> | |
205 | + A cell contains 32 x 32 areas. | |
206 | + Specify 'width' of land area along shore line. | |
207 | + Default value is 1. | |
208 | + </para> | |
209 | + </sect3> | |
210 | + | |
211 | + <sect3> | |
212 | + <title>-t : VTP texture name</title> | |
213 | + <para> | |
214 | + Specify VTP polygon texture name to draw shore line polygon. | |
215 | + </para> | |
216 | + <para> | |
217 | + Default value is "1029" (Sandy beach with wave effect). | |
218 | + </para> | |
219 | + </sect3> | |
220 | + | |
221 | + <sect3> | |
222 | + <title>-w : VTP texture width</title> | |
223 | + <para> | |
224 | + Specify VTP polygon width in meters. | |
225 | + </para> | |
226 | + <para> | |
227 | + Default value is 80. | |
228 | + </para> | |
229 | + </sect3> | |
230 | + | |
231 | + <sect3> | |
232 | + <title>Example</title> | |
233 | + <programlisting> | |
234 | + autocoast -l 1 -t 1032 -w 50 -d 135 55 155 30 | |
235 | + </programlisting> | |
236 | + </sect3> | |
237 | + </sect2> | |
238 | + | |
239 | + <sect2> | |
240 | + <title>Compilation</title> | |
241 | + <para> | |
242 | + To generate BGL file, you must compile the generated *.asm file. | |
243 | + Execute compile.bat: | |
244 | + </para> | |
245 | + <programlisting> | |
246 | + compile.bat | |
247 | + </programlisting> | |
248 | + </sect2> | |
249 | + </sect1> | |
250 | + | |
251 | + <appendix id="restrictions"> | |
252 | + <title>Restrictions</title> | |
253 | + <para> | |
254 | + This version is beta release. | |
255 | + </para> | |
256 | + <para> | |
257 | + Sometimes, some land ares are not drawed because land class is not specified for the area. | |
258 | + In this case, you must create land class scenery. | |
259 | + </para> | |
260 | + </appendix> | |
261 | + | |
262 | + <appendix id="changelog"> | |
263 | + <title>Change logs</title> | |
264 | + <programlisting> | |
265 | + 04/12/3: ver 0.3 | |
266 | + - AutoCoast: Bug fixed for west hemisphere. | |
267 | + | |
268 | + 04/11/24: ver 0.2 | |
269 | + - GshhsExtractor: | |
270 | + - Add -i/-n options. | |
271 | + - Execute polygon smoothing. | |
272 | + - Improve clipping speed. | |
273 | + - Fix polygon process for west hemisphere. | |
274 | + - AutoCoast | |
275 | + - Add -d/-l/-t/-w options. | |
276 | + - Bug fix: LWMDataAreaDrawPolygonsEx. | |
277 | + - Fix attribute of LWM cell ID. | |
278 | + | |
279 | + 04/11/11: ver 0.1 | |
280 | + - Initial release | |
281 | + </programlisting> | |
282 | + </appendix> | |
283 | + | |
284 | + <appendix id="license"> | |
285 | + <title>License</title> | |
286 | + <para> | |
287 | + This software is distributed with <ulink url="http://www.opensource.org/licenses/bsd-license.php">BSD Licence</ulink>. | |
288 | + </para> | |
289 | + | |
290 | + <para> | |
291 | + Note: This software uses | |
292 | + <ulink url="http://www.cs.man.ac.uk/aig/staff/alan/software/">Generic Polygon Clipper</ulink> | |
293 | + , and the library does not allow commercial use. Copyright notice of the library is following: | |
294 | + </para> | |
295 | + <programlisting> | |
296 | + Copyright: (C) 1997-1999, Advanced Interfaces Group, | |
297 | + University of Manchester. | |
298 | + | |
299 | + This software is free for non-commercial use. It may be copied, | |
300 | + modified, and redistributed provided that this copyright notice | |
301 | + is preserved on all copies. The intellectual property rights of | |
302 | + the algorithms used reside with the University of Manchester | |
303 | + Advanced Interfaces Group. | |
304 | + | |
305 | + You may not use this software, in whole or in part, in support | |
306 | + of any commercial product without the express consent of the | |
307 | + author. | |
308 | + | |
309 | + There is no warranty or other guarantee of fitness of this | |
310 | + software for any purpose. It is provided solely "as is". | |
311 | + </programlisting> | |
312 | + </appendix> | |
313 | + | |
314 | + <appendix id="source"> | |
315 | + <title>Get the source code</title> | |
316 | + <para> | |
317 | + You can obtain source code wich CVS from <ulink url="http://sourceforge.jp/projects/autocoast/">http://sourceforge.jp/projects/autocoast/</ulink>. | |
318 | + </para> | |
319 | + </appendix> | |
320 | + | |
321 | + <appendix id="acknowledgements"> | |
322 | + <title>Acknowledgements</title> | |
323 | + <para> | |
324 | + Thanks to GSHHS data maintainer: Paul Wesse, Walter H. F. Smith. | |
325 | + </para> | |
326 | + <para> | |
327 | + AutoCoast uses <ulink url="http://www.cs.man.ac.uk/aig/staff/alan/software/">Generic Polygon Clipper</ulink> by Alan Murta. | |
328 | + </para> | |
329 | + <para> | |
330 | + AutoCoast uses TDFMacros.inc and TDFHeaders.inc by Richard Ludowise. | |
331 | + </para> | |
332 | + <para> | |
333 | + Thaks to all participants at <ulink url="http://flightinfo.ens.ne.jp/pja/cgi-bin/desboard.cgi">Scenery Design Forum</ulink>. | |
334 | + </para> | |
335 | + </appendix> | |
336 | + | |
337 | + <appendix id="contact"> | |
338 | + <title>Contact info</title> | |
339 | + <itemizedlist> | |
340 | + <listitem> | |
341 | + <para><ulink url="http://autocoast.sourceforge.jp">http://autocoast.sourceforge.jp</ulink></para> | |
342 | + </listitem> | |
343 | + <listitem> | |
344 | + <para><ulink url="http://flightinfo.ens.ne.jp/tmurakam/">http://flightinfo.ens.ne.jp/tmurakam/</ulink></para> | |
345 | + </listitem> | |
346 | + </itemizedlist> | |
347 | + </appendix> | |
348 | +</article> |
@@ -0,0 +1,34 @@ | ||
1 | +XSLFILE = ../xsl/main-html.xsl | |
2 | +TEX_XSLFILE = ../xsl/db2latex.xsl | |
3 | + | |
4 | +all: html | |
5 | + | |
6 | +html: html-en html-ja | |
7 | + | |
8 | +html-ja: manual-ja.xml | |
9 | + xmlto -vv html -x $(XSLFILE) -o manual-ja manual-ja.xml | |
10 | + mkdir -p manual-ja/images | |
11 | + cp ../css/style.css manual-ja | |
12 | + -cp /usr/share/sgml/docbook/xsl-stylesheets/images/*.png manual-ja/images | |
13 | + | |
14 | +html-en: manual-en.xml | |
15 | + xmlto -vv html -x $(XSLFILE) -o manual-en manual-en.xml | |
16 | + mkdir -p manual-en/images | |
17 | + cp ../css/style.css manual-en | |
18 | + -cp /usr/share/sgml/docbook/xsl-stylesheets/images/*.png manual-en/images | |
19 | + | |
20 | +pdf: manual-ja.xml | |
21 | + xsltproc -o manual-ja.tex $(TEX_XSLFILE) $(XMLFILE) | |
22 | + -platex manual-ja.tex | |
23 | + pdvips -o manual-ja.ps manual-ja.dvi | |
24 | + ps2pdf manual-ja.ps | |
25 | +# xmlto pdf -x ../xsl/main-pdf.xsl $(XMLFILE) | |
26 | + | |
27 | +clean: | |
28 | + -/bin/rm -rf *.html *.tex *.dvi *.ps *.pdf *.aux *.log manual-ja | |
29 | + | |
30 | +upload: html | |
31 | + rsync -auvz --delete -e ssh ./manual-ja/ \ | |
32 | + shell.sourceforge.jp:/home/groups/a/au/autocoast/htdocs/docs/manual-ja/ | |
33 | + rsync -auvz --delete -e ssh ./manual-en/ \ | |
34 | + shell.sourceforge.jp:/home/groups/a/au/autocoast/htdocs/docs/manual-en/ |
@@ -0,0 +1,110 @@ | ||
1 | +<?xml version='1.0'?> | |
2 | +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" | |
3 | + xmlns="http://www.w3.org/1999/xhtml" | |
4 | + version='1.0' | |
5 | + exclude-result-prefixes="#default" | |
6 | +> | |
7 | + | |
8 | +<!-- set encoding --> | |
9 | +<xsl:param name="chunker.output.encoding" select="'EUC-JP'"/> | |
10 | + | |
11 | +<!-- indentation --> | |
12 | +<xsl:param name="chunker.output.indent" select="'yes'"/> | |
13 | + | |
14 | +<!-- Create a link to a CSS stylesheet named 'style.css' in all html | |
15 | + output so that pages can be beautified. Browsers not supporting | |
16 | + CSS should safely ignore the link. --> | |
17 | +<xsl:param name="html.stylesheet" select="'style.css'"/> | |
18 | + | |
19 | +<!-- Should graphics be used for admonitions (notes, warnings)? 0 or 1 --> | |
20 | +<xsl:param name="admon.graphics" select="1"/> | |
21 | + | |
22 | +<!-- If using admon graphics (1 above), what is path to graphics? --> | |
23 | +<xsl:param name="admon.graphics.path">images/</xsl:param> | |
24 | + | |
25 | +<!-- Note: the default extension for graphics is .png unless the | |
26 | + following line is uncommented and .ext is replaced with the | |
27 | + desired extension. --> | |
28 | +<!-- <xsl:param name="graphic.default.extension" select="'.ext'"/> --> | |
29 | + | |
30 | +<!-- Make funcsynopsis look pretty --> | |
31 | +<xsl:param name="funcsynopsis.decoration" select="1"/> | |
32 | + | |
33 | +<!-- Extension for HTML files --> | |
34 | +<xsl:param name="html.ext" select="'.html'"/> | |
35 | + | |
36 | +<!-- Generate TOCs for book, article, part --> | |
37 | +<xsl:param name="generate.book.toc" select="1"/> | |
38 | +<xsl:param name="generate.article.toc" select="1"/> | |
39 | +<xsl:param name="generate.part.toc" select="1"/> | |
40 | + | |
41 | +<!-- generate-book-titlepage --> | |
42 | + | |
43 | +<!-- generate-article-titlepage --> | |
44 | + | |
45 | +<!-- Equivalent to chunk-skip-first-element-list - forces TOC on separate page | |
46 | + If 0, first sect is on page for chapter or article --> | |
47 | +<xsl:param name="chunk.first.sections" select="'1'"/> | |
48 | + | |
49 | +<!-- NOT IN LDP.DSL --> | |
50 | +<!-- Create chunks for top-level sections. If 0, chunks will only be | |
51 | + created for chapters/appendixes, and NOT for sectx elements --> | |
52 | +<!-- | |
53 | +not supported | |
54 | +<xsl:param name="chunk.sections" select="'1'"/> | |
55 | +--> | |
56 | + | |
57 | +<!-- list-element-list - NO LONGER NEEDED - bug fix --> | |
58 | + | |
59 | +<!-- When chunking, use id attribute as filename? 0 or 1 --> | |
60 | +<xsl:param name="use.id.as.filename" select="1"/> | |
61 | + | |
62 | +<!-- Should chapters be labeled? 0 or 1 --> | |
63 | +<xsl:param name="chapter.autolabel" select="1"/> | |
64 | + | |
65 | +<!-- Should sections be labeled? 0 or 1 --> | |
66 | +<xsl:param name="section.autolabel" select="1"/> | |
67 | + | |
68 | +<!-- Related to section labels, should those labels include the chapter | |
69 | + number in them (i.e., 1.1, 1.2, 1.3, 1.4 )--> | |
70 | +<xsl:param name="section.label.includes.component.label" select="1"/> | |
71 | + | |
72 | +<!-- To what depth (in sections) should the TOC go? --> | |
73 | +<xsl:param name="toc.section.depth" select="3"/> | |
74 | + | |
75 | +<!-- Custom 'emphasis' template to allow 'role="strong"' to | |
76 | + also produce a bold item. --> | |
77 | +<xsl:template match="emphasis"> | |
78 | + <xsl:choose> | |
79 | + <xsl:when test="(@role='strong') or (@role='bold')"> | |
80 | + <xsl:call-template name="inline.boldseq"/> | |
81 | + </xsl:when> | |
82 | + <xsl:otherwise> | |
83 | + <xsl:call-template name="inline.italicseq"/> | |
84 | + </xsl:otherwise> | |
85 | + </xsl:choose> | |
86 | +</xsl:template> | |
87 | + | |
88 | +<!-- book-titlepage-recto-elements | |
89 | + article-titlepage-recto-elements | |
90 | + article-titlepage-recto-mode | |
91 | + article-title | |
92 | + | |
93 | + - Customizing these elements (for instance, to list what is on the | |
94 | + title page) involves writing a layer for html/titlepage.templates.xml and the | |
95 | + other files html/titlepage.xsl and html/titlepage.templates.xsl - Norm | |
96 | + is doing something funky here and I haven't fully figured it out. --> | |
97 | + | |
98 | + | |
99 | +<!-- NOT IN LDP.DSL. Format Q and A labels. | |
100 | + Added by dcm 2003-05-19. --> | |
101 | + | |
102 | +<xsl:template match="question" mode="label.markup"> | |
103 | + <xsl:text>Q</xsl:text> | |
104 | +</xsl:template> | |
105 | + | |
106 | +<xsl:template match="answer" mode="label.markup"> | |
107 | + <xsl:text>A</xsl:text> | |
108 | +</xsl:template> | |
109 | + | |
110 | +</xsl:stylesheet> |
@@ -0,0 +1,12 @@ | ||
1 | +<?xml version='1.0'?> | |
2 | +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" | |
3 | + xmlns:exsl="http://exslt.org/common" | |
4 | + version="1.0" | |
5 | + exclude-result-prefixes="exsl"> | |
6 | + | |
7 | +<xsl:import href="/usr/share/sgml/docbook/xsl-stylesheets/html/chunk.xsl"/> | |
8 | +<xsl:include href="/usr/share/sgml/docbook/xsl-stylesheets/html/manifest.xsl"/> | |
9 | + | |
10 | +<xsl:include href="html-common.xsl"/> | |
11 | + | |
12 | +</xsl:stylesheet> |
@@ -0,0 +1,108 @@ | ||
1 | +/* | |
2 | + | |
3 | +CSS for Red Hat Linux Project docs from the Documentation Project | |
4 | + | |
5 | +Written by Tammy Fox and Garrett LeSage | |
6 | + | |
7 | +Copyright 2003 Tammy Fox, Garrett LeSage, and Red Hat, Inc. | |
8 | + | |
9 | +License: GPL | |
10 | + | |
11 | +*/ | |
12 | + | |
13 | +li p { | |
14 | + display: inline; | |
15 | +} | |
16 | + | |
17 | +div.table table { | |
18 | + width: 95%; | |
19 | + background-color: #DCDCDC; | |
20 | + color: #000000; | |
21 | + border-spacing: 0; | |
22 | +} | |
23 | + | |
24 | +div.table table th { | |
25 | + border: 1px solid #A9A9A9; | |
26 | + background-color: #A9A9A9; | |
27 | + color: #000000; | |
28 | +} | |
29 | + | |
30 | +div.table table td { | |
31 | + border: 1px solid #A9A9A9; | |
32 | + background-color: #DCDCDC; | |
33 | + color: #000000; | |
34 | + padding: 0.5em; | |
35 | + margin-bottom: 0.5em; | |
36 | + margin-top: 2px; | |
37 | + | |
38 | +} | |
39 | + | |
40 | +div.note table, div.tip table, div.important table, div.caution table, div.warning table { | |
41 | + width: 95%; | |
42 | + border: 2px solid #B0C4DE; | |
43 | + background-color: #F0F8FF; | |
44 | + color: #000000; | |
45 | + /* padding inside table area */ | |
46 | + padding: 0.5em; | |
47 | + margin-bottom: 0.5em; | |
48 | + margin-top: 0.5em; | |
49 | +} | |
50 | + | |
51 | +.qandaset table { | |
52 | + border-collapse: collapse; | |
53 | +} | |
54 | +.qandaset { | |
55 | +} | |
56 | +.qandaset tr.question { | |
57 | +} | |
58 | +.qandaset tr.question td { | |
59 | + font-weight: bold; | |
60 | + padding: 1em 1em 0; | |
61 | +} | |
62 | +.qandaset tr.answer td { | |
63 | + padding: 0.25em 1em 1.5em; | |
64 | +} | |
65 | +.qandaset tr.question td, .qandaset tr.answer td { | |
66 | +} | |
67 | + | |
68 | +hr { | |
69 | + border: 0; | |
70 | + border-bottom: 1px solid #ccc; | |
71 | +} | |
72 | + | |
73 | +h1, h2, h3, h4 { | |
74 | + font-family: luxi sans,sans-serif; | |
75 | + color: #990000; | |
76 | + font-weight: bold; | |
77 | +} | |
78 | +h1 { | |
79 | + font-size: 1.75em; | |
80 | +} | |
81 | + | |
82 | +h2 { | |
83 | + font-size: 1.25em; | |
84 | +} | |
85 | + | |
86 | +h3 { | |
87 | + font-size: 1.1em; | |
88 | +} | |
89 | + | |
90 | +code.screen, pre.screen { | |
91 | + font-family: monospace; | |
92 | + font-size: 1em; | |
93 | + display: block; | |
94 | + padding: 10px; | |
95 | + border: 1px solid #bbb; | |
96 | + background-color: #eee; | |
97 | + color: #000; | |
98 | + overflow: auto; | |
99 | + border-radius: 2.5px; | |
100 | + -moz-border-radius: 2.5px; | |
101 | + margin: 0.5em 2em; | |
102 | +} | |
103 | + | |
104 | +div.example { | |
105 | + padding: 10px; | |
106 | + border: 1px solid #bbb; | |
107 | + margin: 0.5em 2em; | |
108 | +} |