..Help
.Objects
|
Knob
 |
Creates values in a variety of units. Also has add and multiply modes. |
Pins
| io |
letter |
name |
unit |
description |
| in |
+ | add | auto |
These inputs are disabled if mode is set to knob. |
|---|
| × | multiply |
|---|
| out |
= |
auto |
value or value +/× input |
|---|
Parameters
| name |
option |
key |
description |
| mode |
knob | k | No input, just produce the value. |
|---|
| add | a | Add the input to the value on the knob. |
| multiply | m | Multiply the input by the value on the knob. |
| turns |
The number of rotations required to get from -1 to +1. Use number keys 1 through 9 to adjust in 4x increments. |
|---|
| taper |
linear | l | |
|---|
| audio | a | logrithmic |
| units |
Sets the display units. Also effects connected objects with auto units |
|---|
| presets |
+1.0 | num 1 | set the value to 1.0 |
|---|
| 0.0 | num 0 | set the value to zero |
| neg | num - | negate the value |
| NumPad 2-9 | Custom preset configurations |
Notes
|
General
The knob can only output numbers between -1.0 and +1.0.
Applying a unit to a value will cause the display to show the appropriate numbers and text,
but the value itself will not change.
Set the number of turns on the knob for precise control.
This can be changed while adjusting the knob by pressing keyboard keys 1 through 9.
The knob has two control rings that may adjusted with the mouse.
The outer ring is always set at 1 turn.
The inner ring always responds according the current turns setting.
The keyboard cursor keys may also be used to adjust the value.
Hover the knob with the mouse and press up or down to change in increments of 1/16 × number of turns.
Press left and right to change in increments of 16 × number of turns.
NumPad 0 will set the knob value to 0.0.
Similarly, NumPad 1 will set the value to 1.0.
NumPad - will negate the value regardless what it is.
During play, the knob smoothes its output by taking 1024 samples to get to the new value.
Be aware of this when using knobs as start-up values.
The value you entered will not be ready until the next sample frame.
Edit Commands
The control panel for the knob contains an edit box in which you can enter values and commands.
Type in the parameters you want to change and either press Enter or select another control.
The knob will not change parameters that are not specified.
As you hover the controls on the panel, the helper text will display the commands to adjust that parameter in [brackets].
Commands are read from left to right and are, in general, not case sensitive.
Separate commands with spaces.
Different commands can be specified in an arbitrary order.
Erroneous input is simply ignored.
After the commands have been processed, the new full configuration will be displayed and selected.
The knob editor will not respond to 'small', 'wrap' or 'note interval' settings.
Edit Details
The number of turns must immediately precede the turns commands.
'10T', for example, correctly specifies 10 turns. 'turns 10', however, does not.
New units must precede or immediately follow their value.
For example, '500Hz', 'Hertz 500' and 'Hz 50turn 500', all specify setting the value and units to 50 hertz.
Numbers formatted in scientific notation may also be used. Use 'e' or 'd' to specify the exponent.
For example, '1.23e-2' is the same as 1.23×10-2, or 0.0123
Hertz and Seconds may be combined with engineering modifiers n u m K M G.
Lower case m means milli x0.001, capital M means mega x1000000.
| n | nano | billionth | ×0.000000001 | |
| u | micro | millionth | ×0.000001 | |
| m | milli | thousandth | ×0.001 | must be lower case |
| K | kilo | thousand | ×1000 | |
| M | mega | million | ×1000000 | must be CAPITAL |
| G | giga | billion | ×1000000000 | |
Values that are out of range will be clipped.
For example '10GHz' will be clipped to '22.050 KHz'.
Similarly, values that are very small will be clipped to 0.0.
For example, '50KSec' and '-1000dB'.
Note values can be specified as note letter, followed by an octave number, followed by an optional detune amount.
The octave starts at A.
The 'note' command may also be used.
For example, middle A (440Hz) is 'A4' or 'A04'.
Middle A detuned by 18.2 cents is 'A4-18.2'.
Use '#' and 'b' to specify sharp and flat. 'Cb4' for example.
Detune, sharp and flat will be rounded to the closest note.
Specifying 'G#4+99' for example, results in 'A5-1'.
Pan values can be entered as L or R followed by a number and an optional % symbol.
The number is interpreted as a percentage, positive values pan left, negative values pan right.
'R 60%' for example, is the same as 'pan -60', is the same as 'L -60'.
'center' and 'pan 0' are also the same.
Decibels should be preceded by a - sign to indicate attenuation, otherwise the value specified will be greater than 1.0.
To make the actual value negative, follow the unit with a 'neg' command.
For example, '-12db' is approximately the value '+0.25' and '-12db neg' is approximately '-0.25'.
Calculator
You can also use the editor as a simple calculator to convert between value, hertz, seconds, note frequency, BPM and FFT bins.
Simply follow the value unit with another unit that you want to convert to.
For example, '1Khz sec' results in '1ms' being displayed.
Similarly, '120BPM sec' converts to '500ms', 'C#3 hz' converts to '277.18Hz' and '5.5125khz bin' converts to '128bin'.
Presets
8 different preset configurations may stored in each knob.
Once set, these may be recalled by hovering the knob and pressing NumPad 2 through NumPad 9.
To store a configuration, first adjust the knob settings and value to the desired state.
Then select a slot from the preset list box and press the Set button.
|
|