Connection Statement

The connection statement is the means by which the end points of a Connector object are specified in a script. Each end of a Connector object can be assigned either an access point or a numerical value representing a fixed anchor point. The following script fragment illustrates the use of the connection statement in its various forms:

    String string1(100 Hz, 20 secs);
    String string2(100 Hz, 20 secs);
    String string3(100 Hz, 20 secs);
    
    Connector conn1, conn2, conn3;
    
    Init:
        string1(0.5) -- conn1 -- string2(0.5);
        string2(0.1) -- conn2 -- 0.0;
        string2(right) -- conn3 -- string3(left) strength 0.5;
        ...

There are several features about the connection statement to note. Firstly it is possible for both ends of a Connector to be assigned access points, for one end to be assigned an access point whilst the other is assigned an anchor point. However it is meaningless for both ends of a Connector to be assigned anchor points since this would have no effect on any instruments and the Connector would thus be rendered useless.

The second thing to note is that regardless of whether access or anchor points are used the connection statement has an optional strength clause which allows the strength of the spring to be set. If the strength value is specified in the range [0..1] then the model's behaviour is guaranteed to remain stable. However some values higher than 1 may be useful at times but can also make the whole instrument model unstable to the point where it induces exponentially growing noisy vibrations. Unfortunately this is an limitation inherent in the discrete model used by Tao.


©1999,2000 Mark Pearson m.pearson@ukonline.co.uk April 30, 2000