This patcher uses the rotation of the phone as the input. For most uses the flowfal.accel_rot patcher will be sufficient - you will only need to use this mode if you need to respond to a very specific motion.

This device outputs two signals. The left Output has all the device filtering applied and is the signal shown on the scope. The right Raw Signal has only a small amount of low pass filtering applied to the input signal.

Input Selector: allows you to select what kind of rotation you want to detect:

• Jerk - the rate of change of acceleration
• Accel - the rate of change of velocity (speed)
• Velocity - the speed of the rotation
• Distance - the distance the phone has been rotated

The units of rotation are radians: 2 Pi (approx. 6.28 radians) means a full rotation around an axis.

The X Y Z buttons allow you to select what axis you want to use. Normally you select just one axis. You can select more than one axis if you wish, but that will mean you can then only use the magnitude of the signal since the direction component is lost. In Distance mode only the first selected axis will be used, as multiple axes make no sense in this mode.

The +/- buttons allow you to select what direction you want to use for each axis. When +/- is selected then both positive and negative rotations are used, if + or - are selected then only the positive or negative rotations respectively are used. Distance mode always uses +/- inputs so these buttons disappear in this mode.

The Max value allows you to set the amount of rotation that will produce the maximum output. The units of this setting change depending on what type of input you have selected.

The Mag button allows you to control if the magnitude of the signal is used or not. When enabled, both positive and negative rotations will result in a positive output. When Mag is disabled, the output will centre half-way, positive rotation will increase the output, and negative rotation will decrease the output. Note that when you have more that one axis, or Distance mode, selected, the output will always be the magnitude, so the button disappears.

The Attack and Release controls are filters used to shape the attack and release time of the signal. This can be useful to create long decay times from a short initial movement. A x10 on each of these controls allows attack or decay times of up to 10 seconds to be set. In Distance mode the separate Attack and Release times are replaced by a single Filter value.

In Distance mode an extra Reset button appears which allows you to reset the distance output. The drop-down list selects where the reset button returns the output value to: top, middle or bottom.

The scope display at the bottom shows how the control signal has changed over the last few seconds.