README
1Fireflies v2.07
2===============
3by Matt Perry <guy@somewhere.fscked.org>
4
5For information on how to compile, read COMPILE.
6
7-- MODES:
8New to 2.0 are modes. There are two types, per-swarm modes, and major
9modes. Per-swarm modes affect a single swarm (but two swarms may decide to
10switch to the same mode), while major modes affect the whole scene. They
11are activated with a certain probability, which is entirely relative. For
12example, if mode A has probability=1, and mode B has probability=5, that
13means mode B is 5 times as likely to occur as mode A. The mode numbers,
14names, and descriptions are as follows:
15
16Per-Swarm modes:
17Normal mode (0) - normal swarm flight
18Stop mode (1) - the bait comes to a halt, and the flies circle in around
19 it.
20Loop mode (2) - the bait travels in a loop, and the flies chase it.
21Psychadelic mode (3) - color cycling speed for this swarm is increased, and
22 the tails look like rainbows.
23Glow mode (4) - the tails increase by glow_factor (an option).
24Hyperspeed mode (5) - the bait and flies get hyper, and increase speed and
25 acceleration.
26Faded mode (6) - the colors fade
27
28Major Modes:
29All-Swarm mode (0) - activate a per-swarm mode for all swarms.
30FlyKill mode (1) - kill a bunch of fireflies.
31FlyBirth mode (2) - create a bunch of fireflies.
32Windy mode (3) - wind speed increases.
33Matrix mode (4) - Matrix-style pause and rotate.
34Swarmsplit mode (5) - a random swarm is split in 2.
35Swarmmerge mode (6) - 2 random swarms are merged.
36
37-- SDL standalone program:
38If you have SDL, and you compiled fireflies with SDL support as a
39standalone program (as opposed to a screensaver), you can enjoy a few neat
40features (mostly there so I could test things, but what the hell, they're
41fun for all).
42
43Mouse input:
44 * Left-click and drag to move the camera left/right/up/down.
45 * Right-click and drag up/down to zoom the camera in/out.
46 * Hold control and Left-click and drag to rotate the camera about the
47 origin.
48
49Keyboard input:
50 * q = quit
51 * p = pause the screensaver (you can move the camera, but nothing else
52 happens)
53 * t = display elapsed time in seconds to the console window (this won't
54 work in windows if you don't have a console window open)
55 * up arrow = fast forward 2x
56 * down arrow = fast forward 1/2x
57 * right arrow = fast forward +1x
58 * left arrow = fast forward -1x
59 * 0-6 = activate major mode corresponding to that digit
60 * shift + 0-6 = activate swarm mode corresponding to that digit
61 * control + 0-6 = stop swarm mode corresponding to that digit
62