Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

[ba73e6]: README.html Maximize Restore History

Download this file

README.html    307 lines (254 with data), 9.9 kB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Asteroids3D README</title>
<style type="text/css">
table.bd {
	border-collapse: collapse;
	border: 1px solid #000000;
}
table.bd td {
	border: 1px solid #000000;
	padding: 2px;
}
</style>
</head>

<body>

<p>Asteroids3D - a first person game of blowing up asteroids<br />
Copyright (C) 2000 Stuart Mark Pomerantz &lt;smp [at] psc edu&gt;<br />
Copyright © Jan Engelhardt &lt;jengelh [at] gmx de&gt;, 2003 - 2007</p>

<h1>Description</h1>

<p class="block">Welcome! Thanks for trying out asteroids3D. This program is
known to compile without error on SUSE LINUX 9.3-10.3, and possibly some other
Linux distributions. The program requires a GL library, which is usually
provided with your card's drivers. Alternatively, you can use the
software-based Mesa3D library, available at <a href="http://www.mesa3d.org/"
target="_blank">mesa3d.org</a>.</p>

<h1>Thanks to</h1>

<p class="block">Thank you to my girlfriend Colleen for her support, and never
failing to say "oooh, cool". Thank you to Lee Beatty for his enormously helpful
artistic suggestions. He has got a great eye for how things should look. Thank
you to everyone on the internet who emailed me with suggestions and kind
words!</p>

<p class="block">Thanks to Rob R. for a patch and a nebula graphic
(nebula3).</p>

<h1>Download</h1>

<p class="block">The latest copy of Asteroids3D can be found at <a
href="http://jengelh.hopto.org/p/as3d/"
target="_blank">jengelh.hopto.org/p/as3d/</a>.</p>

<h1>Compilation &amp; Installation</h1>

<p class="block">asteroids3D uses autoconf, so you can use the usual
two-step. For running asteroids3D out of the source directory, you need:</p>

<p class="code"><code>./configure --with-gamedatadir=src<br />
make</code></p>

<p class="block">If you want to actually install it in the system, you could
use:</p>

<p class="code"><code>./configure --with-gamesdir=/usr/games
--with-gamedatadir=/usr/share/games/asteroids3D<br />
make install</p>

<p class="block">If you need extra compilation or linking flags, you can pass
them to configure using CFLAGS="your options" and LDFLAGS="opts" respectively.
For example, to turn on debugging:</p>

<p class="code"><code>./configure CFLAGS="-O0 -ggdb3"</code></p>

<h1>Playing</h1>

<p class="block">The object of the game is to stay alive and destroy all the
asteroids in the asteroid field.</p>

<p class="block">To view the available command line options type:</p>

<p><code>asteroids3D -help</code></p>

<h1>Playing &gt; Controls</h1>

<h2>mouse</h2>

<p class="block">The mouse rotates your ship up, down, left, and right. The
left mouse button fires your torpedo, the right one targets the asteroid in the
crosshair, if any.</p>

<h2>keyboard</h2>

<p class="block">The basic keyboard movement follows the commonly-known
WASD/SAWD scheme.</p>

