# 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 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

docs generated Sep 15 2019