TicksClass < Unit >

  • Unit: string

Ticks is a primitive type for encoding Time values. Ticks can be constructed with or without the new keyword. Ticks can be passed into the parameter of any method which takes time as an argument.


import { Ticks } from "tone";
const t = Ticks("4n"); // a quarter note as ticks

Hierarchy

Constructor

new TicksClass (
context:BaseContext ,

The context associated with the time value. Used to computeTransport and context-relative timing.

value?:TimeValue ,

The time value as a number, string or object

units?:Unit

Unit values

) => TicksClass

Properties

debug #

boolean

Set this debug flag to log all events that happen in this class.

disposed #

readonly boolean

Indicates if the instance was disposed. 'Disposing' an instance means that all of the Web Audio nodes that were created for the instance are disconnected and freed for garbage collection.

name #

string

static version #

string

The version number semver

Methods

dispose #

disconnect and dispose.

dispose ( ) => this

fromType #

Coerce a time type into this units type.

fromType (
type:TimeBaseClass<any , any >

Any time type units

) => this

static getDefaults #

Returns all of the default options belonging to the class.

getDefaults ( ) => BaseToneOptions

quantize #

Quantize the time by the given subdivision. Optionally add a percentage which will move the time value towards the ideal quantized value by that percentage.


import { Time } from "tone";
Time(21).quantize(2); // returns 22
Time(0.6).quantize("4n", 0.5); // returns 0.55
quantize (
subdiv:Time ,

The subdivision to quantize to

percent= 1:number

Move the time value towards the quantized value by a percentage.

) => Ticks

toBarsBeatsSixteenths #

Return the time encoded as Bars:Beats:Sixteenths.

toBarsBeatsSixteenths ( ) => BarsBeatsSixteenths

toFrequency #

Return the value in hertz

toFrequency ( ) => Hertz

toMidi #

Return the value as a midi note.

toMidi ( ) => MidiNote

toMilliseconds #

Return the time in milliseconds.

toMilliseconds ( ) => Milliseconds

toNotation #

Convert a Time to Notation. The notation values are will be the closest representation between 1m to 128th note.


import { Time } from "tone";
// if the Transport is at 120bpm:
Time(2).toNotation(); // returns "1m"
toNotation ( ) => Subdivision

toSamples #

Return the time in samples

toSamples ( ) => Samples

toSeconds #

Return the time in seconds

toSeconds ( ) => Seconds

toString #

Convert the class to a string


import { Oscillator } from "tone";
const osc = new Oscillator();
console.log(osc.toString());
toString ( ) => string

toTicks #

Return the time in ticks

toTicks ( ) => Ticks

valueOf #

Evaluate the time value. Returns the time in seconds.

valueOf ( ) => Ticks