<table border="1" class="bd">
	<tr>
		<td>ESC</td>
		<td>exit the game immediately</td>
	</tr>
	<tr>
		<td><code>$</code></td>
		<td>turn on debugging axes and cubes (not very interesting for
		playing)</td>
	</tr>
	<tr>
		<td><code>s</code>/<code>w</code></td>
		<td>slide forward/backward</td>
	</tr>
	<tr>
		<td><code>a</code>/<code>d</code></td>
		<td>slide left/right</td>
	</tr>
	<tr>
		<td><code>c</code>/<code>x</code></td>
		<td>slide up/down</td>
	</tr>
	<tr>
		<td><code>f</code></td>
		<td>hit the breaks!</td>
	</tr>
	<tr>
		<td><code>b</code></td>
		<td>automatically target next asteroid</td>
	</tr>
	<tr>
		<td><code>TAB</code></td>
		<td>target asteriod in crosshair</td>
	</tr>
	<tr>
		<td><code>p</code></td>
		<td>pause the game</td>
	</tr>
	<tr>
		<td>SPACE</td>
		<td>fire a torpedo</td>
	</tr>
	<tr>
		<td><code>[</code></td>
		<td>activate/deactivate headlight</td>
	</tr>
	<tr>
		<td colspan="2"><b>Best with keypad:</b></td>
	</tr>
	<tr>
		<td><code>4</code>/<code>6</code></td>
		<td>rotate about the ship's y axis</td>
	</tr>
	<tr>
		<td><code>7</code>/<code>9</code></td>
		<td>rotate about the ship's z axis</td>
	</tr>
	<tr>
		<td><code>8</code>/<code>2</code></td>
		<td>rotate about the ship's x axis</td>
	</tr>
	<tr>
		<td colspan="2"><b>Graphics features:</b><br />
		These keys are like toggle switches now and are mapped across
		the top of the [US] keyboard</td>
	</tr>
	<tr>
		<td><code>+</td>
		<td>activate/deactivate crosshair</td>
	</tr>
	<tr>
		<td><code>_</td>
		<td>activate/deactivate tracer</td>
	</tr>
	<tr>
		<td><code>(</td>
		<td>activate/deactivate dust effect</td>
	</tr>
	<tr>
		<td><code>)</td>
		<td>activate/deactivate shield effect</td>
	</tr>
	<tr>
		<td><code>*</td>
		<td>activate/deactivate torpedo lens flares</td>
	</tr>
	<tr>
		<td><code>m</td>
		<td>activate/deactivate asteroid textures</td>
	</tr>
	<tr>
		<td><code>k</td>
		<td>activate/deactivate nebula textures</td>
	</tr>
	<tr>
		<td><code>o</td>
		<td>activate/deactivate torpedo texture</td>
	</tr>
	<tr>
		<td><code>#</td>
		<td>activate/deactivate sound</td>
	</tr>
	<tr>
		<td><code>!</td>
		<td>swap mouse x direction</td>
	</tr>
	<tr>
		<td><code>@</td>
		<td>swap mouse y direction</td>
	</tr>
</table>

<h1>HUD symbology</h1>

<p class="block">The position of your mouse is represented by a green dot.</p>

<p class="block">The purple circles on the left represent torpedo slots. As you
fire they will dim, letting you know that you have fired and a slot is
reloading. You have five torpedos.</p>

<p class="block">The number at the top center of the screen tells you how many
asteroids are left in the field.</p>

<p class="block">The shield indicator at the bottom right of the screen tells
you the strength of your shield indicator. When you are hit by an asteroid, the
shield will automatically come on and you will bounce elastically off the
asteroid. The amount your shield will decrease depends on the momentum of the
asteroid, which depends on the speed and mass of the asteroid and your ship.
Avoid getting hit by big asteroids if you can. (Avoid getting hit at all,
preferably <code>:-)</code></p>

<p class="block">The collision warning indicator is at the lower center of your
screen. There are four arrows representing above the ship, below the ship, to
the left of the ship, and to the right of the ship. The oval represents
directly behind you. If the dim red arrow (or the oval) lights up, then you
know that an asteroid is near you on that side. For example, if the right red
arrow lights up, then an asteroid is near you on your right side. It is good to
move at a ninety degree angle away from close asteroids.</p>

<p class="block">Finally, a group of numbers on the lower left corner of the
screen represents your velocity vector (x,y,z) in m/s. Although this looks
cool, it may not be of much use to you. You will be able to see if you are
moving, though.</p>

<p class="block">When you lock on to an asteroid:</p>

<p class="block">The spot where your torpedo will be in the time it will take
to reach the asteroid is represented by either a yellow (out of range) or red
(in range) dot.</p>

<p class="block">The spot where the asteroid will be in the time it will take
your torpedo to reach the asteroid is represented by either a yellow (out of
range) or red (in range) circle. The target circle grows and shrinks with
distance to the target so that you have a more accurate idea of how big a
target you need to hit is at a given distance.</p>

<p class="block">There is an outer circle with hash marks which turns right as
you shorten the distance between the ship and the asteroid and left as the
distance between the ship and the asteroid increases. The outer circle will
give you a good idea of your rate of closure with the target.</p>

<p class="block">Put the dot inside the circle when they are both red and
voilà, you hit. There are a small number of cases where the aspect angle of the
torpedo on the target is such that you will miss. And unless you are close
enough, the torpedo may fizzle out before it hits. Additionally, the
will-hit-or-miss-detection logic is simple, so it may happen that a torpedo
might miss if the distance is close to the maximum possible distance while the
circle is still red.</p>

<p class="block">The targeted asteroid is boxed in green, and has a green line
pointing in the direction it is travelling (its movement vector).</p>

<h1>Comments and suggestions</h1>

<p class="block">I welcome all comments and suggestions. Please remember that
this game is A WORK IN PROGRESS. I do not consider it finished or completely
debugged. The version number is meant to reflect that.</p>

<p class="block">If you have a comment or suggestion, please email it to the
current maintainer, Jan Engelhardt and/or cc: Stuart. If you have a criticism,
I would like to hear it as long as it is constructive. "This game sucks"
criticisms will be ignored and put in the trash.</p>

<h1>Finally...</h1>

<p class="block">I am giving this away to thank the GNU community of developers
for all the wonderful software they have given away to me for free. I thank you
all for your generosity. I hope you like this game.</p>

<p>Stu Pomerantz</p>

<h1>License</h1>

<pre>This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
MA 02110-1301  USA


Stuart Pomerantz
3935 Stonecliffe drive
Monroeville, PA 15146</pre>

</body>
</html>