# Types

Default units

## 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”. * 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

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

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

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

## NormalRange

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

## AudioRange

AudioRange values are between [-1, 1].

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

## Interval

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

## BPM

Beats per minute.

## Positive

The value must be greater than or equal to 0.

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

## Cents

A cent is a hundredth of a semitone.

## Degrees

Angle between 0 and 360.

## MIDI

A number representing a midi note.

## BarsBeatsSixteenths

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

## Samples

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

## Hertz

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

## Note

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

## Milliseconds

One millisecond is a thousandth of a second.

## Seconds

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

## Notation

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

docs generated Sep 15 2019