Phasor-Driven Particle The snowfall~ object controls a multi-dimensional particle as one or more audio ramps whose lifetime is triggered and controlled by an input phasor ramp from 0 to 1. The object will typically be used within a larger system of quasi-independent particles using the MC Wrapper as mc.snowfall~. Cycling '74 MSP Phasor Input The start of a phasor ramp causes the particle to start its output signal ramps. Typically the particle output will end when the input ramp resets to zero. Phasor Input TEXT_HERE Particle Output The particle's output ramp signals (up to 4, as determined by the value of the dimensions attribute) begin when an input phasor starts; their evolution is controlled by the various attributes of snowfall~. Dimensions Sets the number of dimensions (1 - 4) which determines the number of signal outputs. The default value is 1. Phasor Input The start of a phasor ramp causes the particle to start its output signal ramps. Typically the particle output will end when the input ramp resets to zero. Boundary Mode The boundarymode attribute controls what happens when the particle output value reaches the current minimum or maximum. It is global for all dimensions. Bounce Mode Causes the particle to reverse its current direction. End Mode Causes the particle to cease outputting; the signal output will become zero. Wrap Mode Causes the particle to move to the opposite boundary. If the particle reaches the current maximum value, its value jumps to the minimum. If the particle reaches the current minimum value, its value jumps to the maximum. Clip Mode The particle's value remains at the value of the boundary (maximum or minimum). Dimensions Sets the number of dimensions (1 - 4) which determines the number of signal outputs. The default value is 1. The dimensions attribute cannot be changed after the object is created. It can be set via an argument or typed-in attribute. Direction / Velocity direction contains up to four values, one for each dimension.
When a particle starts, the direction attribute determines the velocity of movement. The value is expressed in units per second. For example, when direction is set to 5 means, the output value will increase by 5 over one second. If the direction attribute is negative, the output value is likely to decrease over time. If the direction attribute is positive, the output value is likely to increase over time. Direction Deviation directiondev contains up to four values, one for each dimension.
Sets a random deviation around the value of direction used in setting the particle velocity and direction. End Mode Sets the behavior when the particle ends, either as a result of hitting a max or min boundary or when the input signal resets or goes to zero. Set to end value When endmode is set to End Value, the output is set to the current value of the endvalue attribute when the particle ends. Remain at current value When endmode is set to Current Value, the output remains at its current value when the particle ends. End Output Value endvalue contains up to four values, one for each dimension.
Sets the value to output when a particle's life ends. Energy Ramp Factor energyramp contains up to four values, one for each dimension.
The energyramp multiplies the incoming 0 - 1 ramp signal value as part of the particle calculation. If you do not want the particle to move faster as the input ramp value increases, set the energyramp to zero. Initial Value initial contains up to four values, one for each dimension.
Sets a starting output value for the particle. Initial Value Deviation initialdev contains up to four values, one for each dimension.
Sets a random deviation around the initial value used in choosing the starting output value. Update Interval Set the time interval (in milliseconds) between new particle trajectory calculations. Interval Deviation Sets a random deviation around the value of interval used in choosing the update interval. Maximum max contains up to four values, one for each dimension.
Set's the particle's maximum boundary value. Once the particle reaches this value, its behavior is determined by the current setting of the boundarymode attribute. Minimum min contains up to four values, one for each dimension.
Set's the particle's minimum boundary value. Once the particle reaches this value, its behavior is determined by the current setting of the boundarymode attribute. Scaling Maximum scalemin contains up to four values, one for each dimension.
Sets a scale factor for the particle's output value. The particle's value will always range between the scaling minimum and the scaling maximum. Scaling Minimum scalemax contains up to four values, one for each dimension.
Sets a scale factor for the particle's output value. The particle's value will always be bettern the scaling minimum and the scaling maximum. Boundary Damping Factor squish contains up to four values, one for each dimension.
When the boundarymode attribute is set to Bounce, the squish attribute multiplies the force of the particle's direction reversal. Reverse Direction Probability wanderprob contains up to four values, one for each dimension.
Sets the probability that at any particular update, the direction will reverse. Note that as the interval becomes smaller, the effect of the wanderprob increases.