link: define a link

A link is a sequence of elements. Each link has:

        # An identifier, A sequence of elements, and Statements: the number of times it is to be played.

The link command

The link command lets you specify sequences of elements, which can later be played, or used as the initial or final state for a turn or a vary.

    *    link
    name:        l3             # identifier
    0:        e0                # list of constituent elements
    1:        e2
    2:        e1
    3:        e3
    4:                          # end input of list with blank line
    statements=  441            # number of iterations when played

When played, a link creates a frequency that is:

$$frequency ~=~ {sampling\_rate \over link\_duration}$$

The link's duration (which is the waveform's period) is the sum of its elements' durations:

$$link\_duration ~=~ \sum_{i = 0}^n element_i$$

where $element_i$ is the duration of the i'th element.

A link's statements determines how long it will sound.

If you want the link to sound for $N$ seconds, set statements to:

$$statements ~=~ {N * sampling\_rate \over link\_duration}$$

Sawdust uses a sampling rate of 44100 samples per second.