Types
Gain
Gain is the ratio between input and output of a signal. A gain of 0 is the same as silencing the signal. A gain of 1, causes no change to the incoming signal.
Default
Default units
BarsBeatsSixteenths
A colon-separated representation of time in the form of Bars:Beats:Sixteenths.
Cents
A cent is a hundredth of a semitone.
BPM
Beats per minute.
Decibels
Decibels are a logarithmic unit of measurement which is useful for volume because of the logarithmic way that we perceive loudness. 0 decibels means no change in volume. -10db is approximately half as loud and 10db is twice is loud.
AudioRange
AudioRange values are between [-1, 1].
MIDI
A number representing a midi note.
NormalRange
Normal values are within the range [0, 1].
Milliseconds
One millisecond is a thousandth of a second.
Hertz
Hertz are a frequency representation defined as one cycle per second.
Frequency
Frequency can be described similar to time, except ultimately the values are converted to frequency instead of seconds. A number is taken literally as the value in hertz. Additionally any of the Time encodings can be used. Note names in the form of NOTE OCTAVE (i.e. C4) are also accepted and converted to their frequency value.
Interval
Half-step note increments, i.e. 12 is an octave above the root. and 1 is a half-step up.
Degrees
Angle between 0 and 360.
Notation
A string representing a duration relative to a measure. * “4n” = quarter note * “2m” = two measures * “8t” = eighth-note triplet
Note
A frequency represented by a letter name, accidental and octave. This system is known as Scientific Pitch Notation.
Positive
The value must be greater than or equal to 0.
Samples
Sampling is the reduction of a continuous signal to a discrete signal. Audio is typically sampled 44100 times per second.
Seconds
Seconds are the time unit of the AudioContext. In the end, all values need to be evaluated to seconds.
Ticks
Ticks are the basic subunit of the Transport. They are the smallest unit of time that the Transport supports.
Time
Time can be described in a number of ways. Read more Time. * Numbers, which will be taken literally as the time (in seconds). * Notation, (“4n”, “8t”) describes time in BPM and time signature relative values. * TransportTime, (“4:3:2”) will also provide tempo and time signature relative times in the form BARS:QUARTERS:SIXTEENTHS. * Frequency, (“8hz”) is converted to the length of the cycle in seconds. * Now-Relative, (“+1”) prefix any of the above with “+” and it will be interpreted as “the current time plus whatever expression follows”. * Expressions, (“3:0 + 2 - (1m / 7)”) any of the above can also be combined into a mathematical expression which will be evaluated to compute the desired time. * No Argument, for methods which accept time, no argument will be interpreted as “now” (i.e. the currentTime).
TransportTime
TransportTime describes a position along the Transport’s timeline. It is similar to Time in that it uses all the same encodings, but TransportTime specifically pertains to the Transport’s timeline, which is startable, stoppable, loopable, and seekable. Read more