Documentation
    Preparing search index...

    Class DrawClass

    Draw is useful for synchronizing visuals and audio events. Callbacks from Tone.Transport or any of the Tone.Event classes always happen before the scheduled time and are not synchronized to the animation frame so they are not good for triggering tightly synchronized visuals and sound. Draw makes it easy to schedule callbacks using the AudioContext time and uses requestAnimationFrame.

    Tone.Transport.schedule((time) => {
    	// use the time argument to schedule a callback with Draw
    	Tone.Draw.schedule(() => {
    		// do drawing or DOM manipulation here
    		console.log(time);
    	}, time);
    }, "+0.5");
    Tone.Transport.start();

    Hierarchy (View Summary)

    Index
    constructor
    anticipation context debug expiration name version
    blockTime disposed sampleTime
    _getPartialProperties cancel dispose get immediate log now schedule set toFrequency toSeconds toString toTicks getDefaults
    anticipation: number

    The amount of time before the scheduled time that the callback can be invoked. Default is half the time of an animation frame (0.008 seconds).

    context: BaseContext

    The context belonging to the node.

    debug: boolean

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

    expiration: number

    The duration after which events are not invoked.

    name: string

    The name of the class

    version: string

    The version number semver

    • get blockTime(): number

      The number of seconds of 1 processing block (128 samples)

      Returns number

      console.log(Tone.Destination.blockTime);
    • get disposed(): 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.

      Returns boolean

    • get sampleTime(): number

      The duration in seconds of one sample.

      Returns number

    Protected_getPartialProperties

    • Cancel events scheduled after the given time

      Parameters

      • Optionalafter: Time

        Time after which scheduled events will be removed from the scheduling timeline.

      Returns this

    • disconnect and dispose.

      Returns this

    • Return the current time of the Context clock without any lookAhead.

      Returns number

      setInterval(() => {
      	console.log(Tone.immediate());
      }, 100);

    • Prints the outputs to the console log for debugging purposes. Prints the contents only if either the object has a property called debug set to true, or a variable called TONE_DEBUG_CLASS is set to the name of the class.

      Parameters

      • ...args: any[]

      Returns void

      const osc = new Tone.Oscillator();
      // prints all logs originating from this oscillator
      osc.debug = true;
      // calls to start/stop will print in the console
      osc.start();

    • Return the current time of the Context clock plus the lookAhead.

      Returns number

      setInterval(() => {
      	console.log(Tone.now());
      }, 100);

    • Schedule a function at the given time to be invoked on the nearest animation frame.

      Parameters

      • callback: () => void

        Callback is invoked at the given time.

      • time: Time

        The time relative to the AudioContext time to invoke the callback.

      Returns this

      Tone.Transport.scheduleRepeat(time => {
      	Tone.Draw.schedule(() => console.log(time), time);
      }, 1);
      Tone.Transport.start();

    • Set multiple properties at once with an object.

      Parameters

      Returns this

      const filter = new Tone.Filter().toDestination();
      // set values using an object
      filter.set({
      	frequency: "C6",
      	type: "highpass"
      });
      const player = new Tone.Player("https://tonejs.github.io/audio/berklee/Analogsynth_octaves_highmid.mp3").connect(filter);
      player.autostart = true;

    • Convert the input to a frequency number

      Parameters

      Returns number

      const gain = new Tone.Gain();
      console.log(gain.toFrequency("4n"));

    • Convert the incoming time to seconds. This is calculated against the current TransportClass bpm

      Parameters

      Returns number

      const gain = new Tone.Gain();
      setInterval(() => console.log(gain.toSeconds("4n")), 100);
      // ramp the tempo to 60 bpm over 30 seconds
      Tone.getTransport().bpm.rampTo(60, 30);

    • Convert the class to a string

      Returns string

      const osc = new Tone.Oscillator();
      console.log(osc.toString());

    • Convert the input time into ticks

      Parameters

      Returns number

      const gain = new Tone.Gain();
      console.log(gain.toTicks("4n"));

    Settings
    Member Visibility

    On This Page
    Constructors
    Properties
    Accessors
    Methods