OSDN -- Develop and Download Open Source Software
  • R/O
  • SSH
  • HTTPS

autocoast: Commit


Commit MetaInfo

Revision16 (tree)
Time2004-11-27 17:57:27
Authortmurakam

Log Message

updated

Change Summary

Incremental Difference

--- doc/trunk/manual/manual-en.xml (revision 15)
+++ doc/trunk/manual/manual-en.xml (revision 16)
@@ -30,42 +30,40 @@
3030 </articleinfo>
3131
3232 <sect1 id="intro">
33- <title>はじめに</title>
33+ <title>Introduction</title>
3434 <para>
35- AutoCoast は、海岸線のシーナリを自動生成するツールです。
35+ AutoCoast is a tool to automatically generate shore line scenery.
3636 </para>
3737 <para>
38- AutoCoast は
38+ AutoCoast generates scenery with
3939 <ulink url="http://www.soest.hawaii.edu/wessel/gshhs/gshhs.html">GSHHS (Global Self-consistant Hierarchical High-resolution Shorelines)</ulink>
40- を用いて海岸線を自動生成します。
40+ data.
4141 </para>
4242 </sect1>
4343
4444 <sect1 id="install">
45- <title>インストール</title>
45+ <title>Installation</title>
4646
4747 <sect2>
48- <title>必要環境</title>
48+ <title>Requirements</title>
4949 <para>
50- 以下のものが必要です。別途入手してください。
50+ You needs followings:
5151 </para>
5252 <itemizedlist>
5353 <listitem>
5454 <para>
55- GSHHS データ:
56- <ulink url="http://www.soest.hawaii.edu/wessel/gshhs/gshhs.html">こちら</ulink>
57- からGSHHS のデータを入手します。gshhs_1.3.zip ファイルです。
55+ GSHHS Data: Get gshhs_1.3.zip file from
56+ <ulink url="http://www.soest.hawaii.edu/wessel/gshhs/gshhs.html">here.</ulink>
5857 </para>
5958 </listitem>
6059 <listitem>
6160 <para>
62- BGL Compiler :
61+ BGL Compiler : You need BGL Compiler (BGLC.EXE) in
6362 <ulink url="http://www.microsoft.com/games/flightsimulator/fs2002_downloads_sdk.asp">
6463 FS2002 SDK</ulink>
65- の BGL Compiler (BGLC.EXE) が必要です。
6664 </para>
6765 <note>
68- <para>FS2004 SDK ではありません</para>
66+ <para>Not FS2004 SDK!</para>
6967 </note>
7068 </listitem>
7169 </itemizedlist>
@@ -72,76 +70,69 @@
7270 </sect2>
7371
7472 <sect2>
75- <title>インストール手順</title>
73+ <title>Installation</title>
7674 <para>
77- AutoCoast のファイルを展開して、適当なフォルダに展開してください。
75+ Expand all files in AutoCoast zip file and copy to some folder.
7876 </para>
7977 <para>
80- ついで、GSHHS のデータファイルも展開します。これも上記と同じフォルダに置いてください。
81- また、BGL Compiler のプログラムファイル (BGLC.EXE) も同じフォルダに置いてください。
78+ Next, place all GSHHS data and BGLC.EXE into the same folder.
8279 </para>
8380 </sect2>
8481 </sect1>
8582
8683 <sect1 id="usage">
87- <title>使用方法</title>
84+ <title>Usage</title>
8885
8986 <sect2>
90- <title>GSHHS データファイルから必要なデータを抜き出す</title>
87+ <title>Extract data from GSHHS dat file</title>
9188 <para>
92- GSHHS のデータには全世界の海岸線データが入っているので、非常にサイズが大きく
93- このままでは処理に時間がかかります。そこで、必要なデータだけを抜き出します。
89+ GSHHS data is very huge, so you must extract necessary data from data file.
9490 </para>
9591 <para>
96- AutoCoast のツールはすべてコマンドプロンプトから起動します。
97- 「すべてのプログラム」→「アクセサリ」→「コマンドプロンプト」を開き、以下のように
98- 入力してフォルダを移動します。
92+ Start command prompt, then change directory (folder):
9993 </para>
10094 <programlisting>
101- cd <replaceable>AutoCoastをインストールしたフォルダ名</replaceable>
95+ cd <replaceable>folder name in which AutoCoast is installed</replaceable>
10296 </programlisting>
10397 <para>
104- ついで、GshhsExtractor ツールを使ってデータを抜き出します。
98+ Next, extract data with GshhsExtractor tool:
10599 </para>
106100 <programlisting>
107- GshhsExtractor <replaceable>[オプション] GSHHSデータファイル名 最小経度 最大経度 最小緯度 最大緯度</replaceable>
101+ GshhsExtractor <replaceable>[options] GSHHS_data_file_name min_longitude max_longitude min_latitude max_latitude</replaceable>
108102 </programlisting>
109103 <para>
110- GSHHS データファイルには何種類かありますが、もっとも精細なデータを使うなら
111- 'gshhs_f.b' ファイルを指定してください。緯度/経度は度単位で入力してください。
104+ There are 4 types of GSHHS data files. You should use 'gshhs_f.b' file which is
105+ most detailed one.
112106 </para>
113107 <para>
114- 例: 日本周辺のデータを取り出すときは、'GshhsExtractor gshhs_f.b 125 150 25 50' と
115- します。
108+ Exsample: To extract data around Japan, type 'GshhsExtractor gshhs_f.b 125 150 25 50'.
116109 </para>
117110
118111 <caution>
119- <para>グリニッジ子午線をまたいでデータを取り出すことはできません。</para>
112+ <para>You can't extract data crossing greenwich.</para>
120113 </caution>
121114
122115 <para>
123- この他、オプションをいくつか指定することができます（通常は指定する必要はありません）。
116+ You can specify some options (usually, you don't need them):
124117 </para>
125118
126119 <sect3>
127- <title>-n : スムージングの抑止</title>
120+ <title>-n : Suppress polygon smoothing</title>
128121 <para>
129- GSHHS の海岸線データは、かなりがたつきがあるためそのままシーナリにすると
130- あまり見栄えがよくありません。
131- このため、GsshsExtractor は海岸線データをスムージング(平滑化)するように
132- なっています。
122+ By default, GshhsExtractor smoothes shoreline polygon, because
123+ GSHHS shore lines are a bit 'rough'.
133124 </para>
134125 <para>
135- -n オプションをつけると、このスムージング処理を行わないようにすることができます。
126+ To suppress this, specify '-n'.
136127 </para>
137128 </sect3>
138129
139130 <sect3>
140- <title>-i : 特定ポリゴンの除外</title>
131+ <title>-i : Exclude some polygons</title>
141132 <para>
142- 海岸線データの処理にはかなりの時間がかかることがあります(数十分〜数時間）。
143- もし、ユーラシア大陸のデータが不要ならば、'-i 0' のようにオプションをつけることで、
144- 0 番ポリゴン(ユーラシア大陸のポリゴン)を除外するとかなり高速化されます。
133+ You can 'exclude' some GSHHS polygons to speed up processing
134+ by specifying the maximun number of
135+ the polygon. For example, you can exclude No.0 polygon (Eurasia) with '-i 0' option.
145136 </para>
146137 </sect3>
147138
@@ -148,45 +139,38 @@
148139 </sect2>
149140
150141 <sect2>
151- <title>シーナリデータファイルを生成する</title>
142+ <title>Generate scenery data</title>
152143 <para>
153- シーナリデータファイルを生成します。これには autocoast ツールを使います。
154- 使い方は以下の通り。
144+ Generate scenery data with AutoCoast tools:
155145 </para>
156146
157147 <programlisting>
158- autocoast <replaceable>[オプション] min_x min_y max_x max_y</replaceable>
148+ autocoast <replaceable>[options] min_x min_y max_x max_y</replaceable>
159149 </programlisting>
160150
161151 <para>
162- 引数を使って、シーナリを生成する「セル」の範囲を決めます。
163- 「セル」は海岸線シーナリで使われるエリアの単位で、全世界の東西方向に 768、
164- 南北方向に 512、計 768 x 512 = 393,216個のセルが地球表面上に存在します。
152+ You must specify 'cell' range.
153+ Cell is a unit of coast line scenery. There are 768 x 512 = 393,216 cells
154+ on the surface of the globe.
165155 </para>
166- <para>
167- autocoast では、セルのX座標(東西方向)、Y座標(南北方向)の範囲を指定することで、
168- 生成するシーナリの範囲を決定します。
169- </para>
170156
171-
172157 <para>
173- なお、セルの X / Y 座標は以下の式で求められます。
158+ You can calculate cell coordinates with following expressions:
174159 </para>
175160 <itemizedlist>
176161 <listitem>
177- <para>X = (東経 + 180) / 360 x 768</para>
162+ <para>X = ([East longigude] + 180) / 360 x 768</para>
178163 </listitem>
179164 <listitem>
180- <para>Y = (90 - 北緯) / 180 x 512</para>
165+ <para>Y = (90 - [North latitude]) / 180 x 512</para>
181166 </listitem>
182167 </itemizedlist>
183168 <para>
184- 自分で計算するのが面倒な場合は、Coast Line Maker などのツールに計算機がついているので
185- それを使うとよいでしょう。
169+ You can use the calculator with Coast Line Maker.
186170 </para>
187171
188172 <para>
189- 例を示します。
173+ Example:
190174 </para>
191175
192176 <programlisting>
@@ -194,55 +178,51 @@
194178 </programlisting>
195179
196180 <para>
197- オプションには以下のものを使用することができます。
181+ You can specify following options:
198182 </para>
199183
200184 <sect3>
201- <title>-d : 緯度/経度指定</title>
185+ <title>-d : Specify latitude/longitude in degree</title>
202186 <para>
203- -d オプションを指定すると、セル番号の代わりに緯度/経度をそのまま指定することが
204- できます。この場合、引数には最小経度、最大緯度、最大経度、最小緯度の順に指定します。
187+ You can specify latitude/longitude in degree instead of cell coordinates.
205188 </para>
206189 </sect3>
207190
208191 <sect3>
209- <title>-l : 地表エリアの幅指定</title>
192+ <title>-l : Specify width of land area</title>
210193 <para>
211- 海岸線の内側の一定幅のエリアを陸地ポリゴンで埋めます。
212- このオプションは、海岸線内部に予期しない水面ができてしまったときに使用します。
194+ This option tells the autocoast tool to fill some areas within each coast line.
195+ You should this option when you see unexpected 'water' within land.
213196 </para>
214197 <para>
215- １つのセルは 32 x 32 個のエリアからなっています。
216- 海岸線の内側に向かって、-l オプションで指定した距離のエリアまでを
217- 陸地ポリゴンで埋めます。デフォルト値は２になっています。
198+ A cell contains 32 x 32 areas.
199+ Specify 'width' of land area along shore line.
200+ Default value is 1.
218201 </para>
219202 </sect3>
220203
221204 <sect3>
222- <title>-t : VTP テクスチャ名の指定</title>
205+ <title>-t : VTP texture name</title>
223206 <para>
224- 海岸線を描画するときに使用する VTP ポリゴンのテクスチャ名を指定します。
207+ Specify VTP polygon texture name to draw shore line polygon.
225208 </para>
226209 <para>
227- デフォルト値は "1029" です。これは波効果のある砂浜のテクスチャです。
210+ Default value is "1029" (Sandy beach with wave effect).
228211 </para>
229212 </sect3>
230213
231214 <sect3>
232- <title>-w : VTP テクスチャ幅の指定</title>
215+ <title>-w : VTP texture width</title>
233216 <para>
234- 海岸線を描画するときに使用する VTP ポリゴンのテクスチャの幅をメートル単位で指定します。
217+ Specify VTP polygon width in meters.
235218 </para>
236219 <para>
237- デフォルト値は 80m です。
220+ Default value is 80.
238221 </para>
239222 </sect3>
240223
241224 <sect3>
242- <title>使用例</title>
243- <para>
244- 例を示します。
245- </para>
225+ <title>Example</title>
246226 <programlisting>
247227 autocoast -l 1 -t 1032 -w 50 -d 135 55 155 30
248228 </programlisting>
@@ -250,72 +230,58 @@
250230 </sect2>
251231
252232 <sect2>
253- <title>コンパイルして BGL ファイルを生成する</title>
233+ <title>Compilation</title>
254234 <para>
255- autocoast は、シーナリデータを lwm_*.asm と vtp_*.asm の２つのファイル出力します。
256- これは、BGL Compiler のソースファイルなので、コンパイルしてやらなければなりません。
257- コンパイルを行うには compile.bat ファイルを実行します。このファイルは自動的に生成
258- されています。
235+ To generate BGL file, you must compile the generated *.asm file.
236+ Execute compile.bat:
259237 </para>
260238 <programlisting>
261239 compile.bat
262240 </programlisting>
263- <para>
264- これで、lwm_*.bgl と vtp_*.bgl の２つのファイルが生成されます。
265- これを Flight Simulator のシーナリデータベースに登録すれば、シーナリが表示されます。
266- </para>
267241 </sect2>
268242 </sect1>
269243
270244 <appendix id="restrictions">
271- <title>制限事項</title>
245+ <title>Restrictions</title>
272246 <para>
273- 本バージョンはβ版のため、動作上問題があることがあります。
247+ This version is beta release.
274248 </para>
275249 <para>
276- 一部、陸地が正しく生成されない箇所があります。これは Land Class が指定されていない
277- ためで、AutoCoast だけでは対処できません。
250+ Sometimes, some land ares are not drawed because land class is not specified for the area.
251+ In this case, you must create land class scenery.
278252 </para>
279253 </appendix>
280254
281255 <appendix id="changelog">
282- <title>改版履歴</title>
256+ <title>Change logs</title>
283257 <programlisting>
284- 04/11/27: ver 0.2
258+ 04/11/24: ver 0.2
285259 - GshhsExtractor:
286- - -i/-n オプションを追加
287- - ポリゴンの平滑化処理を追加
288- - クリッピング速度を改善
289- - 西半球におけるポリゴン処理を改善
260+ - Add -i/-n options.
261+ - Execute polygon smoothing.
262+ - Improve clipping speed.
263+ - Fix polygon process for west hemisphere.
290264 - AutoCoast
291- - -d/-l/-t/-w オプションを追加
292- - LWM cell ID のアトリビュートを修正
293- - バグ修正: LWMDataAreaDrawPolygonsEx
294- - バグ修正: VTP ポリゴン生成処理を修正
295-
296- 04/11/11: ver 0.1
297- - 初版
265+ - Add -d/-l/-t/-w options.
266+ - Bug fix: LWMDataAreaDrawPolygonsEx.
267+ - Fix attribute of LWM cell ID.
268+
269+ 04/11/11: ver 0.1
270+ - Initial release
298271 </programlisting>
299272 </appendix>
300273
301274 <appendix id="license">
302- <title>ライセンス</title>
275+ <title>License</title>
303276 <para>
304- 本ソフトウエアの利用条件は
305- <ulink url="http://www.opensource.org/licenses/bsd-license.php">BSD Licence</ulink>
306- に従います。
277+ This software is distributed with <ulink url="http://www.opensource.org/licenses/bsd-license.php">BSD Licence</ulink>.
307278 </para>
308279
309280 <para>
310- 本ソフトウェアは
281+ Note: This software uses
311282 <ulink url="http://www.cs.man.ac.uk/aig/staff/alan/software/">Generic Polygon Clipper</ulink>
312- ライブラリを用いており、このライブラリが商用利用を禁じているため、
313- 本ソフトウェアも商用利用は禁止となります。
314- (このため本ソフトウェアは、厳密にはフリーソフトウェアではありません。)
283+ , and the library does not allow commercial use. Copyright notice of the library is following:
315284 </para>
316- <para>
317- Generic Polygon Clipper の Copyright 表示は以下の通り。
318- </para>
319285 <programlisting>
320286 Copyright: (C) 1997-1999, Advanced Interfaces Group,
321287 University of Manchester.
@@ -333,36 +299,33 @@
333299 There is no warranty or other guarantee of fitness of this
334300 software for any purpose. It is provided solely "as is".
335301 </programlisting>
336- <para>
337- なお、本ソフトウェアを使って生成したデータには、上記ライセンスは一切影響しません。
338- </para>
339302 </appendix>
340303
341304 <appendix id="source">
342- <title>ソースコード</title>
305+ <title>Get the source code</title>
343306 <para>
344- ソースコードは、<ulink url="http://sourceforge.jp/projects/autocoast/">http://sourceforge.jp/projects/autocoast/</ulink> から CVS 経由で入手できます。
307+ You can obtain source code wich CVS from <ulink url="http://sourceforge.jp/projects/autocoast/">http://sourceforge.jp/projects/autocoast/</ulink>.
345308 </para>
346309 </appendix>
347310
348311 <appendix id="acknowledgements">
349- <title>謝辞</title>
312+ <title>Acknowledgements</title>
350313 <para>
351- GSHHS のデータを作成/公開されている Paul Wessel、Walter H. F. Smith 両氏に感謝します。
314+ Thanks to GSHHS data maintainer: Paul Wesse, Walter H. F. Smith.
352315 </para>
353316 <para>
354- AutoCoast は、Alan Murta 氏作成の <ulink url="http://www.cs.man.ac.uk/aig/staff/alan/software/">Generic Polygon Clipper</ulink> を使用しています。
317+ AutoCoast uses <ulink url="http://www.cs.man.ac.uk/aig/staff/alan/software/">Generic Polygon Clipper</ulink> by Alan Murta.
355318 </para>
356319 <para>
357- Richard Ludowise 氏作 の TDFMacros.inc と TDFHeaders.inc を使用しています。
320+ AutoCoast uses TDFMacros.inc and TDFHeaders.inc by Richard Ludowise.
358321 </para>
359322 <para>
360- <ulink url="http://flightinfo.ens.ne.jp/pja/cgi-bin/desboard.cgi">シーナリデザイン会議室</ulink>にて助言をくださったすべての方に感謝します。
323+ Thaks to all participants at <ulink url="http://flightinfo.ens.ne.jp/pja/cgi-bin/desboard.cgi">Scenery Design Forum</ulink>.
361324 </para>
362325 </appendix>
363326
364327 <appendix id="contact">
365- <title>連絡先</title>
328+ <title>Contact info</title>
366329 <itemizedlist>
367330 <listitem>
368331 <para><ulink url="http://autocoast.sourceforge.jp">http://autocoast.sourceforge.jp</ulink></para>
Show on old repository browser