Default units


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”. * Object, ({“4n” : 3, “8t” : -1}). The resulting time is equal to the sum of all of the keys multiplied by the values in the object. * No Argument, for methods which accept time, no argument will be interpreted as “now” (i.e. the currentTime).


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.


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


Ticks are the basic subunit of the Transport. They are the smallest unit of time that the Transport supports.


Normal values are within the range [0, 1].


AudioRange values are between [-1, 1].


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.


Half-step note increments, i.e. 12 is an octave above the root. and 1 is a half-step up.


Beats per minute.


The value must be greater than or equal to 0.


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.


A cent is a hundredth of a semitone.


Angle between 0 and 360.


A number representing a midi note.


A colon-separated representation of time in the form of Bars:Beats:Sixteenths.


Sampling is the reduction of a continuous signal to a discrete signal. Audio is typically sampled 44100 times per second.


Hertz are a frequency representation defined as one cycle per second.


A frequency represented by a letter name, accidental and octave. This system is known as Scientific Pitch Notation.


One millisecond is a thousandth of a second.


Seconds are the time unit of the AudioContext. In the end, all values need to be evaluated to seconds.


A string representing a duration relative to a measure. * “4n” = quarter note * “2m” = two measures * “8t” = eighth-note triplet

docs generated Sep 15 2019