States

A state is a sequence of segments.

The ``states'' file is a list of state id's, followed by the sequence of segments that makes up that particular state.

The ``states'' file must be given the extension ``.st''.

Here's an example of a ``states'' file:

     # id    segments
       s1    a1 a2 a3 
       s2    a2 a3 a2 a3 a4
       s3    b5 a3 b3 b2

This file declares that

1.

State s1 consists of 3 segments: a1 followed by a2, followed by a3.

2.

State s2 consists of 5 segments: a2 followed by a3, followed by a2 again, followed by a3 again, followed by a4.

3.

State s3 consists of 4 segments: b5, a3, b3, b2.

As should be obvious from this example, a segment can be repeated any number of times within a state.

A state is iterated from its start time until its end time. (The start and end times are given in the ``events'' file.) On every iteration, each of its segments changes its duration and its amplitude.

Since the frequency we hear is the sum of durations of all the segments of the state, and since the duration of each segment changes from iteration to iteration, so the resulting frequency also changes from iteration to iteration.

State range limits

A state can have a maximum of 64 segments in it. The same segment may occur more than once within a state.