The asteroids Reference Manual

1 Introduction
2 Systems
- 2.1 asteroids
3 Files
- 3.1 Lisp
- 3.2 Static
4 Packages
- 4.1 asteroids
5 Definitions
- 5.1 Exported definitions
  - 5.1.1 Functions
- 5.2 Internal definitions
Appendix A Indexes

The asteroids Reference Manual

This is the asteroids Reference Manual, generated automatically by Declt version 3.0 "Montgomery Scott" on Tue Dec 22 11:44:23 2020 GMT+0.

1 Introduction

asteroids

Classic asteroids arcade game in Common Lisp, using SDL.

Originally ported from Python by andyhd (thanks, andyhd!). The game now has sounds, keyboard controls, a built-in REPL (triggered by ESC key) and is very playable.

Installation (no git cloning needed)

Install SBCL (or CCL) and quicklisp as described here)

IMPORTANT - install native sdl libraries! For linux, that means apt-get install

libsdl-dev
libsdl-gfx1.2-dev
libsdl-mixer1.2-dev

Now, in lisp (ql:quickload "asteroids") (asteroids:main)

Quicklisp updates monthly. If you want the newest version, git clone this repo into an asdf-visible directory (see Xach's article). ql:quickload will load the local repo first

Play Instructions

The game plays like original asteroids, except instead of saucers you get powerups. Ram the powerups to pick up super-missiles that go through anything, shields, or to stop time.

Keyboard controls:

Q - quit A - rotate ship left F - rotate ship right J - thrust SPC - fire ESC - REPL

P starts the game in attract mode.

Notes

In retrospect, this was my first attempt at programming in Lisp, by modifying code written by someone who was probably doing the same thing (I think original code was in some other language...). Don't look too closely; I know I won't.

Code has been re-organized and cleaned up. Names have been altered to make it more sensible and bugs fixed. Now loading with quicklisp

ESC now brings you to a REPL. Examine the game state, recompile anything (carefully).

I also added audio using MAME asteroids samples. lispbuilder-sdl-mixer is fragile and very sensitive to being shut down correctly in an interactive environment.

Background music is courtesy http://teknoaxe.com/Home.php.

TODO:

allow remapping of keys
fix pause

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 `asteroids`

Author

stacksmith stack@sdf.org

License

Do Whatever The Fuck You Want (DWTFYF)

Description

An improved asteroids game with sounds

Dependencies

lispbuilder-sdl
lispbuilder-sdl-gfx
lispbuilder-sdl-mixer

Source

asteroids.asd (file)

Components

package.lisp (file)
asteroids.lisp (file)
sounds/banjo.mp3 (file)
sounds/biding.mp3 (file)
sounds/explode1.wav (file)
sounds/explode2.wav (file)
sounds/explode3.wav (file)
sounds/fire.wav (file)
sounds/haters.mp3 (file)
sounds/life.wav (file)
sounds/lsaucer.wav (file)
sounds/music.mp3 (file)
sounds/phaser.wav (file)
sounds/sfire.wav (file)
sounds/ssaucer.wav (file)
sounds/thrust.wav (file)
sounds/thumphi.wav (file)
sounds/thumplo.wav (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 `asteroids.asd`

Location: asteroids.asd
Systems: asteroids (system)

3.1.2 `asteroids/package.lisp`

Parent: asteroids (system)
Location: package.lisp
Packages: asteroids

3.1.3 `asteroids/asteroids.lisp`

Dependency

package.lisp (file)

Parent

asteroids (system)

Location

asteroids.lisp

Exported Definitions

main (function)

Internal Definitions

*explosion-color* (special variable)
*explosion-max-radius* (special variable)
*friction* (special variable)
*is-thrusting* (special variable)
*lr-map* (special variable)
*missile-velocity* (special variable)
*powerup-max-age* (special variable)
*rock-sides* (special variable)
*screen-height* (special variable)
*screen-width* (special variable)
*sound* (special variable)
*thrust-factor* (special variable)
*window* (special variable)
*world* (special variable)
+degrees+ (constant)
acceleration-of (method)
(setf acceleration-of) (method)
add-freeze (method)
add-score (method)
add-score (method)
add-score (method)
add-shield (method)
add-super-missiles (method)
add-to (method)
add-to (method)
add-to (method)
add-to (method)
apres (function)
asteroids (function)
best-level (method)
(setf best-level) (method)
break-down (method)
collide (method)
collide (method)
collide (method)
collide (method)
collide (method)
collide (method)
collide (method)
direction-of (method)
(setf direction-of) (method)
done (method)
explosion (class)
fade (method)
(setf fade) (method)
frozen-p (method)
handling-errors (macro)
high-score (method)
(setf high-score) (method)
in-world-p (method)
initialize (method)
intersects-p (method)
key-processor (function)
key-processor-attract (function)
key-processor-game (function)
level (method)
(setf level) (method)
level-cleared-p (method)
lifetime (method)
(setf lifetime) (method)
lifetime (method)
(setf lifetime) (method)
lifetime (method)
(setf lifetime) (method)
lives (method)
(setf lives) (method)
make-random-powerup (function)
map-coords (method)
map-radius (method)
missile (class)
mob (class)
mob-rot (class)
mobs (method)
(setf mobs) (method)
music (method)
(setf music) (method)
music-finished-action (function)
my-distance (function)
num-of-rocks (method)
(setf num-of-rocks) (method)
opened (method)
(setf opened) (method)
paused (method)
(setf paused) (method)
period (method)
(setf period) (method)
phasex (method)
(setf phasex) (method)
play-explode1 (method)
play-explode2 (method)
play-explode3 (method)
play-fire (method)
play-music (method)
play-phaser (method)
play-thrust (method)
play-thrust-stop (method)
play-thump-stop (method)
play-thumphi (method)
play-thumplo (method)
play-ufo1 (method)
play-ufo1-stop (method)
play-ufo2 (method)
play-ufo2-stop (method)
polygon1 (function)
pos-of (method)
(setf pos-of) (method)
powerup (class)
powerup-active-p (method)
powerup-freeze (class)
powerup-missile (class)
powerup-shield (class)
radial-point-from (function)
radial-points-from (function)
radii (method)
(setf radii) (method)
radius-of (method)
(setf radius-of) (method)
remove-from (method)
remove-from (method)
remove-from (method)
remove-from (method)
render (method)
render (method)
render (method)
render (method)
render (method)
render (method)
render (method)
render (method)
render (method)
render-attract (method)
render-world (method)
render-world-game (method)
repl (function)
reset (method)
reset (method)
rock (class)
rotation-of (method)
(setf rotation-of) (method)
sample (method)
(setf sample) (method)
sample-finished-action (function)
score (method)
(setf score) (method)
set-radius (method)
set-seconds (method)
ship (method)
(setf ship) (method)
ship (class)
ship-fire (function)
ship-moved (method)
shoot (method)
shut-down (method)
size-of (method)
(setf size-of) (method)
sound (class)
start-next-level (method)
stop-music (method)
super-p (method)
(setf super-p) (method)
target (method)
(setf target) (method)
target (method)
(setf target) (method)
thrust (method)
thrust-0 (method)
thumper (method)
(setf thumper) (method)
thumper (class)
timer (class)
timers (method)
(setf timers) (method)
timers (method)
(setf timers) (method)
update (method)
update (method)
update (method)
update (method)
update (method)
update (method)
update (method)
update-thumper (method)
update-world (function)
velocity-of (method)
(setf velocity-of) (method)
world (class)
x-ship (class)
xy-off-create (function)
xy-off-scale (function)
xy-off-subtract (function)
xy-off-sum (function)

3.2 Static

3.2.1 `asteroids/sounds/banjo.mp3`

Dependency: asteroids.lisp (file)
Parent: asteroids (system)
Location: sounds/banjo.mp3

3.2.2 `asteroids/sounds/biding.mp3`

Dependency: sounds/banjo.mp3 (file)
Parent: asteroids (system)
Location: sounds/biding.mp3

3.2.3 `asteroids/sounds/explode1.wav`

Dependency: sounds/biding.mp3 (file)
Parent: asteroids (system)
Location: sounds/explode1.wav

3.2.4 `asteroids/sounds/explode2.wav`

Dependency: sounds/explode1.wav (file)
Parent: asteroids (system)
Location: sounds/explode2.wav

3.2.5 `asteroids/sounds/explode3.wav`

Dependency: sounds/explode2.wav (file)
Parent: asteroids (system)
Location: sounds/explode3.wav

3.2.6 `asteroids/sounds/fire.wav`

Dependency: sounds/explode3.wav (file)
Parent: asteroids (system)
Location: sounds/fire.wav

3.2.7 `asteroids/sounds/haters.mp3`

Dependency: sounds/fire.wav (file)
Parent: asteroids (system)
Location: sounds/haters.mp3

3.2.8 `asteroids/sounds/life.wav`

Dependency: sounds/haters.mp3 (file)
Parent: asteroids (system)
Location: sounds/life.wav

3.2.9 `asteroids/sounds/lsaucer.wav`

Dependency: sounds/life.wav (file)
Parent: asteroids (system)
Location: sounds/lsaucer.wav

3.2.10 `asteroids/sounds/music.mp3`

Dependency: sounds/lsaucer.wav (file)
Parent: asteroids (system)
Location: sounds/music.mp3

3.2.11 `asteroids/sounds/phaser.wav`

Dependency: sounds/music.mp3 (file)
Parent: asteroids (system)
Location: sounds/phaser.wav

3.2.12 `asteroids/sounds/sfire.wav`

Dependency: sounds/phaser.wav (file)
Parent: asteroids (system)
Location: sounds/sfire.wav

3.2.13 `asteroids/sounds/ssaucer.wav`

Dependency: sounds/sfire.wav (file)
Parent: asteroids (system)
Location: sounds/ssaucer.wav

3.2.14 `asteroids/sounds/thrust.wav`

Dependency: sounds/ssaucer.wav (file)
Parent: asteroids (system)
Location: sounds/thrust.wav

3.2.15 `asteroids/sounds/thumphi.wav`

Dependency: sounds/thrust.wav (file)
Parent: asteroids (system)
Location: sounds/thumphi.wav

3.2.16 `asteroids/sounds/thumplo.wav`

Dependency: sounds/thumphi.wav (file)
Parent: asteroids (system)
Location: sounds/thumplo.wav

4 Packages

Packages are listed by definition order.

4.1 `asteroids`

Source

package.lisp (file)

Use List

lispbuilder-sdl
common-lisp

Exported Definitions

main (function)

Internal Definitions

*explosion-color* (special variable)
*explosion-max-radius* (special variable)
*friction* (special variable)
*is-thrusting* (special variable)
*lr-map* (special variable)
*missile-velocity* (special variable)
*powerup-max-age* (special variable)
*rock-sides* (special variable)
*screen-height* (special variable)
*screen-width* (special variable)
*sound* (special variable)
*thrust-factor* (special variable)
*window* (special variable)
*world* (special variable)
+degrees+ (constant)
acceleration-of (generic function)
acceleration-of (method)
(setf acceleration-of) (method)
(setf acceleration-of) (generic function)
add-freeze (generic function)
add-freeze (method)
add-score (generic function)
add-score (method)
add-score (method)
add-score (method)
add-shield (generic function)
add-shield (method)
add-super-missiles (generic function)
add-super-missiles (method)
add-to (generic function)
add-to (method)
add-to (method)
add-to (method)
add-to (method)
apres (function)
asteroids (function)
best-level (generic function)
best-level (method)
(setf best-level) (method)
(setf best-level) (generic function)
break-down (generic function)
break-down (method)
collide (generic function)
collide (method)
collide (method)
collide (method)
collide (method)
collide (method)
collide (method)
collide (method)
direction-of (generic function)
direction-of (method)
(setf direction-of) (method)
(setf direction-of) (generic function)
done (generic function)
done (method)
explosion (class)
fade (generic function)
fade (method)
(setf fade) (method)
(setf fade) (generic function)
frozen-p (generic function)
frozen-p (method)
handling-errors (macro)
high-score (generic function)
high-score (method)
(setf high-score) (method)
(setf high-score) (generic function)
in-world-p (generic function)
in-world-p (method)
initialize (generic function)
initialize (method)
intersects-p (generic function)
intersects-p (method)
key-processor (function)
key-processor-attract (function)
key-processor-game (function)
level (generic function)
level (method)
(setf level) (method)
(setf level) (generic function)
level-cleared-p (generic function)
level-cleared-p (method)
lifetime (generic function)
lifetime (method)
(setf lifetime) (method)
lifetime (method)
(setf lifetime) (method)
lifetime (method)
(setf lifetime) (method)
(setf lifetime) (generic function)
lives (generic function)
lives (method)
(setf lives) (method)
(setf lives) (generic function)
make-random-powerup (function)
map-coords (generic function)
map-coords (method)
map-radius (generic function)
map-radius (method)
missile (class)
mob (class)
mob-rot (class)
mobs (generic function)
mobs (method)
(setf mobs) (method)
(setf mobs) (generic function)
music (generic function)
music (method)
(setf music) (method)
(setf music) (generic function)
music-finished-action (function)
my-distance (function)
num-of-rocks (generic function)
num-of-rocks (method)
(setf num-of-rocks) (method)
(setf num-of-rocks) (generic function)
opened (generic function)
opened (method)
(setf opened) (method)
(setf opened) (generic function)
paused (generic function)
paused (method)
(setf paused) (method)
(setf paused) (generic function)
period (generic function)
period (method)
(setf period) (method)
(setf period) (generic function)
phasex (generic function)
phasex (method)
(setf phasex) (method)
(setf phasex) (generic function)
play-explode1 (generic function)
play-explode1 (method)
play-explode2 (generic function)
play-explode2 (method)
play-explode3 (generic function)
play-explode3 (method)
play-fire (generic function)
play-fire (method)
play-music (generic function)
play-music (method)
play-phaser (generic function)
play-phaser (method)
play-thrust (generic function)
play-thrust (method)
play-thrust-stop (generic function)
play-thrust-stop (method)
play-thump-stop (generic function)
play-thump-stop (method)
play-thumphi (generic function)
play-thumphi (method)
play-thumplo (generic function)
play-thumplo (method)
play-ufo1 (generic function)
play-ufo1 (method)
play-ufo1-stop (generic function)
play-ufo1-stop (method)
play-ufo2 (generic function)
play-ufo2 (method)
play-ufo2-stop (generic function)
play-ufo2-stop (method)
polygon1 (function)
pos-of (generic function)
pos-of (method)
(setf pos-of) (method)
(setf pos-of) (generic function)
powerup (class)
powerup-active-p (generic function)
powerup-active-p (method)
powerup-freeze (class)
powerup-missile (class)
powerup-shield (class)
radial-point-from (function)
radial-points-from (function)
radii (generic function)
radii (method)
(setf radii) (method)
(setf radii) (generic function)
radius-of (generic function)
radius-of (method)
(setf radius-of) (method)
(setf radius-of) (generic function)
remove-from (generic function)
remove-from (method)
remove-from (method)
remove-from (method)
remove-from (method)
render (generic function)
render (method)
render (method)
render (method)
render (method)
render (method)
render (method)
render (method)
render (method)
render (method)
render-attract (generic function)
render-attract (method)
render-world (generic function)
render-world (method)
render-world-game (generic function)
render-world-game (method)
repl (function)
reset (generic function)
reset (method)
reset (method)
rock (class)
rotation-of (generic function)
rotation-of (method)
(setf rotation-of) (method)
(setf rotation-of) (generic function)
sample (generic function)
sample (method)
(setf sample) (method)
(setf sample) (generic function)
sample-finished-action (function)
score (generic function)
score (method)
(setf score) (method)
(setf score) (generic function)
set-radius (generic function)
set-radius (method)
set-seconds (generic function)
set-seconds (method)
ship (generic function)
ship (method)
(setf ship) (method)
(setf ship) (generic function)
ship (class)
ship-fire (function)
ship-moved (generic function)
ship-moved (method)
shoot (generic function)
shoot (method)
shut-down (generic function)
shut-down (method)
size-of (generic function)
size-of (method)
(setf size-of) (method)
(setf size-of) (generic function)
sound (class)
start-next-level (generic function)
start-next-level (method)
stop-music (generic function)
stop-music (method)
super-p (generic function)
super-p (method)
(setf super-p) (method)
(setf super-p) (generic function)
target (generic function)
target (method)
(setf target) (method)
target (method)
(setf target) (method)
(setf target) (generic function)
thrust (generic function)
thrust (method)
thrust-0 (generic function)
thrust-0 (method)
thumper (generic function)
thumper (method)
(setf thumper) (method)
(setf thumper) (generic function)
thumper (class)
timer (class)
timers (generic function)
timers (method)
(setf timers) (method)
timers (method)
(setf timers) (method)
(setf timers) (generic function)
update (generic function)
update (method)
update (method)
update (method)
update (method)
update (method)
update (method)
update (method)
update-thumper (generic function)
update-thumper (method)
update-world (function)
velocity-of (generic function)
velocity-of (method)
(setf velocity-of) (method)
(setf velocity-of) (generic function)
world (class)
x-ship (class)
xy-off-create (function)
xy-off-scale (function)
xy-off-subtract (function)
xy-off-sum (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Functions

Function: main ()

Package: asteroids
Source: asteroids.lisp (file)

5.2 Internal definitions

5.2.1 Constants

Constant: +degrees+

Package: asteroids
Source: asteroids.lisp (file)

5.2.2 Special variables

Special Variable: *explosion-color*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *explosion-max-radius*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *friction*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *is-thrusting*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *lr-map*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *missile-velocity*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *powerup-max-age*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *rock-sides*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *screen-height*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *screen-width*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *sound*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *thrust-factor*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *window*

Package: asteroids
Source: asteroids.lisp (file)

Special Variable: *world*

Package: asteroids
Source: asteroids.lisp (file)

5.2.3 Macros

Macro: handling-errors &body BODY

Package: asteroids
Source: asteroids.lisp (file)

5.2.4 Functions

Function: apres WORLD TIMER-NAME &key SECONDS FUN

Package: asteroids
Source: asteroids.lisp (file)

Function: asteroids ()

Package: asteroids
Source: asteroids.lisp (file)

Function: key-processor WORLD KEY &key DOWN

Package: asteroids
Source: asteroids.lisp (file)

Function: key-processor-attract WORLD KEY &key DOWN

Package: asteroids
Source: asteroids.lisp (file)

Function: key-processor-game WORLD KEY &key DOWN

Package: asteroids
Source: asteroids.lisp (file)

Function: make-random-powerup &key POS VELOCITY

Package: asteroids
Source: asteroids.lisp (file)

Function: music-finished-action ()

Package: asteroids
Source: asteroids.lisp (file)

Function: my-distance A B

Package: asteroids
Source: asteroids.lisp (file)

Function: polygon1 COORDS RADIUS-OF DIRECTION

return a list of vertices (points) suitable for draw-polygon

Package: asteroids
Source: asteroids.lisp (file)

Function: radial-point-from P RADIUS ANGLE

Package: asteroids
Source: asteroids.lisp (file)

Function: radial-points-from COORD RADIUS ANGLES

return a list of points located along the radius around p, at list of angles

Package: asteroids
Source: asteroids.lisp (file)

Function: repl ()

Package: asteroids
Source: asteroids.lisp (file)

Function: sample-finished-action ()

Package: asteroids
Source: asteroids.lisp (file)

Function: ship-fire SHIP

Package: asteroids
Source: asteroids.lisp (file)

Function: update-world WORLD

Package: asteroids
Source: asteroids.lisp (file)

Function: xy-off-create ANGLE-RAD MAGNITUDE

Create a ’xy-off’

Package: asteroids
Source: asteroids.lisp (file)

Function: xy-off-scale V FACTOR

Package: asteroids
Source: asteroids.lisp (file)

Function: xy-off-subtract A B

Package: asteroids
Source: asteroids.lisp (file)

Function: xy-off-sum A B

Package: asteroids
Source: asteroids.lisp (file)

5.2.5 Generic functions

Generic Function: acceleration-of OBJECT

Generic Function: (setf acceleration-of) NEW-VALUE OBJECT

Package

• Introduction		What asteroids is all about
• Systems		The systems documentation
• Files		The files documentation
• Packages		The packages documentation
• Definitions		The symbols documentation
• Indexes		Concepts, functions, variables and data types

• The asteroids.asd file
• The asteroids/package.lisp file
• The asteroids/asteroids.lisp file

• The asteroids/sounds/banjo.mp3 file
• The asteroids/sounds/biding.mp3 file
• The asteroids/sounds/explode1.wav file
• The asteroids/sounds/explode2.wav file
• The asteroids/sounds/explode3.wav file
• The asteroids/sounds/fire.wav file
• The asteroids/sounds/haters.mp3 file
• The asteroids/sounds/life.wav file
• The asteroids/sounds/lsaucer.wav file
• The asteroids/sounds/music.mp3 file
• The asteroids/sounds/phaser.wav file
• The asteroids/sounds/sfire.wav file
• The asteroids/sounds/ssaucer.wav file
• The asteroids/sounds/thrust.wav file
• The asteroids/sounds/thumphi.wav file
• The asteroids/sounds/thumplo.wav file

• Internal constants
• Internal special variables
• Internal macros
• Internal functions
• Internal generic functions
• Internal classes

• Concept index
• Function index
• Variable index
• Data type index

	Index Entry	Section

A
	`asteroids.asd`:	The asteroids․asd file
	`asteroids/asteroids.lisp`:	The asteroids/asteroids․lisp file
	`asteroids/package.lisp`:	The asteroids/package․lisp file
	`asteroids/sounds/banjo.mp3`:	The asteroids/sounds/banjo․mp3 file
	`asteroids/sounds/biding.mp3`:	The asteroids/sounds/biding․mp3 file
	`asteroids/sounds/explode1.wav`:	The asteroids/sounds/explode1․wav file
	`asteroids/sounds/explode2.wav`:	The asteroids/sounds/explode2․wav file
	`asteroids/sounds/explode3.wav`:	The asteroids/sounds/explode3․wav file
	`asteroids/sounds/fire.wav`:	The asteroids/sounds/fire․wav file
	`asteroids/sounds/haters.mp3`:	The asteroids/sounds/haters․mp3 file
	`asteroids/sounds/life.wav`:	The asteroids/sounds/life․wav file
	`asteroids/sounds/lsaucer.wav`:	The asteroids/sounds/lsaucer․wav file
	`asteroids/sounds/music.mp3`:	The asteroids/sounds/music․mp3 file
	`asteroids/sounds/phaser.wav`:	The asteroids/sounds/phaser․wav file
	`asteroids/sounds/sfire.wav`:	The asteroids/sounds/sfire․wav file
	`asteroids/sounds/ssaucer.wav`:	The asteroids/sounds/ssaucer․wav file
	`asteroids/sounds/thrust.wav`:	The asteroids/sounds/thrust․wav file
	`asteroids/sounds/thumphi.wav`:	The asteroids/sounds/thumphi․wav file
	`asteroids/sounds/thumplo.wav`:	The asteroids/sounds/thumplo․wav file

F
	File, Lisp, `asteroids.asd`:	The asteroids․asd file
	File, Lisp, `asteroids/asteroids.lisp`:	The asteroids/asteroids․lisp file
	File, Lisp, `asteroids/package.lisp`:	The asteroids/package․lisp file
	File, static, `asteroids/sounds/banjo.mp3`:	The asteroids/sounds/banjo․mp3 file
	File, static, `asteroids/sounds/biding.mp3`:	The asteroids/sounds/biding․mp3 file
	File, static, `asteroids/sounds/explode1.wav`:	The asteroids/sounds/explode1․wav file
	File, static, `asteroids/sounds/explode2.wav`:	The asteroids/sounds/explode2․wav file
	File, static, `asteroids/sounds/explode3.wav`:	The asteroids/sounds/explode3․wav file
	File, static, `asteroids/sounds/fire.wav`:	The asteroids/sounds/fire․wav file
	File, static, `asteroids/sounds/haters.mp3`:	The asteroids/sounds/haters․mp3 file
	File, static, `asteroids/sounds/life.wav`:	The asteroids/sounds/life․wav file
	File, static, `asteroids/sounds/lsaucer.wav`:	The asteroids/sounds/lsaucer․wav file
	File, static, `asteroids/sounds/music.mp3`:	The asteroids/sounds/music․mp3 file
	File, static, `asteroids/sounds/phaser.wav`:	The asteroids/sounds/phaser․wav file
	File, static, `asteroids/sounds/sfire.wav`:	The asteroids/sounds/sfire․wav file
	File, static, `asteroids/sounds/ssaucer.wav`:	The asteroids/sounds/ssaucer․wav file
	File, static, `asteroids/sounds/thrust.wav`:	The asteroids/sounds/thrust․wav file
	File, static, `asteroids/sounds/thumphi.wav`:	The asteroids/sounds/thumphi․wav file
	File, static, `asteroids/sounds/thumplo.wav`:	The asteroids/sounds/thumplo․wav file

L
	Lisp File, `asteroids.asd`:	The asteroids․asd file
	Lisp File, `asteroids/asteroids.lisp`:	The asteroids/asteroids․lisp file
	Lisp File, `asteroids/package.lisp`:	The asteroids/package․lisp file

S
	Static File, `asteroids/sounds/banjo.mp3`:	The asteroids/sounds/banjo․mp3 file
	Static File, `asteroids/sounds/biding.mp3`:	The asteroids/sounds/biding․mp3 file
	Static File, `asteroids/sounds/explode1.wav`:	The asteroids/sounds/explode1․wav file
	Static File, `asteroids/sounds/explode2.wav`:	The asteroids/sounds/explode2․wav file
	Static File, `asteroids/sounds/explode3.wav`:	The asteroids/sounds/explode3․wav file
	Static File, `asteroids/sounds/fire.wav`:	The asteroids/sounds/fire․wav file
	Static File, `asteroids/sounds/haters.mp3`:	The asteroids/sounds/haters․mp3 file
	Static File, `asteroids/sounds/life.wav`:	The asteroids/sounds/life․wav file
	Static File, `asteroids/sounds/lsaucer.wav`:	The asteroids/sounds/lsaucer․wav file
	Static File, `asteroids/sounds/music.mp3`:	The asteroids/sounds/music․mp3 file
	Static File, `asteroids/sounds/phaser.wav`:	The asteroids/sounds/phaser․wav file
	Static File, `asteroids/sounds/sfire.wav`:	The asteroids/sounds/sfire․wav file
	Static File, `asteroids/sounds/ssaucer.wav`:	The asteroids/sounds/ssaucer․wav file
	Static File, `asteroids/sounds/thrust.wav`:	The asteroids/sounds/thrust․wav file
	Static File, `asteroids/sounds/thumphi.wav`:	The asteroids/sounds/thumphi․wav file
	Static File, `asteroids/sounds/thumplo.wav`:	The asteroids/sounds/thumplo․wav file

	Index Entry	Section

*
	`explosion-color`:	Internal special variables
	`explosion-max-radius`:	Internal special variables
	`friction`:	Internal special variables
	`is-thrusting`:	Internal special variables
	`lr-map`:	Internal special variables
	`missile-velocity`:	Internal special variables
	`powerup-max-age`:	Internal special variables
	`rock-sides`:	Internal special variables
	`screen-height`:	Internal special variables
	`screen-width`:	Internal special variables
	`sound`:	Internal special variables
	`thrust-factor`:	Internal special variables
	`window`:	Internal special variables
	`world`:	Internal special variables

+
	`+degrees+`:	Internal constants

A
	`acceleration`:	Internal classes

B
	`best-level`:	Internal classes

C
	`Constant, +degrees+`:	Internal constants

D
	`direction`:	Internal classes

F
	`fade`:	Internal classes

H
	`high-score`:	Internal classes

L
	`level`:	Internal classes
	`lifetime`:	Internal classes
	`lifetime`:	Internal classes
	`lifetime`:	Internal classes
	`lives`:	Internal classes

M
	`mobs`:	Internal classes
	`music`:	Internal classes

N
	`num-of-rocks`:	Internal classes

O
	`opened`:	Internal classes

P
	`paused`:	Internal classes
	`period`:	Internal classes
	`phasex`:	Internal classes
	`pos`:	Internal classes

R
	`radii`:	Internal classes
	`radius`:	Internal classes
	`rotation`:	Internal classes

S
	`sample`:	Internal classes
	`score`:	Internal classes
	`ship`:	Internal classes
	`size`:	Internal classes
	`Slot, acceleration`:	Internal classes
	`Slot, best-level`:	Internal classes
	`Slot, direction`:	Internal classes
	`Slot, fade`:	Internal classes
	`Slot, high-score`:	Internal classes
	`Slot, level`:	Internal classes
	`Slot, lifetime`:	Internal classes
	`Slot, lifetime`:	Internal classes
	`Slot, lifetime`:	Internal classes
	`Slot, lives`:	Internal classes
	`Slot, mobs`:	Internal classes
	`Slot, music`:	Internal classes
	`Slot, num-of-rocks`:	Internal classes
	`Slot, opened`:	Internal classes
	`Slot, paused`:	Internal classes
	`Slot, period`:	Internal classes
	`Slot, phasex`:	Internal classes
	`Slot, pos`:	Internal classes
	`Slot, radii`:	Internal classes
	`Slot, radius`:	Internal classes
	`Slot, rotation`:	Internal classes
	`Slot, sample`:	Internal classes
	`Slot, score`:	Internal classes
	`Slot, ship`:	Internal classes
	`Slot, size`:	Internal classes
	`Slot, super`:	Internal classes
	`Slot, target`:	Internal classes
	`Slot, target`:	Internal classes
	`Slot, thumper`:	Internal classes
	`Slot, timers`:	Internal classes
	`Slot, timers`:	Internal classes
	`Slot, velocity`:	Internal classes
	`Special Variable, explosion-color`:	Internal special variables
	`Special Variable, explosion-max-radius`:	Internal special variables
	`Special Variable, friction`:	Internal special variables
	`Special Variable, is-thrusting`:	Internal special variables
	`Special Variable, lr-map`:	Internal special variables
	`Special Variable, missile-velocity`:	Internal special variables
	`Special Variable, powerup-max-age`:	Internal special variables
	`Special Variable, rock-sides`:	Internal special variables
	`Special Variable, screen-height`:	Internal special variables
	`Special Variable, screen-width`:	Internal special variables
	`Special Variable, sound`:	Internal special variables
	`Special Variable, thrust-factor`:	Internal special variables
	`Special Variable, window`:	Internal special variables
	`Special Variable, world`:	Internal special variables
	`super`:	Internal classes

T
	`target`:	Internal classes
	`target`:	Internal classes
	`thumper`:	Internal classes
	`timers`:	Internal classes
	`timers`:	Internal classes

V
	`velocity`:	Internal classes

	Index Entry	Section

A
	`asteroids`:	The asteroids system
	`asteroids`:	The asteroids package

C
	`Class, explosion`:	Internal classes
	`Class, missile`:	Internal classes
	`Class, mob`:	Internal classes
	`Class, mob-rot`:	Internal classes
	`Class, powerup`:	Internal classes
	`Class, powerup-freeze`:	Internal classes
	`Class, powerup-missile`:	Internal classes
	`Class, powerup-shield`:	Internal classes
	`Class, rock`:	Internal classes
	`Class, ship`:	Internal classes
	`Class, sound`:	Internal classes
	`Class, thumper`:	Internal classes
	`Class, timer`:	Internal classes
	`Class, world`:	Internal classes
	`Class, x-ship`:	Internal classes

E
	`explosion`:	Internal classes

M
	`missile`:	Internal classes
	`mob`:	Internal classes
	`mob-rot`:	Internal classes

P
	`Package, asteroids`:	The asteroids package
	`powerup`:	Internal classes
	`powerup-freeze`:	Internal classes
	`powerup-missile`:	Internal classes
	`powerup-shield`:	Internal classes

R
	`rock`:	Internal classes

S
	`ship`:	Internal classes
	`sound`:	Internal classes
	`System, asteroids`:	The asteroids system

T
	`thumper`:	Internal classes
	`timer`:	Internal classes

W
	`world`:	Internal classes

X
	`x-ship`:	Internal classes

The asteroids Reference Manual

Table of Contents

The asteroids Reference Manual

1 Introduction

asteroids

Installation (no git cloning needed)

Play Instructions

Notes

TODO:

2 Systems

2.1 asteroids

3 Files

3.1 Lisp

3.1.1 asteroids.asd

3.1.2 asteroids/package.lisp

3.1.3 asteroids/asteroids.lisp

3.2 Static

3.2.1 asteroids/sounds/banjo.mp3

3.2.2 asteroids/sounds/biding.mp3

3.2.3 asteroids/sounds/explode1.wav

3.2.4 asteroids/sounds/explode2.wav

3.2.5 asteroids/sounds/explode3.wav

3.2.6 asteroids/sounds/fire.wav

3.2.7 asteroids/sounds/haters.mp3

3.2.8 asteroids/sounds/life.wav

3.2.9 asteroids/sounds/lsaucer.wav

3.2.10 asteroids/sounds/music.mp3

3.2.11 asteroids/sounds/phaser.wav

3.2.12 asteroids/sounds/sfire.wav

3.2.13 asteroids/sounds/ssaucer.wav

3.2.14 asteroids/sounds/thrust.wav

3.2.15 asteroids/sounds/thumphi.wav

3.2.16 asteroids/sounds/thumplo.wav

4 Packages

4.1 asteroids

5 Definitions

5.1 Exported definitions

5.1.1 Functions

5.2 Internal definitions

5.2.1 Constants

5.2.2 Special variables

5.2.3 Macros

5.2.4 Functions

5.2.5 Generic functions

5.2.6 Classes

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types

2.1 `asteroids`

3.1.1 `asteroids.asd`

3.1.2 `asteroids/package.lisp`

3.1.3 `asteroids/asteroids.lisp`

3.2.1 `asteroids/sounds/banjo.mp3`

3.2.2 `asteroids/sounds/biding.mp3`

3.2.3 `asteroids/sounds/explode1.wav`

3.2.4 `asteroids/sounds/explode2.wav`

3.2.5 `asteroids/sounds/explode3.wav`

3.2.6 `asteroids/sounds/fire.wav`

3.2.7 `asteroids/sounds/haters.mp3`

3.2.8 `asteroids/sounds/life.wav`

3.2.9 `asteroids/sounds/lsaucer.wav`

3.2.10 `asteroids/sounds/music.mp3`

3.2.11 `asteroids/sounds/phaser.wav`

3.2.12 `asteroids/sounds/sfire.wav`

3.2.13 `asteroids/sounds/ssaucer.wav`

3.2.14 `asteroids/sounds/thrust.wav`

3.2.15 `asteroids/sounds/thumphi.wav`

3.2.16 `asteroids/sounds/thumplo.wav`

4.1 `asteroids`