forked from Open-CT/openct-tasks
12353 lines
438 KiB
JavaScript
12353 lines
438 KiB
JavaScript
/*! p5.sound.js v0.3.7 2018-01-19 */
|
|
/**
|
|
* p5.sound extends p5 with <a href="http://caniuse.com/audio-api"
|
|
* target="_blank">Web Audio</a> functionality including audio input,
|
|
* playback, analysis and synthesis.
|
|
* <br/><br/>
|
|
* <a href="#/p5.SoundFile"><b>p5.SoundFile</b></a>: Load and play sound files.<br/>
|
|
* <a href="#/p5.Amplitude"><b>p5.Amplitude</b></a>: Get the current volume of a sound.<br/>
|
|
* <a href="#/p5.AudioIn"><b>p5.AudioIn</b></a>: Get sound from an input source, typically
|
|
* a computer microphone.<br/>
|
|
* <a href="#/p5.FFT"><b>p5.FFT</b></a>: Analyze the frequency of sound. Returns
|
|
* results from the frequency spectrum or time domain (waveform).<br/>
|
|
* <a href="#/p5.Oscillator"><b>p5.Oscillator</b></a>: Generate Sine,
|
|
* Triangle, Square and Sawtooth waveforms. Base class of
|
|
* <a href="#/p5.Noise">p5.Noise</a> and <a href="#/p5.Pulse">p5.Pulse</a>.
|
|
* <br/>
|
|
* <a href="#/p5.Env"><b>p5.Env</b></a>: An Envelope is a series
|
|
* of fades over time. Often used to control an object's
|
|
* output gain level as an "ADSR Envelope" (Attack, Decay,
|
|
* Sustain, Release). Can also modulate other parameters.<br/>
|
|
* <a href="#/p5.Delay"><b>p5.Delay</b></a>: A delay effect with
|
|
* parameters for feedback, delayTime, and lowpass filter.<br/>
|
|
* <a href="#/p5.Filter"><b>p5.Filter</b></a>: Filter the frequency range of a
|
|
* sound.
|
|
* <br/>
|
|
* <a href="#/p5.Reverb"><b>p5.Reverb</b></a>: Add reverb to a sound by specifying
|
|
* duration and decay. <br/>
|
|
* <b><a href="#/p5.Convolver">p5.Convolver</a>:</b> Extends
|
|
* <a href="#/p5.Reverb">p5.Reverb</a> to simulate the sound of real
|
|
* physical spaces through convolution.<br/>
|
|
* <b><a href="#/p5.SoundRecorder">p5.SoundRecorder</a></b>: Record sound for playback
|
|
* / save the .wav file.
|
|
* <b><a href="#/p5.Phrase">p5.Phrase</a></b>, <b><a href="#/p5.Part">p5.Part</a></b> and
|
|
* <b><a href="#/p5.Score">p5.Score</a></b>: Compose musical sequences.
|
|
* <br/><br/>
|
|
* p5.sound is on <a href="https://github.com/therewasaguy/p5.sound/">GitHub</a>.
|
|
* Download the latest version
|
|
* <a href="https://github.com/therewasaguy/p5.sound/blob/master/lib/p5.sound.js">here</a>.
|
|
*
|
|
* @module p5.sound
|
|
* @submodule p5.sound
|
|
* @for p5.sound
|
|
* @main
|
|
*/
|
|
|
|
/**
|
|
* p5.sound
|
|
* https://p5js.org/reference/#/libraries/p5.sound
|
|
*
|
|
* From the Processing Foundation and contributors
|
|
* https://github.com/processing/p5.js-sound/graphs/contributors
|
|
*
|
|
* MIT License (MIT)
|
|
* https://github.com/processing/p5.js-sound/blob/master/LICENSE
|
|
*
|
|
* Some of the many audio libraries & resources that inspire p5.sound:
|
|
* - TONE.js (c) Yotam Mann. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js
|
|
* - buzz.js (c) Jay Salvat. Licensed under The MIT License (MIT). http://buzz.jaysalvat.com/
|
|
* - Boris Smus Web Audio API book, 2013. Licensed under the Apache License http://www.apache.org/licenses/LICENSE-2.0
|
|
* - wavesurfer.js https://github.com/katspaugh/wavesurfer.js
|
|
* - Web Audio Components by Jordan Santell https://github.com/web-audio-components
|
|
* - Wilm Thoben's Sound library for Processing https://github.com/processing/processing/tree/master/java/libraries/sound
|
|
*
|
|
* Web Audio API: http://w3.org/TR/webaudio/
|
|
*/
|
|
|
|
(function (root, factory) {
|
|
if (typeof define === 'function' && define.amd)
|
|
define('p5.sound', ['p5'], function (p5) { (factory(p5));});
|
|
else if (typeof exports === 'object')
|
|
factory(require('../p5'));
|
|
else
|
|
factory(root['p5']);
|
|
}(this, function (p5) {
|
|
|
|
var sndcore;
|
|
'use strict';
|
|
sndcore = function () {
|
|
/* AudioContext Monkeypatch
|
|
Copyright 2013 Chris Wilson
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
(function () {
|
|
function fixSetTarget(param) {
|
|
if (!param)
|
|
// if NYI, just return
|
|
return;
|
|
if (!param.setTargetAtTime)
|
|
param.setTargetAtTime = param.setTargetValueAtTime;
|
|
}
|
|
if (window.hasOwnProperty('webkitAudioContext') && !window.hasOwnProperty('AudioContext')) {
|
|
window.AudioContext = window.webkitAudioContext;
|
|
if (typeof AudioContext.prototype.createGain !== 'function')
|
|
AudioContext.prototype.createGain = AudioContext.prototype.createGainNode;
|
|
if (typeof AudioContext.prototype.createDelay !== 'function')
|
|
AudioContext.prototype.createDelay = AudioContext.prototype.createDelayNode;
|
|
if (typeof AudioContext.prototype.createScriptProcessor !== 'function')
|
|
AudioContext.prototype.createScriptProcessor = AudioContext.prototype.createJavaScriptNode;
|
|
if (typeof AudioContext.prototype.createPeriodicWave !== 'function')
|
|
AudioContext.prototype.createPeriodicWave = AudioContext.prototype.createWaveTable;
|
|
AudioContext.prototype.internal_createGain = AudioContext.prototype.createGain;
|
|
AudioContext.prototype.createGain = function () {
|
|
var node = this.internal_createGain();
|
|
fixSetTarget(node.gain);
|
|
return node;
|
|
};
|
|
AudioContext.prototype.internal_createDelay = AudioContext.prototype.createDelay;
|
|
AudioContext.prototype.createDelay = function (maxDelayTime) {
|
|
var node = maxDelayTime ? this.internal_createDelay(maxDelayTime) : this.internal_createDelay();
|
|
fixSetTarget(node.delayTime);
|
|
return node;
|
|
};
|
|
AudioContext.prototype.internal_createBufferSource = AudioContext.prototype.createBufferSource;
|
|
AudioContext.prototype.createBufferSource = function () {
|
|
var node = this.internal_createBufferSource();
|
|
if (!node.start) {
|
|
node.start = function (when, offset, duration) {
|
|
if (offset || duration)
|
|
this.noteGrainOn(when || 0, offset, duration);
|
|
else
|
|
this.noteOn(when || 0);
|
|
};
|
|
} else {
|
|
node.internal_start = node.start;
|
|
node.start = function (when, offset, duration) {
|
|
if (typeof duration !== 'undefined')
|
|
node.internal_start(when || 0, offset, duration);
|
|
else
|
|
node.internal_start(when || 0, offset || 0);
|
|
};
|
|
}
|
|
if (!node.stop) {
|
|
node.stop = function (when) {
|
|
this.noteOff(when || 0);
|
|
};
|
|
} else {
|
|
node.internal_stop = node.stop;
|
|
node.stop = function (when) {
|
|
node.internal_stop(when || 0);
|
|
};
|
|
}
|
|
fixSetTarget(node.playbackRate);
|
|
return node;
|
|
};
|
|
AudioContext.prototype.internal_createDynamicsCompressor = AudioContext.prototype.createDynamicsCompressor;
|
|
AudioContext.prototype.createDynamicsCompressor = function () {
|
|
var node = this.internal_createDynamicsCompressor();
|
|
fixSetTarget(node.threshold);
|
|
fixSetTarget(node.knee);
|
|
fixSetTarget(node.ratio);
|
|
fixSetTarget(node.reduction);
|
|
fixSetTarget(node.attack);
|
|
fixSetTarget(node.release);
|
|
return node;
|
|
};
|
|
AudioContext.prototype.internal_createBiquadFilter = AudioContext.prototype.createBiquadFilter;
|
|
AudioContext.prototype.createBiquadFilter = function () {
|
|
var node = this.internal_createBiquadFilter();
|
|
fixSetTarget(node.frequency);
|
|
fixSetTarget(node.detune);
|
|
fixSetTarget(node.Q);
|
|
fixSetTarget(node.gain);
|
|
return node;
|
|
};
|
|
if (typeof AudioContext.prototype.createOscillator !== 'function') {
|
|
AudioContext.prototype.internal_createOscillator = AudioContext.prototype.createOscillator;
|
|
AudioContext.prototype.createOscillator = function () {
|
|
var node = this.internal_createOscillator();
|
|
if (!node.start) {
|
|
node.start = function (when) {
|
|
this.noteOn(when || 0);
|
|
};
|
|
} else {
|
|
node.internal_start = node.start;
|
|
node.start = function (when) {
|
|
node.internal_start(when || 0);
|
|
};
|
|
}
|
|
if (!node.stop) {
|
|
node.stop = function (when) {
|
|
this.noteOff(when || 0);
|
|
};
|
|
} else {
|
|
node.internal_stop = node.stop;
|
|
node.stop = function (when) {
|
|
node.internal_stop(when || 0);
|
|
};
|
|
}
|
|
if (!node.setPeriodicWave)
|
|
node.setPeriodicWave = node.setWaveTable;
|
|
fixSetTarget(node.frequency);
|
|
fixSetTarget(node.detune);
|
|
return node;
|
|
};
|
|
}
|
|
}
|
|
if (window.hasOwnProperty('webkitOfflineAudioContext') && !window.hasOwnProperty('OfflineAudioContext')) {
|
|
window.OfflineAudioContext = window.webkitOfflineAudioContext;
|
|
}
|
|
}(window));
|
|
// <-- end MonkeyPatch.
|
|
// Create the Audio Context
|
|
var audiocontext = new window.AudioContext();
|
|
/**
|
|
* <p>Returns the Audio Context for this sketch. Useful for users
|
|
* who would like to dig deeper into the <a target='_blank' href=
|
|
* 'http://webaudio.github.io/web-audio-api/'>Web Audio API
|
|
* </a>.</p>
|
|
*
|
|
* @method getAudioContext
|
|
* @return {Object} AudioContext for this sketch
|
|
*/
|
|
p5.prototype.getAudioContext = function () {
|
|
return audiocontext;
|
|
};
|
|
// Polyfill for AudioIn, also handled by p5.dom createCapture
|
|
navigator.getUserMedia = navigator.getUserMedia || navigator.webkitGetUserMedia || navigator.mozGetUserMedia || navigator.msGetUserMedia;
|
|
/**
|
|
* Determine which filetypes are supported (inspired by buzz.js)
|
|
* The audio element (el) will only be used to test browser support for various audio formats
|
|
*/
|
|
var el = document.createElement('audio');
|
|
p5.prototype.isSupported = function () {
|
|
return !!el.canPlayType;
|
|
};
|
|
var isOGGSupported = function () {
|
|
return !!el.canPlayType && el.canPlayType('audio/ogg; codecs="vorbis"');
|
|
};
|
|
var isMP3Supported = function () {
|
|
return !!el.canPlayType && el.canPlayType('audio/mpeg;');
|
|
};
|
|
var isWAVSupported = function () {
|
|
return !!el.canPlayType && el.canPlayType('audio/wav; codecs="1"');
|
|
};
|
|
var isAACSupported = function () {
|
|
return !!el.canPlayType && (el.canPlayType('audio/x-m4a;') || el.canPlayType('audio/aac;'));
|
|
};
|
|
var isAIFSupported = function () {
|
|
return !!el.canPlayType && el.canPlayType('audio/x-aiff;');
|
|
};
|
|
p5.prototype.isFileSupported = function (extension) {
|
|
switch (extension.toLowerCase()) {
|
|
case 'mp3':
|
|
return isMP3Supported();
|
|
case 'wav':
|
|
return isWAVSupported();
|
|
case 'ogg':
|
|
return isOGGSupported();
|
|
case 'aac':
|
|
case 'm4a':
|
|
case 'mp4':
|
|
return isAACSupported();
|
|
case 'aif':
|
|
case 'aiff':
|
|
return isAIFSupported();
|
|
default:
|
|
return false;
|
|
}
|
|
};
|
|
// if it is iOS, we have to have a user interaction to start Web Audio
|
|
// http://paulbakaus.com/tutorials/html5/web-audio-on-ios/
|
|
var iOS = navigator.userAgent.match(/(iPad|iPhone|iPod)/g) ? true : false;
|
|
if (iOS) {
|
|
var iosStarted = false;
|
|
var startIOS = function () {
|
|
if (iosStarted)
|
|
return;
|
|
// create empty buffer
|
|
var buffer = audiocontext.createBuffer(1, 1, 22050);
|
|
var source = audiocontext.createBufferSource();
|
|
source.buffer = buffer;
|
|
// connect to output (your speakers)
|
|
source.connect(audiocontext.destination);
|
|
// play the file
|
|
source.start(0);
|
|
console.log('start ios!');
|
|
if (audiocontext.state === 'running') {
|
|
iosStarted = true;
|
|
}
|
|
};
|
|
document.addEventListener('touchend', startIOS, false);
|
|
document.addEventListener('touchstart', startIOS, false);
|
|
}
|
|
}();
|
|
var master;
|
|
'use strict';
|
|
master = function () {
|
|
/**
|
|
* Master contains AudioContext and the master sound output.
|
|
*/
|
|
var Master = function () {
|
|
var audiocontext = p5.prototype.getAudioContext();
|
|
this.input = audiocontext.createGain();
|
|
this.output = audiocontext.createGain();
|
|
//put a hard limiter on the output
|
|
this.limiter = audiocontext.createDynamicsCompressor();
|
|
this.limiter.threshold.value = 0;
|
|
this.limiter.ratio.value = 20;
|
|
this.audiocontext = audiocontext;
|
|
this.output.disconnect();
|
|
// connect input to limiter
|
|
this.input.connect(this.limiter);
|
|
// connect limiter to output
|
|
this.limiter.connect(this.output);
|
|
// meter is just for global Amplitude / FFT analysis
|
|
this.meter = audiocontext.createGain();
|
|
this.fftMeter = audiocontext.createGain();
|
|
this.output.connect(this.meter);
|
|
this.output.connect(this.fftMeter);
|
|
// connect output to destination
|
|
this.output.connect(this.audiocontext.destination);
|
|
// an array of all sounds in the sketch
|
|
this.soundArray = [];
|
|
// an array of all musical parts in the sketch
|
|
this.parts = [];
|
|
// file extensions to search for
|
|
this.extensions = [];
|
|
};
|
|
// create a single instance of the p5Sound / master output for use within this sketch
|
|
var p5sound = new Master();
|
|
/**
|
|
* Returns a number representing the master amplitude (volume) for sound
|
|
* in this sketch.
|
|
*
|
|
* @method getMasterVolume
|
|
* @return {Number} Master amplitude (volume) for sound in this sketch.
|
|
* Should be between 0.0 (silence) and 1.0.
|
|
*/
|
|
p5.prototype.getMasterVolume = function () {
|
|
return p5sound.output.gain.value;
|
|
};
|
|
/**
|
|
* <p>Scale the output of all sound in this sketch</p>
|
|
* Scaled between 0.0 (silence) and 1.0 (full volume).
|
|
* 1.0 is the maximum amplitude of a digital sound, so multiplying
|
|
* by greater than 1.0 may cause digital distortion. To
|
|
* fade, provide a <code>rampTime</code> parameter. For more
|
|
* complex fades, see the Env class.
|
|
*
|
|
* Alternately, you can pass in a signal source such as an
|
|
* oscillator to modulate the amplitude with an audio signal.
|
|
*
|
|
* <p><b>How This Works</b>: When you load the p5.sound module, it
|
|
* creates a single instance of p5sound. All sound objects in this
|
|
* module output to p5sound before reaching your computer's output.
|
|
* So if you change the amplitude of p5sound, it impacts all of the
|
|
* sound in this module.</p>
|
|
*
|
|
* <p>If no value is provided, returns a Web Audio API Gain Node</p>
|
|
*
|
|
* @method masterVolume
|
|
* @param {Number|Object} volume Volume (amplitude) between 0.0
|
|
* and 1.0 or modulating signal/oscillator
|
|
* @param {Number} [rampTime] Fade for t seconds
|
|
* @param {Number} [timeFromNow] Schedule this event to happen at
|
|
* t seconds in the future
|
|
*/
|
|
p5.prototype.masterVolume = function (vol, rampTime, tFromNow) {
|
|
if (typeof vol === 'number') {
|
|
var rampTime = rampTime || 0;
|
|
var tFromNow = tFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var currentVol = p5sound.output.gain.value;
|
|
p5sound.output.gain.cancelScheduledValues(now + tFromNow);
|
|
p5sound.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow);
|
|
p5sound.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime);
|
|
} else if (vol) {
|
|
vol.connect(p5sound.output.gain);
|
|
} else {
|
|
// return the Gain Node
|
|
return p5sound.output.gain;
|
|
}
|
|
};
|
|
/**
|
|
* `p5.soundOut` is the p5.sound master output. It sends output to
|
|
* the destination of this window's web audio context. It contains
|
|
* Web Audio API nodes including a dyanmicsCompressor (<code>.limiter</code>),
|
|
* and Gain Nodes for <code>.input</code> and <code>.output</code>.
|
|
*
|
|
* @property {Object} soundOut
|
|
*/
|
|
p5.prototype.soundOut = p5.soundOut = p5sound;
|
|
/**
|
|
* a silent connection to the DesinationNode
|
|
* which will ensure that anything connected to it
|
|
* will not be garbage collected
|
|
*
|
|
* @private
|
|
*/
|
|
p5.soundOut._silentNode = p5sound.audiocontext.createGain();
|
|
p5.soundOut._silentNode.gain.value = 0;
|
|
p5.soundOut._silentNode.connect(p5sound.audiocontext.destination);
|
|
return p5sound;
|
|
}();
|
|
var helpers;
|
|
'use strict';
|
|
helpers = function () {
|
|
var p5sound = master;
|
|
/**
|
|
* @for p5
|
|
*/
|
|
/**
|
|
* Returns a number representing the sample rate, in samples per second,
|
|
* of all sound objects in this audio context. It is determined by the
|
|
* sampling rate of your operating system's sound card, and it is not
|
|
* currently possile to change.
|
|
* It is often 44100, or twice the range of human hearing.
|
|
*
|
|
* @method sampleRate
|
|
* @return {Number} samplerate samples per second
|
|
*/
|
|
p5.prototype.sampleRate = function () {
|
|
return p5sound.audiocontext.sampleRate;
|
|
};
|
|
/**
|
|
* Returns the closest MIDI note value for
|
|
* a given frequency.
|
|
*
|
|
* @method freqToMidi
|
|
* @param {Number} frequency A freqeuncy, for example, the "A"
|
|
* above Middle C is 440Hz
|
|
* @return {Number} MIDI note value
|
|
*/
|
|
p5.prototype.freqToMidi = function (f) {
|
|
var mathlog2 = Math.log(f / 440) / Math.log(2);
|
|
var m = Math.round(12 * mathlog2) + 69;
|
|
return m;
|
|
};
|
|
/**
|
|
* Returns the frequency value of a MIDI note value.
|
|
* General MIDI treats notes as integers where middle C
|
|
* is 60, C# is 61, D is 62 etc. Useful for generating
|
|
* musical frequencies with oscillators.
|
|
*
|
|
* @method midiToFreq
|
|
* @param {Number} midiNote The number of a MIDI note
|
|
* @return {Number} Frequency value of the given MIDI note
|
|
* @example
|
|
* <div><code>
|
|
* var notes = [60, 64, 67, 72];
|
|
* var i = 0;
|
|
*
|
|
* function setup() {
|
|
* osc = new p5.Oscillator('Triangle');
|
|
* osc.start();
|
|
* frameRate(1);
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* var freq = midiToFreq(notes[i]);
|
|
* osc.freq(freq);
|
|
* i++;
|
|
* if (i >= notes.length){
|
|
* i = 0;
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.prototype.midiToFreq = function (m) {
|
|
return 440 * Math.pow(2, (m - 69) / 12);
|
|
};
|
|
/**
|
|
* List the SoundFile formats that you will include. LoadSound
|
|
* will search your directory for these extensions, and will pick
|
|
* a format that is compatable with the client's web browser.
|
|
* <a href="http://media.io/">Here</a> is a free online file
|
|
* converter.
|
|
*
|
|
* @method soundFormats
|
|
* @param {String} [...formats] i.e. 'mp3', 'wav', 'ogg'
|
|
* @example
|
|
* <div><code>
|
|
* function preload() {
|
|
* // set the global sound formats
|
|
* soundFormats('mp3', 'ogg');
|
|
*
|
|
* // load either beatbox.mp3, or .ogg, depending on browser
|
|
* mySound = loadSound('assets/beatbox.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* mySound.play();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.prototype.soundFormats = function () {
|
|
// reset extensions array
|
|
p5sound.extensions = [];
|
|
// add extensions
|
|
for (var i = 0; i < arguments.length; i++) {
|
|
arguments[i] = arguments[i].toLowerCase();
|
|
if ([
|
|
'mp3',
|
|
'wav',
|
|
'ogg',
|
|
'm4a',
|
|
'aac'
|
|
].indexOf(arguments[i]) > -1) {
|
|
p5sound.extensions.push(arguments[i]);
|
|
} else {
|
|
throw arguments[i] + ' is not a valid sound format!';
|
|
}
|
|
}
|
|
};
|
|
p5.prototype.disposeSound = function () {
|
|
for (var i = 0; i < p5sound.soundArray.length; i++) {
|
|
p5sound.soundArray[i].dispose();
|
|
}
|
|
};
|
|
// register removeSound to dispose of p5sound SoundFiles, Convolvers,
|
|
// Oscillators etc when sketch ends
|
|
p5.prototype.registerMethod('remove', p5.prototype.disposeSound);
|
|
p5.prototype._checkFileFormats = function (paths) {
|
|
var path;
|
|
// if path is a single string, check to see if extension is provided
|
|
if (typeof paths === 'string') {
|
|
path = paths;
|
|
// see if extension is provided
|
|
var extTest = path.split('.').pop();
|
|
// if an extension is provided...
|
|
if ([
|
|
'mp3',
|
|
'wav',
|
|
'ogg',
|
|
'm4a',
|
|
'aac'
|
|
].indexOf(extTest) > -1) {
|
|
if (p5.prototype.isFileSupported(extTest)) {
|
|
path = path;
|
|
} else {
|
|
var pathSplit = path.split('.');
|
|
var pathCore = pathSplit[pathSplit.length - 1];
|
|
for (var i = 0; i < p5sound.extensions.length; i++) {
|
|
var extension = p5sound.extensions[i];
|
|
var supported = p5.prototype.isFileSupported(extension);
|
|
if (supported) {
|
|
pathCore = '';
|
|
if (pathSplit.length === 2) {
|
|
pathCore += pathSplit[0];
|
|
}
|
|
for (var i = 1; i <= pathSplit.length - 2; i++) {
|
|
var p = pathSplit[i];
|
|
pathCore += '.' + p;
|
|
}
|
|
path = pathCore += '.';
|
|
path = path += extension;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
} else {
|
|
for (var i = 0; i < p5sound.extensions.length; i++) {
|
|
var extension = p5sound.extensions[i];
|
|
var supported = p5.prototype.isFileSupported(extension);
|
|
if (supported) {
|
|
path = path + '.' + extension;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
} else if (typeof paths === 'object') {
|
|
for (var i = 0; i < paths.length; i++) {
|
|
var extension = paths[i].split('.').pop();
|
|
var supported = p5.prototype.isFileSupported(extension);
|
|
if (supported) {
|
|
// console.log('.'+extension + ' is ' + supported +
|
|
// ' supported by your browser.');
|
|
path = paths[i];
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
return path;
|
|
};
|
|
/**
|
|
* Used by Osc and Env to chain signal math
|
|
*/
|
|
p5.prototype._mathChain = function (o, math, thisChain, nextChain, type) {
|
|
// if this type of math already exists in the chain, replace it
|
|
for (var i in o.mathOps) {
|
|
if (o.mathOps[i] instanceof type) {
|
|
o.mathOps[i].dispose();
|
|
thisChain = i;
|
|
if (thisChain < o.mathOps.length - 1) {
|
|
nextChain = o.mathOps[i + 1];
|
|
}
|
|
}
|
|
}
|
|
o.mathOps[thisChain - 1].disconnect();
|
|
o.mathOps[thisChain - 1].connect(math);
|
|
math.connect(nextChain);
|
|
o.mathOps[thisChain] = math;
|
|
return o;
|
|
};
|
|
return { midiToFreq: p5.prototype.midiToFreq };
|
|
}(master);
|
|
var errorHandler;
|
|
'use strict';
|
|
errorHandler = function () {
|
|
/*
|
|
Helper function to generate an error
|
|
with a custom stack trace that points to the sketch
|
|
and removes other parts of the stack trace.
|
|
|
|
@private
|
|
@class customError
|
|
@constructor
|
|
@param {String} name custom error name
|
|
@param {String} errorTrace custom error trace
|
|
@param {String} failedPath path to the file that failed to load
|
|
@property {String} name custom error name
|
|
@property {String} message custom error message
|
|
@property {String} stack trace the error back to a line in the user's sketch.
|
|
Note: this edits out stack trace within p5.js and p5.sound.
|
|
@property {String} originalStack unedited, original stack trace
|
|
@property {String} failedPath path to the file that failed to load
|
|
@return {Error} returns a custom Error object
|
|
*/
|
|
var CustomError = function (name, errorTrace, failedPath) {
|
|
var err = new Error();
|
|
var tempStack, splitStack;
|
|
err.name = name;
|
|
err.originalStack = err.stack + errorTrace;
|
|
tempStack = err.stack + errorTrace;
|
|
err.failedPath = failedPath;
|
|
// only print the part of the stack trace that refers to the user code:
|
|
var splitStack = tempStack.split('\n');
|
|
splitStack = splitStack.filter(function (ln) {
|
|
return !ln.match(/(p5.|native code|globalInit)/g);
|
|
});
|
|
err.stack = splitStack.join('\n');
|
|
return err;
|
|
};
|
|
return CustomError;
|
|
}();
|
|
var panner;
|
|
'use strict';
|
|
panner = function () {
|
|
var p5sound = master;
|
|
var ac = p5sound.audiocontext;
|
|
// Stereo panner
|
|
// if there is a stereo panner node use it
|
|
if (typeof ac.createStereoPanner !== 'undefined') {
|
|
p5.Panner = function (input, output) {
|
|
this.stereoPanner = this.input = ac.createStereoPanner();
|
|
input.connect(this.stereoPanner);
|
|
this.stereoPanner.connect(output);
|
|
};
|
|
p5.Panner.prototype.pan = function (val, tFromNow) {
|
|
var time = tFromNow || 0;
|
|
var t = ac.currentTime + time;
|
|
this.stereoPanner.pan.linearRampToValueAtTime(val, t);
|
|
};
|
|
//not implemented because stereopanner
|
|
//node does not require this and will automatically
|
|
//convert single channel or multichannel to stereo.
|
|
//tested with single and stereo, not with (>2) multichannel
|
|
p5.Panner.prototype.inputChannels = function () {
|
|
};
|
|
p5.Panner.prototype.connect = function (obj) {
|
|
this.stereoPanner.connect(obj);
|
|
};
|
|
p5.Panner.prototype.disconnect = function () {
|
|
this.stereoPanner.disconnect();
|
|
};
|
|
} else {
|
|
// if there is no createStereoPanner object
|
|
// such as in safari 7.1.7 at the time of writing this
|
|
// use this method to create the effect
|
|
p5.Panner = function (input, output, numInputChannels) {
|
|
this.input = ac.createGain();
|
|
input.connect(this.input);
|
|
this.left = ac.createGain();
|
|
this.right = ac.createGain();
|
|
this.left.channelInterpretation = 'discrete';
|
|
this.right.channelInterpretation = 'discrete';
|
|
// if input is stereo
|
|
if (numInputChannels > 1) {
|
|
this.splitter = ac.createChannelSplitter(2);
|
|
this.input.connect(this.splitter);
|
|
this.splitter.connect(this.left, 1);
|
|
this.splitter.connect(this.right, 0);
|
|
} else {
|
|
this.input.connect(this.left);
|
|
this.input.connect(this.right);
|
|
}
|
|
this.output = ac.createChannelMerger(2);
|
|
this.left.connect(this.output, 0, 1);
|
|
this.right.connect(this.output, 0, 0);
|
|
this.output.connect(output);
|
|
};
|
|
// -1 is left, +1 is right
|
|
p5.Panner.prototype.pan = function (val, tFromNow) {
|
|
var time = tFromNow || 0;
|
|
var t = ac.currentTime + time;
|
|
var v = (val + 1) / 2;
|
|
var rightVal = Math.cos(v * Math.PI / 2);
|
|
var leftVal = Math.sin(v * Math.PI / 2);
|
|
this.left.gain.linearRampToValueAtTime(leftVal, t);
|
|
this.right.gain.linearRampToValueAtTime(rightVal, t);
|
|
};
|
|
p5.Panner.prototype.inputChannels = function (numChannels) {
|
|
if (numChannels === 1) {
|
|
this.input.disconnect();
|
|
this.input.connect(this.left);
|
|
this.input.connect(this.right);
|
|
} else if (numChannels === 2) {
|
|
if (typeof (this.splitter === 'undefined')) {
|
|
this.splitter = ac.createChannelSplitter(2);
|
|
}
|
|
this.input.disconnect();
|
|
this.input.connect(this.splitter);
|
|
this.splitter.connect(this.left, 1);
|
|
this.splitter.connect(this.right, 0);
|
|
}
|
|
};
|
|
p5.Panner.prototype.connect = function (obj) {
|
|
this.output.connect(obj);
|
|
};
|
|
p5.Panner.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
};
|
|
}
|
|
}(master);
|
|
var soundfile;
|
|
'use strict';
|
|
soundfile = function () {
|
|
var CustomError = errorHandler;
|
|
var p5sound = master;
|
|
var ac = p5sound.audiocontext;
|
|
var midiToFreq = helpers.midiToFreq;
|
|
/**
|
|
* <p>SoundFile object with a path to a file.</p>
|
|
*
|
|
* <p>The p5.SoundFile may not be available immediately because
|
|
* it loads the file information asynchronously.</p>
|
|
*
|
|
* <p>To do something with the sound as soon as it loads
|
|
* pass the name of a function as the second parameter.</p>
|
|
*
|
|
* <p>Only one file path is required. However, audio file formats
|
|
* (i.e. mp3, ogg, wav and m4a/aac) are not supported by all
|
|
* web browsers. If you want to ensure compatability, instead of a single
|
|
* file path, you may include an Array of filepaths, and the browser will
|
|
* choose a format that works.</p>
|
|
*
|
|
* @class p5.SoundFile
|
|
* @constructor
|
|
* @param {String|Array} path path to a sound file (String). Optionally,
|
|
* you may include multiple file formats in
|
|
* an array. Alternately, accepts an object
|
|
* from the HTML5 File API, or a p5.File.
|
|
* @param {Function} [successCallback] Name of a function to call once file loads
|
|
* @param {Function} [errorCallback] Name of a function to call if file fails to
|
|
* load. This function will receive an error or
|
|
* XMLHttpRequest object with information
|
|
* about what went wrong.
|
|
* @param {Function} [whileLoadingCallback] Name of a function to call while file
|
|
* is loading. That function will
|
|
* receive progress of the request to
|
|
* load the sound file
|
|
* (between 0 and 1) as its first
|
|
* parameter. This progress
|
|
* does not account for the additional
|
|
* time needed to decode the audio data.
|
|
*
|
|
* @example
|
|
* <div><code>
|
|
*
|
|
* function preload() {
|
|
* soundFormats('mp3', 'ogg');
|
|
* mySound = loadSound('assets/doorbell.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* mySound.setVolume(0.1);
|
|
* mySound.play();
|
|
* }
|
|
*
|
|
* </code></div>
|
|
*/
|
|
p5.SoundFile = function (paths, onload, onerror, whileLoading) {
|
|
if (typeof paths !== 'undefined') {
|
|
if (typeof paths === 'string' || typeof paths[0] === 'string') {
|
|
var path = p5.prototype._checkFileFormats(paths);
|
|
this.url = path;
|
|
} else if (typeof paths === 'object') {
|
|
if (!(window.File && window.FileReader && window.FileList && window.Blob)) {
|
|
// The File API isn't supported in this browser
|
|
throw 'Unable to load file because the File API is not supported';
|
|
}
|
|
}
|
|
// if type is a p5.File...get the actual file
|
|
if (paths.file) {
|
|
paths = paths.file;
|
|
}
|
|
this.file = paths;
|
|
}
|
|
// private _onended callback, set by the method: onended(callback)
|
|
this._onended = function () {
|
|
};
|
|
this._looping = false;
|
|
this._playing = false;
|
|
this._paused = false;
|
|
this._pauseTime = 0;
|
|
// cues for scheduling events with addCue() removeCue()
|
|
this._cues = [];
|
|
// position of the most recently played sample
|
|
this._lastPos = 0;
|
|
this._counterNode = null;
|
|
this._scopeNode = null;
|
|
// array of sources so that they can all be stopped!
|
|
this.bufferSourceNodes = [];
|
|
// current source
|
|
this.bufferSourceNode = null;
|
|
this.buffer = null;
|
|
this.playbackRate = 1;
|
|
this.input = p5sound.audiocontext.createGain();
|
|
this.output = p5sound.audiocontext.createGain();
|
|
this.reversed = false;
|
|
// start and end of playback / loop
|
|
this.startTime = 0;
|
|
this.endTime = null;
|
|
this.pauseTime = 0;
|
|
// "restart" would stop playback before retriggering
|
|
this.mode = 'sustain';
|
|
// time that playback was started, in millis
|
|
this.startMillis = null;
|
|
// stereo panning
|
|
this.panPosition = 0;
|
|
this.panner = new p5.Panner(this.output, p5sound.input, 2);
|
|
// it is possible to instantiate a soundfile with no path
|
|
if (this.url || this.file) {
|
|
this.load(onload, onerror);
|
|
}
|
|
// add this p5.SoundFile to the soundArray
|
|
p5sound.soundArray.push(this);
|
|
if (typeof whileLoading === 'function') {
|
|
this._whileLoading = whileLoading;
|
|
} else {
|
|
this._whileLoading = function () {
|
|
};
|
|
}
|
|
};
|
|
// register preload handling of loadSound
|
|
p5.prototype.registerPreloadMethod('loadSound', p5.prototype);
|
|
/**
|
|
* loadSound() returns a new p5.SoundFile from a specified
|
|
* path. If called during preload(), the p5.SoundFile will be ready
|
|
* to play in time for setup() and draw(). If called outside of
|
|
* preload, the p5.SoundFile will not be ready immediately, so
|
|
* loadSound accepts a callback as the second parameter. Using a
|
|
* <a href="https://github.com/processing/p5.js/wiki/Local-server">
|
|
* local server</a> is recommended when loading external files.
|
|
*
|
|
* @method loadSound
|
|
* @param {String|Array} path Path to the sound file, or an array with
|
|
* paths to soundfiles in multiple formats
|
|
* i.e. ['sound.ogg', 'sound.mp3'].
|
|
* Alternately, accepts an object: either
|
|
* from the HTML5 File API, or a p5.File.
|
|
* @param {Function} [successCallback] Name of a function to call once file loads
|
|
* @param {Function} [errorCallback] Name of a function to call if there is
|
|
* an error loading the file.
|
|
* @param {Function} [whileLoading] Name of a function to call while file is loading.
|
|
* This function will receive the percentage loaded
|
|
* so far, from 0.0 to 1.0.
|
|
* @return {SoundFile} Returns a p5.SoundFile
|
|
* @example
|
|
* <div><code>
|
|
* function preload() {
|
|
* mySound = loadSound('assets/doorbell.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* mySound.setVolume(0.1);
|
|
* mySound.play();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.prototype.loadSound = function (path, callback, onerror, whileLoading) {
|
|
// if loading locally without a server
|
|
if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') {
|
|
window.alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS');
|
|
}
|
|
var self = this;
|
|
var s = new p5.SoundFile(path, function () {
|
|
if (typeof callback === 'function') {
|
|
callback.apply(self, arguments);
|
|
}
|
|
self._decrementPreload();
|
|
}, onerror, whileLoading);
|
|
return s;
|
|
};
|
|
/**
|
|
* This is a helper function that the p5.SoundFile calls to load
|
|
* itself. Accepts a callback (the name of another function)
|
|
* as an optional parameter.
|
|
*
|
|
* @private
|
|
* @param {Function} [successCallback] Name of a function to call once file loads
|
|
* @param {Function} [errorCallback] Name of a function to call if there is an error
|
|
*/
|
|
p5.SoundFile.prototype.load = function (callback, errorCallback) {
|
|
var self = this;
|
|
var errorTrace = new Error().stack;
|
|
if (this.url !== undefined && this.url !== '') {
|
|
var request = new XMLHttpRequest();
|
|
request.addEventListener('progress', function (evt) {
|
|
self._updateProgress(evt);
|
|
}, false);
|
|
request.open('GET', this.url, true);
|
|
request.responseType = 'arraybuffer';
|
|
request.onload = function () {
|
|
if (request.status === 200) {
|
|
// on sucess loading file:
|
|
ac.decodeAudioData(request.response, // success decoding buffer:
|
|
function (buff) {
|
|
self.buffer = buff;
|
|
self.panner.inputChannels(buff.numberOfChannels);
|
|
if (callback) {
|
|
callback(self);
|
|
}
|
|
}, // error decoding buffer. "e" is undefined in Chrome 11/22/2015
|
|
function () {
|
|
var err = new CustomError('decodeAudioData', errorTrace, self.url);
|
|
var msg = 'AudioContext error at decodeAudioData for ' + self.url;
|
|
if (errorCallback) {
|
|
err.msg = msg;
|
|
errorCallback(err);
|
|
} else {
|
|
console.error(msg + '\n The error stack trace includes: \n' + err.stack);
|
|
}
|
|
});
|
|
} else {
|
|
var err = new CustomError('loadSound', errorTrace, self.url);
|
|
var msg = 'Unable to load ' + self.url + '. The request status was: ' + request.status + ' (' + request.statusText + ')';
|
|
if (errorCallback) {
|
|
err.message = msg;
|
|
errorCallback(err);
|
|
} else {
|
|
console.error(msg + '\n The error stack trace includes: \n' + err.stack);
|
|
}
|
|
}
|
|
};
|
|
// if there is another error, aside from 404...
|
|
request.onerror = function () {
|
|
var err = new CustomError('loadSound', errorTrace, self.url);
|
|
var msg = 'There was no response from the server at ' + self.url + '. Check the url and internet connectivity.';
|
|
if (errorCallback) {
|
|
err.message = msg;
|
|
errorCallback(err);
|
|
} else {
|
|
console.error(msg + '\n The error stack trace includes: \n' + err.stack);
|
|
}
|
|
};
|
|
request.send();
|
|
} else if (this.file !== undefined) {
|
|
var reader = new FileReader();
|
|
reader.onload = function () {
|
|
ac.decodeAudioData(reader.result, function (buff) {
|
|
self.buffer = buff;
|
|
self.panner.inputChannels(buff.numberOfChannels);
|
|
if (callback) {
|
|
callback(self);
|
|
}
|
|
});
|
|
};
|
|
reader.onerror = function (e) {
|
|
if (onerror) {
|
|
onerror(e);
|
|
}
|
|
};
|
|
reader.readAsArrayBuffer(this.file);
|
|
}
|
|
};
|
|
// TO DO: use this method to create a loading bar that shows progress during file upload/decode.
|
|
p5.SoundFile.prototype._updateProgress = function (evt) {
|
|
if (evt.lengthComputable) {
|
|
var percentComplete = evt.loaded / evt.total * 0.99;
|
|
this._whileLoading(percentComplete, evt);
|
|
} else {
|
|
// Unable to compute progress information since the total size is unknown
|
|
this._whileLoading('size unknown');
|
|
}
|
|
};
|
|
/**
|
|
* Returns true if the sound file finished loading successfully.
|
|
*
|
|
* @method isLoaded
|
|
* @return {Boolean}
|
|
*/
|
|
p5.SoundFile.prototype.isLoaded = function () {
|
|
if (this.buffer) {
|
|
return true;
|
|
} else {
|
|
return false;
|
|
}
|
|
};
|
|
/**
|
|
* Play the p5.SoundFile
|
|
*
|
|
* @method play
|
|
* @param {Number} [startTime] (optional) schedule playback to start (in seconds from now).
|
|
* @param {Number} [rate] (optional) playback rate
|
|
* @param {Number} [amp] (optional) amplitude (volume)
|
|
* of playback
|
|
* @param {Number} [cueStart] (optional) cue start time in seconds
|
|
* @param {Number} [duration] (optional) duration of playback in seconds
|
|
*/
|
|
p5.SoundFile.prototype.play = function (startTime, rate, amp, _cueStart, duration) {
|
|
var self = this;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var cueStart, cueEnd;
|
|
var time = startTime || 0;
|
|
if (time < 0) {
|
|
time = 0;
|
|
}
|
|
time = time + now;
|
|
if (typeof rate !== 'undefined') {
|
|
this.rate(rate);
|
|
}
|
|
if (typeof amp !== 'undefined') {
|
|
this.setVolume(amp);
|
|
}
|
|
// TO DO: if already playing, create array of buffers for easy stop()
|
|
if (this.buffer) {
|
|
// reset the pause time (if it was paused)
|
|
this._pauseTime = 0;
|
|
// handle restart playmode
|
|
if (this.mode === 'restart' && this.buffer && this.bufferSourceNode) {
|
|
this.bufferSourceNode.stop(time);
|
|
this._counterNode.stop(time);
|
|
}
|
|
//dont create another instance if already playing
|
|
if (this.mode === 'untildone' && this.isPlaying()) {
|
|
return;
|
|
}
|
|
// make a new source and counter. They are automatically assigned playbackRate and buffer
|
|
this.bufferSourceNode = this._initSourceNode();
|
|
// garbage collect counterNode and create a new one
|
|
delete this._counterNode;
|
|
this._counterNode = this._initCounterNode();
|
|
if (_cueStart) {
|
|
if (_cueStart >= 0 && _cueStart < this.buffer.duration) {
|
|
// this.startTime = cueStart;
|
|
cueStart = _cueStart;
|
|
} else {
|
|
throw 'start time out of range';
|
|
}
|
|
} else {
|
|
cueStart = 0;
|
|
}
|
|
if (duration) {
|
|
// if duration is greater than buffer.duration, just play entire file anyway rather than throw an error
|
|
duration = duration <= this.buffer.duration - cueStart ? duration : this.buffer.duration;
|
|
}
|
|
// if it was paused, play at the pause position
|
|
if (this._paused) {
|
|
this.bufferSourceNode.start(time, this.pauseTime, duration);
|
|
this._counterNode.start(time, this.pauseTime, duration);
|
|
} else {
|
|
this.bufferSourceNode.start(time, cueStart, duration);
|
|
this._counterNode.start(time, cueStart, duration);
|
|
}
|
|
this._playing = true;
|
|
this._paused = false;
|
|
// add source to sources array, which is used in stopAll()
|
|
this.bufferSourceNodes.push(this.bufferSourceNode);
|
|
this.bufferSourceNode._arrayIndex = this.bufferSourceNodes.length - 1;
|
|
// delete this.bufferSourceNode from the sources array when it is done playing:
|
|
var clearOnEnd = function () {
|
|
this._playing = false;
|
|
this.removeEventListener('ended', clearOnEnd, false);
|
|
// call the onended callback
|
|
self._onended(self);
|
|
self.bufferSourceNodes.forEach(function (n, i) {
|
|
if (n._playing === false) {
|
|
self.bufferSourceNodes.splice(i);
|
|
}
|
|
});
|
|
if (self.bufferSourceNodes.length === 0) {
|
|
self._playing = false;
|
|
}
|
|
};
|
|
this.bufferSourceNode.onended = clearOnEnd;
|
|
} else {
|
|
throw 'not ready to play file, buffer has yet to load. Try preload()';
|
|
}
|
|
// if looping, will restart at original time
|
|
this.bufferSourceNode.loop = this._looping;
|
|
this._counterNode.loop = this._looping;
|
|
if (this._looping === true) {
|
|
cueEnd = duration ? duration : cueStart - 1e-15;
|
|
this.bufferSourceNode.loopStart = cueStart;
|
|
this.bufferSourceNode.loopEnd = cueEnd;
|
|
this._counterNode.loopStart = cueStart;
|
|
this._counterNode.loopEnd = cueEnd;
|
|
}
|
|
};
|
|
/**
|
|
* p5.SoundFile has two play modes: <code>restart</code> and
|
|
* <code>sustain</code>. Play Mode determines what happens to a
|
|
* p5.SoundFile if it is triggered while in the middle of playback.
|
|
* In sustain mode, playback will continue simultaneous to the
|
|
* new playback. In restart mode, play() will stop playback
|
|
* and start over. With untilDone, a sound will play only if it's
|
|
* not already playing. Sustain is the default mode.
|
|
*
|
|
* @method playMode
|
|
* @param {String} str 'restart' or 'sustain' or 'untilDone'
|
|
* @example
|
|
* <div><code>
|
|
* function setup(){
|
|
* mySound = loadSound('assets/Damscray_DancingTiger.mp3');
|
|
* }
|
|
* function mouseClicked() {
|
|
* mySound.playMode('sustain');
|
|
* mySound.play();
|
|
* }
|
|
* function keyPressed() {
|
|
* mySound.playMode('restart');
|
|
* mySound.play();
|
|
* }
|
|
*
|
|
* </code></div>
|
|
*/
|
|
p5.SoundFile.prototype.playMode = function (str) {
|
|
var s = str.toLowerCase();
|
|
// if restart, stop all other sounds from playing
|
|
if (s === 'restart' && this.buffer && this.bufferSourceNode) {
|
|
for (var i = 0; i < this.bufferSourceNodes.length - 1; i++) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.bufferSourceNodes[i].stop(now);
|
|
}
|
|
}
|
|
// set play mode to effect future playback
|
|
if (s === 'restart' || s === 'sustain' || s === 'untildone') {
|
|
this.mode = s;
|
|
} else {
|
|
throw 'Invalid play mode. Must be either "restart" or "sustain"';
|
|
}
|
|
};
|
|
/**
|
|
* Pauses a file that is currently playing. If the file is not
|
|
* playing, then nothing will happen.
|
|
*
|
|
* After pausing, .play() will resume from the paused
|
|
* position.
|
|
* If p5.SoundFile had been set to loop before it was paused,
|
|
* it will continue to loop after it is unpaused with .play().
|
|
*
|
|
* @method pause
|
|
* @param {Number} [startTime] (optional) schedule event to occur
|
|
* seconds from now
|
|
* @example
|
|
* <div><code>
|
|
* var soundFile;
|
|
*
|
|
* function preload() {
|
|
* soundFormats('ogg', 'mp3');
|
|
* soundFile = loadSound('assets/Damscray_02.mp3');
|
|
* }
|
|
* function setup() {
|
|
* background(0, 255, 0);
|
|
* soundFile.setVolume(0.1);
|
|
* soundFile.loop();
|
|
* }
|
|
* function keyTyped() {
|
|
* if (key == 'p') {
|
|
* soundFile.pause();
|
|
* background(255, 0, 0);
|
|
* }
|
|
* }
|
|
*
|
|
* function keyReleased() {
|
|
* if (key == 'p') {
|
|
* soundFile.play();
|
|
* background(0, 255, 0);
|
|
* }
|
|
* }
|
|
* </code>
|
|
* </div>
|
|
*/
|
|
p5.SoundFile.prototype.pause = function (startTime) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var time = startTime || 0;
|
|
var pTime = time + now;
|
|
if (this.isPlaying() && this.buffer && this.bufferSourceNode) {
|
|
this.pauseTime = this.currentTime();
|
|
this.bufferSourceNode.stop(pTime);
|
|
this._counterNode.stop(pTime);
|
|
this._paused = true;
|
|
this._playing = false;
|
|
this._pauseTime = this.currentTime();
|
|
} else {
|
|
this._pauseTime = 0;
|
|
}
|
|
};
|
|
/**
|
|
* Loop the p5.SoundFile. Accepts optional parameters to set the
|
|
* playback rate, playback volume, loopStart, loopEnd.
|
|
*
|
|
* @method loop
|
|
* @param {Number} [startTime] (optional) schedule event to occur
|
|
* seconds from now
|
|
* @param {Number} [rate] (optional) playback rate
|
|
* @param {Number} [amp] (optional) playback volume
|
|
* @param {Number} [cueLoopStart] (optional) startTime in seconds
|
|
* @param {Number} [duration] (optional) loop duration in seconds
|
|
*/
|
|
p5.SoundFile.prototype.loop = function (startTime, rate, amp, loopStart, duration) {
|
|
this._looping = true;
|
|
this.play(startTime, rate, amp, loopStart, duration);
|
|
};
|
|
/**
|
|
* Set a p5.SoundFile's looping flag to true or false. If the sound
|
|
* is currently playing, this change will take effect when it
|
|
* reaches the end of the current playback.
|
|
*
|
|
* @method setLoop
|
|
* @param {Boolean} Boolean set looping to true or false
|
|
*/
|
|
p5.SoundFile.prototype.setLoop = function (bool) {
|
|
if (bool === true) {
|
|
this._looping = true;
|
|
} else if (bool === false) {
|
|
this._looping = false;
|
|
} else {
|
|
throw 'Error: setLoop accepts either true or false';
|
|
}
|
|
if (this.bufferSourceNode) {
|
|
this.bufferSourceNode.loop = this._looping;
|
|
this._counterNode.loop = this._looping;
|
|
}
|
|
};
|
|
/**
|
|
* Returns 'true' if a p5.SoundFile is currently looping and playing, 'false' if not.
|
|
*
|
|
* @method isLooping
|
|
* @return {Boolean}
|
|
*/
|
|
p5.SoundFile.prototype.isLooping = function () {
|
|
if (!this.bufferSourceNode) {
|
|
return false;
|
|
}
|
|
if (this._looping === true && this.isPlaying() === true) {
|
|
return true;
|
|
}
|
|
return false;
|
|
};
|
|
/**
|
|
* Returns true if a p5.SoundFile is playing, false if not (i.e.
|
|
* paused or stopped).
|
|
*
|
|
* @method isPlaying
|
|
* @return {Boolean}
|
|
*/
|
|
p5.SoundFile.prototype.isPlaying = function () {
|
|
return this._playing;
|
|
};
|
|
/**
|
|
* Returns true if a p5.SoundFile is paused, false if not (i.e.
|
|
* playing or stopped).
|
|
*
|
|
* @method isPaused
|
|
* @return {Boolean}
|
|
*/
|
|
p5.SoundFile.prototype.isPaused = function () {
|
|
return this._paused;
|
|
};
|
|
/**
|
|
* Stop soundfile playback.
|
|
*
|
|
* @method stop
|
|
* @param {Number} [startTime] (optional) schedule event to occur
|
|
* in seconds from now
|
|
*/
|
|
p5.SoundFile.prototype.stop = function (timeFromNow) {
|
|
var time = timeFromNow || 0;
|
|
if (this.mode === 'sustain' || this.mode === 'untildone') {
|
|
this.stopAll(time);
|
|
this._playing = false;
|
|
this.pauseTime = 0;
|
|
this._paused = false;
|
|
} else if (this.buffer && this.bufferSourceNode) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var t = time || 0;
|
|
this.pauseTime = 0;
|
|
this.bufferSourceNode.stop(now + t);
|
|
this._counterNode.stop(now + t);
|
|
this._playing = false;
|
|
this._paused = false;
|
|
}
|
|
};
|
|
/**
|
|
* Stop playback on all of this soundfile's sources.
|
|
* @private
|
|
*/
|
|
p5.SoundFile.prototype.stopAll = function (_time) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var time = _time || 0;
|
|
if (this.buffer && this.bufferSourceNode) {
|
|
for (var i = 0; i < this.bufferSourceNodes.length; i++) {
|
|
if (typeof this.bufferSourceNodes[i] !== undefined) {
|
|
try {
|
|
this.bufferSourceNodes[i].onended = function () {
|
|
};
|
|
this.bufferSourceNodes[i].stop(now + time);
|
|
} catch (e) {
|
|
}
|
|
}
|
|
}
|
|
this._counterNode.stop(now + time);
|
|
this._onended(this);
|
|
}
|
|
};
|
|
/**
|
|
* Multiply the output volume (amplitude) of a sound file
|
|
* between 0.0 (silence) and 1.0 (full volume).
|
|
* 1.0 is the maximum amplitude of a digital sound, so multiplying
|
|
* by greater than 1.0 may cause digital distortion. To
|
|
* fade, provide a <code>rampTime</code> parameter. For more
|
|
* complex fades, see the Env class.
|
|
*
|
|
* Alternately, you can pass in a signal source such as an
|
|
* oscillator to modulate the amplitude with an audio signal.
|
|
*
|
|
* @method setVolume
|
|
* @param {Number|Object} volume Volume (amplitude) between 0.0
|
|
* and 1.0 or modulating signal/oscillator
|
|
* @param {Number} [rampTime] Fade for t seconds
|
|
* @param {Number} [timeFromNow] Schedule this event to happen at
|
|
* t seconds in the future
|
|
*/
|
|
p5.SoundFile.prototype.setVolume = function (vol, _rampTime, _tFromNow) {
|
|
if (typeof vol === 'number') {
|
|
var rampTime = _rampTime || 0;
|
|
var tFromNow = _tFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var currentVol = this.output.gain.value;
|
|
this.output.gain.cancelScheduledValues(now + tFromNow);
|
|
this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow);
|
|
this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime);
|
|
} else if (vol) {
|
|
vol.connect(this.output.gain);
|
|
} else {
|
|
// return the Gain Node
|
|
return this.output.gain;
|
|
}
|
|
};
|
|
// same as setVolume, to match Processing Sound
|
|
p5.SoundFile.prototype.amp = p5.SoundFile.prototype.setVolume;
|
|
// these are the same thing
|
|
p5.SoundFile.prototype.fade = p5.SoundFile.prototype.setVolume;
|
|
p5.SoundFile.prototype.getVolume = function () {
|
|
return this.output.gain.value;
|
|
};
|
|
/**
|
|
* Set the stereo panning of a p5.sound object to
|
|
* a floating point number between -1.0 (left) and 1.0 (right).
|
|
* Default is 0.0 (center).
|
|
*
|
|
* @method pan
|
|
* @param {Number} [panValue] Set the stereo panner
|
|
* @param {Number} [timeFromNow] schedule this event to happen
|
|
* seconds from now
|
|
* @example
|
|
* <div><code>
|
|
*
|
|
* var ball = {};
|
|
* var soundFile;
|
|
*
|
|
* function setup() {
|
|
* soundFormats('ogg', 'mp3');
|
|
* soundFile = loadSound('assets/beatbox.mp3');
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(0);
|
|
* ball.x = constrain(mouseX, 0, width);
|
|
* ellipse(ball.x, height/2, 20, 20)
|
|
* }
|
|
*
|
|
* function mousePressed(){
|
|
* // map the ball's x location to a panning degree
|
|
* // between -1.0 (left) and 1.0 (right)
|
|
* var panning = map(ball.x, 0., width,-1.0, 1.0);
|
|
* soundFile.pan(panning);
|
|
* soundFile.play();
|
|
* }
|
|
* </div></code>
|
|
*/
|
|
p5.SoundFile.prototype.pan = function (pval, tFromNow) {
|
|
this.panPosition = pval;
|
|
this.panner.pan(pval, tFromNow);
|
|
};
|
|
/**
|
|
* Returns the current stereo pan position (-1.0 to 1.0)
|
|
*
|
|
* @method getPan
|
|
* @return {Number} Returns the stereo pan setting of the Oscillator
|
|
* as a number between -1.0 (left) and 1.0 (right).
|
|
* 0.0 is center and default.
|
|
*/
|
|
p5.SoundFile.prototype.getPan = function () {
|
|
return this.panPosition;
|
|
};
|
|
/**
|
|
* Set the playback rate of a sound file. Will change the speed and the pitch.
|
|
* Values less than zero will reverse the audio buffer.
|
|
*
|
|
* @method rate
|
|
* @param {Number} [playbackRate] Set the playback rate. 1.0 is normal,
|
|
* .5 is half-speed, 2.0 is twice as fast.
|
|
* Values less than zero play backwards.
|
|
* @example
|
|
* <div><code>
|
|
* var song;
|
|
*
|
|
* function preload() {
|
|
* song = loadSound('assets/Damscray_DancingTiger.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* song.loop();
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(200);
|
|
*
|
|
* // Set the rate to a range between 0.1 and 4
|
|
* // Changing the rate also alters the pitch
|
|
* var speed = map(mouseY, 0.1, height, 0, 2);
|
|
* speed = constrain(speed, 0.01, 4);
|
|
* song.rate(speed);
|
|
*
|
|
* // Draw a circle to show what is going on
|
|
* stroke(0);
|
|
* fill(51, 100);
|
|
* ellipse(mouseX, 100, 48, 48);
|
|
* }
|
|
*
|
|
* </code>
|
|
* </div>
|
|
*
|
|
*/
|
|
p5.SoundFile.prototype.rate = function (playbackRate) {
|
|
var reverse = false;
|
|
if (typeof playbackRate === 'undefined') {
|
|
return this.playbackRate;
|
|
}
|
|
this.playbackRate = playbackRate;
|
|
if (playbackRate === 0) {
|
|
playbackRate = 1e-13;
|
|
} else if (playbackRate < 0 && !this.reversed) {
|
|
playbackRate = Math.abs(playbackRate);
|
|
reverse = true;
|
|
} else if (playbackRate > 0 && this.reversed) {
|
|
reverse = true;
|
|
}
|
|
if (this.bufferSourceNode) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.bufferSourceNode.playbackRate.cancelScheduledValues(now);
|
|
this.bufferSourceNode.playbackRate.linearRampToValueAtTime(Math.abs(playbackRate), now);
|
|
this._counterNode.playbackRate.cancelScheduledValues(now);
|
|
this._counterNode.playbackRate.linearRampToValueAtTime(Math.abs(playbackRate), now);
|
|
}
|
|
if (reverse) {
|
|
this.reverseBuffer();
|
|
}
|
|
return this.playbackRate;
|
|
};
|
|
// TO DO: document this
|
|
p5.SoundFile.prototype.setPitch = function (num) {
|
|
var newPlaybackRate = midiToFreq(num) / midiToFreq(60);
|
|
this.rate(newPlaybackRate);
|
|
};
|
|
p5.SoundFile.prototype.getPlaybackRate = function () {
|
|
return this.playbackRate;
|
|
};
|
|
/**
|
|
* Returns the duration of a sound file in seconds.
|
|
*
|
|
* @method duration
|
|
* @return {Number} The duration of the soundFile in seconds.
|
|
*/
|
|
p5.SoundFile.prototype.duration = function () {
|
|
// Return Duration
|
|
if (this.buffer) {
|
|
return this.buffer.duration;
|
|
} else {
|
|
return 0;
|
|
}
|
|
};
|
|
/**
|
|
* Return the current position of the p5.SoundFile playhead, in seconds.
|
|
* Time is relative to the normal buffer direction, so if `reverseBuffer`
|
|
* has been called, currentTime will count backwards.
|
|
*
|
|
* @method currentTime
|
|
* @return {Number} currentTime of the soundFile in seconds.
|
|
*/
|
|
p5.SoundFile.prototype.currentTime = function () {
|
|
return this.reversed ? Math.abs(this._lastPos - this.buffer.length) / ac.sampleRate : this._lastPos / ac.sampleRate;
|
|
};
|
|
/**
|
|
* Move the playhead of the song to a position, in seconds. Start timing
|
|
* and playback duration. If none are given, will reset the file to play
|
|
* entire duration from start to finish.
|
|
*
|
|
* @method jump
|
|
* @param {Number} cueTime cueTime of the soundFile in seconds.
|
|
* @param {Number} duration duration in seconds.
|
|
*/
|
|
p5.SoundFile.prototype.jump = function (cueTime, duration) {
|
|
if (cueTime < 0 || cueTime > this.buffer.duration) {
|
|
throw 'jump time out of range';
|
|
}
|
|
if (duration > this.buffer.duration - cueTime) {
|
|
throw 'end time out of range';
|
|
}
|
|
var cTime = cueTime || 0;
|
|
var dur = duration || undefined;
|
|
if (this.isPlaying()) {
|
|
this.stop(0);
|
|
}
|
|
this.play(0, this.playbackRate, this.output.gain.value, cTime, dur);
|
|
};
|
|
/**
|
|
* Return the number of channels in a sound file.
|
|
* For example, Mono = 1, Stereo = 2.
|
|
*
|
|
* @method channels
|
|
* @return {Number} [channels]
|
|
*/
|
|
p5.SoundFile.prototype.channels = function () {
|
|
return this.buffer.numberOfChannels;
|
|
};
|
|
/**
|
|
* Return the sample rate of the sound file.
|
|
*
|
|
* @method sampleRate
|
|
* @return {Number} [sampleRate]
|
|
*/
|
|
p5.SoundFile.prototype.sampleRate = function () {
|
|
return this.buffer.sampleRate;
|
|
};
|
|
/**
|
|
* Return the number of samples in a sound file.
|
|
* Equal to sampleRate * duration.
|
|
*
|
|
* @method frames
|
|
* @return {Number} [sampleCount]
|
|
*/
|
|
p5.SoundFile.prototype.frames = function () {
|
|
return this.buffer.length;
|
|
};
|
|
/**
|
|
* Returns an array of amplitude peaks in a p5.SoundFile that can be
|
|
* used to draw a static waveform. Scans through the p5.SoundFile's
|
|
* audio buffer to find the greatest amplitudes. Accepts one
|
|
* parameter, 'length', which determines size of the array.
|
|
* Larger arrays result in more precise waveform visualizations.
|
|
*
|
|
* Inspired by Wavesurfer.js.
|
|
*
|
|
* @method getPeaks
|
|
* @params {Number} [length] length is the size of the returned array.
|
|
* Larger length results in more precision.
|
|
* Defaults to 5*width of the browser window.
|
|
* @returns {Float32Array} Array of peaks.
|
|
*/
|
|
p5.SoundFile.prototype.getPeaks = function (length) {
|
|
if (this.buffer) {
|
|
// set length to window's width if no length is provided
|
|
if (!length) {
|
|
length = window.width * 5;
|
|
}
|
|
if (this.buffer) {
|
|
var buffer = this.buffer;
|
|
var sampleSize = buffer.length / length;
|
|
var sampleStep = ~~(sampleSize / 10) || 1;
|
|
var channels = buffer.numberOfChannels;
|
|
var peaks = new Float32Array(Math.round(length));
|
|
for (var c = 0; c < channels; c++) {
|
|
var chan = buffer.getChannelData(c);
|
|
for (var i = 0; i < length; i++) {
|
|
var start = ~~(i * sampleSize);
|
|
var end = ~~(start + sampleSize);
|
|
var max = 0;
|
|
for (var j = start; j < end; j += sampleStep) {
|
|
var value = chan[j];
|
|
if (value > max) {
|
|
max = value;
|
|
} else if (-value > max) {
|
|
max = value;
|
|
}
|
|
}
|
|
if (c === 0 || Math.abs(max) > peaks[i]) {
|
|
peaks[i] = max;
|
|
}
|
|
}
|
|
}
|
|
return peaks;
|
|
}
|
|
} else {
|
|
throw 'Cannot load peaks yet, buffer is not loaded';
|
|
}
|
|
};
|
|
/**
|
|
* Reverses the p5.SoundFile's buffer source.
|
|
* Playback must be handled separately (see example).
|
|
*
|
|
* @method reverseBuffer
|
|
* @example
|
|
* <div><code>
|
|
* var drum;
|
|
*
|
|
* function preload() {
|
|
* drum = loadSound('assets/drum.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* drum.reverseBuffer();
|
|
* drum.play();
|
|
* }
|
|
*
|
|
* </code>
|
|
* </div>
|
|
*/
|
|
p5.SoundFile.prototype.reverseBuffer = function () {
|
|
if (this.buffer) {
|
|
var currentPos = this._lastPos / ac.sampleRate;
|
|
var curVol = this.getVolume();
|
|
this.setVolume(0, 0.001);
|
|
const numChannels = this.buffer.numberOfChannels;
|
|
for (var i = 0; i < numChannels; i++) {
|
|
this.buffer.getChannelData(i).reverse();
|
|
}
|
|
// set reversed flag
|
|
this.reversed = !this.reversed;
|
|
if (currentPos) {
|
|
this.jump(this.duration() - currentPos);
|
|
}
|
|
this.setVolume(curVol, 0.001);
|
|
} else {
|
|
throw 'SoundFile is not done loading';
|
|
}
|
|
};
|
|
/**
|
|
* Schedule an event to be called when the soundfile
|
|
* reaches the end of a buffer. If the soundfile is
|
|
* playing through once, this will be called when it
|
|
* ends. If it is looping, it will be called when
|
|
* stop is called.
|
|
*
|
|
* @method onended
|
|
* @param {Function} callback function to call when the
|
|
* soundfile has ended.
|
|
*/
|
|
p5.SoundFile.prototype.onended = function (callback) {
|
|
this._onended = callback;
|
|
return this;
|
|
};
|
|
p5.SoundFile.prototype.add = function () {
|
|
};
|
|
p5.SoundFile.prototype.dispose = function () {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
// remove reference to soundfile
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
this.stop(now);
|
|
if (this.buffer && this.bufferSourceNode) {
|
|
for (var i = 0; i < this.bufferSourceNodes.length - 1; i++) {
|
|
if (this.bufferSourceNodes[i] !== null) {
|
|
this.bufferSourceNodes[i].disconnect();
|
|
try {
|
|
this.bufferSourceNodes[i].stop(now);
|
|
} catch (e) {
|
|
console.warning('no buffer source node to dispose');
|
|
}
|
|
this.bufferSourceNodes[i] = null;
|
|
}
|
|
}
|
|
if (this.isPlaying()) {
|
|
try {
|
|
this._counterNode.stop(now);
|
|
} catch (e) {
|
|
console.log(e);
|
|
}
|
|
this._counterNode = null;
|
|
}
|
|
}
|
|
if (this.output) {
|
|
this.output.disconnect();
|
|
this.output = null;
|
|
}
|
|
if (this.panner) {
|
|
this.panner.disconnect();
|
|
this.panner = null;
|
|
}
|
|
};
|
|
/**
|
|
* Connects the output of a p5sound object to input of another
|
|
* p5.sound object. For example, you may connect a p5.SoundFile to an
|
|
* FFT or an Effect. If no parameter is given, it will connect to
|
|
* the master output. Most p5sound objects connect to the master
|
|
* output when they are created.
|
|
*
|
|
* @method connect
|
|
* @param {Object} [object] Audio object that accepts an input
|
|
*/
|
|
p5.SoundFile.prototype.connect = function (unit) {
|
|
if (!unit) {
|
|
this.panner.connect(p5sound.input);
|
|
} else {
|
|
if (unit.hasOwnProperty('input')) {
|
|
this.panner.connect(unit.input);
|
|
} else {
|
|
this.panner.connect(unit);
|
|
}
|
|
}
|
|
};
|
|
/**
|
|
* Disconnects the output of this p5sound object.
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
p5.SoundFile.prototype.disconnect = function () {
|
|
this.panner.disconnect();
|
|
};
|
|
/**
|
|
*/
|
|
p5.SoundFile.prototype.getLevel = function () {
|
|
console.warn('p5.SoundFile.getLevel has been removed from the library. Use p5.Amplitude instead');
|
|
};
|
|
/**
|
|
* Reset the source for this SoundFile to a
|
|
* new path (URL).
|
|
*
|
|
* @method setPath
|
|
* @param {String} path path to audio file
|
|
* @param {Function} callback Callback
|
|
*/
|
|
p5.SoundFile.prototype.setPath = function (p, callback) {
|
|
var path = p5.prototype._checkFileFormats(p);
|
|
this.url = path;
|
|
this.load(callback);
|
|
};
|
|
/**
|
|
* Replace the current Audio Buffer with a new Buffer.
|
|
*
|
|
* @method setBuffer
|
|
* @param {Array} buf Array of Float32 Array(s). 2 Float32 Arrays
|
|
* will create a stereo source. 1 will create
|
|
* a mono source.
|
|
*/
|
|
p5.SoundFile.prototype.setBuffer = function (buf) {
|
|
var numChannels = buf.length;
|
|
var size = buf[0].length;
|
|
var newBuffer = ac.createBuffer(numChannels, size, ac.sampleRate);
|
|
if (!(buf[0] instanceof Float32Array)) {
|
|
buf[0] = new Float32Array(buf[0]);
|
|
}
|
|
for (var channelNum = 0; channelNum < numChannels; channelNum++) {
|
|
var channel = newBuffer.getChannelData(channelNum);
|
|
channel.set(buf[channelNum]);
|
|
}
|
|
this.buffer = newBuffer;
|
|
// set numbers of channels on input to the panner
|
|
this.panner.inputChannels(numChannels);
|
|
};
|
|
//////////////////////////////////////////////////
|
|
// script processor node with an empty buffer to help
|
|
// keep a sample-accurate position in playback buffer.
|
|
// Inspired by Chinmay Pendharkar's technique for Sonoport --> http://bit.ly/1HwdCsV
|
|
// Copyright [2015] [Sonoport (Asia) Pte. Ltd.],
|
|
// Licensed under the Apache License http://apache.org/licenses/LICENSE-2.0
|
|
////////////////////////////////////////////////////////////////////////////////////
|
|
var _createCounterBuffer = function (buffer) {
|
|
const len = buffer.length;
|
|
const audioBuf = ac.createBuffer(1, buffer.length, ac.sampleRate);
|
|
const arrayBuffer = audioBuf.getChannelData(0);
|
|
for (var index = 0; index < len; index++) {
|
|
arrayBuffer[index] = index;
|
|
}
|
|
return audioBuf;
|
|
};
|
|
// initialize counterNode, set its initial buffer and playbackRate
|
|
p5.SoundFile.prototype._initCounterNode = function () {
|
|
var self = this;
|
|
var now = ac.currentTime;
|
|
var cNode = ac.createBufferSource();
|
|
// dispose of scope node if it already exists
|
|
if (self._scopeNode) {
|
|
self._scopeNode.disconnect();
|
|
delete self._scopeNode.onaudioprocess;
|
|
delete self._scopeNode;
|
|
}
|
|
self._scopeNode = ac.createScriptProcessor(256, 1, 1);
|
|
// create counter buffer of the same length as self.buffer
|
|
cNode.buffer = _createCounterBuffer(self.buffer);
|
|
cNode.playbackRate.setValueAtTime(self.playbackRate, now);
|
|
cNode.connect(self._scopeNode);
|
|
self._scopeNode.connect(p5.soundOut._silentNode);
|
|
self._scopeNode.onaudioprocess = function (processEvent) {
|
|
var inputBuffer = processEvent.inputBuffer.getChannelData(0);
|
|
self._lastPos = inputBuffer[inputBuffer.length - 1] || 0;
|
|
// do any callbacks that have been scheduled
|
|
self._onTimeUpdate(self._lastPos);
|
|
};
|
|
return cNode;
|
|
};
|
|
// initialize sourceNode, set its initial buffer and playbackRate
|
|
p5.SoundFile.prototype._initSourceNode = function () {
|
|
var bufferSourceNode = ac.createBufferSource();
|
|
bufferSourceNode.buffer = this.buffer;
|
|
bufferSourceNode.playbackRate.value = this.playbackRate;
|
|
bufferSourceNode.connect(this.output);
|
|
return bufferSourceNode;
|
|
};
|
|
/**
|
|
* processPeaks returns an array of timestamps where it thinks there is a beat.
|
|
*
|
|
* This is an asynchronous function that processes the soundfile in an offline audio context,
|
|
* and sends the results to your callback function.
|
|
*
|
|
* The process involves running the soundfile through a lowpass filter, and finding all of the
|
|
* peaks above the initial threshold. If the total number of peaks are below the minimum number of peaks,
|
|
* it decreases the threshold and re-runs the analysis until either minPeaks or minThreshold are reached.
|
|
*
|
|
* @method processPeaks
|
|
* @param {Function} callback a function to call once this data is returned
|
|
* @param {Number} [initThreshold] initial threshold defaults to 0.9
|
|
* @param {Number} [minThreshold] minimum threshold defaults to 0.22
|
|
* @param {Number} [minPeaks] minimum number of peaks defaults to 200
|
|
* @return {Array} Array of timestamped peaks
|
|
*/
|
|
p5.SoundFile.prototype.processPeaks = function (callback, _initThreshold, _minThreshold, _minPeaks) {
|
|
var bufLen = this.buffer.length;
|
|
var sampleRate = this.buffer.sampleRate;
|
|
var buffer = this.buffer;
|
|
var allPeaks = [];
|
|
var initialThreshold = _initThreshold || 0.9, threshold = initialThreshold, minThreshold = _minThreshold || 0.22, minPeaks = _minPeaks || 200;
|
|
// Create offline context
|
|
var offlineContext = new window.OfflineAudioContext(1, bufLen, sampleRate);
|
|
// create buffer source
|
|
var source = offlineContext.createBufferSource();
|
|
source.buffer = buffer;
|
|
// Create filter. TO DO: allow custom setting of filter
|
|
var filter = offlineContext.createBiquadFilter();
|
|
filter.type = 'lowpass';
|
|
source.connect(filter);
|
|
filter.connect(offlineContext.destination);
|
|
// start playing at time:0
|
|
source.start(0);
|
|
offlineContext.startRendering();
|
|
// Render the song
|
|
// act on the result
|
|
offlineContext.oncomplete = function (e) {
|
|
var filteredBuffer = e.renderedBuffer;
|
|
var bufferData = filteredBuffer.getChannelData(0);
|
|
// step 1:
|
|
// create Peak instances, add them to array, with strength and sampleIndex
|
|
do {
|
|
allPeaks = getPeaksAtThreshold(bufferData, threshold);
|
|
threshold -= 0.005;
|
|
} while (Object.keys(allPeaks).length < minPeaks && threshold >= minThreshold);
|
|
// step 2:
|
|
// find intervals for each peak in the sampleIndex, add tempos array
|
|
var intervalCounts = countIntervalsBetweenNearbyPeaks(allPeaks);
|
|
// step 3: find top tempos
|
|
var groups = groupNeighborsByTempo(intervalCounts, filteredBuffer.sampleRate);
|
|
// sort top intervals
|
|
var topTempos = groups.sort(function (intA, intB) {
|
|
return intB.count - intA.count;
|
|
}).splice(0, 5);
|
|
// set this SoundFile's tempo to the top tempo ??
|
|
this.tempo = topTempos[0].tempo;
|
|
// step 4:
|
|
// new array of peaks at top tempo within a bpmVariance
|
|
var bpmVariance = 5;
|
|
var tempoPeaks = getPeaksAtTopTempo(allPeaks, topTempos[0].tempo, filteredBuffer.sampleRate, bpmVariance);
|
|
callback(tempoPeaks);
|
|
};
|
|
};
|
|
// process peaks
|
|
var Peak = function (amp, i) {
|
|
this.sampleIndex = i;
|
|
this.amplitude = amp;
|
|
this.tempos = [];
|
|
this.intervals = [];
|
|
};
|
|
// 1. for processPeaks() Function to identify peaks above a threshold
|
|
// returns an array of peak indexes as frames (samples) of the original soundfile
|
|
function getPeaksAtThreshold(data, threshold) {
|
|
var peaksObj = {};
|
|
var length = data.length;
|
|
for (var i = 0; i < length; i++) {
|
|
if (data[i] > threshold) {
|
|
var amp = data[i];
|
|
var peak = new Peak(amp, i);
|
|
peaksObj[i] = peak;
|
|
// Skip forward ~ 1/8s to get past this peak.
|
|
i += 6000;
|
|
}
|
|
i++;
|
|
}
|
|
return peaksObj;
|
|
}
|
|
// 2. for processPeaks()
|
|
function countIntervalsBetweenNearbyPeaks(peaksObj) {
|
|
var intervalCounts = [];
|
|
var peaksArray = Object.keys(peaksObj).sort();
|
|
for (var index = 0; index < peaksArray.length; index++) {
|
|
// find intervals in comparison to nearby peaks
|
|
for (var i = 0; i < 10; i++) {
|
|
var startPeak = peaksObj[peaksArray[index]];
|
|
var endPeak = peaksObj[peaksArray[index + i]];
|
|
if (startPeak && endPeak) {
|
|
var startPos = startPeak.sampleIndex;
|
|
var endPos = endPeak.sampleIndex;
|
|
var interval = endPos - startPos;
|
|
// add a sample interval to the startPeak in the allPeaks array
|
|
if (interval > 0) {
|
|
startPeak.intervals.push(interval);
|
|
}
|
|
// tally the intervals and return interval counts
|
|
var foundInterval = intervalCounts.some(function (intervalCount) {
|
|
if (intervalCount.interval === interval) {
|
|
intervalCount.count++;
|
|
return intervalCount;
|
|
}
|
|
});
|
|
// store with JSON like formatting
|
|
if (!foundInterval) {
|
|
intervalCounts.push({
|
|
interval: interval,
|
|
count: 1
|
|
});
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return intervalCounts;
|
|
}
|
|
// 3. for processPeaks --> find tempo
|
|
function groupNeighborsByTempo(intervalCounts, sampleRate) {
|
|
var tempoCounts = [];
|
|
intervalCounts.forEach(function (intervalCount) {
|
|
try {
|
|
// Convert an interval to tempo
|
|
var theoreticalTempo = Math.abs(60 / (intervalCount.interval / sampleRate));
|
|
theoreticalTempo = mapTempo(theoreticalTempo);
|
|
var foundTempo = tempoCounts.some(function (tempoCount) {
|
|
if (tempoCount.tempo === theoreticalTempo)
|
|
return tempoCount.count += intervalCount.count;
|
|
});
|
|
if (!foundTempo) {
|
|
if (isNaN(theoreticalTempo)) {
|
|
return;
|
|
}
|
|
tempoCounts.push({
|
|
tempo: Math.round(theoreticalTempo),
|
|
count: intervalCount.count
|
|
});
|
|
}
|
|
} catch (e) {
|
|
throw e;
|
|
}
|
|
});
|
|
return tempoCounts;
|
|
}
|
|
// 4. for processPeaks - get peaks at top tempo
|
|
function getPeaksAtTopTempo(peaksObj, tempo, sampleRate, bpmVariance) {
|
|
var peaksAtTopTempo = [];
|
|
var peaksArray = Object.keys(peaksObj).sort();
|
|
// TO DO: filter out peaks that have the tempo and return
|
|
for (var i = 0; i < peaksArray.length; i++) {
|
|
var key = peaksArray[i];
|
|
var peak = peaksObj[key];
|
|
for (var j = 0; j < peak.intervals.length; j++) {
|
|
var intervalBPM = Math.round(Math.abs(60 / (peak.intervals[j] / sampleRate)));
|
|
intervalBPM = mapTempo(intervalBPM);
|
|
if (Math.abs(intervalBPM - tempo) < bpmVariance) {
|
|
// convert sampleIndex to seconds
|
|
peaksAtTopTempo.push(peak.sampleIndex / sampleRate);
|
|
}
|
|
}
|
|
}
|
|
// filter out peaks that are very close to each other
|
|
peaksAtTopTempo = peaksAtTopTempo.filter(function (peakTime, index, arr) {
|
|
var dif = arr[index + 1] - peakTime;
|
|
if (dif > 0.01) {
|
|
return true;
|
|
}
|
|
});
|
|
return peaksAtTopTempo;
|
|
}
|
|
// helper function for processPeaks
|
|
function mapTempo(theoreticalTempo) {
|
|
// these scenarios create infinite while loop
|
|
if (!isFinite(theoreticalTempo) || theoreticalTempo === 0) {
|
|
return;
|
|
}
|
|
// Adjust the tempo to fit within the 90-180 BPM range
|
|
while (theoreticalTempo < 90)
|
|
theoreticalTempo *= 2;
|
|
while (theoreticalTempo > 180 && theoreticalTempo > 90)
|
|
theoreticalTempo /= 2;
|
|
return theoreticalTempo;
|
|
}
|
|
/*** SCHEDULE EVENTS ***/
|
|
// Cue inspired by JavaScript setTimeout, and the
|
|
// Tone.js Transport Timeline Event, MIT License Yotam Mann 2015 tonejs.org
|
|
var Cue = function (callback, time, id, val) {
|
|
this.callback = callback;
|
|
this.time = time;
|
|
this.id = id;
|
|
this.val = val;
|
|
};
|
|
/**
|
|
* Schedule events to trigger every time a MediaElement
|
|
* (audio/video) reaches a playback cue point.
|
|
*
|
|
* Accepts a callback function, a time (in seconds) at which to trigger
|
|
* the callback, and an optional parameter for the callback.
|
|
*
|
|
* Time will be passed as the first parameter to the callback function,
|
|
* and param will be the second parameter.
|
|
*
|
|
*
|
|
* @method addCue
|
|
* @param {Number} time Time in seconds, relative to this media
|
|
* element's playback. For example, to trigger
|
|
* an event every time playback reaches two
|
|
* seconds, pass in the number 2. This will be
|
|
* passed as the first parameter to
|
|
* the callback function.
|
|
* @param {Function} callback Name of a function that will be
|
|
* called at the given time. The callback will
|
|
* receive time and (optionally) param as its
|
|
* two parameters.
|
|
* @param {Object} [value] An object to be passed as the
|
|
* second parameter to the
|
|
* callback function.
|
|
* @return {Number} id ID of this cue,
|
|
* useful for removeCue(id)
|
|
* @example
|
|
* <div><code>
|
|
* function setup() {
|
|
* background(0);
|
|
* noStroke();
|
|
* fill(255);
|
|
* textAlign(CENTER);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* mySound = loadSound('assets/beat.mp3');
|
|
*
|
|
* // schedule calls to changeText
|
|
* mySound.addCue(0.50, changeText, "hello" );
|
|
* mySound.addCue(1.00, changeText, "p5" );
|
|
* mySound.addCue(1.50, changeText, "what" );
|
|
* mySound.addCue(2.00, changeText, "do" );
|
|
* mySound.addCue(2.50, changeText, "you" );
|
|
* mySound.addCue(3.00, changeText, "want" );
|
|
* mySound.addCue(4.00, changeText, "to" );
|
|
* mySound.addCue(5.00, changeText, "make" );
|
|
* mySound.addCue(6.00, changeText, "?" );
|
|
* }
|
|
*
|
|
* function changeText(val) {
|
|
* background(0);
|
|
* text(val, width/2, height/2);
|
|
* }
|
|
*
|
|
* function mouseClicked() {
|
|
* if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {
|
|
* if (mySound.isPlaying() ) {
|
|
* mySound.stop();
|
|
* } else {
|
|
* mySound.play();
|
|
* }
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.SoundFile.prototype.addCue = function (time, callback, val) {
|
|
var id = this._cueIDCounter++;
|
|
var cue = new Cue(callback, time, id, val);
|
|
this._cues.push(cue);
|
|
// if (!this.elt.ontimeupdate) {
|
|
// this.elt.ontimeupdate = this._onTimeUpdate.bind(this);
|
|
// }
|
|
return id;
|
|
};
|
|
/**
|
|
* Remove a callback based on its ID. The ID is returned by the
|
|
* addCue method.
|
|
*
|
|
* @method removeCue
|
|
* @param {Number} id ID of the cue, as returned by addCue
|
|
*/
|
|
p5.SoundFile.prototype.removeCue = function (id) {
|
|
var cueLength = this._cues.length;
|
|
for (var i = 0; i < cueLength; i++) {
|
|
var cue = this._cues[i];
|
|
if (cue.id === id) {
|
|
this.cues.splice(i, 1);
|
|
}
|
|
}
|
|
if (this._cues.length === 0) {
|
|
}
|
|
};
|
|
/**
|
|
* Remove all of the callbacks that had originally been scheduled
|
|
* via the addCue method.
|
|
*
|
|
* @method clearCues
|
|
*/
|
|
p5.SoundFile.prototype.clearCues = function () {
|
|
this._cues = [];
|
|
};
|
|
// private method that checks for cues to be fired if events
|
|
// have been scheduled using addCue(callback, time).
|
|
p5.SoundFile.prototype._onTimeUpdate = function (position) {
|
|
var playbackTime = position / this.buffer.sampleRate;
|
|
var cueLength = this._cues.length;
|
|
for (var i = 0; i < cueLength; i++) {
|
|
var cue = this._cues[i];
|
|
var callbackTime = cue.time;
|
|
var val = cue.val;
|
|
if (this._prevTime < callbackTime && callbackTime <= playbackTime) {
|
|
// pass the scheduled callbackTime as parameter to the callback
|
|
cue.callback(val);
|
|
}
|
|
}
|
|
this._prevTime = playbackTime;
|
|
};
|
|
}(sndcore, errorHandler, master, helpers);
|
|
var amplitude;
|
|
'use strict';
|
|
amplitude = function () {
|
|
var p5sound = master;
|
|
/**
|
|
* Amplitude measures volume between 0.0 and 1.0.
|
|
* Listens to all p5sound by default, or use setInput()
|
|
* to listen to a specific sound source. Accepts an optional
|
|
* smoothing value, which defaults to 0.
|
|
*
|
|
* @class p5.Amplitude
|
|
* @constructor
|
|
* @param {Number} [smoothing] between 0.0 and .999 to smooth
|
|
* amplitude readings (defaults to 0)
|
|
* @example
|
|
* <div><code>
|
|
* var sound, amplitude, cnv;
|
|
*
|
|
* function preload(){
|
|
* sound = loadSound('assets/beat.mp3');
|
|
* }
|
|
* function setup() {
|
|
* cnv = createCanvas(100,100);
|
|
* amplitude = new p5.Amplitude();
|
|
*
|
|
* // start / stop the sound when canvas is clicked
|
|
* cnv.mouseClicked(function() {
|
|
* if (sound.isPlaying() ){
|
|
* sound.stop();
|
|
* } else {
|
|
* sound.play();
|
|
* }
|
|
* });
|
|
* }
|
|
* function draw() {
|
|
* background(0);
|
|
* fill(255);
|
|
* var level = amplitude.getLevel();
|
|
* var size = map(level, 0, 1, 0, 200);
|
|
* ellipse(width/2, height/2, size, size);
|
|
* }
|
|
*
|
|
* </code></div>
|
|
*/
|
|
p5.Amplitude = function (smoothing) {
|
|
// Set to 2048 for now. In future iterations, this should be inherited or parsed from p5sound's default
|
|
this.bufferSize = 2048;
|
|
// set audio context
|
|
this.audiocontext = p5sound.audiocontext;
|
|
this.processor = this.audiocontext.createScriptProcessor(this.bufferSize, 2, 1);
|
|
// for connections
|
|
this.input = this.processor;
|
|
this.output = this.audiocontext.createGain();
|
|
// smoothing defaults to 0
|
|
this.smoothing = smoothing || 0;
|
|
// the variables to return
|
|
this.volume = 0;
|
|
this.average = 0;
|
|
this.stereoVol = [
|
|
0,
|
|
0
|
|
];
|
|
this.stereoAvg = [
|
|
0,
|
|
0
|
|
];
|
|
this.stereoVolNorm = [
|
|
0,
|
|
0
|
|
];
|
|
this.volMax = 0.001;
|
|
this.normalize = false;
|
|
this.processor.onaudioprocess = this._audioProcess.bind(this);
|
|
this.processor.connect(this.output);
|
|
this.output.gain.value = 0;
|
|
// this may only be necessary because of a Chrome bug
|
|
this.output.connect(this.audiocontext.destination);
|
|
// connect to p5sound master output by default, unless set by input()
|
|
p5sound.meter.connect(this.processor);
|
|
// add this p5.SoundFile to the soundArray
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
/**
|
|
* Connects to the p5sound instance (master output) by default.
|
|
* Optionally, you can pass in a specific source (i.e. a soundfile).
|
|
*
|
|
* @method setInput
|
|
* @param {soundObject|undefined} [snd] set the sound source
|
|
* (optional, defaults to
|
|
* master output)
|
|
* @param {Number|undefined} [smoothing] a range between 0.0 and 1.0
|
|
* to smooth amplitude readings
|
|
* @example
|
|
* <div><code>
|
|
* function preload(){
|
|
* sound1 = loadSound('assets/beat.mp3');
|
|
* sound2 = loadSound('assets/drum.mp3');
|
|
* }
|
|
* function setup(){
|
|
* amplitude = new p5.Amplitude();
|
|
* sound1.play();
|
|
* sound2.play();
|
|
* amplitude.setInput(sound2);
|
|
* }
|
|
* function draw() {
|
|
* background(0);
|
|
* fill(255);
|
|
* var level = amplitude.getLevel();
|
|
* var size = map(level, 0, 1, 0, 200);
|
|
* ellipse(width/2, height/2, size, size);
|
|
* }
|
|
* function mouseClicked(){
|
|
* sound1.stop();
|
|
* sound2.stop();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Amplitude.prototype.setInput = function (source, smoothing) {
|
|
p5sound.meter.disconnect();
|
|
if (smoothing) {
|
|
this.smoothing = smoothing;
|
|
}
|
|
// connect to the master out of p5s instance if no snd is provided
|
|
if (source == null) {
|
|
console.log('Amplitude input source is not ready! Connecting to master output instead');
|
|
p5sound.meter.connect(this.processor);
|
|
} else if (source instanceof p5.Signal) {
|
|
source.output.connect(this.processor);
|
|
} else if (source) {
|
|
source.connect(this.processor);
|
|
this.processor.disconnect();
|
|
this.processor.connect(this.output);
|
|
} else {
|
|
p5sound.meter.connect(this.processor);
|
|
}
|
|
};
|
|
p5.Amplitude.prototype.connect = function (unit) {
|
|
if (unit) {
|
|
if (unit.hasOwnProperty('input')) {
|
|
this.output.connect(unit.input);
|
|
} else {
|
|
this.output.connect(unit);
|
|
}
|
|
} else {
|
|
this.output.connect(this.panner.connect(p5sound.input));
|
|
}
|
|
};
|
|
p5.Amplitude.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
};
|
|
// TO DO make this stereo / dependent on # of audio channels
|
|
p5.Amplitude.prototype._audioProcess = function (event) {
|
|
for (var channel = 0; channel < event.inputBuffer.numberOfChannels; channel++) {
|
|
var inputBuffer = event.inputBuffer.getChannelData(channel);
|
|
var bufLength = inputBuffer.length;
|
|
var total = 0;
|
|
var sum = 0;
|
|
var x;
|
|
for (var i = 0; i < bufLength; i++) {
|
|
x = inputBuffer[i];
|
|
if (this.normalize) {
|
|
total += Math.max(Math.min(x / this.volMax, 1), -1);
|
|
sum += Math.max(Math.min(x / this.volMax, 1), -1) * Math.max(Math.min(x / this.volMax, 1), -1);
|
|
} else {
|
|
total += x;
|
|
sum += x * x;
|
|
}
|
|
}
|
|
var average = total / bufLength;
|
|
// ... then take the square root of the sum.
|
|
var rms = Math.sqrt(sum / bufLength);
|
|
this.stereoVol[channel] = Math.max(rms, this.stereoVol[channel] * this.smoothing);
|
|
this.stereoAvg[channel] = Math.max(average, this.stereoVol[channel] * this.smoothing);
|
|
this.volMax = Math.max(this.stereoVol[channel], this.volMax);
|
|
}
|
|
// add volume from all channels together
|
|
var self = this;
|
|
var volSum = this.stereoVol.reduce(function (previousValue, currentValue, index) {
|
|
self.stereoVolNorm[index - 1] = Math.max(Math.min(self.stereoVol[index - 1] / self.volMax, 1), 0);
|
|
self.stereoVolNorm[index] = Math.max(Math.min(self.stereoVol[index] / self.volMax, 1), 0);
|
|
return previousValue + currentValue;
|
|
});
|
|
// volume is average of channels
|
|
this.volume = volSum / this.stereoVol.length;
|
|
// normalized value
|
|
this.volNorm = Math.max(Math.min(this.volume / this.volMax, 1), 0);
|
|
};
|
|
/**
|
|
* Returns a single Amplitude reading at the moment it is called.
|
|
* For continuous readings, run in the draw loop.
|
|
*
|
|
* @method getLevel
|
|
* @param {Number} [channel] Optionally return only channel 0 (left) or 1 (right)
|
|
* @return {Number} Amplitude as a number between 0.0 and 1.0
|
|
* @example
|
|
* <div><code>
|
|
* function preload(){
|
|
* sound = loadSound('assets/beat.mp3');
|
|
* }
|
|
* function setup() {
|
|
* amplitude = new p5.Amplitude();
|
|
* sound.play();
|
|
* }
|
|
* function draw() {
|
|
* background(0);
|
|
* fill(255);
|
|
* var level = amplitude.getLevel();
|
|
* var size = map(level, 0, 1, 0, 200);
|
|
* ellipse(width/2, height/2, size, size);
|
|
* }
|
|
* function mouseClicked(){
|
|
* sound.stop();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Amplitude.prototype.getLevel = function (channel) {
|
|
if (typeof channel !== 'undefined') {
|
|
if (this.normalize) {
|
|
return this.stereoVolNorm[channel];
|
|
} else {
|
|
return this.stereoVol[channel];
|
|
}
|
|
} else if (this.normalize) {
|
|
return this.volNorm;
|
|
} else {
|
|
return this.volume;
|
|
}
|
|
};
|
|
/**
|
|
* Determines whether the results of Amplitude.process() will be
|
|
* Normalized. To normalize, Amplitude finds the difference the
|
|
* loudest reading it has processed and the maximum amplitude of
|
|
* 1.0. Amplitude adds this difference to all values to produce
|
|
* results that will reliably map between 0.0 and 1.0. However,
|
|
* if a louder moment occurs, the amount that Normalize adds to
|
|
* all the values will change. Accepts an optional boolean parameter
|
|
* (true or false). Normalizing is off by default.
|
|
*
|
|
* @method toggleNormalize
|
|
* @param {boolean} [boolean] set normalize to true (1) or false (0)
|
|
*/
|
|
p5.Amplitude.prototype.toggleNormalize = function (bool) {
|
|
if (typeof bool === 'boolean') {
|
|
this.normalize = bool;
|
|
} else {
|
|
this.normalize = !this.normalize;
|
|
}
|
|
};
|
|
/**
|
|
* Smooth Amplitude analysis by averaging with the last analysis
|
|
* frame. Off by default.
|
|
*
|
|
* @method smooth
|
|
* @param {Number} set smoothing from 0.0 <= 1
|
|
*/
|
|
p5.Amplitude.prototype.smooth = function (s) {
|
|
if (s >= 0 && s < 1) {
|
|
this.smoothing = s;
|
|
} else {
|
|
console.log('Error: smoothing must be between 0 and 1');
|
|
}
|
|
};
|
|
p5.Amplitude.prototype.dispose = function () {
|
|
// remove reference from soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
this.input.disconnect();
|
|
this.output.disconnect();
|
|
this.input = this.processor = undefined;
|
|
this.output = undefined;
|
|
};
|
|
}(master);
|
|
var fft;
|
|
'use strict';
|
|
fft = function () {
|
|
var p5sound = master;
|
|
/**
|
|
* <p>FFT (Fast Fourier Transform) is an analysis algorithm that
|
|
* isolates individual
|
|
* <a href="https://en.wikipedia.org/wiki/Audio_frequency">
|
|
* audio frequencies</a> within a waveform.</p>
|
|
*
|
|
* <p>Once instantiated, a p5.FFT object can return an array based on
|
|
* two types of analyses: <br> • <code>FFT.waveform()</code> computes
|
|
* amplitude values along the time domain. The array indices correspond
|
|
* to samples across a brief moment in time. Each value represents
|
|
* amplitude of the waveform at that sample of time.<br>
|
|
* • <code>FFT.analyze() </code> computes amplitude values along the
|
|
* frequency domain. The array indices correspond to frequencies (i.e.
|
|
* pitches), from the lowest to the highest that humans can hear. Each
|
|
* value represents amplitude at that slice of the frequency spectrum.
|
|
* Use with <code>getEnergy()</code> to measure amplitude at specific
|
|
* frequencies, or within a range of frequencies. </p>
|
|
*
|
|
* <p>FFT analyzes a very short snapshot of sound called a sample
|
|
* buffer. It returns an array of amplitude measurements, referred
|
|
* to as <code>bins</code>. The array is 1024 bins long by default.
|
|
* You can change the bin array length, but it must be a power of 2
|
|
* between 16 and 1024 in order for the FFT algorithm to function
|
|
* correctly. The actual size of the FFT buffer is twice the
|
|
* number of bins, so given a standard sample rate, the buffer is
|
|
* 2048/44100 seconds long.</p>
|
|
*
|
|
*
|
|
* @class p5.FFT
|
|
* @constructor
|
|
* @param {Number} [smoothing] Smooth results of Freq Spectrum.
|
|
* 0.0 < smoothing < 1.0.
|
|
* Defaults to 0.8.
|
|
* @param {Number} [bins] Length of resulting array.
|
|
* Must be a power of two between
|
|
* 16 and 1024. Defaults to 1024.
|
|
* @example
|
|
* <div><code>
|
|
* function preload(){
|
|
* sound = loadSound('assets/Damscray_DancingTiger.mp3');
|
|
* }
|
|
*
|
|
* function setup(){
|
|
* var cnv = createCanvas(100,100);
|
|
* cnv.mouseClicked(togglePlay);
|
|
* fft = new p5.FFT();
|
|
* sound.amp(0.2);
|
|
* }
|
|
*
|
|
* function draw(){
|
|
* background(0);
|
|
*
|
|
* var spectrum = fft.analyze();
|
|
* noStroke();
|
|
* fill(0,255,0); // spectrum is green
|
|
* for (var i = 0; i< spectrum.length; i++){
|
|
* var x = map(i, 0, spectrum.length, 0, width);
|
|
* var h = -height + map(spectrum[i], 0, 255, height, 0);
|
|
* rect(x, height, width / spectrum.length, h )
|
|
* }
|
|
*
|
|
* var waveform = fft.waveform();
|
|
* noFill();
|
|
* beginShape();
|
|
* stroke(255,0,0); // waveform is red
|
|
* strokeWeight(1);
|
|
* for (var i = 0; i< waveform.length; i++){
|
|
* var x = map(i, 0, waveform.length, 0, width);
|
|
* var y = map( waveform[i], -1, 1, 0, height);
|
|
* vertex(x,y);
|
|
* }
|
|
* endShape();
|
|
*
|
|
* text('click to play/pause', 4, 10);
|
|
* }
|
|
*
|
|
* // fade sound if mouse is over canvas
|
|
* function togglePlay() {
|
|
* if (sound.isPlaying()) {
|
|
* sound.pause();
|
|
* } else {
|
|
* sound.loop();
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.FFT = function (smoothing, bins) {
|
|
this.input = this.analyser = p5sound.audiocontext.createAnalyser();
|
|
Object.defineProperties(this, {
|
|
bins: {
|
|
get: function () {
|
|
return this.analyser.fftSize / 2;
|
|
},
|
|
set: function (b) {
|
|
this.analyser.fftSize = b * 2;
|
|
},
|
|
configurable: true,
|
|
enumerable: true
|
|
},
|
|
smoothing: {
|
|
get: function () {
|
|
return this.analyser.smoothingTimeConstant;
|
|
},
|
|
set: function (s) {
|
|
this.analyser.smoothingTimeConstant = s;
|
|
},
|
|
configurable: true,
|
|
enumerable: true
|
|
}
|
|
});
|
|
// set default smoothing and bins
|
|
this.smooth(smoothing);
|
|
this.bins = bins || 1024;
|
|
// default connections to p5sound fftMeter
|
|
p5sound.fftMeter.connect(this.analyser);
|
|
this.freqDomain = new Uint8Array(this.analyser.frequencyBinCount);
|
|
this.timeDomain = new Uint8Array(this.analyser.frequencyBinCount);
|
|
// predefined frequency ranges, these will be tweakable
|
|
this.bass = [
|
|
20,
|
|
140
|
|
];
|
|
this.lowMid = [
|
|
140,
|
|
400
|
|
];
|
|
this.mid = [
|
|
400,
|
|
2600
|
|
];
|
|
this.highMid = [
|
|
2600,
|
|
5200
|
|
];
|
|
this.treble = [
|
|
5200,
|
|
14000
|
|
];
|
|
// add this p5.SoundFile to the soundArray
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
/**
|
|
* Set the input source for the FFT analysis. If no source is
|
|
* provided, FFT will analyze all sound in the sketch.
|
|
*
|
|
* @method setInput
|
|
* @param {Object} [source] p5.sound object (or web audio API source node)
|
|
*/
|
|
p5.FFT.prototype.setInput = function (source) {
|
|
if (!source) {
|
|
p5sound.fftMeter.connect(this.analyser);
|
|
} else {
|
|
if (source.output) {
|
|
source.output.connect(this.analyser);
|
|
} else if (source.connect) {
|
|
source.connect(this.analyser);
|
|
}
|
|
p5sound.fftMeter.disconnect();
|
|
}
|
|
};
|
|
/**
|
|
* Returns an array of amplitude values (between -1.0 and +1.0) that represent
|
|
* a snapshot of amplitude readings in a single buffer. Length will be
|
|
* equal to bins (defaults to 1024). Can be used to draw the waveform
|
|
* of a sound.
|
|
*
|
|
* @method waveform
|
|
* @param {Number} [bins] Must be a power of two between
|
|
* 16 and 1024. Defaults to 1024.
|
|
* @param {String} [precision] If any value is provided, will return results
|
|
* in a Float32 Array which is more precise
|
|
* than a regular array.
|
|
* @return {Array} Array Array of amplitude values (-1 to 1)
|
|
* over time. Array length = bins.
|
|
*
|
|
*/
|
|
p5.FFT.prototype.waveform = function () {
|
|
var bins, mode, normalArray;
|
|
for (var i = 0; i < arguments.length; i++) {
|
|
if (typeof arguments[i] === 'number') {
|
|
bins = arguments[i];
|
|
this.analyser.fftSize = bins * 2;
|
|
}
|
|
if (typeof arguments[i] === 'string') {
|
|
mode = arguments[i];
|
|
}
|
|
}
|
|
// getFloatFrequencyData doesnt work in Safari as of 5/2015
|
|
if (mode && !p5.prototype._isSafari()) {
|
|
timeToFloat(this, this.timeDomain);
|
|
this.analyser.getFloatTimeDomainData(this.timeDomain);
|
|
return this.timeDomain;
|
|
} else {
|
|
timeToInt(this, this.timeDomain);
|
|
this.analyser.getByteTimeDomainData(this.timeDomain);
|
|
var normalArray = new Array();
|
|
for (var j = 0; j < this.timeDomain.length; j++) {
|
|
var scaled = p5.prototype.map(this.timeDomain[j], 0, 255, -1, 1);
|
|
normalArray.push(scaled);
|
|
}
|
|
return normalArray;
|
|
}
|
|
};
|
|
/**
|
|
* Returns an array of amplitude values (between 0 and 255)
|
|
* across the frequency spectrum. Length is equal to FFT bins
|
|
* (1024 by default). The array indices correspond to frequencies
|
|
* (i.e. pitches), from the lowest to the highest that humans can
|
|
* hear. Each value represents amplitude at that slice of the
|
|
* frequency spectrum. Must be called prior to using
|
|
* <code>getEnergy()</code>.
|
|
*
|
|
* @method analyze
|
|
* @param {Number} [bins] Must be a power of two between
|
|
* 16 and 1024. Defaults to 1024.
|
|
* @param {Number} [scale] If "dB," returns decibel
|
|
* float measurements between
|
|
* -140 and 0 (max).
|
|
* Otherwise returns integers from 0-255.
|
|
* @return {Array} spectrum Array of energy (amplitude/volume)
|
|
* values across the frequency spectrum.
|
|
* Lowest energy (silence) = 0, highest
|
|
* possible is 255.
|
|
* @example
|
|
* <div><code>
|
|
* var osc;
|
|
* var fft;
|
|
*
|
|
* function setup(){
|
|
* createCanvas(100,100);
|
|
* osc = new p5.Oscillator();
|
|
* osc.amp(0);
|
|
* osc.start();
|
|
* fft = new p5.FFT();
|
|
* }
|
|
*
|
|
* function draw(){
|
|
* background(0);
|
|
*
|
|
* var freq = map(mouseX, 0, 800, 20, 15000);
|
|
* freq = constrain(freq, 1, 20000);
|
|
* osc.freq(freq);
|
|
*
|
|
* var spectrum = fft.analyze();
|
|
* noStroke();
|
|
* fill(0,255,0); // spectrum is green
|
|
* for (var i = 0; i< spectrum.length; i++){
|
|
* var x = map(i, 0, spectrum.length, 0, width);
|
|
* var h = -height + map(spectrum[i], 0, 255, height, 0);
|
|
* rect(x, height, width / spectrum.length, h );
|
|
* }
|
|
*
|
|
* stroke(255);
|
|
* text('Freq: ' + round(freq)+'Hz', 10, 10);
|
|
*
|
|
* isMouseOverCanvas();
|
|
* }
|
|
*
|
|
* // only play sound when mouse is over canvas
|
|
* function isMouseOverCanvas() {
|
|
* var mX = mouseX, mY = mouseY;
|
|
* if (mX > 0 && mX < width && mY < height && mY > 0) {
|
|
* osc.amp(0.5, 0.2);
|
|
* } else {
|
|
* osc.amp(0, 0.2);
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*
|
|
*
|
|
*/
|
|
p5.FFT.prototype.analyze = function () {
|
|
var mode;
|
|
for (var i = 0; i < arguments.length; i++) {
|
|
if (typeof arguments[i] === 'number') {
|
|
this.bins = arguments[i];
|
|
this.analyser.fftSize = this.bins * 2;
|
|
}
|
|
if (typeof arguments[i] === 'string') {
|
|
mode = arguments[i];
|
|
}
|
|
}
|
|
if (mode && mode.toLowerCase() === 'db') {
|
|
freqToFloat(this);
|
|
this.analyser.getFloatFrequencyData(this.freqDomain);
|
|
return this.freqDomain;
|
|
} else {
|
|
freqToInt(this, this.freqDomain);
|
|
this.analyser.getByteFrequencyData(this.freqDomain);
|
|
var normalArray = Array.apply([], this.freqDomain);
|
|
normalArray.length === this.analyser.fftSize;
|
|
normalArray.constructor === Array;
|
|
return normalArray;
|
|
}
|
|
};
|
|
/**
|
|
* Returns the amount of energy (volume) at a specific
|
|
* <a href="https://en.wikipedia.org/wiki/Audio_frequency" target="_blank">
|
|
* frequency</a>, or the average amount of energy between two
|
|
* frequencies. Accepts Number(s) corresponding
|
|
* to frequency (in Hz), or a String corresponding to predefined
|
|
* frequency ranges ("bass", "lowMid", "mid", "highMid", "treble").
|
|
* Returns a range between 0 (no energy/volume at that frequency) and
|
|
* 255 (maximum energy).
|
|
* <em>NOTE: analyze() must be called prior to getEnergy(). Analyze()
|
|
* tells the FFT to analyze frequency data, and getEnergy() uses
|
|
* the results determine the value at a specific frequency or
|
|
* range of frequencies.</em></p>
|
|
*
|
|
* @method getEnergy
|
|
* @param {Number|String} frequency1 Will return a value representing
|
|
* energy at this frequency. Alternately,
|
|
* the strings "bass", "lowMid" "mid",
|
|
* "highMid", and "treble" will return
|
|
* predefined frequency ranges.
|
|
* @param {Number} [frequency2] If a second frequency is given,
|
|
* will return average amount of
|
|
* energy that exists between the
|
|
* two frequencies.
|
|
* @return {Number} Energy Energy (volume/amplitude) from
|
|
* 0 and 255.
|
|
*
|
|
*/
|
|
p5.FFT.prototype.getEnergy = function (frequency1, frequency2) {
|
|
var nyquist = p5sound.audiocontext.sampleRate / 2;
|
|
if (frequency1 === 'bass') {
|
|
frequency1 = this.bass[0];
|
|
frequency2 = this.bass[1];
|
|
} else if (frequency1 === 'lowMid') {
|
|
frequency1 = this.lowMid[0];
|
|
frequency2 = this.lowMid[1];
|
|
} else if (frequency1 === 'mid') {
|
|
frequency1 = this.mid[0];
|
|
frequency2 = this.mid[1];
|
|
} else if (frequency1 === 'highMid') {
|
|
frequency1 = this.highMid[0];
|
|
frequency2 = this.highMid[1];
|
|
} else if (frequency1 === 'treble') {
|
|
frequency1 = this.treble[0];
|
|
frequency2 = this.treble[1];
|
|
}
|
|
if (typeof frequency1 !== 'number') {
|
|
throw 'invalid input for getEnergy()';
|
|
} else if (!frequency2) {
|
|
// if only one parameter:
|
|
var index = Math.round(frequency1 / nyquist * this.freqDomain.length);
|
|
return this.freqDomain[index];
|
|
} else if (frequency1 && frequency2) {
|
|
// if two parameters:
|
|
// if second is higher than first
|
|
if (frequency1 > frequency2) {
|
|
var swap = frequency2;
|
|
frequency2 = frequency1;
|
|
frequency1 = swap;
|
|
}
|
|
var lowIndex = Math.round(frequency1 / nyquist * this.freqDomain.length);
|
|
var highIndex = Math.round(frequency2 / nyquist * this.freqDomain.length);
|
|
var total = 0;
|
|
var numFrequencies = 0;
|
|
// add up all of the values for the frequencies
|
|
for (var i = lowIndex; i <= highIndex; i++) {
|
|
total += this.freqDomain[i];
|
|
numFrequencies += 1;
|
|
}
|
|
// divide by total number of frequencies
|
|
var toReturn = total / numFrequencies;
|
|
return toReturn;
|
|
} else {
|
|
throw 'invalid input for getEnergy()';
|
|
}
|
|
};
|
|
// compatability with v.012, changed to getEnergy in v.0121. Will be deprecated...
|
|
p5.FFT.prototype.getFreq = function (freq1, freq2) {
|
|
console.log('getFreq() is deprecated. Please use getEnergy() instead.');
|
|
var x = this.getEnergy(freq1, freq2);
|
|
return x;
|
|
};
|
|
/**
|
|
* Returns the
|
|
* <a href="http://en.wikipedia.org/wiki/Spectral_centroid" target="_blank">
|
|
* spectral centroid</a> of the input signal.
|
|
* <em>NOTE: analyze() must be called prior to getCentroid(). Analyze()
|
|
* tells the FFT to analyze frequency data, and getCentroid() uses
|
|
* the results determine the spectral centroid.</em></p>
|
|
*
|
|
* @method getCentroid
|
|
* @return {Number} Spectral Centroid Frequency Frequency of the spectral centroid in Hz.
|
|
*
|
|
*
|
|
* @example
|
|
* <div><code>
|
|
*
|
|
*
|
|
*function setup(){
|
|
* cnv = createCanvas(800,400);
|
|
* sound = new p5.AudioIn();
|
|
* sound.start();
|
|
* fft = new p5.FFT();
|
|
* sound.connect(fft);
|
|
*}
|
|
*
|
|
*
|
|
*function draw(){
|
|
*
|
|
* var centroidplot = 0.0;
|
|
* var spectralCentroid = 0;
|
|
*
|
|
*
|
|
* background(0);
|
|
* stroke(0,255,0);
|
|
* var spectrum = fft.analyze();
|
|
* fill(0,255,0); // spectrum is green
|
|
*
|
|
* //draw the spectrum
|
|
*
|
|
* for (var i = 0; i< spectrum.length; i++){
|
|
* var x = map(log(i), 0, log(spectrum.length), 0, width);
|
|
* var h = map(spectrum[i], 0, 255, 0, height);
|
|
* var rectangle_width = (log(i+1)-log(i))*(width/log(spectrum.length));
|
|
* rect(x, height, rectangle_width, -h )
|
|
* }
|
|
|
|
* var nyquist = 22050;
|
|
*
|
|
* // get the centroid
|
|
* spectralCentroid = fft.getCentroid();
|
|
*
|
|
* // the mean_freq_index calculation is for the display.
|
|
* var mean_freq_index = spectralCentroid/(nyquist/spectrum.length);
|
|
*
|
|
* centroidplot = map(log(mean_freq_index), 0, log(spectrum.length), 0, width);
|
|
*
|
|
*
|
|
* stroke(255,0,0); // the line showing where the centroid is will be red
|
|
*
|
|
* rect(centroidplot, 0, width / spectrum.length, height)
|
|
* noStroke();
|
|
* fill(255,255,255); // text is white
|
|
* textSize(40);
|
|
* text("centroid: "+round(spectralCentroid)+" Hz", 10, 40);
|
|
*}
|
|
* </code></div>
|
|
*/
|
|
p5.FFT.prototype.getCentroid = function () {
|
|
var nyquist = p5sound.audiocontext.sampleRate / 2;
|
|
var cumulative_sum = 0;
|
|
var centroid_normalization = 0;
|
|
for (var i = 0; i < this.freqDomain.length; i++) {
|
|
cumulative_sum += i * this.freqDomain[i];
|
|
centroid_normalization += this.freqDomain[i];
|
|
}
|
|
var mean_freq_index = 0;
|
|
if (centroid_normalization !== 0) {
|
|
mean_freq_index = cumulative_sum / centroid_normalization;
|
|
}
|
|
var spec_centroid_freq = mean_freq_index * (nyquist / this.freqDomain.length);
|
|
return spec_centroid_freq;
|
|
};
|
|
/**
|
|
* Smooth FFT analysis by averaging with the last analysis frame.
|
|
*
|
|
* @method smooth
|
|
* @param {Number} smoothing 0.0 < smoothing < 1.0.
|
|
* Defaults to 0.8.
|
|
*/
|
|
p5.FFT.prototype.smooth = function (s) {
|
|
if (typeof s !== 'undefined') {
|
|
this.smoothing = s;
|
|
}
|
|
return this.smoothing;
|
|
};
|
|
p5.FFT.prototype.dispose = function () {
|
|
// remove reference from soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
this.analyser.disconnect();
|
|
this.analyser = undefined;
|
|
};
|
|
/**
|
|
* Returns an array of average amplitude values for a given number
|
|
* of frequency bands split equally. N defaults to 16.
|
|
* <em>NOTE: analyze() must be called prior to linAverages(). Analyze()
|
|
* tells the FFT to analyze frequency data, and linAverages() uses
|
|
* the results to group them into a smaller set of averages.</em></p>
|
|
*
|
|
* @method linAverages
|
|
* @param {Number} N Number of returned frequency groups
|
|
* @return {Array} linearAverages Array of average amplitude values for each group
|
|
*/
|
|
p5.FFT.prototype.linAverages = function (N) {
|
|
var N = N || 16;
|
|
// This prevents undefined, null or 0 values of N
|
|
var spectrum = this.freqDomain;
|
|
var spectrumLength = spectrum.length;
|
|
var spectrumStep = Math.floor(spectrumLength / N);
|
|
var linearAverages = new Array(N);
|
|
// Keep a second index for the current average group and place the values accordingly
|
|
// with only one loop in the spectrum data
|
|
var groupIndex = 0;
|
|
for (var specIndex = 0; specIndex < spectrumLength; specIndex++) {
|
|
linearAverages[groupIndex] = linearAverages[groupIndex] !== undefined ? (linearAverages[groupIndex] + spectrum[specIndex]) / 2 : spectrum[specIndex];
|
|
// Increase the group index when the last element of the group is processed
|
|
if (specIndex % spectrumStep === spectrumStep - 1) {
|
|
groupIndex++;
|
|
}
|
|
}
|
|
return linearAverages;
|
|
};
|
|
/**
|
|
* Returns an array of average amplitude values of the spectrum, for a given
|
|
* set of <a href="https://en.wikipedia.org/wiki/Octave_band" target="_blank">
|
|
* Octave Bands</a>
|
|
* <em>NOTE: analyze() must be called prior to logAverages(). Analyze()
|
|
* tells the FFT to analyze frequency data, and logAverages() uses
|
|
* the results to group them into a smaller set of averages.</em></p>
|
|
*
|
|
* @method logAverages
|
|
* @param {Array} octaveBands Array of Octave Bands objects for grouping
|
|
* @return {Array} logAverages Array of average amplitude values for each group
|
|
*/
|
|
p5.FFT.prototype.logAverages = function (octaveBands) {
|
|
var nyquist = p5sound.audiocontext.sampleRate / 2;
|
|
var spectrum = this.freqDomain;
|
|
var spectrumLength = spectrum.length;
|
|
var logAverages = new Array(octaveBands.length);
|
|
// Keep a second index for the current average group and place the values accordingly
|
|
// With only one loop in the spectrum data
|
|
var octaveIndex = 0;
|
|
for (var specIndex = 0; specIndex < spectrumLength; specIndex++) {
|
|
var specIndexFrequency = Math.round(specIndex * nyquist / this.freqDomain.length);
|
|
// Increase the group index if the current frequency exceeds the limits of the band
|
|
if (specIndexFrequency > octaveBands[octaveIndex].hi) {
|
|
octaveIndex++;
|
|
}
|
|
logAverages[octaveIndex] = logAverages[octaveIndex] !== undefined ? (logAverages[octaveIndex] + spectrum[specIndex]) / 2 : spectrum[specIndex];
|
|
}
|
|
return logAverages;
|
|
};
|
|
/**
|
|
* Calculates and Returns the 1/N
|
|
* <a href="https://en.wikipedia.org/wiki/Octave_band" target="_blank">Octave Bands</a>
|
|
* N defaults to 3 and minimum central frequency to 15.625Hz.
|
|
* (1/3 Octave Bands ~= 31 Frequency Bands)
|
|
* Setting fCtr0 to a central value of a higher octave will ignore the lower bands
|
|
* and produce less frequency groups.
|
|
*
|
|
* @method getOctaveBands
|
|
* @param {Number} N Specifies the 1/N type of generated octave bands
|
|
* @param {Number} fCtr0 Minimum central frequency for the lowest band
|
|
* @return {Array} octaveBands Array of octave band objects with their bounds
|
|
*/
|
|
p5.FFT.prototype.getOctaveBands = function (N, fCtr0) {
|
|
var N = N || 3;
|
|
// Default to 1/3 Octave Bands
|
|
var fCtr0 = fCtr0 || 15.625;
|
|
// Minimum central frequency, defaults to 15.625Hz
|
|
var octaveBands = [];
|
|
var lastFrequencyBand = {
|
|
lo: fCtr0 / Math.pow(2, 1 / (2 * N)),
|
|
ctr: fCtr0,
|
|
hi: fCtr0 * Math.pow(2, 1 / (2 * N))
|
|
};
|
|
octaveBands.push(lastFrequencyBand);
|
|
var nyquist = p5sound.audiocontext.sampleRate / 2;
|
|
while (lastFrequencyBand.hi < nyquist) {
|
|
var newFrequencyBand = {};
|
|
newFrequencyBand.lo = lastFrequencyBand.hi;
|
|
newFrequencyBand.ctr = lastFrequencyBand.ctr * Math.pow(2, 1 / N);
|
|
newFrequencyBand.hi = newFrequencyBand.ctr * Math.pow(2, 1 / (2 * N));
|
|
octaveBands.push(newFrequencyBand);
|
|
lastFrequencyBand = newFrequencyBand;
|
|
}
|
|
return octaveBands;
|
|
};
|
|
// helper methods to convert type from float (dB) to int (0-255)
|
|
var freqToFloat = function (fft) {
|
|
if (fft.freqDomain instanceof Float32Array === false) {
|
|
fft.freqDomain = new Float32Array(fft.analyser.frequencyBinCount);
|
|
}
|
|
};
|
|
var freqToInt = function (fft) {
|
|
if (fft.freqDomain instanceof Uint8Array === false) {
|
|
fft.freqDomain = new Uint8Array(fft.analyser.frequencyBinCount);
|
|
}
|
|
};
|
|
var timeToFloat = function (fft) {
|
|
if (fft.timeDomain instanceof Float32Array === false) {
|
|
fft.timeDomain = new Float32Array(fft.analyser.frequencyBinCount);
|
|
}
|
|
};
|
|
var timeToInt = function (fft) {
|
|
if (fft.timeDomain instanceof Uint8Array === false) {
|
|
fft.timeDomain = new Uint8Array(fft.analyser.frequencyBinCount);
|
|
}
|
|
};
|
|
}(master);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_core_Tone;
|
|
Tone_core_Tone = function () {
|
|
'use strict';
|
|
var Tone = function (inputs, outputs) {
|
|
if (this.isUndef(inputs) || inputs === 1) {
|
|
this.input = this.context.createGain();
|
|
} else if (inputs > 1) {
|
|
this.input = new Array(inputs);
|
|
}
|
|
if (this.isUndef(outputs) || outputs === 1) {
|
|
this.output = this.context.createGain();
|
|
} else if (outputs > 1) {
|
|
this.output = new Array(inputs);
|
|
}
|
|
};
|
|
Tone.prototype.set = function (params, value, rampTime) {
|
|
if (this.isObject(params)) {
|
|
rampTime = value;
|
|
} else if (this.isString(params)) {
|
|
var tmpObj = {};
|
|
tmpObj[params] = value;
|
|
params = tmpObj;
|
|
}
|
|
paramLoop:
|
|
for (var attr in params) {
|
|
value = params[attr];
|
|
var parent = this;
|
|
if (attr.indexOf('.') !== -1) {
|
|
var attrSplit = attr.split('.');
|
|
for (var i = 0; i < attrSplit.length - 1; i++) {
|
|
parent = parent[attrSplit[i]];
|
|
if (parent instanceof Tone) {
|
|
attrSplit.splice(0, i + 1);
|
|
var innerParam = attrSplit.join('.');
|
|
parent.set(innerParam, value);
|
|
continue paramLoop;
|
|
}
|
|
}
|
|
attr = attrSplit[attrSplit.length - 1];
|
|
}
|
|
var param = parent[attr];
|
|
if (this.isUndef(param)) {
|
|
continue;
|
|
}
|
|
if (Tone.Signal && param instanceof Tone.Signal || Tone.Param && param instanceof Tone.Param) {
|
|
if (param.value !== value) {
|
|
if (this.isUndef(rampTime)) {
|
|
param.value = value;
|
|
} else {
|
|
param.rampTo(value, rampTime);
|
|
}
|
|
}
|
|
} else if (param instanceof AudioParam) {
|
|
if (param.value !== value) {
|
|
param.value = value;
|
|
}
|
|
} else if (param instanceof Tone) {
|
|
param.set(value);
|
|
} else if (param !== value) {
|
|
parent[attr] = value;
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
Tone.prototype.get = function (params) {
|
|
if (this.isUndef(params)) {
|
|
params = this._collectDefaults(this.constructor);
|
|
} else if (this.isString(params)) {
|
|
params = [params];
|
|
}
|
|
var ret = {};
|
|
for (var i = 0; i < params.length; i++) {
|
|
var attr = params[i];
|
|
var parent = this;
|
|
var subRet = ret;
|
|
if (attr.indexOf('.') !== -1) {
|
|
var attrSplit = attr.split('.');
|
|
for (var j = 0; j < attrSplit.length - 1; j++) {
|
|
var subAttr = attrSplit[j];
|
|
subRet[subAttr] = subRet[subAttr] || {};
|
|
subRet = subRet[subAttr];
|
|
parent = parent[subAttr];
|
|
}
|
|
attr = attrSplit[attrSplit.length - 1];
|
|
}
|
|
var param = parent[attr];
|
|
if (this.isObject(params[attr])) {
|
|
subRet[attr] = param.get();
|
|
} else if (Tone.Signal && param instanceof Tone.Signal) {
|
|
subRet[attr] = param.value;
|
|
} else if (Tone.Param && param instanceof Tone.Param) {
|
|
subRet[attr] = param.value;
|
|
} else if (param instanceof AudioParam) {
|
|
subRet[attr] = param.value;
|
|
} else if (param instanceof Tone) {
|
|
subRet[attr] = param.get();
|
|
} else if (!this.isFunction(param) && !this.isUndef(param)) {
|
|
subRet[attr] = param;
|
|
}
|
|
}
|
|
return ret;
|
|
};
|
|
Tone.prototype._collectDefaults = function (constr) {
|
|
var ret = [];
|
|
if (!this.isUndef(constr.defaults)) {
|
|
ret = Object.keys(constr.defaults);
|
|
}
|
|
if (!this.isUndef(constr._super)) {
|
|
var superDefs = this._collectDefaults(constr._super);
|
|
for (var i = 0; i < superDefs.length; i++) {
|
|
if (ret.indexOf(superDefs[i]) === -1) {
|
|
ret.push(superDefs[i]);
|
|
}
|
|
}
|
|
}
|
|
return ret;
|
|
};
|
|
Tone.prototype.toString = function () {
|
|
for (var className in Tone) {
|
|
var isLetter = className[0].match(/^[A-Z]$/);
|
|
var sameConstructor = Tone[className] === this.constructor;
|
|
if (this.isFunction(Tone[className]) && isLetter && sameConstructor) {
|
|
return className;
|
|
}
|
|
}
|
|
return 'Tone';
|
|
};
|
|
Object.defineProperty(Tone.prototype, 'numberOfInputs', {
|
|
get: function () {
|
|
if (this.input) {
|
|
if (this.isArray(this.input)) {
|
|
return this.input.length;
|
|
} else {
|
|
return 1;
|
|
}
|
|
} else {
|
|
return 0;
|
|
}
|
|
}
|
|
});
|
|
Object.defineProperty(Tone.prototype, 'numberOfOutputs', {
|
|
get: function () {
|
|
if (this.output) {
|
|
if (this.isArray(this.output)) {
|
|
return this.output.length;
|
|
} else {
|
|
return 1;
|
|
}
|
|
} else {
|
|
return 0;
|
|
}
|
|
}
|
|
});
|
|
Tone.prototype.dispose = function () {
|
|
if (!this.isUndef(this.input)) {
|
|
if (this.input instanceof AudioNode) {
|
|
this.input.disconnect();
|
|
}
|
|
this.input = null;
|
|
}
|
|
if (!this.isUndef(this.output)) {
|
|
if (this.output instanceof AudioNode) {
|
|
this.output.disconnect();
|
|
}
|
|
this.output = null;
|
|
}
|
|
return this;
|
|
};
|
|
Tone.prototype.connect = function (unit, outputNum, inputNum) {
|
|
if (Array.isArray(this.output)) {
|
|
outputNum = this.defaultArg(outputNum, 0);
|
|
this.output[outputNum].connect(unit, 0, inputNum);
|
|
} else {
|
|
this.output.connect(unit, outputNum, inputNum);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.prototype.disconnect = function (destination, outputNum, inputNum) {
|
|
if (this.isArray(this.output)) {
|
|
if (this.isNumber(destination)) {
|
|
this.output[destination].disconnect();
|
|
} else {
|
|
outputNum = this.defaultArg(outputNum, 0);
|
|
this.output[outputNum].disconnect(destination, 0, inputNum);
|
|
}
|
|
} else {
|
|
this.output.disconnect.apply(this.output, arguments);
|
|
}
|
|
};
|
|
Tone.prototype.connectSeries = function () {
|
|
if (arguments.length > 1) {
|
|
var currentUnit = arguments[0];
|
|
for (var i = 1; i < arguments.length; i++) {
|
|
var toUnit = arguments[i];
|
|
currentUnit.connect(toUnit);
|
|
currentUnit = toUnit;
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
Tone.prototype.chain = function () {
|
|
if (arguments.length > 0) {
|
|
var currentUnit = this;
|
|
for (var i = 0; i < arguments.length; i++) {
|
|
var toUnit = arguments[i];
|
|
currentUnit.connect(toUnit);
|
|
currentUnit = toUnit;
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
Tone.prototype.fan = function () {
|
|
if (arguments.length > 0) {
|
|
for (var i = 0; i < arguments.length; i++) {
|
|
this.connect(arguments[i]);
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
AudioNode.prototype.chain = Tone.prototype.chain;
|
|
AudioNode.prototype.fan = Tone.prototype.fan;
|
|
Tone.prototype.defaultArg = function (given, fallback) {
|
|
if (this.isObject(given) && this.isObject(fallback)) {
|
|
var ret = {};
|
|
for (var givenProp in given) {
|
|
ret[givenProp] = this.defaultArg(fallback[givenProp], given[givenProp]);
|
|
}
|
|
for (var fallbackProp in fallback) {
|
|
ret[fallbackProp] = this.defaultArg(given[fallbackProp], fallback[fallbackProp]);
|
|
}
|
|
return ret;
|
|
} else {
|
|
return this.isUndef(given) ? fallback : given;
|
|
}
|
|
};
|
|
Tone.prototype.optionsObject = function (values, keys, defaults) {
|
|
var options = {};
|
|
if (values.length === 1 && this.isObject(values[0])) {
|
|
options = values[0];
|
|
} else {
|
|
for (var i = 0; i < keys.length; i++) {
|
|
options[keys[i]] = values[i];
|
|
}
|
|
}
|
|
if (!this.isUndef(defaults)) {
|
|
return this.defaultArg(options, defaults);
|
|
} else {
|
|
return options;
|
|
}
|
|
};
|
|
Tone.prototype.isUndef = function (val) {
|
|
return typeof val === 'undefined';
|
|
};
|
|
Tone.prototype.isFunction = function (val) {
|
|
return typeof val === 'function';
|
|
};
|
|
Tone.prototype.isNumber = function (arg) {
|
|
return typeof arg === 'number';
|
|
};
|
|
Tone.prototype.isObject = function (arg) {
|
|
return Object.prototype.toString.call(arg) === '[object Object]' && arg.constructor === Object;
|
|
};
|
|
Tone.prototype.isBoolean = function (arg) {
|
|
return typeof arg === 'boolean';
|
|
};
|
|
Tone.prototype.isArray = function (arg) {
|
|
return Array.isArray(arg);
|
|
};
|
|
Tone.prototype.isString = function (arg) {
|
|
return typeof arg === 'string';
|
|
};
|
|
Tone.noOp = function () {
|
|
};
|
|
Tone.prototype._readOnly = function (property) {
|
|
if (Array.isArray(property)) {
|
|
for (var i = 0; i < property.length; i++) {
|
|
this._readOnly(property[i]);
|
|
}
|
|
} else {
|
|
Object.defineProperty(this, property, {
|
|
writable: false,
|
|
enumerable: true
|
|
});
|
|
}
|
|
};
|
|
Tone.prototype._writable = function (property) {
|
|
if (Array.isArray(property)) {
|
|
for (var i = 0; i < property.length; i++) {
|
|
this._writable(property[i]);
|
|
}
|
|
} else {
|
|
Object.defineProperty(this, property, { writable: true });
|
|
}
|
|
};
|
|
Tone.State = {
|
|
Started: 'started',
|
|
Stopped: 'stopped',
|
|
Paused: 'paused'
|
|
};
|
|
Tone.prototype.equalPowerScale = function (percent) {
|
|
var piFactor = 0.5 * Math.PI;
|
|
return Math.sin(percent * piFactor);
|
|
};
|
|
Tone.prototype.dbToGain = function (db) {
|
|
return Math.pow(2, db / 6);
|
|
};
|
|
Tone.prototype.gainToDb = function (gain) {
|
|
return 20 * (Math.log(gain) / Math.LN10);
|
|
};
|
|
Tone.prototype.intervalToFrequencyRatio = function (interval) {
|
|
return Math.pow(2, interval / 12);
|
|
};
|
|
Tone.prototype.now = function () {
|
|
return Tone.context.now();
|
|
};
|
|
Tone.now = function () {
|
|
return Tone.context.now();
|
|
};
|
|
Tone.extend = function (child, parent) {
|
|
if (Tone.prototype.isUndef(parent)) {
|
|
parent = Tone;
|
|
}
|
|
function TempConstructor() {
|
|
}
|
|
TempConstructor.prototype = parent.prototype;
|
|
child.prototype = new TempConstructor();
|
|
child.prototype.constructor = child;
|
|
child._super = parent;
|
|
};
|
|
var audioContext;
|
|
Object.defineProperty(Tone, 'context', {
|
|
get: function () {
|
|
return audioContext;
|
|
},
|
|
set: function (context) {
|
|
if (Tone.Context && context instanceof Tone.Context) {
|
|
audioContext = context;
|
|
} else {
|
|
audioContext = new Tone.Context(context);
|
|
}
|
|
if (Tone.Context) {
|
|
Tone.Context.emit('init', audioContext);
|
|
}
|
|
}
|
|
});
|
|
Object.defineProperty(Tone.prototype, 'context', {
|
|
get: function () {
|
|
return Tone.context;
|
|
}
|
|
});
|
|
Tone.setContext = function (ctx) {
|
|
Tone.context = ctx;
|
|
};
|
|
Object.defineProperty(Tone.prototype, 'blockTime', {
|
|
get: function () {
|
|
return 128 / this.context.sampleRate;
|
|
}
|
|
});
|
|
Object.defineProperty(Tone.prototype, 'sampleTime', {
|
|
get: function () {
|
|
return 1 / this.context.sampleRate;
|
|
}
|
|
});
|
|
Object.defineProperty(Tone, 'supported', {
|
|
get: function () {
|
|
var hasAudioContext = window.hasOwnProperty('AudioContext') || window.hasOwnProperty('webkitAudioContext');
|
|
var hasPromises = window.hasOwnProperty('Promise');
|
|
var hasWorkers = window.hasOwnProperty('Worker');
|
|
return hasAudioContext && hasPromises && hasWorkers;
|
|
}
|
|
});
|
|
Tone.version = 'r10';
|
|
if (!window.TONE_SILENCE_VERSION_LOGGING) {
|
|
}
|
|
return Tone;
|
|
}();
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_SignalBase;
|
|
Tone_signal_SignalBase = function (Tone) {
|
|
'use strict';
|
|
Tone.SignalBase = function () {
|
|
};
|
|
Tone.extend(Tone.SignalBase);
|
|
Tone.SignalBase.prototype.connect = function (node, outputNumber, inputNumber) {
|
|
if (Tone.Signal && Tone.Signal === node.constructor || Tone.Param && Tone.Param === node.constructor || Tone.TimelineSignal && Tone.TimelineSignal === node.constructor) {
|
|
node._param.cancelScheduledValues(0);
|
|
node._param.value = 0;
|
|
node.overridden = true;
|
|
} else if (node instanceof AudioParam) {
|
|
node.cancelScheduledValues(0);
|
|
node.value = 0;
|
|
}
|
|
Tone.prototype.connect.call(this, node, outputNumber, inputNumber);
|
|
return this;
|
|
};
|
|
return Tone.SignalBase;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_WaveShaper;
|
|
Tone_signal_WaveShaper = function (Tone) {
|
|
'use strict';
|
|
Tone.WaveShaper = function (mapping, bufferLen) {
|
|
this._shaper = this.input = this.output = this.context.createWaveShaper();
|
|
this._curve = null;
|
|
if (Array.isArray(mapping)) {
|
|
this.curve = mapping;
|
|
} else if (isFinite(mapping) || this.isUndef(mapping)) {
|
|
this._curve = new Float32Array(this.defaultArg(mapping, 1024));
|
|
} else if (this.isFunction(mapping)) {
|
|
this._curve = new Float32Array(this.defaultArg(bufferLen, 1024));
|
|
this.setMap(mapping);
|
|
}
|
|
};
|
|
Tone.extend(Tone.WaveShaper, Tone.SignalBase);
|
|
Tone.WaveShaper.prototype.setMap = function (mapping) {
|
|
for (var i = 0, len = this._curve.length; i < len; i++) {
|
|
var normalized = i / (len - 1) * 2 - 1;
|
|
this._curve[i] = mapping(normalized, i);
|
|
}
|
|
this._shaper.curve = this._curve;
|
|
return this;
|
|
};
|
|
Object.defineProperty(Tone.WaveShaper.prototype, 'curve', {
|
|
get: function () {
|
|
return this._shaper.curve;
|
|
},
|
|
set: function (mapping) {
|
|
this._curve = new Float32Array(mapping);
|
|
this._shaper.curve = this._curve;
|
|
}
|
|
});
|
|
Object.defineProperty(Tone.WaveShaper.prototype, 'oversample', {
|
|
get: function () {
|
|
return this._shaper.oversample;
|
|
},
|
|
set: function (oversampling) {
|
|
if ([
|
|
'none',
|
|
'2x',
|
|
'4x'
|
|
].indexOf(oversampling) !== -1) {
|
|
this._shaper.oversample = oversampling;
|
|
} else {
|
|
throw new RangeError('Tone.WaveShaper: oversampling must be either \'none\', \'2x\', or \'4x\'');
|
|
}
|
|
}
|
|
});
|
|
Tone.WaveShaper.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._shaper.disconnect();
|
|
this._shaper = null;
|
|
this._curve = null;
|
|
return this;
|
|
};
|
|
return Tone.WaveShaper;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_type_TimeBase;
|
|
Tone_type_TimeBase = function (Tone) {
|
|
Tone.TimeBase = function (val, units) {
|
|
if (this instanceof Tone.TimeBase) {
|
|
this._expr = this._noOp;
|
|
if (val instanceof Tone.TimeBase) {
|
|
this.copy(val);
|
|
} else if (!this.isUndef(units) || this.isNumber(val)) {
|
|
units = this.defaultArg(units, this._defaultUnits);
|
|
var method = this._primaryExpressions[units].method;
|
|
this._expr = method.bind(this, val);
|
|
} else if (this.isString(val)) {
|
|
this.set(val);
|
|
} else if (this.isUndef(val)) {
|
|
this._expr = this._defaultExpr();
|
|
}
|
|
} else {
|
|
return new Tone.TimeBase(val, units);
|
|
}
|
|
};
|
|
Tone.extend(Tone.TimeBase);
|
|
Tone.TimeBase.prototype.set = function (exprString) {
|
|
this._expr = this._parseExprString(exprString);
|
|
return this;
|
|
};
|
|
Tone.TimeBase.prototype.clone = function () {
|
|
var instance = new this.constructor();
|
|
instance.copy(this);
|
|
return instance;
|
|
};
|
|
Tone.TimeBase.prototype.copy = function (time) {
|
|
var val = time._expr();
|
|
return this.set(val);
|
|
};
|
|
Tone.TimeBase.prototype._primaryExpressions = {
|
|
'n': {
|
|
regexp: /^(\d+)n/i,
|
|
method: function (value) {
|
|
value = parseInt(value);
|
|
if (value === 1) {
|
|
return this._beatsToUnits(this._timeSignature());
|
|
} else {
|
|
return this._beatsToUnits(4 / value);
|
|
}
|
|
}
|
|
},
|
|
't': {
|
|
regexp: /^(\d+)t/i,
|
|
method: function (value) {
|
|
value = parseInt(value);
|
|
return this._beatsToUnits(8 / (parseInt(value) * 3));
|
|
}
|
|
},
|
|
'm': {
|
|
regexp: /^(\d+)m/i,
|
|
method: function (value) {
|
|
return this._beatsToUnits(parseInt(value) * this._timeSignature());
|
|
}
|
|
},
|
|
'i': {
|
|
regexp: /^(\d+)i/i,
|
|
method: function (value) {
|
|
return this._ticksToUnits(parseInt(value));
|
|
}
|
|
},
|
|
'hz': {
|
|
regexp: /^(\d+(?:\.\d+)?)hz/i,
|
|
method: function (value) {
|
|
return this._frequencyToUnits(parseFloat(value));
|
|
}
|
|
},
|
|
'tr': {
|
|
regexp: /^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?):?(\d+(?:\.\d+)?)?/,
|
|
method: function (m, q, s) {
|
|
var total = 0;
|
|
if (m && m !== '0') {
|
|
total += this._beatsToUnits(this._timeSignature() * parseFloat(m));
|
|
}
|
|
if (q && q !== '0') {
|
|
total += this._beatsToUnits(parseFloat(q));
|
|
}
|
|
if (s && s !== '0') {
|
|
total += this._beatsToUnits(parseFloat(s) / 4);
|
|
}
|
|
return total;
|
|
}
|
|
},
|
|
's': {
|
|
regexp: /^(\d+(?:\.\d+)?s)/,
|
|
method: function (value) {
|
|
return this._secondsToUnits(parseFloat(value));
|
|
}
|
|
},
|
|
'samples': {
|
|
regexp: /^(\d+)samples/,
|
|
method: function (value) {
|
|
return parseInt(value) / this.context.sampleRate;
|
|
}
|
|
},
|
|
'default': {
|
|
regexp: /^(\d+(?:\.\d+)?)/,
|
|
method: function (value) {
|
|
return this._primaryExpressions[this._defaultUnits].method.call(this, value);
|
|
}
|
|
}
|
|
};
|
|
Tone.TimeBase.prototype._binaryExpressions = {
|
|
'+': {
|
|
regexp: /^\+/,
|
|
precedence: 2,
|
|
method: function (lh, rh) {
|
|
return lh() + rh();
|
|
}
|
|
},
|
|
'-': {
|
|
regexp: /^\-/,
|
|
precedence: 2,
|
|
method: function (lh, rh) {
|
|
return lh() - rh();
|
|
}
|
|
},
|
|
'*': {
|
|
regexp: /^\*/,
|
|
precedence: 1,
|
|
method: function (lh, rh) {
|
|
return lh() * rh();
|
|
}
|
|
},
|
|
'/': {
|
|
regexp: /^\//,
|
|
precedence: 1,
|
|
method: function (lh, rh) {
|
|
return lh() / rh();
|
|
}
|
|
}
|
|
};
|
|
Tone.TimeBase.prototype._unaryExpressions = {
|
|
'neg': {
|
|
regexp: /^\-/,
|
|
method: function (lh) {
|
|
return -lh();
|
|
}
|
|
}
|
|
};
|
|
Tone.TimeBase.prototype._syntaxGlue = {
|
|
'(': { regexp: /^\(/ },
|
|
')': { regexp: /^\)/ }
|
|
};
|
|
Tone.TimeBase.prototype._tokenize = function (expr) {
|
|
var position = -1;
|
|
var tokens = [];
|
|
while (expr.length > 0) {
|
|
expr = expr.trim();
|
|
var token = getNextToken(expr, this);
|
|
tokens.push(token);
|
|
expr = expr.substr(token.value.length);
|
|
}
|
|
function getNextToken(expr, context) {
|
|
var expressions = [
|
|
'_binaryExpressions',
|
|
'_unaryExpressions',
|
|
'_primaryExpressions',
|
|
'_syntaxGlue'
|
|
];
|
|
for (var i = 0; i < expressions.length; i++) {
|
|
var group = context[expressions[i]];
|
|
for (var opName in group) {
|
|
var op = group[opName];
|
|
var reg = op.regexp;
|
|
var match = expr.match(reg);
|
|
if (match !== null) {
|
|
return {
|
|
method: op.method,
|
|
precedence: op.precedence,
|
|
regexp: op.regexp,
|
|
value: match[0]
|
|
};
|
|
}
|
|
}
|
|
}
|
|
throw new SyntaxError('Tone.TimeBase: Unexpected token ' + expr);
|
|
}
|
|
return {
|
|
next: function () {
|
|
return tokens[++position];
|
|
},
|
|
peek: function () {
|
|
return tokens[position + 1];
|
|
}
|
|
};
|
|
};
|
|
Tone.TimeBase.prototype._matchGroup = function (token, group, prec) {
|
|
var ret = false;
|
|
if (!this.isUndef(token)) {
|
|
for (var opName in group) {
|
|
var op = group[opName];
|
|
if (op.regexp.test(token.value)) {
|
|
if (!this.isUndef(prec)) {
|
|
if (op.precedence === prec) {
|
|
return op;
|
|
}
|
|
} else {
|
|
return op;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return ret;
|
|
};
|
|
Tone.TimeBase.prototype._parseBinary = function (lexer, precedence) {
|
|
if (this.isUndef(precedence)) {
|
|
precedence = 2;
|
|
}
|
|
var expr;
|
|
if (precedence < 0) {
|
|
expr = this._parseUnary(lexer);
|
|
} else {
|
|
expr = this._parseBinary(lexer, precedence - 1);
|
|
}
|
|
var token = lexer.peek();
|
|
while (token && this._matchGroup(token, this._binaryExpressions, precedence)) {
|
|
token = lexer.next();
|
|
expr = token.method.bind(this, expr, this._parseBinary(lexer, precedence - 1));
|
|
token = lexer.peek();
|
|
}
|
|
return expr;
|
|
};
|
|
Tone.TimeBase.prototype._parseUnary = function (lexer) {
|
|
var token, expr;
|
|
token = lexer.peek();
|
|
var op = this._matchGroup(token, this._unaryExpressions);
|
|
if (op) {
|
|
token = lexer.next();
|
|
expr = this._parseUnary(lexer);
|
|
return op.method.bind(this, expr);
|
|
}
|
|
return this._parsePrimary(lexer);
|
|
};
|
|
Tone.TimeBase.prototype._parsePrimary = function (lexer) {
|
|
var token, expr;
|
|
token = lexer.peek();
|
|
if (this.isUndef(token)) {
|
|
throw new SyntaxError('Tone.TimeBase: Unexpected end of expression');
|
|
}
|
|
if (this._matchGroup(token, this._primaryExpressions)) {
|
|
token = lexer.next();
|
|
var matching = token.value.match(token.regexp);
|
|
return token.method.bind(this, matching[1], matching[2], matching[3]);
|
|
}
|
|
if (token && token.value === '(') {
|
|
lexer.next();
|
|
expr = this._parseBinary(lexer);
|
|
token = lexer.next();
|
|
if (!(token && token.value === ')')) {
|
|
throw new SyntaxError('Expected )');
|
|
}
|
|
return expr;
|
|
}
|
|
throw new SyntaxError('Tone.TimeBase: Cannot process token ' + token.value);
|
|
};
|
|
Tone.TimeBase.prototype._parseExprString = function (exprString) {
|
|
if (!this.isString(exprString)) {
|
|
exprString = exprString.toString();
|
|
}
|
|
var lexer = this._tokenize(exprString);
|
|
var tree = this._parseBinary(lexer);
|
|
return tree;
|
|
};
|
|
Tone.TimeBase.prototype._noOp = function () {
|
|
return 0;
|
|
};
|
|
Tone.TimeBase.prototype._defaultExpr = function () {
|
|
return this._noOp;
|
|
};
|
|
Tone.TimeBase.prototype._defaultUnits = 's';
|
|
Tone.TimeBase.prototype._frequencyToUnits = function (freq) {
|
|
return 1 / freq;
|
|
};
|
|
Tone.TimeBase.prototype._beatsToUnits = function (beats) {
|
|
return 60 / Tone.Transport.bpm.value * beats;
|
|
};
|
|
Tone.TimeBase.prototype._secondsToUnits = function (seconds) {
|
|
return seconds;
|
|
};
|
|
Tone.TimeBase.prototype._ticksToUnits = function (ticks) {
|
|
return ticks * (this._beatsToUnits(1) / Tone.Transport.PPQ);
|
|
};
|
|
Tone.TimeBase.prototype._timeSignature = function () {
|
|
return Tone.Transport.timeSignature;
|
|
};
|
|
Tone.TimeBase.prototype._pushExpr = function (val, name, units) {
|
|
if (!(val instanceof Tone.TimeBase)) {
|
|
val = new this.constructor(val, units);
|
|
}
|
|
this._expr = this._binaryExpressions[name].method.bind(this, this._expr, val._expr);
|
|
return this;
|
|
};
|
|
Tone.TimeBase.prototype.add = function (val, units) {
|
|
return this._pushExpr(val, '+', units);
|
|
};
|
|
Tone.TimeBase.prototype.sub = function (val, units) {
|
|
return this._pushExpr(val, '-', units);
|
|
};
|
|
Tone.TimeBase.prototype.mult = function (val, units) {
|
|
return this._pushExpr(val, '*', units);
|
|
};
|
|
Tone.TimeBase.prototype.div = function (val, units) {
|
|
return this._pushExpr(val, '/', units);
|
|
};
|
|
Tone.TimeBase.prototype.valueOf = function () {
|
|
return this._expr();
|
|
};
|
|
Tone.TimeBase.prototype.dispose = function () {
|
|
this._expr = null;
|
|
};
|
|
return Tone.TimeBase;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_type_Time;
|
|
Tone_type_Time = function (Tone) {
|
|
Tone.Time = function (val, units) {
|
|
if (this instanceof Tone.Time) {
|
|
this._plusNow = false;
|
|
Tone.TimeBase.call(this, val, units);
|
|
} else {
|
|
return new Tone.Time(val, units);
|
|
}
|
|
};
|
|
Tone.extend(Tone.Time, Tone.TimeBase);
|
|
Tone.Time.prototype._unaryExpressions = Object.create(Tone.TimeBase.prototype._unaryExpressions);
|
|
Tone.Time.prototype._unaryExpressions.quantize = {
|
|
regexp: /^@/,
|
|
method: function (rh) {
|
|
return Tone.Transport.nextSubdivision(rh());
|
|
}
|
|
};
|
|
Tone.Time.prototype._unaryExpressions.now = {
|
|
regexp: /^\+/,
|
|
method: function (lh) {
|
|
this._plusNow = true;
|
|
return lh();
|
|
}
|
|
};
|
|
Tone.Time.prototype.quantize = function (subdiv, percent) {
|
|
percent = this.defaultArg(percent, 1);
|
|
this._expr = function (expr, subdivision, percent) {
|
|
expr = expr();
|
|
subdivision = subdivision.toSeconds();
|
|
var multiple = Math.round(expr / subdivision);
|
|
var ideal = multiple * subdivision;
|
|
var diff = ideal - expr;
|
|
return expr + diff * percent;
|
|
}.bind(this, this._expr, new this.constructor(subdiv), percent);
|
|
return this;
|
|
};
|
|
Tone.Time.prototype.addNow = function () {
|
|
this._plusNow = true;
|
|
return this;
|
|
};
|
|
Tone.Time.prototype._defaultExpr = function () {
|
|
this._plusNow = true;
|
|
return this._noOp;
|
|
};
|
|
Tone.Time.prototype.copy = function (time) {
|
|
Tone.TimeBase.prototype.copy.call(this, time);
|
|
this._plusNow = time._plusNow;
|
|
return this;
|
|
};
|
|
Tone.Time.prototype.toNotation = function () {
|
|
var time = this.toSeconds();
|
|
var testNotations = [
|
|
'1m',
|
|
'2n',
|
|
'4n',
|
|
'8n',
|
|
'16n',
|
|
'32n',
|
|
'64n',
|
|
'128n'
|
|
];
|
|
var retNotation = this._toNotationHelper(time, testNotations);
|
|
var testTripletNotations = [
|
|
'1m',
|
|
'2n',
|
|
'2t',
|
|
'4n',
|
|
'4t',
|
|
'8n',
|
|
'8t',
|
|
'16n',
|
|
'16t',
|
|
'32n',
|
|
'32t',
|
|
'64n',
|
|
'64t',
|
|
'128n'
|
|
];
|
|
var retTripletNotation = this._toNotationHelper(time, testTripletNotations);
|
|
if (retTripletNotation.split('+').length < retNotation.split('+').length) {
|
|
return retTripletNotation;
|
|
} else {
|
|
return retNotation;
|
|
}
|
|
};
|
|
Tone.Time.prototype._toNotationHelper = function (units, testNotations) {
|
|
var threshold = this._notationToUnits(testNotations[testNotations.length - 1]);
|
|
var retNotation = '';
|
|
for (var i = 0; i < testNotations.length; i++) {
|
|
var notationTime = this._notationToUnits(testNotations[i]);
|
|
var multiple = units / notationTime;
|
|
var floatingPointError = 0.000001;
|
|
if (1 - multiple % 1 < floatingPointError) {
|
|
multiple += floatingPointError;
|
|
}
|
|
multiple = Math.floor(multiple);
|
|
if (multiple > 0) {
|
|
if (multiple === 1) {
|
|
retNotation += testNotations[i];
|
|
} else {
|
|
retNotation += multiple.toString() + '*' + testNotations[i];
|
|
}
|
|
units -= multiple * notationTime;
|
|
if (units < threshold) {
|
|
break;
|
|
} else {
|
|
retNotation += ' + ';
|
|
}
|
|
}
|
|
}
|
|
if (retNotation === '') {
|
|
retNotation = '0';
|
|
}
|
|
return retNotation;
|
|
};
|
|
Tone.Time.prototype._notationToUnits = function (notation) {
|
|
var primaryExprs = this._primaryExpressions;
|
|
var notationExprs = [
|
|
primaryExprs.n,
|
|
primaryExprs.t,
|
|
primaryExprs.m
|
|
];
|
|
for (var i = 0; i < notationExprs.length; i++) {
|
|
var expr = notationExprs[i];
|
|
var match = notation.match(expr.regexp);
|
|
if (match) {
|
|
return expr.method.call(this, match[1]);
|
|
}
|
|
}
|
|
};
|
|
Tone.Time.prototype.toBarsBeatsSixteenths = function () {
|
|
var quarterTime = this._beatsToUnits(1);
|
|
var quarters = this.toSeconds() / quarterTime;
|
|
var measures = Math.floor(quarters / this._timeSignature());
|
|
var sixteenths = quarters % 1 * 4;
|
|
quarters = Math.floor(quarters) % this._timeSignature();
|
|
sixteenths = sixteenths.toString();
|
|
if (sixteenths.length > 3) {
|
|
sixteenths = parseFloat(sixteenths).toFixed(3);
|
|
}
|
|
var progress = [
|
|
measures,
|
|
quarters,
|
|
sixteenths
|
|
];
|
|
return progress.join(':');
|
|
};
|
|
Tone.Time.prototype.toTicks = function () {
|
|
var quarterTime = this._beatsToUnits(1);
|
|
var quarters = this.valueOf() / quarterTime;
|
|
return Math.floor(quarters * Tone.Transport.PPQ);
|
|
};
|
|
Tone.Time.prototype.toSamples = function () {
|
|
return this.toSeconds() * this.context.sampleRate;
|
|
};
|
|
Tone.Time.prototype.toFrequency = function () {
|
|
return 1 / this.toSeconds();
|
|
};
|
|
Tone.Time.prototype.toSeconds = function () {
|
|
return this.valueOf();
|
|
};
|
|
Tone.Time.prototype.toMilliseconds = function () {
|
|
return this.toSeconds() * 1000;
|
|
};
|
|
Tone.Time.prototype.valueOf = function () {
|
|
var val = this._expr();
|
|
return val + (this._plusNow ? this.now() : 0);
|
|
};
|
|
return Tone.Time;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_type_Frequency;
|
|
Tone_type_Frequency = function (Tone) {
|
|
Tone.Frequency = function (val, units) {
|
|
if (this instanceof Tone.Frequency) {
|
|
Tone.TimeBase.call(this, val, units);
|
|
} else {
|
|
return new Tone.Frequency(val, units);
|
|
}
|
|
};
|
|
Tone.extend(Tone.Frequency, Tone.TimeBase);
|
|
Tone.Frequency.prototype._primaryExpressions = Object.create(Tone.TimeBase.prototype._primaryExpressions);
|
|
Tone.Frequency.prototype._primaryExpressions.midi = {
|
|
regexp: /^(\d+(?:\.\d+)?midi)/,
|
|
method: function (value) {
|
|
return this.midiToFrequency(value);
|
|
}
|
|
};
|
|
Tone.Frequency.prototype._primaryExpressions.note = {
|
|
regexp: /^([a-g]{1}(?:b|#|x|bb)?)(-?[0-9]+)/i,
|
|
method: function (pitch, octave) {
|
|
var index = noteToScaleIndex[pitch.toLowerCase()];
|
|
var noteNumber = index + (parseInt(octave) + 1) * 12;
|
|
return this.midiToFrequency(noteNumber);
|
|
}
|
|
};
|
|
Tone.Frequency.prototype._primaryExpressions.tr = {
|
|
regexp: /^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?):?(\d+(?:\.\d+)?)?/,
|
|
method: function (m, q, s) {
|
|
var total = 1;
|
|
if (m && m !== '0') {
|
|
total *= this._beatsToUnits(this._timeSignature() * parseFloat(m));
|
|
}
|
|
if (q && q !== '0') {
|
|
total *= this._beatsToUnits(parseFloat(q));
|
|
}
|
|
if (s && s !== '0') {
|
|
total *= this._beatsToUnits(parseFloat(s) / 4);
|
|
}
|
|
return total;
|
|
}
|
|
};
|
|
Tone.Frequency.prototype.transpose = function (interval) {
|
|
this._expr = function (expr, interval) {
|
|
var val = expr();
|
|
return val * this.intervalToFrequencyRatio(interval);
|
|
}.bind(this, this._expr, interval);
|
|
return this;
|
|
};
|
|
Tone.Frequency.prototype.harmonize = function (intervals) {
|
|
this._expr = function (expr, intervals) {
|
|
var val = expr();
|
|
var ret = [];
|
|
for (var i = 0; i < intervals.length; i++) {
|
|
ret[i] = val * this.intervalToFrequencyRatio(intervals[i]);
|
|
}
|
|
return ret;
|
|
}.bind(this, this._expr, intervals);
|
|
return this;
|
|
};
|
|
Tone.Frequency.prototype.toMidi = function () {
|
|
return this.frequencyToMidi(this.valueOf());
|
|
};
|
|
Tone.Frequency.prototype.toNote = function () {
|
|
var freq = this.valueOf();
|
|
var log = Math.log(freq / Tone.Frequency.A4) / Math.LN2;
|
|
var noteNumber = Math.round(12 * log) + 57;
|
|
var octave = Math.floor(noteNumber / 12);
|
|
if (octave < 0) {
|
|
noteNumber += -12 * octave;
|
|
}
|
|
var noteName = scaleIndexToNote[noteNumber % 12];
|
|
return noteName + octave.toString();
|
|
};
|
|
Tone.Frequency.prototype.toSeconds = function () {
|
|
return 1 / this.valueOf();
|
|
};
|
|
Tone.Frequency.prototype.toFrequency = function () {
|
|
return this.valueOf();
|
|
};
|
|
Tone.Frequency.prototype.toTicks = function () {
|
|
var quarterTime = this._beatsToUnits(1);
|
|
var quarters = this.valueOf() / quarterTime;
|
|
return Math.floor(quarters * Tone.Transport.PPQ);
|
|
};
|
|
Tone.Frequency.prototype._frequencyToUnits = function (freq) {
|
|
return freq;
|
|
};
|
|
Tone.Frequency.prototype._ticksToUnits = function (ticks) {
|
|
return 1 / (ticks * 60 / (Tone.Transport.bpm.value * Tone.Transport.PPQ));
|
|
};
|
|
Tone.Frequency.prototype._beatsToUnits = function (beats) {
|
|
return 1 / Tone.TimeBase.prototype._beatsToUnits.call(this, beats);
|
|
};
|
|
Tone.Frequency.prototype._secondsToUnits = function (seconds) {
|
|
return 1 / seconds;
|
|
};
|
|
Tone.Frequency.prototype._defaultUnits = 'hz';
|
|
var noteToScaleIndex = {
|
|
'cbb': -2,
|
|
'cb': -1,
|
|
'c': 0,
|
|
'c#': 1,
|
|
'cx': 2,
|
|
'dbb': 0,
|
|
'db': 1,
|
|
'd': 2,
|
|
'd#': 3,
|
|
'dx': 4,
|
|
'ebb': 2,
|
|
'eb': 3,
|
|
'e': 4,
|
|
'e#': 5,
|
|
'ex': 6,
|
|
'fbb': 3,
|
|
'fb': 4,
|
|
'f': 5,
|
|
'f#': 6,
|
|
'fx': 7,
|
|
'gbb': 5,
|
|
'gb': 6,
|
|
'g': 7,
|
|
'g#': 8,
|
|
'gx': 9,
|
|
'abb': 7,
|
|
'ab': 8,
|
|
'a': 9,
|
|
'a#': 10,
|
|
'ax': 11,
|
|
'bbb': 9,
|
|
'bb': 10,
|
|
'b': 11,
|
|
'b#': 12,
|
|
'bx': 13
|
|
};
|
|
var scaleIndexToNote = [
|
|
'C',
|
|
'C#',
|
|
'D',
|
|
'D#',
|
|
'E',
|
|
'F',
|
|
'F#',
|
|
'G',
|
|
'G#',
|
|
'A',
|
|
'A#',
|
|
'B'
|
|
];
|
|
Tone.Frequency.A4 = 440;
|
|
Tone.Frequency.prototype.midiToFrequency = function (midi) {
|
|
return Tone.Frequency.A4 * Math.pow(2, (midi - 69) / 12);
|
|
};
|
|
Tone.Frequency.prototype.frequencyToMidi = function (frequency) {
|
|
return 69 + 12 * Math.log(frequency / Tone.Frequency.A4) / Math.LN2;
|
|
};
|
|
return Tone.Frequency;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_type_TransportTime;
|
|
Tone_type_TransportTime = function (Tone) {
|
|
Tone.TransportTime = function (val, units) {
|
|
if (this instanceof Tone.TransportTime) {
|
|
Tone.Time.call(this, val, units);
|
|
} else {
|
|
return new Tone.TransportTime(val, units);
|
|
}
|
|
};
|
|
Tone.extend(Tone.TransportTime, Tone.Time);
|
|
Tone.TransportTime.prototype._unaryExpressions = Object.create(Tone.Time.prototype._unaryExpressions);
|
|
Tone.TransportTime.prototype._unaryExpressions.quantize = {
|
|
regexp: /^@/,
|
|
method: function (rh) {
|
|
var subdivision = this._secondsToTicks(rh());
|
|
var multiple = Math.ceil(Tone.Transport.ticks / subdivision);
|
|
return this._ticksToUnits(multiple * subdivision);
|
|
}
|
|
};
|
|
Tone.TransportTime.prototype._secondsToTicks = function (seconds) {
|
|
var quarterTime = this._beatsToUnits(1);
|
|
var quarters = seconds / quarterTime;
|
|
return Math.round(quarters * Tone.Transport.PPQ);
|
|
};
|
|
Tone.TransportTime.prototype.valueOf = function () {
|
|
var val = this._secondsToTicks(this._expr());
|
|
return val + (this._plusNow ? Tone.Transport.ticks : 0);
|
|
};
|
|
Tone.TransportTime.prototype.toTicks = function () {
|
|
return this.valueOf();
|
|
};
|
|
Tone.TransportTime.prototype.toSeconds = function () {
|
|
var val = this._expr();
|
|
return val + (this._plusNow ? Tone.Transport.seconds : 0);
|
|
};
|
|
Tone.TransportTime.prototype.toFrequency = function () {
|
|
return 1 / this.toSeconds();
|
|
};
|
|
return Tone.TransportTime;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_core_Emitter;
|
|
Tone_core_Emitter = function (Tone) {
|
|
'use strict';
|
|
Tone.Emitter = function () {
|
|
this._events = {};
|
|
};
|
|
Tone.extend(Tone.Emitter);
|
|
Tone.Emitter.prototype.on = function (event, callback) {
|
|
var events = event.split(/\W+/);
|
|
for (var i = 0; i < events.length; i++) {
|
|
var eventName = events[i];
|
|
if (!this._events.hasOwnProperty(eventName)) {
|
|
this._events[eventName] = [];
|
|
}
|
|
this._events[eventName].push(callback);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Emitter.prototype.off = function (event, callback) {
|
|
var events = event.split(/\W+/);
|
|
for (var ev = 0; ev < events.length; ev++) {
|
|
event = events[ev];
|
|
if (this._events.hasOwnProperty(event)) {
|
|
if (Tone.prototype.isUndef(callback)) {
|
|
this._events[event] = [];
|
|
} else {
|
|
var eventList = this._events[event];
|
|
for (var i = 0; i < eventList.length; i++) {
|
|
if (eventList[i] === callback) {
|
|
eventList.splice(i, 1);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Emitter.prototype.emit = function (event) {
|
|
if (this._events) {
|
|
var args = Array.apply(null, arguments).slice(1);
|
|
if (this._events.hasOwnProperty(event)) {
|
|
var eventList = this._events[event];
|
|
for (var i = 0, len = eventList.length; i < len; i++) {
|
|
eventList[i].apply(this, args);
|
|
}
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Emitter.mixin = function (object) {
|
|
var functions = [
|
|
'on',
|
|
'off',
|
|
'emit'
|
|
];
|
|
object._events = {};
|
|
for (var i = 0; i < functions.length; i++) {
|
|
var func = functions[i];
|
|
var emitterFunc = Tone.Emitter.prototype[func];
|
|
object[func] = emitterFunc;
|
|
}
|
|
};
|
|
Tone.Emitter.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._events = null;
|
|
return this;
|
|
};
|
|
return Tone.Emitter;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_core_Context;
|
|
Tone_core_Context = function (Tone) {
|
|
if (!window.hasOwnProperty('AudioContext') && window.hasOwnProperty('webkitAudioContext')) {
|
|
window.AudioContext = window.webkitAudioContext;
|
|
}
|
|
Tone.Context = function (context) {
|
|
Tone.Emitter.call(this);
|
|
if (!context) {
|
|
context = new window.AudioContext();
|
|
}
|
|
this._context = context;
|
|
for (var prop in this._context) {
|
|
this._defineProperty(this._context, prop);
|
|
}
|
|
this._latencyHint = 'interactive';
|
|
this._lookAhead = 0.1;
|
|
this._updateInterval = this._lookAhead / 3;
|
|
this._computedUpdateInterval = 0;
|
|
this._worker = this._createWorker();
|
|
this._constants = {};
|
|
};
|
|
Tone.extend(Tone.Context, Tone.Emitter);
|
|
Tone.Emitter.mixin(Tone.Context);
|
|
Tone.Context.prototype._defineProperty = function (context, prop) {
|
|
if (this.isUndef(this[prop])) {
|
|
Object.defineProperty(this, prop, {
|
|
get: function () {
|
|
if (typeof context[prop] === 'function') {
|
|
return context[prop].bind(context);
|
|
} else {
|
|
return context[prop];
|
|
}
|
|
},
|
|
set: function (val) {
|
|
context[prop] = val;
|
|
}
|
|
});
|
|
}
|
|
};
|
|
Tone.Context.prototype.now = function () {
|
|
return this._context.currentTime;
|
|
};
|
|
Tone.Context.prototype._createWorker = function () {
|
|
window.URL = window.URL || window.webkitURL;
|
|
var blob = new Blob(['var timeoutTime = ' + (this._updateInterval * 1000).toFixed(1) + ';' + 'self.onmessage = function(msg){' + '\ttimeoutTime = parseInt(msg.data);' + '};' + 'function tick(){' + '\tsetTimeout(tick, timeoutTime);' + '\tself.postMessage(\'tick\');' + '}' + 'tick();']);
|
|
var blobUrl = URL.createObjectURL(blob);
|
|
var worker = new Worker(blobUrl);
|
|
worker.addEventListener('message', function () {
|
|
this.emit('tick');
|
|
}.bind(this));
|
|
worker.addEventListener('message', function () {
|
|
var now = this.now();
|
|
if (this.isNumber(this._lastUpdate)) {
|
|
var diff = now - this._lastUpdate;
|
|
this._computedUpdateInterval = Math.max(diff, this._computedUpdateInterval * 0.97);
|
|
}
|
|
this._lastUpdate = now;
|
|
}.bind(this));
|
|
return worker;
|
|
};
|
|
Tone.Context.prototype.getConstant = function (val) {
|
|
if (this._constants[val]) {
|
|
return this._constants[val];
|
|
} else {
|
|
var buffer = this._context.createBuffer(1, 128, this._context.sampleRate);
|
|
var arr = buffer.getChannelData(0);
|
|
for (var i = 0; i < arr.length; i++) {
|
|
arr[i] = val;
|
|
}
|
|
var constant = this._context.createBufferSource();
|
|
constant.channelCount = 1;
|
|
constant.channelCountMode = 'explicit';
|
|
constant.buffer = buffer;
|
|
constant.loop = true;
|
|
constant.start(0);
|
|
this._constants[val] = constant;
|
|
return constant;
|
|
}
|
|
};
|
|
Object.defineProperty(Tone.Context.prototype, 'lag', {
|
|
get: function () {
|
|
var diff = this._computedUpdateInterval - this._updateInterval;
|
|
diff = Math.max(diff, 0);
|
|
return diff;
|
|
}
|
|
});
|
|
Object.defineProperty(Tone.Context.prototype, 'lookAhead', {
|
|
get: function () {
|
|
return this._lookAhead;
|
|
},
|
|
set: function (lA) {
|
|
this._lookAhead = lA;
|
|
}
|
|
});
|
|
Object.defineProperty(Tone.Context.prototype, 'updateInterval', {
|
|
get: function () {
|
|
return this._updateInterval;
|
|
},
|
|
set: function (interval) {
|
|
this._updateInterval = Math.max(interval, Tone.prototype.blockTime);
|
|
this._worker.postMessage(Math.max(interval * 1000, 1));
|
|
}
|
|
});
|
|
Object.defineProperty(Tone.Context.prototype, 'latencyHint', {
|
|
get: function () {
|
|
return this._latencyHint;
|
|
},
|
|
set: function (hint) {
|
|
var lookAhead = hint;
|
|
this._latencyHint = hint;
|
|
if (this.isString(hint)) {
|
|
switch (hint) {
|
|
case 'interactive':
|
|
lookAhead = 0.1;
|
|
this._context.latencyHint = hint;
|
|
break;
|
|
case 'playback':
|
|
lookAhead = 0.8;
|
|
this._context.latencyHint = hint;
|
|
break;
|
|
case 'balanced':
|
|
lookAhead = 0.25;
|
|
this._context.latencyHint = hint;
|
|
break;
|
|
case 'fastest':
|
|
lookAhead = 0.01;
|
|
break;
|
|
}
|
|
}
|
|
this.lookAhead = lookAhead;
|
|
this.updateInterval = lookAhead / 3;
|
|
}
|
|
});
|
|
function shimConnect() {
|
|
var nativeConnect = AudioNode.prototype.connect;
|
|
var nativeDisconnect = AudioNode.prototype.disconnect;
|
|
function toneConnect(B, outNum, inNum) {
|
|
if (B.input) {
|
|
if (Array.isArray(B.input)) {
|
|
if (Tone.prototype.isUndef(inNum)) {
|
|
inNum = 0;
|
|
}
|
|
this.connect(B.input[inNum]);
|
|
} else {
|
|
this.connect(B.input, outNum, inNum);
|
|
}
|
|
} else {
|
|
try {
|
|
if (B instanceof AudioNode) {
|
|
nativeConnect.call(this, B, outNum, inNum);
|
|
} else {
|
|
nativeConnect.call(this, B, outNum);
|
|
}
|
|
} catch (e) {
|
|
throw new Error('error connecting to node: ' + B + '\n' + e);
|
|
}
|
|
}
|
|
}
|
|
function toneDisconnect(B, outNum, inNum) {
|
|
if (B && B.input && Array.isArray(B.input)) {
|
|
if (Tone.prototype.isUndef(inNum)) {
|
|
inNum = 0;
|
|
}
|
|
this.disconnect(B.input[inNum], outNum, inNum);
|
|
} else if (B && B.input) {
|
|
this.disconnect(B.input, outNum, inNum);
|
|
} else {
|
|
try {
|
|
nativeDisconnect.apply(this, arguments);
|
|
} catch (e) {
|
|
throw new Error('error disconnecting node: ' + B + '\n' + e);
|
|
}
|
|
}
|
|
}
|
|
if (AudioNode.prototype.connect !== toneConnect) {
|
|
AudioNode.prototype.connect = toneConnect;
|
|
AudioNode.prototype.disconnect = toneDisconnect;
|
|
}
|
|
}
|
|
if (Tone.supported) {
|
|
shimConnect();
|
|
Tone.context = new Tone.Context();
|
|
} else {
|
|
console.warn('This browser does not support Tone.js');
|
|
}
|
|
return Tone.Context;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_type_Type;
|
|
Tone_type_Type = function (Tone) {
|
|
Tone.Type = {
|
|
Default: 'number',
|
|
Time: 'time',
|
|
Frequency: 'frequency',
|
|
TransportTime: 'transportTime',
|
|
Ticks: 'ticks',
|
|
NormalRange: 'normalRange',
|
|
AudioRange: 'audioRange',
|
|
Decibels: 'db',
|
|
Interval: 'interval',
|
|
BPM: 'bpm',
|
|
Positive: 'positive',
|
|
Cents: 'cents',
|
|
Degrees: 'degrees',
|
|
MIDI: 'midi',
|
|
BarsBeatsSixteenths: 'barsBeatsSixteenths',
|
|
Samples: 'samples',
|
|
Hertz: 'hertz',
|
|
Note: 'note',
|
|
Milliseconds: 'milliseconds',
|
|
Seconds: 'seconds',
|
|
Notation: 'notation'
|
|
};
|
|
Tone.prototype.toSeconds = function (time) {
|
|
if (this.isNumber(time)) {
|
|
return time;
|
|
} else if (this.isUndef(time)) {
|
|
return this.now();
|
|
} else if (this.isString(time)) {
|
|
return new Tone.Time(time).toSeconds();
|
|
} else if (time instanceof Tone.TimeBase) {
|
|
return time.toSeconds();
|
|
}
|
|
};
|
|
Tone.prototype.toFrequency = function (freq) {
|
|
if (this.isNumber(freq)) {
|
|
return freq;
|
|
} else if (this.isString(freq) || this.isUndef(freq)) {
|
|
return new Tone.Frequency(freq).valueOf();
|
|
} else if (freq instanceof Tone.TimeBase) {
|
|
return freq.toFrequency();
|
|
}
|
|
};
|
|
Tone.prototype.toTicks = function (time) {
|
|
if (this.isNumber(time) || this.isString(time)) {
|
|
return new Tone.TransportTime(time).toTicks();
|
|
} else if (this.isUndef(time)) {
|
|
return Tone.Transport.ticks;
|
|
} else if (time instanceof Tone.TimeBase) {
|
|
return time.toTicks();
|
|
}
|
|
};
|
|
return Tone;
|
|
}(Tone_core_Tone, Tone_type_Time, Tone_type_Frequency, Tone_type_TransportTime);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_core_Param;
|
|
Tone_core_Param = function (Tone) {
|
|
'use strict';
|
|
Tone.Param = function () {
|
|
var options = this.optionsObject(arguments, [
|
|
'param',
|
|
'units',
|
|
'convert'
|
|
], Tone.Param.defaults);
|
|
this._param = this.input = options.param;
|
|
this.units = options.units;
|
|
this.convert = options.convert;
|
|
this.overridden = false;
|
|
this._lfo = null;
|
|
if (this.isObject(options.lfo)) {
|
|
this.value = options.lfo;
|
|
} else if (!this.isUndef(options.value)) {
|
|
this.value = options.value;
|
|
}
|
|
};
|
|
Tone.extend(Tone.Param);
|
|
Tone.Param.defaults = {
|
|
'units': Tone.Type.Default,
|
|
'convert': true,
|
|
'param': undefined
|
|
};
|
|
Object.defineProperty(Tone.Param.prototype, 'value', {
|
|
get: function () {
|
|
return this._toUnits(this._param.value);
|
|
},
|
|
set: function (value) {
|
|
if (this.isObject(value)) {
|
|
if (this.isUndef(Tone.LFO)) {
|
|
throw new Error('Include \'Tone.LFO\' to use an LFO as a Param value.');
|
|
}
|
|
if (this._lfo) {
|
|
this._lfo.dispose();
|
|
}
|
|
this._lfo = new Tone.LFO(value).start();
|
|
this._lfo.connect(this.input);
|
|
} else {
|
|
var convertedVal = this._fromUnits(value);
|
|
this._param.cancelScheduledValues(0);
|
|
this._param.value = convertedVal;
|
|
}
|
|
}
|
|
});
|
|
Tone.Param.prototype._fromUnits = function (val) {
|
|
if (this.convert || this.isUndef(this.convert)) {
|
|
switch (this.units) {
|
|
case Tone.Type.Time:
|
|
return this.toSeconds(val);
|
|
case Tone.Type.Frequency:
|
|
return this.toFrequency(val);
|
|
case Tone.Type.Decibels:
|
|
return this.dbToGain(val);
|
|
case Tone.Type.NormalRange:
|
|
return Math.min(Math.max(val, 0), 1);
|
|
case Tone.Type.AudioRange:
|
|
return Math.min(Math.max(val, -1), 1);
|
|
case Tone.Type.Positive:
|
|
return Math.max(val, 0);
|
|
default:
|
|
return val;
|
|
}
|
|
} else {
|
|
return val;
|
|
}
|
|
};
|
|
Tone.Param.prototype._toUnits = function (val) {
|
|
if (this.convert || this.isUndef(this.convert)) {
|
|
switch (this.units) {
|
|
case Tone.Type.Decibels:
|
|
return this.gainToDb(val);
|
|
default:
|
|
return val;
|
|
}
|
|
} else {
|
|
return val;
|
|
}
|
|
};
|
|
Tone.Param.prototype._minOutput = 0.00001;
|
|
Tone.Param.prototype.setValueAtTime = function (value, time) {
|
|
value = this._fromUnits(value);
|
|
time = this.toSeconds(time);
|
|
if (time <= this.now() + this.blockTime) {
|
|
this._param.value = value;
|
|
} else {
|
|
this._param.setValueAtTime(value, time);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Param.prototype.setRampPoint = function (now) {
|
|
now = this.defaultArg(now, this.now());
|
|
var currentVal = this._param.value;
|
|
if (currentVal === 0) {
|
|
currentVal = this._minOutput;
|
|
}
|
|
this._param.setValueAtTime(currentVal, now);
|
|
return this;
|
|
};
|
|
Tone.Param.prototype.linearRampToValueAtTime = function (value, endTime) {
|
|
value = this._fromUnits(value);
|
|
this._param.linearRampToValueAtTime(value, this.toSeconds(endTime));
|
|
return this;
|
|
};
|
|
Tone.Param.prototype.exponentialRampToValueAtTime = function (value, endTime) {
|
|
value = this._fromUnits(value);
|
|
value = Math.max(this._minOutput, value);
|
|
this._param.exponentialRampToValueAtTime(value, this.toSeconds(endTime));
|
|
return this;
|
|
};
|
|
Tone.Param.prototype.exponentialRampToValue = function (value, rampTime, startTime) {
|
|
startTime = this.toSeconds(startTime);
|
|
this.setRampPoint(startTime);
|
|
this.exponentialRampToValueAtTime(value, startTime + this.toSeconds(rampTime));
|
|
return this;
|
|
};
|
|
Tone.Param.prototype.linearRampToValue = function (value, rampTime, startTime) {
|
|
startTime = this.toSeconds(startTime);
|
|
this.setRampPoint(startTime);
|
|
this.linearRampToValueAtTime(value, startTime + this.toSeconds(rampTime));
|
|
return this;
|
|
};
|
|
Tone.Param.prototype.setTargetAtTime = function (value, startTime, timeConstant) {
|
|
value = this._fromUnits(value);
|
|
value = Math.max(this._minOutput, value);
|
|
timeConstant = Math.max(this._minOutput, timeConstant);
|
|
this._param.setTargetAtTime(value, this.toSeconds(startTime), timeConstant);
|
|
return this;
|
|
};
|
|
Tone.Param.prototype.setValueCurveAtTime = function (values, startTime, duration) {
|
|
for (var i = 0; i < values.length; i++) {
|
|
values[i] = this._fromUnits(values[i]);
|
|
}
|
|
this._param.setValueCurveAtTime(values, this.toSeconds(startTime), this.toSeconds(duration));
|
|
return this;
|
|
};
|
|
Tone.Param.prototype.cancelScheduledValues = function (startTime) {
|
|
this._param.cancelScheduledValues(this.toSeconds(startTime));
|
|
return this;
|
|
};
|
|
Tone.Param.prototype.rampTo = function (value, rampTime, startTime) {
|
|
rampTime = this.defaultArg(rampTime, 0);
|
|
if (this.units === Tone.Type.Frequency || this.units === Tone.Type.BPM || this.units === Tone.Type.Decibels) {
|
|
this.exponentialRampToValue(value, rampTime, startTime);
|
|
} else {
|
|
this.linearRampToValue(value, rampTime, startTime);
|
|
}
|
|
return this;
|
|
};
|
|
Object.defineProperty(Tone.Param.prototype, 'lfo', {
|
|
get: function () {
|
|
return this._lfo;
|
|
}
|
|
});
|
|
Tone.Param.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._param = null;
|
|
if (this._lfo) {
|
|
this._lfo.dispose();
|
|
this._lfo = null;
|
|
}
|
|
return this;
|
|
};
|
|
return Tone.Param;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_core_Gain;
|
|
Tone_core_Gain = function (Tone) {
|
|
'use strict';
|
|
if (window.GainNode && !AudioContext.prototype.createGain) {
|
|
AudioContext.prototype.createGain = AudioContext.prototype.createGainNode;
|
|
}
|
|
Tone.Gain = function () {
|
|
var options = this.optionsObject(arguments, [
|
|
'gain',
|
|
'units'
|
|
], Tone.Gain.defaults);
|
|
this.input = this.output = this._gainNode = this.context.createGain();
|
|
this.gain = new Tone.Param({
|
|
'param': this._gainNode.gain,
|
|
'units': options.units,
|
|
'value': options.gain,
|
|
'convert': options.convert
|
|
});
|
|
this._readOnly('gain');
|
|
};
|
|
Tone.extend(Tone.Gain);
|
|
Tone.Gain.defaults = {
|
|
'gain': 1,
|
|
'convert': true
|
|
};
|
|
Tone.Gain.prototype.dispose = function () {
|
|
Tone.Param.prototype.dispose.call(this);
|
|
this._gainNode.disconnect();
|
|
this._gainNode = null;
|
|
this._writable('gain');
|
|
this.gain.dispose();
|
|
this.gain = null;
|
|
};
|
|
Tone.prototype.createInsOuts = function (inputs, outputs) {
|
|
if (inputs === 1) {
|
|
this.input = new Tone.Gain();
|
|
} else if (inputs > 1) {
|
|
this.input = new Array(inputs);
|
|
}
|
|
if (outputs === 1) {
|
|
this.output = new Tone.Gain();
|
|
} else if (outputs > 1) {
|
|
this.output = new Array(inputs);
|
|
}
|
|
};
|
|
return Tone.Gain;
|
|
}(Tone_core_Tone, Tone_core_Param);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Signal;
|
|
Tone_signal_Signal = function (Tone) {
|
|
'use strict';
|
|
Tone.Signal = function () {
|
|
var options = this.optionsObject(arguments, [
|
|
'value',
|
|
'units'
|
|
], Tone.Signal.defaults);
|
|
this.output = this._gain = this.context.createGain();
|
|
options.param = this._gain.gain;
|
|
Tone.Param.call(this, options);
|
|
this.input = this._param = this._gain.gain;
|
|
this.context.getConstant(1).chain(this._gain);
|
|
};
|
|
Tone.extend(Tone.Signal, Tone.Param);
|
|
Tone.Signal.defaults = {
|
|
'value': 0,
|
|
'units': Tone.Type.Default,
|
|
'convert': true
|
|
};
|
|
Tone.Signal.prototype.connect = Tone.SignalBase.prototype.connect;
|
|
Tone.Signal.prototype.dispose = function () {
|
|
Tone.Param.prototype.dispose.call(this);
|
|
this._param = null;
|
|
this._gain.disconnect();
|
|
this._gain = null;
|
|
return this;
|
|
};
|
|
return Tone.Signal;
|
|
}(Tone_core_Tone, Tone_signal_WaveShaper, Tone_type_Type, Tone_core_Param);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Add;
|
|
Tone_signal_Add = function (Tone) {
|
|
'use strict';
|
|
Tone.Add = function (value) {
|
|
this.createInsOuts(2, 0);
|
|
this._sum = this.input[0] = this.input[1] = this.output = new Tone.Gain();
|
|
this._param = this.input[1] = new Tone.Signal(value);
|
|
this._param.connect(this._sum);
|
|
};
|
|
Tone.extend(Tone.Add, Tone.Signal);
|
|
Tone.Add.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._sum.dispose();
|
|
this._sum = null;
|
|
this._param.dispose();
|
|
this._param = null;
|
|
return this;
|
|
};
|
|
return Tone.Add;
|
|
}(Tone_core_Tone, Tone_signal_Signal);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Multiply;
|
|
Tone_signal_Multiply = function (Tone) {
|
|
'use strict';
|
|
Tone.Multiply = function (value) {
|
|
this.createInsOuts(2, 0);
|
|
this._mult = this.input[0] = this.output = new Tone.Gain();
|
|
this._param = this.input[1] = this.output.gain;
|
|
this._param.value = this.defaultArg(value, 0);
|
|
};
|
|
Tone.extend(Tone.Multiply, Tone.Signal);
|
|
Tone.Multiply.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._mult.dispose();
|
|
this._mult = null;
|
|
this._param = null;
|
|
return this;
|
|
};
|
|
return Tone.Multiply;
|
|
}(Tone_core_Tone, Tone_signal_Signal);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Scale;
|
|
Tone_signal_Scale = function (Tone) {
|
|
'use strict';
|
|
Tone.Scale = function (outputMin, outputMax) {
|
|
this._outputMin = this.defaultArg(outputMin, 0);
|
|
this._outputMax = this.defaultArg(outputMax, 1);
|
|
this._scale = this.input = new Tone.Multiply(1);
|
|
this._add = this.output = new Tone.Add(0);
|
|
this._scale.connect(this._add);
|
|
this._setRange();
|
|
};
|
|
Tone.extend(Tone.Scale, Tone.SignalBase);
|
|
Object.defineProperty(Tone.Scale.prototype, 'min', {
|
|
get: function () {
|
|
return this._outputMin;
|
|
},
|
|
set: function (min) {
|
|
this._outputMin = min;
|
|
this._setRange();
|
|
}
|
|
});
|
|
Object.defineProperty(Tone.Scale.prototype, 'max', {
|
|
get: function () {
|
|
return this._outputMax;
|
|
},
|
|
set: function (max) {
|
|
this._outputMax = max;
|
|
this._setRange();
|
|
}
|
|
});
|
|
Tone.Scale.prototype._setRange = function () {
|
|
this._add.value = this._outputMin;
|
|
this._scale.value = this._outputMax - this._outputMin;
|
|
};
|
|
Tone.Scale.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._add.dispose();
|
|
this._add = null;
|
|
this._scale.dispose();
|
|
this._scale = null;
|
|
return this;
|
|
};
|
|
return Tone.Scale;
|
|
}(Tone_core_Tone, Tone_signal_Add, Tone_signal_Multiply);
|
|
var signal;
|
|
'use strict';
|
|
signal = function () {
|
|
// Signal is built with the Tone.js signal by Yotam Mann
|
|
// https://github.com/TONEnoTONE/Tone.js/
|
|
var Signal = Tone_signal_Signal;
|
|
var Add = Tone_signal_Add;
|
|
var Mult = Tone_signal_Multiply;
|
|
var Scale = Tone_signal_Scale;
|
|
var Tone = Tone_core_Tone;
|
|
var p5sound = master;
|
|
Tone.setContext(p5sound.audiocontext);
|
|
/**
|
|
* <p>p5.Signal is a constant audio-rate signal used by p5.Oscillator
|
|
* and p5.Envelope for modulation math.</p>
|
|
*
|
|
* <p>This is necessary because Web Audio is processed on a seprate clock.
|
|
* For example, the p5 draw loop runs about 60 times per second. But
|
|
* the audio clock must process samples 44100 times per second. If we
|
|
* want to add a value to each of those samples, we can't do it in the
|
|
* draw loop, but we can do it by adding a constant-rate audio signal.</p.
|
|
*
|
|
* <p>This class mostly functions behind the scenes in p5.sound, and returns
|
|
* a Tone.Signal from the Tone.js library by Yotam Mann.
|
|
* If you want to work directly with audio signals for modular
|
|
* synthesis, check out
|
|
* <a href='http://bit.ly/1oIoEng' target=_'blank'>tone.js.</a></p>
|
|
*
|
|
* @class p5.Signal
|
|
* @constructor
|
|
* @return {Tone.Signal} A Signal object from the Tone.js library
|
|
* @example
|
|
* <div><code>
|
|
* function setup() {
|
|
* carrier = new p5.Oscillator('sine');
|
|
* carrier.amp(1); // set amplitude
|
|
* carrier.freq(220); // set frequency
|
|
* carrier.start(); // start oscillating
|
|
*
|
|
* modulator = new p5.Oscillator('sawtooth');
|
|
* modulator.disconnect();
|
|
* modulator.amp(1);
|
|
* modulator.freq(4);
|
|
* modulator.start();
|
|
*
|
|
* // Modulator's default amplitude range is -1 to 1.
|
|
* // Multiply it by -200, so the range is -200 to 200
|
|
* // then add 220 so the range is 20 to 420
|
|
* carrier.freq( modulator.mult(-200).add(220) );
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Signal = function (value) {
|
|
var s = new Signal(value);
|
|
// p5sound.soundArray.push(s);
|
|
return s;
|
|
};
|
|
/**
|
|
* Fade to value, for smooth transitions
|
|
*
|
|
* @method fade
|
|
* @param {Number} value Value to set this signal
|
|
* @param {Number} [secondsFromNow] Length of fade, in seconds from now
|
|
*/
|
|
Signal.prototype.fade = Signal.prototype.linearRampToValueAtTime;
|
|
Mult.prototype.fade = Signal.prototype.fade;
|
|
Add.prototype.fade = Signal.prototype.fade;
|
|
Scale.prototype.fade = Signal.prototype.fade;
|
|
/**
|
|
* Connect a p5.sound object or Web Audio node to this
|
|
* p5.Signal so that its amplitude values can be scaled.
|
|
*
|
|
* @method setInput
|
|
* @param {Object} input
|
|
*/
|
|
Signal.prototype.setInput = function (_input) {
|
|
_input.connect(this);
|
|
};
|
|
Mult.prototype.setInput = Signal.prototype.setInput;
|
|
Add.prototype.setInput = Signal.prototype.setInput;
|
|
Scale.prototype.setInput = Signal.prototype.setInput;
|
|
// signals can add / mult / scale themselves
|
|
/**
|
|
* Add a constant value to this audio signal,
|
|
* and return the resulting audio signal. Does
|
|
* not change the value of the original signal,
|
|
* instead it returns a new p5.SignalAdd.
|
|
*
|
|
* @method add
|
|
* @param {Number} number
|
|
* @return {p5.Signal} object
|
|
*/
|
|
Signal.prototype.add = function (num) {
|
|
var add = new Add(num);
|
|
// add.setInput(this);
|
|
this.connect(add);
|
|
return add;
|
|
};
|
|
Mult.prototype.add = Signal.prototype.add;
|
|
Add.prototype.add = Signal.prototype.add;
|
|
Scale.prototype.add = Signal.prototype.add;
|
|
/**
|
|
* Multiply this signal by a constant value,
|
|
* and return the resulting audio signal. Does
|
|
* not change the value of the original signal,
|
|
* instead it returns a new p5.SignalMult.
|
|
*
|
|
* @method mult
|
|
* @param {Number} number to multiply
|
|
* @return {p5.Signal} object
|
|
*/
|
|
Signal.prototype.mult = function (num) {
|
|
var mult = new Mult(num);
|
|
// mult.setInput(this);
|
|
this.connect(mult);
|
|
return mult;
|
|
};
|
|
Mult.prototype.mult = Signal.prototype.mult;
|
|
Add.prototype.mult = Signal.prototype.mult;
|
|
Scale.prototype.mult = Signal.prototype.mult;
|
|
/**
|
|
* Scale this signal value to a given range,
|
|
* and return the result as an audio signal. Does
|
|
* not change the value of the original signal,
|
|
* instead it returns a new p5.SignalScale.
|
|
*
|
|
* @method scale
|
|
* @param {Number} number to multiply
|
|
* @param {Number} inMin input range minumum
|
|
* @param {Number} inMax input range maximum
|
|
* @param {Number} outMin input range minumum
|
|
* @param {Number} outMax input range maximum
|
|
* @return {p5.Signal} object
|
|
*/
|
|
Signal.prototype.scale = function (inMin, inMax, outMin, outMax) {
|
|
var mapOutMin, mapOutMax;
|
|
if (arguments.length === 4) {
|
|
mapOutMin = p5.prototype.map(outMin, inMin, inMax, 0, 1) - 0.5;
|
|
mapOutMax = p5.prototype.map(outMax, inMin, inMax, 0, 1) - 0.5;
|
|
} else {
|
|
mapOutMin = arguments[0];
|
|
mapOutMax = arguments[1];
|
|
}
|
|
var scale = new Scale(mapOutMin, mapOutMax);
|
|
this.connect(scale);
|
|
return scale;
|
|
};
|
|
Mult.prototype.scale = Signal.prototype.scale;
|
|
Add.prototype.scale = Signal.prototype.scale;
|
|
Scale.prototype.scale = Signal.prototype.scale;
|
|
}(Tone_signal_Signal, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale, Tone_core_Tone, master);
|
|
var oscillator;
|
|
'use strict';
|
|
oscillator = function () {
|
|
var p5sound = master;
|
|
var Add = Tone_signal_Add;
|
|
var Mult = Tone_signal_Multiply;
|
|
var Scale = Tone_signal_Scale;
|
|
/**
|
|
* <p>Creates a signal that oscillates between -1.0 and 1.0.
|
|
* By default, the oscillation takes the form of a sinusoidal
|
|
* shape ('sine'). Additional types include 'triangle',
|
|
* 'sawtooth' and 'square'. The frequency defaults to
|
|
* 440 oscillations per second (440Hz, equal to the pitch of an
|
|
* 'A' note).</p>
|
|
*
|
|
* <p>Set the type of oscillation with setType(), or by instantiating a
|
|
* specific oscillator: <a href="/reference/#/p5.SinOsc">p5.SinOsc</a>, <a
|
|
* href="/reference/#/p5.TriOsc">p5.TriOsc</a>, <a
|
|
* href="/reference/#/p5.SqrOsc">p5.SqrOsc</a>, or <a
|
|
* href="/reference/#/p5.SawOsc">p5.SawOsc</a>.
|
|
* </p>
|
|
*
|
|
* @class p5.Oscillator
|
|
* @constructor
|
|
* @param {Number} [freq] frequency defaults to 440Hz
|
|
* @param {String} [type] type of oscillator. Options:
|
|
* 'sine' (default), 'triangle',
|
|
* 'sawtooth', 'square'
|
|
* @example
|
|
* <div><code>
|
|
* var osc;
|
|
* var playing = false;
|
|
*
|
|
* function setup() {
|
|
* backgroundColor = color(255,0,255);
|
|
* textAlign(CENTER);
|
|
*
|
|
* osc = new p5.Oscillator();
|
|
* osc.setType('sine');
|
|
* osc.freq(240);
|
|
* osc.amp(0);
|
|
* osc.start();
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(backgroundColor)
|
|
* text('click to play', width/2, height/2);
|
|
* }
|
|
*
|
|
* function mouseClicked() {
|
|
* if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) {
|
|
* if (!playing) {
|
|
* // ramp amplitude to 0.5 over 0.05 seconds
|
|
* osc.amp(0.5, 0.05);
|
|
* playing = true;
|
|
* backgroundColor = color(0,255,255);
|
|
* } else {
|
|
* // ramp amplitude to 0 over 0.5 seconds
|
|
* osc.amp(0, 0.5);
|
|
* playing = false;
|
|
* backgroundColor = color(255,0,255);
|
|
* }
|
|
* }
|
|
* }
|
|
* </code> </div>
|
|
*/
|
|
p5.Oscillator = function (freq, type) {
|
|
if (typeof freq === 'string') {
|
|
var f = type;
|
|
type = freq;
|
|
freq = f;
|
|
}
|
|
if (typeof type === 'number') {
|
|
var f = type;
|
|
type = freq;
|
|
freq = f;
|
|
}
|
|
this.started = false;
|
|
// components
|
|
this.phaseAmount = undefined;
|
|
this.oscillator = p5sound.audiocontext.createOscillator();
|
|
this.f = freq || 440;
|
|
// frequency
|
|
this.oscillator.type = type || 'sine';
|
|
this.oscillator.frequency.setValueAtTime(this.f, p5sound.audiocontext.currentTime);
|
|
// connections
|
|
this.output = p5sound.audiocontext.createGain();
|
|
this._freqMods = [];
|
|
// modulators connected to this oscillator's frequency
|
|
// set default output gain to 0.5
|
|
this.output.gain.value = 0.5;
|
|
this.output.gain.setValueAtTime(0.5, p5sound.audiocontext.currentTime);
|
|
this.oscillator.connect(this.output);
|
|
// stereo panning
|
|
this.panPosition = 0;
|
|
this.connection = p5sound.input;
|
|
// connect to p5sound by default
|
|
this.panner = new p5.Panner(this.output, this.connection, 1);
|
|
//array of math operation signal chaining
|
|
this.mathOps = [this.output];
|
|
// add to the soundArray so we can dispose of the osc later
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
/**
|
|
* Start an oscillator. Accepts an optional parameter to
|
|
* determine how long (in seconds from now) until the
|
|
* oscillator starts.
|
|
*
|
|
* @method start
|
|
* @param {Number} [time] startTime in seconds from now.
|
|
* @param {Number} [frequency] frequency in Hz.
|
|
*/
|
|
p5.Oscillator.prototype.start = function (time, f) {
|
|
if (this.started) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.stop(now);
|
|
}
|
|
if (!this.started) {
|
|
var freq = f || this.f;
|
|
var type = this.oscillator.type;
|
|
// set old osc free to be garbage collected (memory)
|
|
if (this.oscillator) {
|
|
this.oscillator.disconnect();
|
|
this.oscillator = undefined;
|
|
}
|
|
// var detune = this.oscillator.frequency.value;
|
|
this.oscillator = p5sound.audiocontext.createOscillator();
|
|
this.oscillator.frequency.value = Math.abs(freq);
|
|
this.oscillator.type = type;
|
|
// this.oscillator.detune.value = detune;
|
|
this.oscillator.connect(this.output);
|
|
time = time || 0;
|
|
this.oscillator.start(time + p5sound.audiocontext.currentTime);
|
|
this.freqNode = this.oscillator.frequency;
|
|
// if other oscillators are already connected to this osc's freq
|
|
for (var i in this._freqMods) {
|
|
if (typeof this._freqMods[i].connect !== 'undefined') {
|
|
this._freqMods[i].connect(this.oscillator.frequency);
|
|
}
|
|
}
|
|
this.started = true;
|
|
}
|
|
};
|
|
/**
|
|
* Stop an oscillator. Accepts an optional parameter
|
|
* to determine how long (in seconds from now) until the
|
|
* oscillator stops.
|
|
*
|
|
* @method stop
|
|
* @param {Number} secondsFromNow Time, in seconds from now.
|
|
*/
|
|
p5.Oscillator.prototype.stop = function (time) {
|
|
if (this.started) {
|
|
var t = time || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.oscillator.stop(t + now);
|
|
this.started = false;
|
|
}
|
|
};
|
|
/**
|
|
* Set the amplitude between 0 and 1.0. Or, pass in an object
|
|
* such as an oscillator to modulate amplitude with an audio signal.
|
|
*
|
|
* @method amp
|
|
* @param {Number|Object} vol between 0 and 1.0
|
|
* or a modulating signal/oscillator
|
|
* @param {Number} [rampTime] create a fade that lasts rampTime
|
|
* @param {Number} [timeFromNow] schedule this event to happen
|
|
* seconds from now
|
|
* @return {AudioParam} gain If no value is provided,
|
|
* returns the Web Audio API
|
|
* AudioParam that controls
|
|
* this oscillator's
|
|
* gain/amplitude/volume)
|
|
*/
|
|
p5.Oscillator.prototype.amp = function (vol, rampTime, tFromNow) {
|
|
var self = this;
|
|
if (typeof vol === 'number') {
|
|
var rampTime = rampTime || 0;
|
|
var tFromNow = tFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime);
|
|
} else if (vol) {
|
|
vol.connect(self.output.gain);
|
|
} else {
|
|
// return the Gain Node
|
|
return this.output.gain;
|
|
}
|
|
};
|
|
// these are now the same thing
|
|
p5.Oscillator.prototype.fade = p5.Oscillator.prototype.amp;
|
|
p5.Oscillator.prototype.getAmp = function () {
|
|
return this.output.gain.value;
|
|
};
|
|
/**
|
|
* Set frequency of an oscillator to a value. Or, pass in an object
|
|
* such as an oscillator to modulate the frequency with an audio signal.
|
|
*
|
|
* @method freq
|
|
* @param {Number|Object} Frequency Frequency in Hz
|
|
* or modulating signal/oscillator
|
|
* @param {Number} [rampTime] Ramp time (in seconds)
|
|
* @param {Number} [timeFromNow] Schedule this event to happen
|
|
* at x seconds from now
|
|
* @return {AudioParam} Frequency If no value is provided,
|
|
* returns the Web Audio API
|
|
* AudioParam that controls
|
|
* this oscillator's frequency
|
|
* @example
|
|
* <div><code>
|
|
* var osc = new p5.Oscillator(300);
|
|
* osc.start();
|
|
* osc.freq(40, 10);
|
|
* </code></div>
|
|
*/
|
|
p5.Oscillator.prototype.freq = function (val, rampTime, tFromNow) {
|
|
if (typeof val === 'number' && !isNaN(val)) {
|
|
this.f = val;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var rampTime = rampTime || 0;
|
|
var tFromNow = tFromNow || 0;
|
|
var t = now + tFromNow + rampTime;
|
|
// var currentFreq = this.oscillator.frequency.value;
|
|
// this.oscillator.frequency.cancelScheduledValues(now);
|
|
if (rampTime === 0) {
|
|
this.oscillator.frequency.setValueAtTime(val, tFromNow + now);
|
|
} else {
|
|
if (val > 0) {
|
|
this.oscillator.frequency.exponentialRampToValueAtTime(val, tFromNow + rampTime + now);
|
|
} else {
|
|
this.oscillator.frequency.linearRampToValueAtTime(val, tFromNow + rampTime + now);
|
|
}
|
|
}
|
|
// reset phase if oscillator has a phase
|
|
if (this.phaseAmount) {
|
|
this.phase(this.phaseAmount);
|
|
}
|
|
} else if (val) {
|
|
if (val.output) {
|
|
val = val.output;
|
|
}
|
|
val.connect(this.oscillator.frequency);
|
|
// keep track of what is modulating this param
|
|
// so it can be re-connected if
|
|
this._freqMods.push(val);
|
|
} else {
|
|
// return the Frequency Node
|
|
return this.oscillator.frequency;
|
|
}
|
|
};
|
|
p5.Oscillator.prototype.getFreq = function () {
|
|
return this.oscillator.frequency.value;
|
|
};
|
|
/**
|
|
* Set type to 'sine', 'triangle', 'sawtooth' or 'square'.
|
|
*
|
|
* @method setType
|
|
* @param {String} type 'sine', 'triangle', 'sawtooth' or 'square'.
|
|
*/
|
|
p5.Oscillator.prototype.setType = function (type) {
|
|
this.oscillator.type = type;
|
|
};
|
|
p5.Oscillator.prototype.getType = function () {
|
|
return this.oscillator.type;
|
|
};
|
|
/**
|
|
* Connect to a p5.sound / Web Audio object.
|
|
*
|
|
* @method connect
|
|
* @param {Object} unit A p5.sound or Web Audio object
|
|
*/
|
|
p5.Oscillator.prototype.connect = function (unit) {
|
|
if (!unit) {
|
|
this.panner.connect(p5sound.input);
|
|
} else if (unit.hasOwnProperty('input')) {
|
|
this.panner.connect(unit.input);
|
|
this.connection = unit.input;
|
|
} else {
|
|
this.panner.connect(unit);
|
|
this.connection = unit;
|
|
}
|
|
};
|
|
/**
|
|
* Disconnect all outputs
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
p5.Oscillator.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
this.panner.disconnect();
|
|
this.output.connect(this.panner);
|
|
this.oscMods = [];
|
|
};
|
|
/**
|
|
* Pan between Left (-1) and Right (1)
|
|
*
|
|
* @method pan
|
|
* @param {Number} panning Number between -1 and 1
|
|
* @param {Number} timeFromNow schedule this event to happen
|
|
* seconds from now
|
|
*/
|
|
p5.Oscillator.prototype.pan = function (pval, tFromNow) {
|
|
this.panPosition = pval;
|
|
this.panner.pan(pval, tFromNow);
|
|
};
|
|
p5.Oscillator.prototype.getPan = function () {
|
|
return this.panPosition;
|
|
};
|
|
// get rid of the oscillator
|
|
p5.Oscillator.prototype.dispose = function () {
|
|
// remove reference from soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
if (this.oscillator) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.stop(now);
|
|
this.disconnect();
|
|
this.panner = null;
|
|
this.oscillator = null;
|
|
}
|
|
// if it is a Pulse
|
|
if (this.osc2) {
|
|
this.osc2.dispose();
|
|
}
|
|
};
|
|
/**
|
|
* Set the phase of an oscillator between 0.0 and 1.0.
|
|
* In this implementation, phase is a delay time
|
|
* based on the oscillator's current frequency.
|
|
*
|
|
* @method phase
|
|
* @param {Number} phase float between 0.0 and 1.0
|
|
*/
|
|
p5.Oscillator.prototype.phase = function (p) {
|
|
var delayAmt = p5.prototype.map(p, 0, 1, 0, 1 / this.f);
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.phaseAmount = p;
|
|
if (!this.dNode) {
|
|
// create a delay node
|
|
this.dNode = p5sound.audiocontext.createDelay();
|
|
// put the delay node in between output and panner
|
|
this.oscillator.disconnect();
|
|
this.oscillator.connect(this.dNode);
|
|
this.dNode.connect(this.output);
|
|
}
|
|
// set delay time to match phase:
|
|
this.dNode.delayTime.setValueAtTime(delayAmt, now);
|
|
};
|
|
// ========================== //
|
|
// SIGNAL MATH FOR MODULATION //
|
|
// ========================== //
|
|
// return sigChain(this, scale, thisChain, nextChain, Scale);
|
|
var sigChain = function (o, mathObj, thisChain, nextChain, type) {
|
|
var chainSource = o.oscillator;
|
|
// if this type of math already exists in the chain, replace it
|
|
for (var i in o.mathOps) {
|
|
if (o.mathOps[i] instanceof type) {
|
|
chainSource.disconnect();
|
|
o.mathOps[i].dispose();
|
|
thisChain = i;
|
|
// assume nextChain is output gain node unless...
|
|
if (thisChain < o.mathOps.length - 2) {
|
|
nextChain = o.mathOps[i + 1];
|
|
}
|
|
}
|
|
}
|
|
if (thisChain === o.mathOps.length - 1) {
|
|
o.mathOps.push(nextChain);
|
|
}
|
|
// assume source is the oscillator unless i > 0
|
|
if (i > 0) {
|
|
chainSource = o.mathOps[i - 1];
|
|
}
|
|
chainSource.disconnect();
|
|
chainSource.connect(mathObj);
|
|
mathObj.connect(nextChain);
|
|
o.mathOps[thisChain] = mathObj;
|
|
return o;
|
|
};
|
|
/**
|
|
* Add a value to the p5.Oscillator's output amplitude,
|
|
* and return the oscillator. Calling this method again
|
|
* will override the initial add() with a new value.
|
|
*
|
|
* @method add
|
|
* @param {Number} number Constant number to add
|
|
* @return {p5.Oscillator} Oscillator Returns this oscillator
|
|
* with scaled output
|
|
*
|
|
*/
|
|
p5.Oscillator.prototype.add = function (num) {
|
|
var add = new Add(num);
|
|
var thisChain = this.mathOps.length - 1;
|
|
var nextChain = this.output;
|
|
return sigChain(this, add, thisChain, nextChain, Add);
|
|
};
|
|
/**
|
|
* Multiply the p5.Oscillator's output amplitude
|
|
* by a fixed value (i.e. turn it up!). Calling this method
|
|
* again will override the initial mult() with a new value.
|
|
*
|
|
* @method mult
|
|
* @param {Number} number Constant number to multiply
|
|
* @return {p5.Oscillator} Oscillator Returns this oscillator
|
|
* with multiplied output
|
|
*/
|
|
p5.Oscillator.prototype.mult = function (num) {
|
|
var mult = new Mult(num);
|
|
var thisChain = this.mathOps.length - 1;
|
|
var nextChain = this.output;
|
|
return sigChain(this, mult, thisChain, nextChain, Mult);
|
|
};
|
|
/**
|
|
* Scale this oscillator's amplitude values to a given
|
|
* range, and return the oscillator. Calling this method
|
|
* again will override the initial scale() with new values.
|
|
*
|
|
* @method scale
|
|
* @param {Number} inMin input range minumum
|
|
* @param {Number} inMax input range maximum
|
|
* @param {Number} outMin input range minumum
|
|
* @param {Number} outMax input range maximum
|
|
* @return {p5.Oscillator} Oscillator Returns this oscillator
|
|
* with scaled output
|
|
*/
|
|
p5.Oscillator.prototype.scale = function (inMin, inMax, outMin, outMax) {
|
|
var mapOutMin, mapOutMax;
|
|
if (arguments.length === 4) {
|
|
mapOutMin = p5.prototype.map(outMin, inMin, inMax, 0, 1) - 0.5;
|
|
mapOutMax = p5.prototype.map(outMax, inMin, inMax, 0, 1) - 0.5;
|
|
} else {
|
|
mapOutMin = arguments[0];
|
|
mapOutMax = arguments[1];
|
|
}
|
|
var scale = new Scale(mapOutMin, mapOutMax);
|
|
var thisChain = this.mathOps.length - 1;
|
|
var nextChain = this.output;
|
|
return sigChain(this, scale, thisChain, nextChain, Scale);
|
|
};
|
|
// ============================== //
|
|
// SinOsc, TriOsc, SqrOsc, SawOsc //
|
|
// ============================== //
|
|
/**
|
|
* Constructor: <code>new p5.SinOsc()</code>.
|
|
* This creates a Sine Wave Oscillator and is
|
|
* equivalent to <code> new p5.Oscillator('sine')
|
|
* </code> or creating a p5.Oscillator and then calling
|
|
* its method <code>setType('sine')</code>.
|
|
* See p5.Oscillator for methods.
|
|
*
|
|
* @class p5.SinOsc
|
|
* @constructor
|
|
* @extends p5.Oscillator
|
|
* @param {Number} [freq] Set the frequency
|
|
*/
|
|
p5.SinOsc = function (freq) {
|
|
p5.Oscillator.call(this, freq, 'sine');
|
|
};
|
|
p5.SinOsc.prototype = Object.create(p5.Oscillator.prototype);
|
|
/**
|
|
* Constructor: <code>new p5.TriOsc()</code>.
|
|
* This creates a Triangle Wave Oscillator and is
|
|
* equivalent to <code>new p5.Oscillator('triangle')
|
|
* </code> or creating a p5.Oscillator and then calling
|
|
* its method <code>setType('triangle')</code>.
|
|
* See p5.Oscillator for methods.
|
|
*
|
|
* @class p5.TriOsc
|
|
* @constructor
|
|
* @extends p5.Oscillator
|
|
* @param {Number} [freq] Set the frequency
|
|
*/
|
|
p5.TriOsc = function (freq) {
|
|
p5.Oscillator.call(this, freq, 'triangle');
|
|
};
|
|
p5.TriOsc.prototype = Object.create(p5.Oscillator.prototype);
|
|
/**
|
|
* Constructor: <code>new p5.SawOsc()</code>.
|
|
* This creates a SawTooth Wave Oscillator and is
|
|
* equivalent to <code> new p5.Oscillator('sawtooth')
|
|
* </code> or creating a p5.Oscillator and then calling
|
|
* its method <code>setType('sawtooth')</code>.
|
|
* See p5.Oscillator for methods.
|
|
*
|
|
* @class p5.SawOsc
|
|
* @constructor
|
|
* @extends p5.Oscillator
|
|
* @param {Number} [freq] Set the frequency
|
|
*/
|
|
p5.SawOsc = function (freq) {
|
|
p5.Oscillator.call(this, freq, 'sawtooth');
|
|
};
|
|
p5.SawOsc.prototype = Object.create(p5.Oscillator.prototype);
|
|
/**
|
|
* Constructor: <code>new p5.SqrOsc()</code>.
|
|
* This creates a Square Wave Oscillator and is
|
|
* equivalent to <code> new p5.Oscillator('square')
|
|
* </code> or creating a p5.Oscillator and then calling
|
|
* its method <code>setType('square')</code>.
|
|
* See p5.Oscillator for methods.
|
|
*
|
|
* @class p5.SqrOsc
|
|
* @constructor
|
|
* @extends p5.Oscillator
|
|
* @param {Number} [freq] Set the frequency
|
|
*/
|
|
p5.SqrOsc = function (freq) {
|
|
p5.Oscillator.call(this, freq, 'square');
|
|
};
|
|
p5.SqrOsc.prototype = Object.create(p5.Oscillator.prototype);
|
|
}(master, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_core_Timeline;
|
|
Tone_core_Timeline = function (Tone) {
|
|
'use strict';
|
|
Tone.Timeline = function () {
|
|
var options = this.optionsObject(arguments, ['memory'], Tone.Timeline.defaults);
|
|
this._timeline = [];
|
|
this._toRemove = [];
|
|
this._iterating = false;
|
|
this.memory = options.memory;
|
|
};
|
|
Tone.extend(Tone.Timeline);
|
|
Tone.Timeline.defaults = { 'memory': Infinity };
|
|
Object.defineProperty(Tone.Timeline.prototype, 'length', {
|
|
get: function () {
|
|
return this._timeline.length;
|
|
}
|
|
});
|
|
Tone.Timeline.prototype.add = function (event) {
|
|
if (this.isUndef(event.time)) {
|
|
throw new Error('Tone.Timeline: events must have a time attribute');
|
|
}
|
|
if (this._timeline.length) {
|
|
var index = this._search(event.time);
|
|
this._timeline.splice(index + 1, 0, event);
|
|
} else {
|
|
this._timeline.push(event);
|
|
}
|
|
if (this.length > this.memory) {
|
|
var diff = this.length - this.memory;
|
|
this._timeline.splice(0, diff);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Timeline.prototype.remove = function (event) {
|
|
if (this._iterating) {
|
|
this._toRemove.push(event);
|
|
} else {
|
|
var index = this._timeline.indexOf(event);
|
|
if (index !== -1) {
|
|
this._timeline.splice(index, 1);
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Timeline.prototype.get = function (time) {
|
|
var index = this._search(time);
|
|
if (index !== -1) {
|
|
return this._timeline[index];
|
|
} else {
|
|
return null;
|
|
}
|
|
};
|
|
Tone.Timeline.prototype.peek = function () {
|
|
return this._timeline[0];
|
|
};
|
|
Tone.Timeline.prototype.shift = function () {
|
|
return this._timeline.shift();
|
|
};
|
|
Tone.Timeline.prototype.getAfter = function (time) {
|
|
var index = this._search(time);
|
|
if (index + 1 < this._timeline.length) {
|
|
return this._timeline[index + 1];
|
|
} else {
|
|
return null;
|
|
}
|
|
};
|
|
Tone.Timeline.prototype.getBefore = function (time) {
|
|
var len = this._timeline.length;
|
|
if (len > 0 && this._timeline[len - 1].time < time) {
|
|
return this._timeline[len - 1];
|
|
}
|
|
var index = this._search(time);
|
|
if (index - 1 >= 0) {
|
|
return this._timeline[index - 1];
|
|
} else {
|
|
return null;
|
|
}
|
|
};
|
|
Tone.Timeline.prototype.cancel = function (after) {
|
|
if (this._timeline.length > 1) {
|
|
var index = this._search(after);
|
|
if (index >= 0) {
|
|
if (this._timeline[index].time === after) {
|
|
for (var i = index; i >= 0; i--) {
|
|
if (this._timeline[i].time === after) {
|
|
index = i;
|
|
} else {
|
|
break;
|
|
}
|
|
}
|
|
this._timeline = this._timeline.slice(0, index);
|
|
} else {
|
|
this._timeline = this._timeline.slice(0, index + 1);
|
|
}
|
|
} else {
|
|
this._timeline = [];
|
|
}
|
|
} else if (this._timeline.length === 1) {
|
|
if (this._timeline[0].time >= after) {
|
|
this._timeline = [];
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Timeline.prototype.cancelBefore = function (time) {
|
|
if (this._timeline.length) {
|
|
var index = this._search(time);
|
|
if (index >= 0) {
|
|
this._timeline = this._timeline.slice(index + 1);
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Timeline.prototype._search = function (time) {
|
|
var beginning = 0;
|
|
var len = this._timeline.length;
|
|
var end = len;
|
|
if (len > 0 && this._timeline[len - 1].time <= time) {
|
|
return len - 1;
|
|
}
|
|
while (beginning < end) {
|
|
var midPoint = Math.floor(beginning + (end - beginning) / 2);
|
|
var event = this._timeline[midPoint];
|
|
var nextEvent = this._timeline[midPoint + 1];
|
|
if (event.time === time) {
|
|
for (var i = midPoint; i < this._timeline.length; i++) {
|
|
var testEvent = this._timeline[i];
|
|
if (testEvent.time === time) {
|
|
midPoint = i;
|
|
}
|
|
}
|
|
return midPoint;
|
|
} else if (event.time < time && nextEvent.time > time) {
|
|
return midPoint;
|
|
} else if (event.time > time) {
|
|
end = midPoint;
|
|
} else if (event.time < time) {
|
|
beginning = midPoint + 1;
|
|
}
|
|
}
|
|
return -1;
|
|
};
|
|
Tone.Timeline.prototype._iterate = function (callback, lowerBound, upperBound) {
|
|
this._iterating = true;
|
|
lowerBound = this.defaultArg(lowerBound, 0);
|
|
upperBound = this.defaultArg(upperBound, this._timeline.length - 1);
|
|
for (var i = lowerBound; i <= upperBound; i++) {
|
|
callback(this._timeline[i]);
|
|
}
|
|
this._iterating = false;
|
|
if (this._toRemove.length > 0) {
|
|
for (var j = 0; j < this._toRemove.length; j++) {
|
|
var index = this._timeline.indexOf(this._toRemove[j]);
|
|
if (index !== -1) {
|
|
this._timeline.splice(index, 1);
|
|
}
|
|
}
|
|
this._toRemove = [];
|
|
}
|
|
};
|
|
Tone.Timeline.prototype.forEach = function (callback) {
|
|
this._iterate(callback);
|
|
return this;
|
|
};
|
|
Tone.Timeline.prototype.forEachBefore = function (time, callback) {
|
|
var upperBound = this._search(time);
|
|
if (upperBound !== -1) {
|
|
this._iterate(callback, 0, upperBound);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Timeline.prototype.forEachAfter = function (time, callback) {
|
|
var lowerBound = this._search(time);
|
|
this._iterate(callback, lowerBound + 1);
|
|
return this;
|
|
};
|
|
Tone.Timeline.prototype.forEachFrom = function (time, callback) {
|
|
var lowerBound = this._search(time);
|
|
while (lowerBound >= 0 && this._timeline[lowerBound].time >= time) {
|
|
lowerBound--;
|
|
}
|
|
this._iterate(callback, lowerBound + 1);
|
|
return this;
|
|
};
|
|
Tone.Timeline.prototype.forEachAtTime = function (time, callback) {
|
|
var upperBound = this._search(time);
|
|
if (upperBound !== -1) {
|
|
this._iterate(function (event) {
|
|
if (event.time === time) {
|
|
callback(event);
|
|
}
|
|
}, 0, upperBound);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Timeline.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._timeline = null;
|
|
this._toRemove = null;
|
|
};
|
|
return Tone.Timeline;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_TimelineSignal;
|
|
Tone_signal_TimelineSignal = function (Tone) {
|
|
'use strict';
|
|
Tone.TimelineSignal = function () {
|
|
var options = this.optionsObject(arguments, [
|
|
'value',
|
|
'units'
|
|
], Tone.Signal.defaults);
|
|
this._events = new Tone.Timeline(10);
|
|
Tone.Signal.apply(this, options);
|
|
options.param = this._param;
|
|
Tone.Param.call(this, options);
|
|
this._initial = this._fromUnits(this._param.value);
|
|
};
|
|
Tone.extend(Tone.TimelineSignal, Tone.Param);
|
|
Tone.TimelineSignal.Type = {
|
|
Linear: 'linear',
|
|
Exponential: 'exponential',
|
|
Target: 'target',
|
|
Curve: 'curve',
|
|
Set: 'set'
|
|
};
|
|
Object.defineProperty(Tone.TimelineSignal.prototype, 'value', {
|
|
get: function () {
|
|
var now = this.now();
|
|
var val = this.getValueAtTime(now);
|
|
return this._toUnits(val);
|
|
},
|
|
set: function (value) {
|
|
var convertedVal = this._fromUnits(value);
|
|
this._initial = convertedVal;
|
|
this.cancelScheduledValues();
|
|
this._param.value = convertedVal;
|
|
}
|
|
});
|
|
Tone.TimelineSignal.prototype.setValueAtTime = function (value, startTime) {
|
|
value = this._fromUnits(value);
|
|
startTime = this.toSeconds(startTime);
|
|
this._events.add({
|
|
'type': Tone.TimelineSignal.Type.Set,
|
|
'value': value,
|
|
'time': startTime
|
|
});
|
|
this._param.setValueAtTime(value, startTime);
|
|
return this;
|
|
};
|
|
Tone.TimelineSignal.prototype.linearRampToValueAtTime = function (value, endTime) {
|
|
value = this._fromUnits(value);
|
|
endTime = this.toSeconds(endTime);
|
|
this._events.add({
|
|
'type': Tone.TimelineSignal.Type.Linear,
|
|
'value': value,
|
|
'time': endTime
|
|
});
|
|
this._param.linearRampToValueAtTime(value, endTime);
|
|
return this;
|
|
};
|
|
Tone.TimelineSignal.prototype.exponentialRampToValueAtTime = function (value, endTime) {
|
|
endTime = this.toSeconds(endTime);
|
|
var beforeEvent = this._searchBefore(endTime);
|
|
if (beforeEvent && beforeEvent.value === 0) {
|
|
this.setValueAtTime(this._minOutput, beforeEvent.time);
|
|
}
|
|
value = this._fromUnits(value);
|
|
var setValue = Math.max(value, this._minOutput);
|
|
this._events.add({
|
|
'type': Tone.TimelineSignal.Type.Exponential,
|
|
'value': setValue,
|
|
'time': endTime
|
|
});
|
|
if (value < this._minOutput) {
|
|
this._param.exponentialRampToValueAtTime(this._minOutput, endTime - this.sampleTime);
|
|
this.setValueAtTime(0, endTime);
|
|
} else {
|
|
this._param.exponentialRampToValueAtTime(value, endTime);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.TimelineSignal.prototype.setTargetAtTime = function (value, startTime, timeConstant) {
|
|
value = this._fromUnits(value);
|
|
value = Math.max(this._minOutput, value);
|
|
timeConstant = Math.max(this._minOutput, timeConstant);
|
|
startTime = this.toSeconds(startTime);
|
|
this._events.add({
|
|
'type': Tone.TimelineSignal.Type.Target,
|
|
'value': value,
|
|
'time': startTime,
|
|
'constant': timeConstant
|
|
});
|
|
this._param.setTargetAtTime(value, startTime, timeConstant);
|
|
return this;
|
|
};
|
|
Tone.TimelineSignal.prototype.setValueCurveAtTime = function (values, startTime, duration, scaling) {
|
|
scaling = this.defaultArg(scaling, 1);
|
|
var floats = new Array(values.length);
|
|
for (var i = 0; i < floats.length; i++) {
|
|
floats[i] = this._fromUnits(values[i]) * scaling;
|
|
}
|
|
startTime = this.toSeconds(startTime);
|
|
duration = this.toSeconds(duration);
|
|
this._events.add({
|
|
'type': Tone.TimelineSignal.Type.Curve,
|
|
'value': floats,
|
|
'time': startTime,
|
|
'duration': duration
|
|
});
|
|
this._param.setValueAtTime(floats[0], startTime);
|
|
for (var j = 1; j < floats.length; j++) {
|
|
var segmentTime = startTime + j / (floats.length - 1) * duration;
|
|
this._param.linearRampToValueAtTime(floats[j], segmentTime);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.TimelineSignal.prototype.cancelScheduledValues = function (after) {
|
|
after = this.toSeconds(after);
|
|
this._events.cancel(after);
|
|
this._param.cancelScheduledValues(after);
|
|
return this;
|
|
};
|
|
Tone.TimelineSignal.prototype.setRampPoint = function (time) {
|
|
time = this.toSeconds(time);
|
|
var val = this._toUnits(this.getValueAtTime(time));
|
|
var before = this._searchBefore(time);
|
|
if (before && before.time === time) {
|
|
this.cancelScheduledValues(time + this.sampleTime);
|
|
} else if (before && before.type === Tone.TimelineSignal.Type.Curve && before.time + before.duration > time) {
|
|
this.cancelScheduledValues(time);
|
|
this.linearRampToValueAtTime(val, time);
|
|
} else {
|
|
var after = this._searchAfter(time);
|
|
if (after) {
|
|
this.cancelScheduledValues(time);
|
|
if (after.type === Tone.TimelineSignal.Type.Linear) {
|
|
this.linearRampToValueAtTime(val, time);
|
|
} else if (after.type === Tone.TimelineSignal.Type.Exponential) {
|
|
this.exponentialRampToValueAtTime(val, time);
|
|
}
|
|
}
|
|
this.setValueAtTime(val, time);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.TimelineSignal.prototype.linearRampToValueBetween = function (value, start, finish) {
|
|
this.setRampPoint(start);
|
|
this.linearRampToValueAtTime(value, finish);
|
|
return this;
|
|
};
|
|
Tone.TimelineSignal.prototype.exponentialRampToValueBetween = function (value, start, finish) {
|
|
this.setRampPoint(start);
|
|
this.exponentialRampToValueAtTime(value, finish);
|
|
return this;
|
|
};
|
|
Tone.TimelineSignal.prototype._searchBefore = function (time) {
|
|
return this._events.get(time);
|
|
};
|
|
Tone.TimelineSignal.prototype._searchAfter = function (time) {
|
|
return this._events.getAfter(time);
|
|
};
|
|
Tone.TimelineSignal.prototype.getValueAtTime = function (time) {
|
|
time = this.toSeconds(time);
|
|
var after = this._searchAfter(time);
|
|
var before = this._searchBefore(time);
|
|
var value = this._initial;
|
|
if (before === null) {
|
|
value = this._initial;
|
|
} else if (before.type === Tone.TimelineSignal.Type.Target) {
|
|
var previous = this._events.getBefore(before.time);
|
|
var previouVal;
|
|
if (previous === null) {
|
|
previouVal = this._initial;
|
|
} else {
|
|
previouVal = previous.value;
|
|
}
|
|
value = this._exponentialApproach(before.time, previouVal, before.value, before.constant, time);
|
|
} else if (before.type === Tone.TimelineSignal.Type.Curve) {
|
|
value = this._curveInterpolate(before.time, before.value, before.duration, time);
|
|
} else if (after === null) {
|
|
value = before.value;
|
|
} else if (after.type === Tone.TimelineSignal.Type.Linear) {
|
|
value = this._linearInterpolate(before.time, before.value, after.time, after.value, time);
|
|
} else if (after.type === Tone.TimelineSignal.Type.Exponential) {
|
|
value = this._exponentialInterpolate(before.time, before.value, after.time, after.value, time);
|
|
} else {
|
|
value = before.value;
|
|
}
|
|
return value;
|
|
};
|
|
Tone.TimelineSignal.prototype.connect = Tone.SignalBase.prototype.connect;
|
|
Tone.TimelineSignal.prototype._exponentialApproach = function (t0, v0, v1, timeConstant, t) {
|
|
return v1 + (v0 - v1) * Math.exp(-(t - t0) / timeConstant);
|
|
};
|
|
Tone.TimelineSignal.prototype._linearInterpolate = function (t0, v0, t1, v1, t) {
|
|
return v0 + (v1 - v0) * ((t - t0) / (t1 - t0));
|
|
};
|
|
Tone.TimelineSignal.prototype._exponentialInterpolate = function (t0, v0, t1, v1, t) {
|
|
v0 = Math.max(this._minOutput, v0);
|
|
return v0 * Math.pow(v1 / v0, (t - t0) / (t1 - t0));
|
|
};
|
|
Tone.TimelineSignal.prototype._curveInterpolate = function (start, curve, duration, time) {
|
|
var len = curve.length;
|
|
if (time >= start + duration) {
|
|
return curve[len - 1];
|
|
} else if (time <= start) {
|
|
return curve[0];
|
|
} else {
|
|
var progress = (time - start) / duration;
|
|
var lowerIndex = Math.floor((len - 1) * progress);
|
|
var upperIndex = Math.ceil((len - 1) * progress);
|
|
var lowerVal = curve[lowerIndex];
|
|
var upperVal = curve[upperIndex];
|
|
if (upperIndex === lowerIndex) {
|
|
return lowerVal;
|
|
} else {
|
|
return this._linearInterpolate(lowerIndex, lowerVal, upperIndex, upperVal, progress * (len - 1));
|
|
}
|
|
}
|
|
};
|
|
Tone.TimelineSignal.prototype.dispose = function () {
|
|
Tone.Signal.prototype.dispose.call(this);
|
|
Tone.Param.prototype.dispose.call(this);
|
|
this._events.dispose();
|
|
this._events = null;
|
|
};
|
|
return Tone.TimelineSignal;
|
|
}(Tone_core_Tone, Tone_signal_Signal);
|
|
var env;
|
|
'use strict';
|
|
env = function () {
|
|
var p5sound = master;
|
|
var Add = Tone_signal_Add;
|
|
var Mult = Tone_signal_Multiply;
|
|
var Scale = Tone_signal_Scale;
|
|
var TimelineSignal = Tone_signal_TimelineSignal;
|
|
var Tone = Tone_core_Tone;
|
|
Tone.setContext(p5sound.audiocontext);
|
|
/**
|
|
* <p>Envelopes are pre-defined amplitude distribution over time.
|
|
* Typically, envelopes are used to control the output volume
|
|
* of an object, a series of fades referred to as Attack, Decay,
|
|
* Sustain and Release (
|
|
* <a href="https://upload.wikimedia.org/wikipedia/commons/e/ea/ADSR_parameter.svg">ADSR</a>
|
|
* ). Envelopes can also control other Web Audio Parameters—for example, a p5.Env can
|
|
* control an Oscillator's frequency like this: <code>osc.freq(env)</code>.</p>
|
|
* <p>Use <code><a href="#/p5.Env/setRange">setRange</a></code> to change the attack/release level.
|
|
* Use <code><a href="#/p5.Env/setADSR">setADSR</a></code> to change attackTime, decayTime, sustainPercent and releaseTime.</p>
|
|
* <p>Use the <code><a href="#/p5.Env/play">play</a></code> method to play the entire envelope,
|
|
* the <code><a href="#/p5.Env/ramp">ramp</a></code> method for a pingable trigger,
|
|
* or <code><a href="#/p5.Env/triggerAttack">triggerAttack</a></code>/
|
|
* <code><a href="#/p5.Env/triggerRelease">triggerRelease</a></code> to trigger noteOn/noteOff.</p>
|
|
*
|
|
* @class p5.Env
|
|
* @constructor
|
|
* @example
|
|
* <div><code>
|
|
* var attackLevel = 1.0;
|
|
* var releaseLevel = 0;
|
|
*
|
|
* var attackTime = 0.001
|
|
* var decayTime = 0.2;
|
|
* var susPercent = 0.2;
|
|
* var releaseTime = 0.5;
|
|
*
|
|
* var env, triOsc;
|
|
*
|
|
* function setup() {
|
|
* var cnv = createCanvas(100, 100);
|
|
*
|
|
* textAlign(CENTER);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* env = new p5.Env();
|
|
* env.setADSR(attackTime, decayTime, susPercent, releaseTime);
|
|
* env.setRange(attackLevel, releaseLevel);
|
|
*
|
|
* triOsc = new p5.Oscillator('triangle');
|
|
* triOsc.amp(env);
|
|
* triOsc.start();
|
|
* triOsc.freq(220);
|
|
*
|
|
* cnv.mousePressed(playEnv);
|
|
* }
|
|
*
|
|
* function playEnv(){
|
|
* env.play();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Env = function (t1, l1, t2, l2, t3, l3) {
|
|
/**
|
|
* Time until envelope reaches attackLevel
|
|
* @property attackTime
|
|
*/
|
|
this.aTime = t1 || 0.1;
|
|
/**
|
|
* Level once attack is complete.
|
|
* @property attackLevel
|
|
*/
|
|
this.aLevel = l1 || 1;
|
|
/**
|
|
* Time until envelope reaches decayLevel.
|
|
* @property decayTime
|
|
*/
|
|
this.dTime = t2 || 0.5;
|
|
/**
|
|
* Level after decay. The envelope will sustain here until it is released.
|
|
* @property decayLevel
|
|
*/
|
|
this.dLevel = l2 || 0;
|
|
/**
|
|
* Duration of the release portion of the envelope.
|
|
* @property releaseTime
|
|
*/
|
|
this.rTime = t3 || 0;
|
|
/**
|
|
* Level at the end of the release.
|
|
* @property releaseLevel
|
|
*/
|
|
this.rLevel = l3 || 0;
|
|
this._rampHighPercentage = 0.98;
|
|
this._rampLowPercentage = 0.02;
|
|
this.output = p5sound.audiocontext.createGain();
|
|
this.control = new TimelineSignal();
|
|
this._init();
|
|
// this makes sure the envelope starts at zero
|
|
this.control.connect(this.output);
|
|
// connect to the output
|
|
this.connection = null;
|
|
// store connection
|
|
//array of math operation signal chaining
|
|
this.mathOps = [this.control];
|
|
//whether envelope should be linear or exponential curve
|
|
this.isExponential = false;
|
|
// oscillator or buffer source to clear on env complete
|
|
// to save resources if/when it is retriggered
|
|
this.sourceToClear = null;
|
|
// set to true if attack is set, then false on release
|
|
this.wasTriggered = false;
|
|
// add to the soundArray so we can dispose of the env later
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
// this init function just smooths the starting value to zero and gives a start point for the timeline
|
|
// - it was necessary to remove glitches at the beginning.
|
|
p5.Env.prototype._init = function () {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var t = now;
|
|
this.control.setTargetAtTime(0.00001, t, 0.001);
|
|
//also, compute the correct time constants
|
|
this._setRampAD(this.aTime, this.dTime);
|
|
};
|
|
/**
|
|
* Reset the envelope with a series of time/value pairs.
|
|
*
|
|
* @method set
|
|
* @param {Number} attackTime Time (in seconds) before level
|
|
* reaches attackLevel
|
|
* @param {Number} attackLevel Typically an amplitude between
|
|
* 0.0 and 1.0
|
|
* @param {Number} decayTime Time
|
|
* @param {Number} decayLevel Amplitude (In a standard ADSR envelope,
|
|
* decayLevel = sustainLevel)
|
|
* @param {Number} releaseTime Release Time (in seconds)
|
|
* @param {Number} releaseLevel Amplitude
|
|
* @example
|
|
* <div><code>
|
|
* var t1 = 0.1; // attack time in seconds
|
|
* var l1 = 0.7; // attack level 0.0 to 1.0
|
|
* var t2 = 0.3; // decay time in seconds
|
|
* var l2 = 0.1; // decay level 0.0 to 1.0
|
|
* var t3 = 0.2; // sustain time in seconds
|
|
* var l3 = dL; // sustain level 0.0 to 1.0
|
|
* // release level defaults to zero
|
|
*
|
|
* var env;
|
|
* var triOsc;
|
|
*
|
|
* function setup() {
|
|
* background(0);
|
|
* noStroke();
|
|
* fill(255);
|
|
* textAlign(CENTER);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* env = new p5.Env(t1, l1, t2, l2, t3, l3);
|
|
* triOsc = new p5.Oscillator('triangle');
|
|
* triOsc.amp(env); // give the env control of the triOsc's amp
|
|
* triOsc.start();
|
|
* }
|
|
*
|
|
* // mouseClick triggers envelope if over canvas
|
|
* function mouseClicked() {
|
|
* // is mouse over canvas?
|
|
* if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {
|
|
* env.play(triOsc);
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*
|
|
*/
|
|
p5.Env.prototype.set = function (t1, l1, t2, l2, t3, l3) {
|
|
this.aTime = t1;
|
|
this.aLevel = l1;
|
|
this.dTime = t2 || 0;
|
|
this.dLevel = l2 || 0;
|
|
this.rTime = t3 || 0;
|
|
this.rLevel = l3 || 0;
|
|
// set time constants for ramp
|
|
this._setRampAD(t1, t2);
|
|
};
|
|
/**
|
|
* Set values like a traditional
|
|
* <a href="https://en.wikipedia.org/wiki/Synthesizer#/media/File:ADSR_parameter.svg">
|
|
* ADSR envelope
|
|
* </a>.
|
|
*
|
|
* @method setADSR
|
|
* @param {Number} attackTime Time (in seconds before envelope
|
|
* reaches Attack Level
|
|
* @param {Number} [decayTime] Time (in seconds) before envelope
|
|
* reaches Decay/Sustain Level
|
|
* @param {Number} [susRatio] Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,
|
|
* where 1.0 = attackLevel, 0.0 = releaseLevel.
|
|
* The susRatio determines the decayLevel and the level at which the
|
|
* sustain portion of the envelope will sustain.
|
|
* For example, if attackLevel is 0.4, releaseLevel is 0,
|
|
* and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is
|
|
* increased to 1.0 (using <code>setRange</code>),
|
|
* then decayLevel would increase proportionally, to become 0.5.
|
|
* @param {Number} [releaseTime] Time in seconds from now (defaults to 0)
|
|
* @example
|
|
* <div><code>
|
|
* var attackLevel = 1.0;
|
|
* var releaseLevel = 0;
|
|
*
|
|
* var attackTime = 0.001
|
|
* var decayTime = 0.2;
|
|
* var susPercent = 0.2;
|
|
* var releaseTime = 0.5;
|
|
*
|
|
* var env, triOsc;
|
|
*
|
|
* function setup() {
|
|
* var cnv = createCanvas(100, 100);
|
|
*
|
|
* textAlign(CENTER);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* env = new p5.Env();
|
|
* env.setADSR(attackTime, decayTime, susPercent, releaseTime);
|
|
* env.setRange(attackLevel, releaseLevel);
|
|
*
|
|
* triOsc = new p5.Oscillator('triangle');
|
|
* triOsc.amp(env);
|
|
* triOsc.start();
|
|
* triOsc.freq(220);
|
|
*
|
|
* cnv.mousePressed(playEnv);
|
|
* }
|
|
*
|
|
* function playEnv(){
|
|
* env.play();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Env.prototype.setADSR = function (aTime, dTime, sPercent, rTime) {
|
|
this.aTime = aTime;
|
|
this.dTime = dTime || 0;
|
|
// lerp
|
|
this.sPercent = sPercent || 0;
|
|
this.dLevel = typeof sPercent !== 'undefined' ? sPercent * (this.aLevel - this.rLevel) + this.rLevel : 0;
|
|
this.rTime = rTime || 0;
|
|
// also set time constants for ramp
|
|
this._setRampAD(aTime, dTime);
|
|
};
|
|
/**
|
|
* Set max (attackLevel) and min (releaseLevel) of envelope.
|
|
*
|
|
* @method setRange
|
|
* @param {Number} aLevel attack level (defaults to 1)
|
|
* @param {Number} rLevel release level (defaults to 0)
|
|
* @example
|
|
* <div><code>
|
|
* var attackLevel = 1.0;
|
|
* var releaseLevel = 0;
|
|
*
|
|
* var attackTime = 0.001
|
|
* var decayTime = 0.2;
|
|
* var susPercent = 0.2;
|
|
* var releaseTime = 0.5;
|
|
*
|
|
* var env, triOsc;
|
|
*
|
|
* function setup() {
|
|
* var cnv = createCanvas(100, 100);
|
|
*
|
|
* textAlign(CENTER);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* env = new p5.Env();
|
|
* env.setADSR(attackTime, decayTime, susPercent, releaseTime);
|
|
* env.setRange(attackLevel, releaseLevel);
|
|
*
|
|
* triOsc = new p5.Oscillator('triangle');
|
|
* triOsc.amp(env);
|
|
* triOsc.start();
|
|
* triOsc.freq(220);
|
|
*
|
|
* cnv.mousePressed(playEnv);
|
|
* }
|
|
*
|
|
* function playEnv(){
|
|
* env.play();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Env.prototype.setRange = function (aLevel, rLevel) {
|
|
this.aLevel = aLevel || 1;
|
|
this.rLevel = rLevel || 0;
|
|
};
|
|
// private (undocumented) method called when ADSR is set to set time constants for ramp
|
|
//
|
|
// Set the <a href="https://en.wikipedia.org/wiki/RC_time_constant">
|
|
// time constants</a> for simple exponential ramps.
|
|
// The larger the time constant value, the slower the
|
|
// transition will be.
|
|
//
|
|
// method _setRampAD
|
|
// param {Number} attackTimeConstant attack time constant
|
|
// param {Number} decayTimeConstant decay time constant
|
|
//
|
|
p5.Env.prototype._setRampAD = function (t1, t2) {
|
|
this._rampAttackTime = this.checkExpInput(t1);
|
|
this._rampDecayTime = this.checkExpInput(t2);
|
|
var TCDenominator = 1;
|
|
/// Aatish Bhatia's calculation for time constant for rise(to adjust 1/1-e calculation to any percentage)
|
|
TCDenominator = Math.log(1 / this.checkExpInput(1 - this._rampHighPercentage));
|
|
this._rampAttackTC = t1 / this.checkExpInput(TCDenominator);
|
|
TCDenominator = Math.log(1 / this._rampLowPercentage);
|
|
this._rampDecayTC = t2 / this.checkExpInput(TCDenominator);
|
|
};
|
|
// private method
|
|
p5.Env.prototype.setRampPercentages = function (p1, p2) {
|
|
//set the percentages that the simple exponential ramps go to
|
|
this._rampHighPercentage = this.checkExpInput(p1);
|
|
this._rampLowPercentage = this.checkExpInput(p2);
|
|
var TCDenominator = 1;
|
|
//now re-compute the time constants based on those percentages
|
|
/// Aatish Bhatia's calculation for time constant for rise(to adjust 1/1-e calculation to any percentage)
|
|
TCDenominator = Math.log(1 / this.checkExpInput(1 - this._rampHighPercentage));
|
|
this._rampAttackTC = this._rampAttackTime / this.checkExpInput(TCDenominator);
|
|
TCDenominator = Math.log(1 / this._rampLowPercentage);
|
|
this._rampDecayTC = this._rampDecayTime / this.checkExpInput(TCDenominator);
|
|
};
|
|
/**
|
|
* Assign a parameter to be controlled by this envelope.
|
|
* If a p5.Sound object is given, then the p5.Env will control its
|
|
* output gain. If multiple inputs are provided, the env will
|
|
* control all of them.
|
|
*
|
|
* @method setInput
|
|
* @param {Object} [...inputs] A p5.sound object or
|
|
* Web Audio Param.
|
|
*/
|
|
p5.Env.prototype.setInput = function () {
|
|
for (var i = 0; i < arguments.length; i++) {
|
|
this.connect(arguments[i]);
|
|
}
|
|
};
|
|
/**
|
|
* Set whether the envelope ramp is linear (default) or exponential.
|
|
* Exponential ramps can be useful because we perceive amplitude
|
|
* and frequency logarithmically.
|
|
*
|
|
* @method setExp
|
|
* @param {Boolean} isExp true is exponential, false is linear
|
|
*/
|
|
p5.Env.prototype.setExp = function (isExp) {
|
|
this.isExponential = isExp;
|
|
};
|
|
//helper method to protect against zero values being sent to exponential functions
|
|
p5.Env.prototype.checkExpInput = function (value) {
|
|
if (value <= 0) {
|
|
value = 1e-8;
|
|
}
|
|
return value;
|
|
};
|
|
/**
|
|
* Play tells the envelope to start acting on a given input.
|
|
* If the input is a p5.sound object (i.e. AudioIn, Oscillator,
|
|
* SoundFile), then Env will control its output volume.
|
|
* Envelopes can also be used to control any <a href="
|
|
* http://docs.webplatform.org/wiki/apis/webaudio/AudioParam">
|
|
* Web Audio Audio Param.</a>
|
|
*
|
|
* @method play
|
|
* @param {Object} unit A p5.sound object or
|
|
* Web Audio Param.
|
|
* @param {Number} [startTime] time from now (in seconds) at which to play
|
|
* @param {Number} [sustainTime] time to sustain before releasing the envelope
|
|
* @example
|
|
* <div><code>
|
|
* var attackLevel = 1.0;
|
|
* var releaseLevel = 0;
|
|
*
|
|
* var attackTime = 0.001
|
|
* var decayTime = 0.2;
|
|
* var susPercent = 0.2;
|
|
* var releaseTime = 0.5;
|
|
*
|
|
* var env, triOsc;
|
|
*
|
|
* function setup() {
|
|
* var cnv = createCanvas(100, 100);
|
|
*
|
|
* textAlign(CENTER);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* env = new p5.Env();
|
|
* env.setADSR(attackTime, decayTime, susPercent, releaseTime);
|
|
* env.setRange(attackLevel, releaseLevel);
|
|
*
|
|
* triOsc = new p5.Oscillator('triangle');
|
|
* triOsc.amp(env);
|
|
* triOsc.start();
|
|
* triOsc.freq(220);
|
|
*
|
|
* cnv.mousePressed(playEnv);
|
|
* }
|
|
*
|
|
* function playEnv(){
|
|
* // trigger env on triOsc, 0 seconds from now
|
|
* // After decay, sustain for 0.2 seconds before release
|
|
* env.play(triOsc, 0, 0.2);
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Env.prototype.play = function (unit, secondsFromNow, susTime) {
|
|
var tFromNow = secondsFromNow || 0;
|
|
var susTime = susTime || 0;
|
|
if (unit) {
|
|
if (this.connection !== unit) {
|
|
this.connect(unit);
|
|
}
|
|
}
|
|
this.triggerAttack(unit, tFromNow);
|
|
this.triggerRelease(unit, tFromNow + this.aTime + this.dTime + susTime);
|
|
};
|
|
/**
|
|
* Trigger the Attack, and Decay portion of the Envelope.
|
|
* Similar to holding down a key on a piano, but it will
|
|
* hold the sustain level until you let go. Input can be
|
|
* any p5.sound object, or a <a href="
|
|
* http://docs.webplatform.org/wiki/apis/webaudio/AudioParam">
|
|
* Web Audio Param</a>.
|
|
*
|
|
* @method triggerAttack
|
|
* @param {Object} unit p5.sound Object or Web Audio Param
|
|
* @param {Number} secondsFromNow time from now (in seconds)
|
|
* @example
|
|
* <div><code>
|
|
*
|
|
* var attackLevel = 1.0;
|
|
* var releaseLevel = 0;
|
|
*
|
|
* var attackTime = 0.001
|
|
* var decayTime = 0.3;
|
|
* var susPercent = 0.4;
|
|
* var releaseTime = 0.5;
|
|
*
|
|
* var env, triOsc;
|
|
*
|
|
* function setup() {
|
|
* var cnv = createCanvas(100, 100);
|
|
* background(200);
|
|
* textAlign(CENTER);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* env = new p5.Env();
|
|
* env.setADSR(attackTime, decayTime, susPercent, releaseTime);
|
|
* env.setRange(attackLevel, releaseLevel);
|
|
*
|
|
* triOsc = new p5.Oscillator('triangle');
|
|
* triOsc.amp(env);
|
|
* triOsc.start();
|
|
* triOsc.freq(220);
|
|
*
|
|
* cnv.mousePressed(envAttack);
|
|
* }
|
|
*
|
|
* function envAttack(){
|
|
* console.log('trigger attack');
|
|
* env.triggerAttack();
|
|
*
|
|
* background(0,255,0);
|
|
* text('attack!', width/2, height/2);
|
|
* }
|
|
*
|
|
* function mouseReleased() {
|
|
* env.triggerRelease();
|
|
*
|
|
* background(200);
|
|
* text('click to play', width/2, height/2);
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Env.prototype.triggerAttack = function (unit, secondsFromNow) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var tFromNow = secondsFromNow || 0;
|
|
var t = now + tFromNow;
|
|
this.lastAttack = t;
|
|
this.wasTriggered = true;
|
|
if (unit) {
|
|
if (this.connection !== unit) {
|
|
this.connect(unit);
|
|
}
|
|
}
|
|
// get and set value (with linear ramp) to anchor automation
|
|
var valToSet = this.control.getValueAtTime(t);
|
|
if (this.isExponential === true) {
|
|
this.control.exponentialRampToValueAtTime(this.checkExpInput(valToSet), t);
|
|
} else {
|
|
this.control.linearRampToValueAtTime(valToSet, t);
|
|
}
|
|
// after each ramp completes, cancel scheduled values
|
|
// (so they can be overridden in case env has been re-triggered)
|
|
// then, set current value (with linearRamp to avoid click)
|
|
// then, schedule the next automation...
|
|
// attack
|
|
t += this.aTime;
|
|
if (this.isExponential === true) {
|
|
this.control.exponentialRampToValueAtTime(this.checkExpInput(this.aLevel), t);
|
|
valToSet = this.checkExpInput(this.control.getValueAtTime(t));
|
|
this.control.cancelScheduledValues(t);
|
|
this.control.exponentialRampToValueAtTime(valToSet, t);
|
|
} else {
|
|
this.control.linearRampToValueAtTime(this.aLevel, t);
|
|
valToSet = this.control.getValueAtTime(t);
|
|
this.control.cancelScheduledValues(t);
|
|
this.control.linearRampToValueAtTime(valToSet, t);
|
|
}
|
|
// decay to decay level (if using ADSR, then decay level == sustain level)
|
|
t += this.dTime;
|
|
if (this.isExponential === true) {
|
|
this.control.exponentialRampToValueAtTime(this.checkExpInput(this.dLevel), t);
|
|
valToSet = this.checkExpInput(this.control.getValueAtTime(t));
|
|
this.control.cancelScheduledValues(t);
|
|
this.control.exponentialRampToValueAtTime(valToSet, t);
|
|
} else {
|
|
this.control.linearRampToValueAtTime(this.dLevel, t);
|
|
valToSet = this.control.getValueAtTime(t);
|
|
this.control.cancelScheduledValues(t);
|
|
this.control.linearRampToValueAtTime(valToSet, t);
|
|
}
|
|
};
|
|
/**
|
|
* Trigger the Release of the Envelope. This is similar to releasing
|
|
* the key on a piano and letting the sound fade according to the
|
|
* release level and release time.
|
|
*
|
|
* @method triggerRelease
|
|
* @param {Object} unit p5.sound Object or Web Audio Param
|
|
* @param {Number} secondsFromNow time to trigger the release
|
|
* @example
|
|
* <div><code>
|
|
*
|
|
* var attackLevel = 1.0;
|
|
* var releaseLevel = 0;
|
|
*
|
|
* var attackTime = 0.001
|
|
* var decayTime = 0.3;
|
|
* var susPercent = 0.4;
|
|
* var releaseTime = 0.5;
|
|
*
|
|
* var env, triOsc;
|
|
*
|
|
* function setup() {
|
|
* var cnv = createCanvas(100, 100);
|
|
* background(200);
|
|
* textAlign(CENTER);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* env = new p5.Env();
|
|
* env.setADSR(attackTime, decayTime, susPercent, releaseTime);
|
|
* env.setRange(attackLevel, releaseLevel);
|
|
*
|
|
* triOsc = new p5.Oscillator('triangle');
|
|
* triOsc.amp(env);
|
|
* triOsc.start();
|
|
* triOsc.freq(220);
|
|
*
|
|
* cnv.mousePressed(envAttack);
|
|
* }
|
|
*
|
|
* function envAttack(){
|
|
* console.log('trigger attack');
|
|
* env.triggerAttack();
|
|
*
|
|
* background(0,255,0);
|
|
* text('attack!', width/2, height/2);
|
|
* }
|
|
*
|
|
* function mouseReleased() {
|
|
* env.triggerRelease();
|
|
*
|
|
* background(200);
|
|
* text('click to play', width/2, height/2);
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Env.prototype.triggerRelease = function (unit, secondsFromNow) {
|
|
// only trigger a release if an attack was triggered
|
|
if (!this.wasTriggered) {
|
|
// this currently causes a bit of trouble:
|
|
// if a later release has been scheduled (via the play function)
|
|
// a new earlier release won't interrupt it, because
|
|
// this.wasTriggered has already been set to false.
|
|
// If we want new earlier releases to override, then we need to
|
|
// keep track of the last release time, and if the new release time is
|
|
// earlier, then use it.
|
|
return;
|
|
}
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var tFromNow = secondsFromNow || 0;
|
|
var t = now + tFromNow;
|
|
if (unit) {
|
|
if (this.connection !== unit) {
|
|
this.connect(unit);
|
|
}
|
|
}
|
|
// get and set value (with linear or exponential ramp) to anchor automation
|
|
var valToSet = this.control.getValueAtTime(t);
|
|
if (this.isExponential === true) {
|
|
this.control.exponentialRampToValueAtTime(this.checkExpInput(valToSet), t);
|
|
} else {
|
|
this.control.linearRampToValueAtTime(valToSet, t);
|
|
}
|
|
// release
|
|
t += this.rTime;
|
|
if (this.isExponential === true) {
|
|
this.control.exponentialRampToValueAtTime(this.checkExpInput(this.rLevel), t);
|
|
valToSet = this.checkExpInput(this.control.getValueAtTime(t));
|
|
this.control.cancelScheduledValues(t);
|
|
this.control.exponentialRampToValueAtTime(valToSet, t);
|
|
} else {
|
|
this.control.linearRampToValueAtTime(this.rLevel, t);
|
|
valToSet = this.control.getValueAtTime(t);
|
|
this.control.cancelScheduledValues(t);
|
|
this.control.linearRampToValueAtTime(valToSet, t);
|
|
}
|
|
this.wasTriggered = false;
|
|
};
|
|
/**
|
|
* Exponentially ramp to a value using the first two
|
|
* values from <code><a href="#/p5.Env/setADSR">setADSR(attackTime, decayTime)</a></code>
|
|
* as <a href="https://en.wikipedia.org/wiki/RC_time_constant">
|
|
* time constants</a> for simple exponential ramps.
|
|
* If the value is higher than current value, it uses attackTime,
|
|
* while a decrease uses decayTime.
|
|
*
|
|
* @method ramp
|
|
* @param {Object} unit p5.sound Object or Web Audio Param
|
|
* @param {Number} secondsFromNow When to trigger the ramp
|
|
* @param {Number} v Target value
|
|
* @param {Number} [v2] Second target value (optional)
|
|
* @example
|
|
* <div><code>
|
|
* var env, osc, amp, cnv;
|
|
*
|
|
* var attackTime = 0.001;
|
|
* var decayTime = 0.2;
|
|
* var attackLevel = 1;
|
|
* var decayLevel = 0;
|
|
*
|
|
* function setup() {
|
|
* cnv = createCanvas(100, 100);
|
|
* fill(0,255,0);
|
|
* noStroke();
|
|
*
|
|
* env = new p5.Env();
|
|
* env.setADSR(attackTime, decayTime);
|
|
*
|
|
* osc = new p5.Oscillator();
|
|
* osc.amp(env);
|
|
* osc.start();
|
|
*
|
|
* amp = new p5.Amplitude();
|
|
*
|
|
* cnv.mousePressed(triggerRamp);
|
|
* }
|
|
*
|
|
* function triggerRamp() {
|
|
* env.ramp(osc, 0, attackLevel, decayLevel);
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(20,20,20);
|
|
* text('click me', 10, 20);
|
|
* var h = map(amp.getLevel(), 0, 0.4, 0, height);;
|
|
*
|
|
* rect(0, height, width, -h);
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Env.prototype.ramp = function (unit, secondsFromNow, v1, v2) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var tFromNow = secondsFromNow || 0;
|
|
var t = now + tFromNow;
|
|
var destination1 = this.checkExpInput(v1);
|
|
var destination2 = typeof v2 !== 'undefined' ? this.checkExpInput(v2) : undefined;
|
|
// connect env to unit if not already connected
|
|
if (unit) {
|
|
if (this.connection !== unit) {
|
|
this.connect(unit);
|
|
}
|
|
}
|
|
//get current value
|
|
var currentVal = this.checkExpInput(this.control.getValueAtTime(t));
|
|
// this.control.cancelScheduledValues(t);
|
|
//if it's going up
|
|
if (destination1 > currentVal) {
|
|
this.control.setTargetAtTime(destination1, t, this._rampAttackTC);
|
|
t += this._rampAttackTime;
|
|
} else if (destination1 < currentVal) {
|
|
this.control.setTargetAtTime(destination1, t, this._rampDecayTC);
|
|
t += this._rampDecayTime;
|
|
}
|
|
// Now the second part of envelope begins
|
|
if (destination2 === undefined)
|
|
return;
|
|
//if it's going up
|
|
if (destination2 > destination1) {
|
|
this.control.setTargetAtTime(destination2, t, this._rampAttackTC);
|
|
} else if (destination2 < destination1) {
|
|
this.control.setTargetAtTime(destination2, t, this._rampDecayTC);
|
|
}
|
|
};
|
|
p5.Env.prototype.connect = function (unit) {
|
|
this.connection = unit;
|
|
// assume we're talking about output gain
|
|
// unless given a different audio param
|
|
if (unit instanceof p5.Oscillator || unit instanceof p5.SoundFile || unit instanceof p5.AudioIn || unit instanceof p5.Reverb || unit instanceof p5.Noise || unit instanceof p5.Filter || unit instanceof p5.Delay) {
|
|
unit = unit.output.gain;
|
|
}
|
|
if (unit instanceof AudioParam) {
|
|
//set the initial value
|
|
unit.setValueAtTime(0, p5sound.audiocontext.currentTime);
|
|
}
|
|
if (unit instanceof p5.Signal) {
|
|
unit.setValue(0);
|
|
}
|
|
this.output.connect(unit);
|
|
};
|
|
p5.Env.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
};
|
|
// Signal Math
|
|
/**
|
|
* Add a value to the p5.Oscillator's output amplitude,
|
|
* and return the oscillator. Calling this method
|
|
* again will override the initial add() with new values.
|
|
*
|
|
* @method add
|
|
* @param {Number} number Constant number to add
|
|
* @return {p5.Env} Envelope Returns this envelope
|
|
* with scaled output
|
|
*/
|
|
p5.Env.prototype.add = function (num) {
|
|
var add = new Add(num);
|
|
var thisChain = this.mathOps.length;
|
|
var nextChain = this.output;
|
|
return p5.prototype._mathChain(this, add, thisChain, nextChain, Add);
|
|
};
|
|
/**
|
|
* Multiply the p5.Env's output amplitude
|
|
* by a fixed value. Calling this method
|
|
* again will override the initial mult() with new values.
|
|
*
|
|
* @method mult
|
|
* @param {Number} number Constant number to multiply
|
|
* @return {p5.Env} Envelope Returns this envelope
|
|
* with scaled output
|
|
*/
|
|
p5.Env.prototype.mult = function (num) {
|
|
var mult = new Mult(num);
|
|
var thisChain = this.mathOps.length;
|
|
var nextChain = this.output;
|
|
return p5.prototype._mathChain(this, mult, thisChain, nextChain, Mult);
|
|
};
|
|
/**
|
|
* Scale this envelope's amplitude values to a given
|
|
* range, and return the envelope. Calling this method
|
|
* again will override the initial scale() with new values.
|
|
*
|
|
* @method scale
|
|
* @param {Number} inMin input range minumum
|
|
* @param {Number} inMax input range maximum
|
|
* @param {Number} outMin input range minumum
|
|
* @param {Number} outMax input range maximum
|
|
* @return {p5.Env} Envelope Returns this envelope
|
|
* with scaled output
|
|
*/
|
|
p5.Env.prototype.scale = function (inMin, inMax, outMin, outMax) {
|
|
var scale = new Scale(inMin, inMax, outMin, outMax);
|
|
var thisChain = this.mathOps.length;
|
|
var nextChain = this.output;
|
|
return p5.prototype._mathChain(this, scale, thisChain, nextChain, Scale);
|
|
};
|
|
// get rid of the oscillator
|
|
p5.Env.prototype.dispose = function () {
|
|
// remove reference from soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
this.disconnect();
|
|
try {
|
|
this.control.dispose();
|
|
this.control = null;
|
|
} catch (e) {
|
|
console.warn(e, 'already disposed p5.Env');
|
|
}
|
|
for (var i = 1; i < this.mathOps.length; i++) {
|
|
this.mathOps[i].dispose();
|
|
}
|
|
};
|
|
}(master, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale, Tone_signal_TimelineSignal, Tone_core_Tone);
|
|
var pulse;
|
|
'use strict';
|
|
pulse = function () {
|
|
var p5sound = master;
|
|
/**
|
|
* Creates a Pulse object, an oscillator that implements
|
|
* Pulse Width Modulation.
|
|
* The pulse is created with two oscillators.
|
|
* Accepts a parameter for frequency, and to set the
|
|
* width between the pulses. See <a href="
|
|
* http://p5js.org/reference/#/p5.Oscillator">
|
|
* <code>p5.Oscillator</code> for a full list of methods.
|
|
*
|
|
* @class p5.Pulse
|
|
* @extends p5.Oscillator
|
|
* @constructor
|
|
* @param {Number} [freq] Frequency in oscillations per second (Hz)
|
|
* @param {Number} [w] Width between the pulses (0 to 1.0,
|
|
* defaults to 0)
|
|
* @example
|
|
* <div><code>
|
|
* var pulse;
|
|
* function setup() {
|
|
* background(0);
|
|
*
|
|
* // Create and start the pulse wave oscillator
|
|
* pulse = new p5.Pulse();
|
|
* pulse.amp(0.5);
|
|
* pulse.freq(220);
|
|
* pulse.start();
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* var w = map(mouseX, 0, width, 0, 1);
|
|
* w = constrain(w, 0, 1);
|
|
* pulse.width(w)
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Pulse = function (freq, w) {
|
|
p5.Oscillator.call(this, freq, 'sawtooth');
|
|
// width of PWM, should be betw 0 to 1.0
|
|
this.w = w || 0;
|
|
// create a second oscillator with inverse frequency
|
|
this.osc2 = new p5.SawOsc(freq);
|
|
// create a delay node
|
|
this.dNode = p5sound.audiocontext.createDelay();
|
|
// dc offset
|
|
this.dcOffset = createDCOffset();
|
|
this.dcGain = p5sound.audiocontext.createGain();
|
|
this.dcOffset.connect(this.dcGain);
|
|
this.dcGain.connect(this.output);
|
|
// set delay time based on PWM width
|
|
this.f = freq || 440;
|
|
var mW = this.w / this.oscillator.frequency.value;
|
|
this.dNode.delayTime.value = mW;
|
|
this.dcGain.gain.value = 1.7 * (0.5 - this.w);
|
|
// disconnect osc2 and connect it to delay, which is connected to output
|
|
this.osc2.disconnect();
|
|
this.osc2.panner.disconnect();
|
|
this.osc2.amp(-1);
|
|
// inverted amplitude
|
|
this.osc2.output.connect(this.dNode);
|
|
this.dNode.connect(this.output);
|
|
this.output.gain.value = 1;
|
|
this.output.connect(this.panner);
|
|
};
|
|
p5.Pulse.prototype = Object.create(p5.Oscillator.prototype);
|
|
/**
|
|
* Set the width of a Pulse object (an oscillator that implements
|
|
* Pulse Width Modulation).
|
|
*
|
|
* @method width
|
|
* @param {Number} [width] Width between the pulses (0 to 1.0,
|
|
* defaults to 0)
|
|
*/
|
|
p5.Pulse.prototype.width = function (w) {
|
|
if (typeof w === 'number') {
|
|
if (w <= 1 && w >= 0) {
|
|
this.w = w;
|
|
// set delay time based on PWM width
|
|
// var mW = map(this.w, 0, 1.0, 0, 1/this.f);
|
|
var mW = this.w / this.oscillator.frequency.value;
|
|
this.dNode.delayTime.value = mW;
|
|
}
|
|
this.dcGain.gain.value = 1.7 * (0.5 - this.w);
|
|
} else {
|
|
w.connect(this.dNode.delayTime);
|
|
var sig = new p5.SignalAdd(-0.5);
|
|
sig.setInput(w);
|
|
sig = sig.mult(-1);
|
|
sig = sig.mult(1.7);
|
|
sig.connect(this.dcGain.gain);
|
|
}
|
|
};
|
|
p5.Pulse.prototype.start = function (f, time) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var t = time || 0;
|
|
if (!this.started) {
|
|
var freq = f || this.f;
|
|
var type = this.oscillator.type;
|
|
this.oscillator = p5sound.audiocontext.createOscillator();
|
|
this.oscillator.frequency.setValueAtTime(freq, now);
|
|
this.oscillator.type = type;
|
|
this.oscillator.connect(this.output);
|
|
this.oscillator.start(t + now);
|
|
// set up osc2
|
|
this.osc2.oscillator = p5sound.audiocontext.createOscillator();
|
|
this.osc2.oscillator.frequency.setValueAtTime(freq, t + now);
|
|
this.osc2.oscillator.type = type;
|
|
this.osc2.oscillator.connect(this.osc2.output);
|
|
this.osc2.start(t + now);
|
|
this.freqNode = [
|
|
this.oscillator.frequency,
|
|
this.osc2.oscillator.frequency
|
|
];
|
|
// start dcOffset, too
|
|
this.dcOffset = createDCOffset();
|
|
this.dcOffset.connect(this.dcGain);
|
|
this.dcOffset.start(t + now);
|
|
// if LFO connections depend on these oscillators
|
|
if (this.mods !== undefined && this.mods.frequency !== undefined) {
|
|
this.mods.frequency.connect(this.freqNode[0]);
|
|
this.mods.frequency.connect(this.freqNode[1]);
|
|
}
|
|
this.started = true;
|
|
this.osc2.started = true;
|
|
}
|
|
};
|
|
p5.Pulse.prototype.stop = function (time) {
|
|
if (this.started) {
|
|
var t = time || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.oscillator.stop(t + now);
|
|
this.osc2.oscillator.stop(t + now);
|
|
this.dcOffset.stop(t + now);
|
|
this.started = false;
|
|
this.osc2.started = false;
|
|
}
|
|
};
|
|
p5.Pulse.prototype.freq = function (val, rampTime, tFromNow) {
|
|
if (typeof val === 'number') {
|
|
this.f = val;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var rampTime = rampTime || 0;
|
|
var tFromNow = tFromNow || 0;
|
|
var currentFreq = this.oscillator.frequency.value;
|
|
this.oscillator.frequency.cancelScheduledValues(now);
|
|
this.oscillator.frequency.setValueAtTime(currentFreq, now + tFromNow);
|
|
this.oscillator.frequency.exponentialRampToValueAtTime(val, tFromNow + rampTime + now);
|
|
this.osc2.oscillator.frequency.cancelScheduledValues(now);
|
|
this.osc2.oscillator.frequency.setValueAtTime(currentFreq, now + tFromNow);
|
|
this.osc2.oscillator.frequency.exponentialRampToValueAtTime(val, tFromNow + rampTime + now);
|
|
if (this.freqMod) {
|
|
this.freqMod.output.disconnect();
|
|
this.freqMod = null;
|
|
}
|
|
} else if (val.output) {
|
|
val.output.disconnect();
|
|
val.output.connect(this.oscillator.frequency);
|
|
val.output.connect(this.osc2.oscillator.frequency);
|
|
this.freqMod = val;
|
|
}
|
|
};
|
|
// inspiration: http://webaudiodemos.appspot.com/oscilloscope/
|
|
function createDCOffset() {
|
|
var ac = p5sound.audiocontext;
|
|
var buffer = ac.createBuffer(1, 2048, ac.sampleRate);
|
|
var data = buffer.getChannelData(0);
|
|
for (var i = 0; i < 2048; i++)
|
|
data[i] = 1;
|
|
var bufferSource = ac.createBufferSource();
|
|
bufferSource.buffer = buffer;
|
|
bufferSource.loop = true;
|
|
return bufferSource;
|
|
}
|
|
}(master, oscillator);
|
|
var noise;
|
|
'use strict';
|
|
noise = function () {
|
|
var p5sound = master;
|
|
/**
|
|
* Noise is a type of oscillator that generates a buffer with random values.
|
|
*
|
|
* @class p5.Noise
|
|
* @extends p5.Oscillator
|
|
* @constructor
|
|
* @param {String} type Type of noise can be 'white' (default),
|
|
* 'brown' or 'pink'.
|
|
*/
|
|
p5.Noise = function (type) {
|
|
var assignType;
|
|
p5.Oscillator.call(this);
|
|
delete this.f;
|
|
delete this.freq;
|
|
delete this.oscillator;
|
|
if (type === 'brown') {
|
|
assignType = _brownNoise;
|
|
} else if (type === 'pink') {
|
|
assignType = _pinkNoise;
|
|
} else {
|
|
assignType = _whiteNoise;
|
|
}
|
|
this.buffer = assignType;
|
|
};
|
|
p5.Noise.prototype = Object.create(p5.Oscillator.prototype);
|
|
// generate noise buffers
|
|
var _whiteNoise = function () {
|
|
var bufferSize = 2 * p5sound.audiocontext.sampleRate;
|
|
var whiteBuffer = p5sound.audiocontext.createBuffer(1, bufferSize, p5sound.audiocontext.sampleRate);
|
|
var noiseData = whiteBuffer.getChannelData(0);
|
|
for (var i = 0; i < bufferSize; i++) {
|
|
noiseData[i] = Math.random() * 2 - 1;
|
|
}
|
|
whiteBuffer.type = 'white';
|
|
return whiteBuffer;
|
|
}();
|
|
var _pinkNoise = function () {
|
|
var bufferSize = 2 * p5sound.audiocontext.sampleRate;
|
|
var pinkBuffer = p5sound.audiocontext.createBuffer(1, bufferSize, p5sound.audiocontext.sampleRate);
|
|
var noiseData = pinkBuffer.getChannelData(0);
|
|
var b0, b1, b2, b3, b4, b5, b6;
|
|
b0 = b1 = b2 = b3 = b4 = b5 = b6 = 0;
|
|
for (var i = 0; i < bufferSize; i++) {
|
|
var white = Math.random() * 2 - 1;
|
|
b0 = 0.99886 * b0 + white * 0.0555179;
|
|
b1 = 0.99332 * b1 + white * 0.0750759;
|
|
b2 = 0.969 * b2 + white * 0.153852;
|
|
b3 = 0.8665 * b3 + white * 0.3104856;
|
|
b4 = 0.55 * b4 + white * 0.5329522;
|
|
b5 = -0.7616 * b5 - white * 0.016898;
|
|
noiseData[i] = b0 + b1 + b2 + b3 + b4 + b5 + b6 + white * 0.5362;
|
|
noiseData[i] *= 0.11;
|
|
// (roughly) compensate for gain
|
|
b6 = white * 0.115926;
|
|
}
|
|
pinkBuffer.type = 'pink';
|
|
return pinkBuffer;
|
|
}();
|
|
var _brownNoise = function () {
|
|
var bufferSize = 2 * p5sound.audiocontext.sampleRate;
|
|
var brownBuffer = p5sound.audiocontext.createBuffer(1, bufferSize, p5sound.audiocontext.sampleRate);
|
|
var noiseData = brownBuffer.getChannelData(0);
|
|
var lastOut = 0;
|
|
for (var i = 0; i < bufferSize; i++) {
|
|
var white = Math.random() * 2 - 1;
|
|
noiseData[i] = (lastOut + 0.02 * white) / 1.02;
|
|
lastOut = noiseData[i];
|
|
noiseData[i] *= 3.5;
|
|
}
|
|
brownBuffer.type = 'brown';
|
|
return brownBuffer;
|
|
}();
|
|
/**
|
|
* Set type of noise to 'white', 'pink' or 'brown'.
|
|
* White is the default.
|
|
*
|
|
* @method setType
|
|
* @param {String} [type] 'white', 'pink' or 'brown'
|
|
*/
|
|
p5.Noise.prototype.setType = function (type) {
|
|
switch (type) {
|
|
case 'white':
|
|
this.buffer = _whiteNoise;
|
|
break;
|
|
case 'pink':
|
|
this.buffer = _pinkNoise;
|
|
break;
|
|
case 'brown':
|
|
this.buffer = _brownNoise;
|
|
break;
|
|
default:
|
|
this.buffer = _whiteNoise;
|
|
}
|
|
if (this.started) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.stop(now);
|
|
this.start(now + 0.01);
|
|
}
|
|
};
|
|
p5.Noise.prototype.getType = function () {
|
|
return this.buffer.type;
|
|
};
|
|
/**
|
|
* Start the noise
|
|
*
|
|
* @method start
|
|
*/
|
|
p5.Noise.prototype.start = function () {
|
|
if (this.started) {
|
|
this.stop();
|
|
}
|
|
this.noise = p5sound.audiocontext.createBufferSource();
|
|
this.noise.buffer = this.buffer;
|
|
this.noise.loop = true;
|
|
this.noise.connect(this.output);
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.noise.start(now);
|
|
this.started = true;
|
|
};
|
|
/**
|
|
* Stop the noise.
|
|
*
|
|
* @method stop
|
|
*/
|
|
p5.Noise.prototype.stop = function () {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
if (this.noise) {
|
|
this.noise.stop(now);
|
|
this.started = false;
|
|
}
|
|
};
|
|
/**
|
|
* Pan the noise.
|
|
*
|
|
* @method pan
|
|
* @param {Number} panning Number between -1 (left)
|
|
* and 1 (right)
|
|
* @param {Number} timeFromNow schedule this event to happen
|
|
* seconds from now
|
|
*/
|
|
/**
|
|
* Set the amplitude of the noise between 0 and 1.0. Or,
|
|
* modulate amplitude with an audio signal such as an oscillator.
|
|
*
|
|
* @method amp
|
|
* @param {Number|Object} volume amplitude between 0 and 1.0
|
|
* or modulating signal/oscillator
|
|
* @param {Number} [rampTime] create a fade that lasts rampTime
|
|
* @param {Number} [timeFromNow] schedule this event to happen
|
|
* seconds from now
|
|
*/
|
|
/**
|
|
* Send output to a p5.sound or web audio object
|
|
*
|
|
* @method connect
|
|
* @param {Object} unit
|
|
*/
|
|
/**
|
|
* Disconnect all output.
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
p5.Noise.prototype.dispose = function () {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
// remove reference from soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
if (this.noise) {
|
|
this.noise.disconnect();
|
|
this.stop(now);
|
|
}
|
|
if (this.output) {
|
|
this.output.disconnect();
|
|
}
|
|
if (this.panner) {
|
|
this.panner.disconnect();
|
|
}
|
|
this.output = null;
|
|
this.panner = null;
|
|
this.buffer = null;
|
|
this.noise = null;
|
|
};
|
|
}(master);
|
|
var audioin;
|
|
'use strict';
|
|
audioin = function () {
|
|
var p5sound = master;
|
|
// an array of input sources
|
|
p5sound.inputSources = [];
|
|
/**
|
|
* <p>Get audio from an input, i.e. your computer's microphone.</p>
|
|
*
|
|
* <p>Turn the mic on/off with the start() and stop() methods. When the mic
|
|
* is on, its volume can be measured with getLevel or by connecting an
|
|
* FFT object.</p>
|
|
*
|
|
* <p>If you want to hear the AudioIn, use the .connect() method.
|
|
* AudioIn does not connect to p5.sound output by default to prevent
|
|
* feedback.</p>
|
|
*
|
|
* <p><em>Note: This uses the <a href="http://caniuse.com/stream">getUserMedia/
|
|
* Stream</a> API, which is not supported by certain browsers. Access in Chrome browser
|
|
* is limited to localhost and https, but access over http may be limited.</em></p>
|
|
*
|
|
* @class p5.AudioIn
|
|
* @constructor
|
|
* @param {Function} [errorCallback] A function to call if there is an error
|
|
* accessing the AudioIn. For example,
|
|
* Safari and iOS devices do not
|
|
* currently allow microphone access.
|
|
* @example
|
|
* <div><code>
|
|
* var mic;
|
|
* function setup(){
|
|
* mic = new p5.AudioIn()
|
|
* mic.start();
|
|
* }
|
|
* function draw(){
|
|
* background(0);
|
|
* micLevel = mic.getLevel();
|
|
* ellipse(width/2, constrain(height-micLevel*height*5, 0, height), 10, 10);
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.AudioIn = function (errorCallback) {
|
|
// set up audio input
|
|
this.input = p5sound.audiocontext.createGain();
|
|
this.output = p5sound.audiocontext.createGain();
|
|
this.stream = null;
|
|
this.mediaStream = null;
|
|
this.currentSource = null;
|
|
/**
|
|
* Client must allow browser to access their microphone / audioin source.
|
|
* Default: false. Will become true when the client enables acces.
|
|
*
|
|
* @property {Boolean} enabled
|
|
*/
|
|
this.enabled = false;
|
|
// create an amplitude, connect to it by default but not to master out
|
|
this.amplitude = new p5.Amplitude();
|
|
this.output.connect(this.amplitude.input);
|
|
if (!window.MediaStreamTrack || !window.navigator.mediaDevices || !window.navigator.mediaDevices.getUserMedia) {
|
|
errorCallback ? errorCallback() : window.alert('This browser does not support MediaStreamTrack and mediaDevices');
|
|
}
|
|
// add to soundArray so we can dispose on close
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
/**
|
|
* Start processing audio input. This enables the use of other
|
|
* AudioIn methods like getLevel(). Note that by default, AudioIn
|
|
* is not connected to p5.sound's output. So you won't hear
|
|
* anything unless you use the connect() method.<br/>
|
|
*
|
|
* Certain browsers limit access to the user's microphone. For example,
|
|
* Chrome only allows access from localhost and over https. For this reason,
|
|
* you may want to include an errorCallback—a function that is called in case
|
|
* the browser won't provide mic access.
|
|
*
|
|
* @method start
|
|
* @param {Function} [successCallback] Name of a function to call on
|
|
* success.
|
|
* @param {Function} [errorCallback] Name of a function to call if
|
|
* there was an error. For example,
|
|
* some browsers do not support
|
|
* getUserMedia.
|
|
*/
|
|
p5.AudioIn.prototype.start = function (successCallback, errorCallback) {
|
|
var self = this;
|
|
if (this.stream) {
|
|
this.stop();
|
|
}
|
|
// set the audio source
|
|
var audioSource = p5sound.inputSources[self.currentSource];
|
|
var constraints = {
|
|
audio: {
|
|
sampleRate: p5sound.audiocontext.sampleRate,
|
|
echoCancellation: false
|
|
}
|
|
};
|
|
// if developers determine which source to use
|
|
if (p5sound.inputSources[this.currentSource]) {
|
|
constraints.audio.deviceId = audioSource.deviceId;
|
|
}
|
|
window.navigator.mediaDevices.getUserMedia(constraints).then(function (stream) {
|
|
self.stream = stream;
|
|
self.enabled = true;
|
|
// Wrap a MediaStreamSourceNode around the live input
|
|
self.mediaStream = p5sound.audiocontext.createMediaStreamSource(stream);
|
|
self.mediaStream.connect(self.output);
|
|
// only send to the Amplitude reader, so we can see it but not hear it.
|
|
self.amplitude.setInput(self.output);
|
|
if (successCallback)
|
|
successCallback();
|
|
}).catch(function (err) {
|
|
if (errorCallback)
|
|
errorCallback(err);
|
|
else
|
|
console.error(err);
|
|
});
|
|
};
|
|
/**
|
|
* Turn the AudioIn off. If the AudioIn is stopped, it cannot getLevel().
|
|
* If re-starting, the user may be prompted for permission access.
|
|
*
|
|
* @method stop
|
|
*/
|
|
p5.AudioIn.prototype.stop = function () {
|
|
if (this.stream) {
|
|
this.stream.getTracks().forEach(function (track) {
|
|
track.stop();
|
|
});
|
|
this.mediaStream.disconnect();
|
|
delete this.mediaStream;
|
|
delete this.stream;
|
|
}
|
|
};
|
|
/**
|
|
* Connect to an audio unit. If no parameter is provided, will
|
|
* connect to the master output (i.e. your speakers).<br/>
|
|
*
|
|
* @method connect
|
|
* @param {Object} [unit] An object that accepts audio input,
|
|
* such as an FFT
|
|
*/
|
|
p5.AudioIn.prototype.connect = function (unit) {
|
|
if (unit) {
|
|
if (unit.hasOwnProperty('input')) {
|
|
this.output.connect(unit.input);
|
|
} else if (unit.hasOwnProperty('analyser')) {
|
|
this.output.connect(unit.analyser);
|
|
} else {
|
|
this.output.connect(unit);
|
|
}
|
|
} else {
|
|
this.output.connect(p5sound.input);
|
|
}
|
|
};
|
|
/**
|
|
* Disconnect the AudioIn from all audio units. For example, if
|
|
* connect() had been called, disconnect() will stop sending
|
|
* signal to your speakers.<br/>
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
p5.AudioIn.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
// stay connected to amplitude even if not outputting to p5
|
|
this.output.connect(this.amplitude.input);
|
|
};
|
|
/**
|
|
* Read the Amplitude (volume level) of an AudioIn. The AudioIn
|
|
* class contains its own instance of the Amplitude class to help
|
|
* make it easy to get a microphone's volume level. Accepts an
|
|
* optional smoothing value (0.0 < 1.0). <em>NOTE: AudioIn must
|
|
* .start() before using .getLevel().</em><br/>
|
|
*
|
|
* @method getLevel
|
|
* @param {Number} [smoothing] Smoothing is 0.0 by default.
|
|
* Smooths values based on previous values.
|
|
* @return {Number} Volume level (between 0.0 and 1.0)
|
|
*/
|
|
p5.AudioIn.prototype.getLevel = function (smoothing) {
|
|
if (smoothing) {
|
|
this.amplitude.smoothing = smoothing;
|
|
}
|
|
return this.amplitude.getLevel();
|
|
};
|
|
/**
|
|
* Set amplitude (volume) of a mic input between 0 and 1.0. <br/>
|
|
*
|
|
* @method amp
|
|
* @param {Number} vol between 0 and 1.0
|
|
* @param {Number} [time] ramp time (optional)
|
|
*/
|
|
p5.AudioIn.prototype.amp = function (vol, t) {
|
|
if (t) {
|
|
var rampTime = t || 0;
|
|
var currentVol = this.output.gain.value;
|
|
this.output.gain.cancelScheduledValues(p5sound.audiocontext.currentTime);
|
|
this.output.gain.setValueAtTime(currentVol, p5sound.audiocontext.currentTime);
|
|
this.output.gain.linearRampToValueAtTime(vol, rampTime + p5sound.audiocontext.currentTime);
|
|
} else {
|
|
this.output.gain.cancelScheduledValues(p5sound.audiocontext.currentTime);
|
|
this.output.gain.setValueAtTime(vol, p5sound.audiocontext.currentTime);
|
|
}
|
|
};
|
|
/**
|
|
* Returns a list of available input sources. This is a wrapper
|
|
* for <a title="MediaDevices.enumerateDevices() - Web APIs | MDN" target="_blank" href=
|
|
* "https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices"
|
|
* > and it returns a Promise.
|
|
*
|
|
* @method getSources
|
|
* @param {Function} [successCallback] This callback function handles the sources when they
|
|
* have been enumerated. The callback function
|
|
* receives the deviceList array as its only argument
|
|
* @param {Function} [errorCallback] This optional callback receives the error
|
|
* message as its argument.
|
|
* @returns {Object} Returns a Promise that can be used in place of the callbacks, similar
|
|
* to the enumerateDevices() method
|
|
* @example
|
|
* <div><code>
|
|
* var audiograb;
|
|
*
|
|
* function setup(){
|
|
* //new audioIn
|
|
* audioGrab = new p5.AudioIn();
|
|
*
|
|
* audioGrab.getSources(function(deviceList) {
|
|
* //print out the array of available sources
|
|
* console.log(deviceList);
|
|
* //set the source to the first item in the deviceList array
|
|
* audioGrab.setSource(0);
|
|
* });
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.AudioIn.prototype.getSources = function (onSuccess, onError) {
|
|
return new Promise(function (resolve, reject) {
|
|
window.navigator.mediaDevices.enumerateDevices().then(function (devices) {
|
|
p5sound.inputSources = devices.filter(function (device) {
|
|
return device.kind === 'audioinput';
|
|
});
|
|
resolve(p5sound.inputSources);
|
|
if (onSuccess) {
|
|
onSuccess(p5sound.inputSources);
|
|
}
|
|
}).catch(function (error) {
|
|
reject(error);
|
|
if (onError) {
|
|
onError(error);
|
|
} else {
|
|
console.error('This browser does not support MediaStreamTrack.getSources()');
|
|
}
|
|
});
|
|
});
|
|
};
|
|
/**
|
|
* Set the input source. Accepts a number representing a
|
|
* position in the array returned by getSources().
|
|
* This is only available in browsers that support
|
|
* <a title="MediaDevices.enumerateDevices() - Web APIs | MDN" target="_blank" href=
|
|
* "https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices"
|
|
* >navigator.mediaDevices.enumerateDevices()</a>.<br/>
|
|
*
|
|
* @method setSource
|
|
* @param {number} num position of input source in the array
|
|
*/
|
|
p5.AudioIn.prototype.setSource = function (num) {
|
|
if (p5sound.inputSources.length > 0 && num < p5sound.inputSources.length) {
|
|
// set the current source
|
|
this.currentSource = num;
|
|
console.log('set source to ', p5sound.inputSources[this.currentSource]);
|
|
} else {
|
|
console.log('unable to set input source');
|
|
}
|
|
// restart stream if currently active
|
|
if (this.stream && this.stream.active) {
|
|
this.start();
|
|
}
|
|
};
|
|
// private method
|
|
p5.AudioIn.prototype.dispose = function () {
|
|
// remove reference from soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
this.stop();
|
|
if (this.output) {
|
|
this.output.disconnect();
|
|
}
|
|
if (this.amplitude) {
|
|
this.amplitude.disconnect();
|
|
}
|
|
delete this.amplitude;
|
|
delete this.output;
|
|
};
|
|
}(master);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Negate;
|
|
Tone_signal_Negate = function (Tone) {
|
|
'use strict';
|
|
Tone.Negate = function () {
|
|
this._multiply = this.input = this.output = new Tone.Multiply(-1);
|
|
};
|
|
Tone.extend(Tone.Negate, Tone.SignalBase);
|
|
Tone.Negate.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._multiply.dispose();
|
|
this._multiply = null;
|
|
return this;
|
|
};
|
|
return Tone.Negate;
|
|
}(Tone_core_Tone, Tone_signal_Multiply);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Subtract;
|
|
Tone_signal_Subtract = function (Tone) {
|
|
'use strict';
|
|
Tone.Subtract = function (value) {
|
|
this.createInsOuts(2, 0);
|
|
this._sum = this.input[0] = this.output = new Tone.Gain();
|
|
this._neg = new Tone.Negate();
|
|
this._param = this.input[1] = new Tone.Signal(value);
|
|
this._param.chain(this._neg, this._sum);
|
|
};
|
|
Tone.extend(Tone.Subtract, Tone.Signal);
|
|
Tone.Subtract.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._neg.dispose();
|
|
this._neg = null;
|
|
this._sum.disconnect();
|
|
this._sum = null;
|
|
this._param.dispose();
|
|
this._param = null;
|
|
return this;
|
|
};
|
|
return Tone.Subtract;
|
|
}(Tone_core_Tone, Tone_signal_Add, Tone_signal_Negate, Tone_signal_Signal);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_GreaterThanZero;
|
|
Tone_signal_GreaterThanZero = function (Tone) {
|
|
'use strict';
|
|
Tone.GreaterThanZero = function () {
|
|
this._thresh = this.output = new Tone.WaveShaper(function (val) {
|
|
if (val <= 0) {
|
|
return 0;
|
|
} else {
|
|
return 1;
|
|
}
|
|
}, 127);
|
|
this._scale = this.input = new Tone.Multiply(10000);
|
|
this._scale.connect(this._thresh);
|
|
};
|
|
Tone.extend(Tone.GreaterThanZero, Tone.SignalBase);
|
|
Tone.GreaterThanZero.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._scale.dispose();
|
|
this._scale = null;
|
|
this._thresh.dispose();
|
|
this._thresh = null;
|
|
return this;
|
|
};
|
|
return Tone.GreaterThanZero;
|
|
}(Tone_core_Tone, Tone_signal_Signal, Tone_signal_Multiply);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_GreaterThan;
|
|
Tone_signal_GreaterThan = function (Tone) {
|
|
'use strict';
|
|
Tone.GreaterThan = function (value) {
|
|
this.createInsOuts(2, 0);
|
|
this._param = this.input[0] = new Tone.Subtract(value);
|
|
this.input[1] = this._param.input[1];
|
|
this._gtz = this.output = new Tone.GreaterThanZero();
|
|
this._param.connect(this._gtz);
|
|
};
|
|
Tone.extend(Tone.GreaterThan, Tone.Signal);
|
|
Tone.GreaterThan.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._param.dispose();
|
|
this._param = null;
|
|
this._gtz.dispose();
|
|
this._gtz = null;
|
|
return this;
|
|
};
|
|
return Tone.GreaterThan;
|
|
}(Tone_core_Tone, Tone_signal_GreaterThanZero, Tone_signal_Subtract);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Abs;
|
|
Tone_signal_Abs = function (Tone) {
|
|
'use strict';
|
|
Tone.Abs = function () {
|
|
this._abs = this.input = this.output = new Tone.WaveShaper(function (val) {
|
|
if (val === 0) {
|
|
return 0;
|
|
} else {
|
|
return Math.abs(val);
|
|
}
|
|
}, 127);
|
|
};
|
|
Tone.extend(Tone.Abs, Tone.SignalBase);
|
|
Tone.Abs.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._abs.dispose();
|
|
this._abs = null;
|
|
return this;
|
|
};
|
|
return Tone.Abs;
|
|
}(Tone_core_Tone, Tone_signal_WaveShaper);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Modulo;
|
|
Tone_signal_Modulo = function (Tone) {
|
|
'use strict';
|
|
Tone.Modulo = function (modulus) {
|
|
this.createInsOuts(1, 0);
|
|
this._shaper = new Tone.WaveShaper(Math.pow(2, 16));
|
|
this._multiply = new Tone.Multiply();
|
|
this._subtract = this.output = new Tone.Subtract();
|
|
this._modSignal = new Tone.Signal(modulus);
|
|
this.input.fan(this._shaper, this._subtract);
|
|
this._modSignal.connect(this._multiply, 0, 0);
|
|
this._shaper.connect(this._multiply, 0, 1);
|
|
this._multiply.connect(this._subtract, 0, 1);
|
|
this._setWaveShaper(modulus);
|
|
};
|
|
Tone.extend(Tone.Modulo, Tone.SignalBase);
|
|
Tone.Modulo.prototype._setWaveShaper = function (mod) {
|
|
this._shaper.setMap(function (val) {
|
|
var multiple = Math.floor((val + 0.0001) / mod);
|
|
return multiple;
|
|
});
|
|
};
|
|
Object.defineProperty(Tone.Modulo.prototype, 'value', {
|
|
get: function () {
|
|
return this._modSignal.value;
|
|
},
|
|
set: function (mod) {
|
|
this._modSignal.value = mod;
|
|
this._setWaveShaper(mod);
|
|
}
|
|
});
|
|
Tone.Modulo.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._shaper.dispose();
|
|
this._shaper = null;
|
|
this._multiply.dispose();
|
|
this._multiply = null;
|
|
this._subtract.dispose();
|
|
this._subtract = null;
|
|
this._modSignal.dispose();
|
|
this._modSignal = null;
|
|
return this;
|
|
};
|
|
return Tone.Modulo;
|
|
}(Tone_core_Tone, Tone_signal_WaveShaper, Tone_signal_Multiply);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Pow;
|
|
Tone_signal_Pow = function (Tone) {
|
|
'use strict';
|
|
Tone.Pow = function (exp) {
|
|
this._exp = this.defaultArg(exp, 1);
|
|
this._expScaler = this.input = this.output = new Tone.WaveShaper(this._expFunc(this._exp), 8192);
|
|
};
|
|
Tone.extend(Tone.Pow, Tone.SignalBase);
|
|
Object.defineProperty(Tone.Pow.prototype, 'value', {
|
|
get: function () {
|
|
return this._exp;
|
|
},
|
|
set: function (exp) {
|
|
this._exp = exp;
|
|
this._expScaler.setMap(this._expFunc(this._exp));
|
|
}
|
|
});
|
|
Tone.Pow.prototype._expFunc = function (exp) {
|
|
return function (val) {
|
|
return Math.pow(Math.abs(val), exp);
|
|
};
|
|
};
|
|
Tone.Pow.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._expScaler.dispose();
|
|
this._expScaler = null;
|
|
return this;
|
|
};
|
|
return Tone.Pow;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_AudioToGain;
|
|
Tone_signal_AudioToGain = function (Tone) {
|
|
'use strict';
|
|
Tone.AudioToGain = function () {
|
|
this._norm = this.input = this.output = new Tone.WaveShaper(function (x) {
|
|
return (x + 1) / 2;
|
|
});
|
|
};
|
|
Tone.extend(Tone.AudioToGain, Tone.SignalBase);
|
|
Tone.AudioToGain.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._norm.dispose();
|
|
this._norm = null;
|
|
return this;
|
|
};
|
|
return Tone.AudioToGain;
|
|
}(Tone_core_Tone, Tone_signal_WaveShaper);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_Expr;
|
|
Tone_signal_Expr = function (Tone) {
|
|
'use strict';
|
|
Tone.Expr = function () {
|
|
var expr = this._replacements(Array.prototype.slice.call(arguments));
|
|
var inputCount = this._parseInputs(expr);
|
|
this._nodes = [];
|
|
this.input = new Array(inputCount);
|
|
for (var i = 0; i < inputCount; i++) {
|
|
this.input[i] = this.context.createGain();
|
|
}
|
|
var tree = this._parseTree(expr);
|
|
var result;
|
|
try {
|
|
result = this._eval(tree);
|
|
} catch (e) {
|
|
this._disposeNodes();
|
|
throw new Error('Tone.Expr: Could evaluate expression: ' + expr);
|
|
}
|
|
this.output = result;
|
|
};
|
|
Tone.extend(Tone.Expr, Tone.SignalBase);
|
|
function applyBinary(Constructor, args, self) {
|
|
var op = new Constructor();
|
|
self._eval(args[0]).connect(op, 0, 0);
|
|
self._eval(args[1]).connect(op, 0, 1);
|
|
return op;
|
|
}
|
|
function applyUnary(Constructor, args, self) {
|
|
var op = new Constructor();
|
|
self._eval(args[0]).connect(op, 0, 0);
|
|
return op;
|
|
}
|
|
function getNumber(arg) {
|
|
return arg ? parseFloat(arg) : undefined;
|
|
}
|
|
function literalNumber(arg) {
|
|
return arg && arg.args ? parseFloat(arg.args) : undefined;
|
|
}
|
|
Tone.Expr._Expressions = {
|
|
'value': {
|
|
'signal': {
|
|
regexp: /^\d+\.\d+|^\d+/,
|
|
method: function (arg) {
|
|
var sig = new Tone.Signal(getNumber(arg));
|
|
return sig;
|
|
}
|
|
},
|
|
'input': {
|
|
regexp: /^\$\d/,
|
|
method: function (arg, self) {
|
|
return self.input[getNumber(arg.substr(1))];
|
|
}
|
|
}
|
|
},
|
|
'glue': {
|
|
'(': { regexp: /^\(/ },
|
|
')': { regexp: /^\)/ },
|
|
',': { regexp: /^,/ }
|
|
},
|
|
'func': {
|
|
'abs': {
|
|
regexp: /^abs/,
|
|
method: applyUnary.bind(this, Tone.Abs)
|
|
},
|
|
'mod': {
|
|
regexp: /^mod/,
|
|
method: function (args, self) {
|
|
var modulus = literalNumber(args[1]);
|
|
var op = new Tone.Modulo(modulus);
|
|
self._eval(args[0]).connect(op);
|
|
return op;
|
|
}
|
|
},
|
|
'pow': {
|
|
regexp: /^pow/,
|
|
method: function (args, self) {
|
|
var exp = literalNumber(args[1]);
|
|
var op = new Tone.Pow(exp);
|
|
self._eval(args[0]).connect(op);
|
|
return op;
|
|
}
|
|
},
|
|
'a2g': {
|
|
regexp: /^a2g/,
|
|
method: function (args, self) {
|
|
var op = new Tone.AudioToGain();
|
|
self._eval(args[0]).connect(op);
|
|
return op;
|
|
}
|
|
}
|
|
},
|
|
'binary': {
|
|
'+': {
|
|
regexp: /^\+/,
|
|
precedence: 1,
|
|
method: applyBinary.bind(this, Tone.Add)
|
|
},
|
|
'-': {
|
|
regexp: /^\-/,
|
|
precedence: 1,
|
|
method: function (args, self) {
|
|
if (args.length === 1) {
|
|
return applyUnary(Tone.Negate, args, self);
|
|
} else {
|
|
return applyBinary(Tone.Subtract, args, self);
|
|
}
|
|
}
|
|
},
|
|
'*': {
|
|
regexp: /^\*/,
|
|
precedence: 0,
|
|
method: applyBinary.bind(this, Tone.Multiply)
|
|
}
|
|
},
|
|
'unary': {
|
|
'-': {
|
|
regexp: /^\-/,
|
|
method: applyUnary.bind(this, Tone.Negate)
|
|
},
|
|
'!': {
|
|
regexp: /^\!/,
|
|
method: applyUnary.bind(this, Tone.NOT)
|
|
}
|
|
}
|
|
};
|
|
Tone.Expr.prototype._parseInputs = function (expr) {
|
|
var inputArray = expr.match(/\$\d/g);
|
|
var inputMax = 0;
|
|
if (inputArray !== null) {
|
|
for (var i = 0; i < inputArray.length; i++) {
|
|
var inputNum = parseInt(inputArray[i].substr(1)) + 1;
|
|
inputMax = Math.max(inputMax, inputNum);
|
|
}
|
|
}
|
|
return inputMax;
|
|
};
|
|
Tone.Expr.prototype._replacements = function (args) {
|
|
var expr = args.shift();
|
|
for (var i = 0; i < args.length; i++) {
|
|
expr = expr.replace(/\%/i, args[i]);
|
|
}
|
|
return expr;
|
|
};
|
|
Tone.Expr.prototype._tokenize = function (expr) {
|
|
var position = -1;
|
|
var tokens = [];
|
|
while (expr.length > 0) {
|
|
expr = expr.trim();
|
|
var token = getNextToken(expr);
|
|
tokens.push(token);
|
|
expr = expr.substr(token.value.length);
|
|
}
|
|
function getNextToken(expr) {
|
|
for (var type in Tone.Expr._Expressions) {
|
|
var group = Tone.Expr._Expressions[type];
|
|
for (var opName in group) {
|
|
var op = group[opName];
|
|
var reg = op.regexp;
|
|
var match = expr.match(reg);
|
|
if (match !== null) {
|
|
return {
|
|
type: type,
|
|
value: match[0],
|
|
method: op.method
|
|
};
|
|
}
|
|
}
|
|
}
|
|
throw new SyntaxError('Tone.Expr: Unexpected token ' + expr);
|
|
}
|
|
return {
|
|
next: function () {
|
|
return tokens[++position];
|
|
},
|
|
peek: function () {
|
|
return tokens[position + 1];
|
|
}
|
|
};
|
|
};
|
|
Tone.Expr.prototype._parseTree = function (expr) {
|
|
var lexer = this._tokenize(expr);
|
|
var isUndef = this.isUndef.bind(this);
|
|
function matchSyntax(token, syn) {
|
|
return !isUndef(token) && token.type === 'glue' && token.value === syn;
|
|
}
|
|
function matchGroup(token, groupName, prec) {
|
|
var ret = false;
|
|
var group = Tone.Expr._Expressions[groupName];
|
|
if (!isUndef(token)) {
|
|
for (var opName in group) {
|
|
var op = group[opName];
|
|
if (op.regexp.test(token.value)) {
|
|
if (!isUndef(prec)) {
|
|
if (op.precedence === prec) {
|
|
return true;
|
|
}
|
|
} else {
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return ret;
|
|
}
|
|
function parseExpression(precedence) {
|
|
if (isUndef(precedence)) {
|
|
precedence = 5;
|
|
}
|
|
var expr;
|
|
if (precedence < 0) {
|
|
expr = parseUnary();
|
|
} else {
|
|
expr = parseExpression(precedence - 1);
|
|
}
|
|
var token = lexer.peek();
|
|
while (matchGroup(token, 'binary', precedence)) {
|
|
token = lexer.next();
|
|
expr = {
|
|
operator: token.value,
|
|
method: token.method,
|
|
args: [
|
|
expr,
|
|
parseExpression(precedence - 1)
|
|
]
|
|
};
|
|
token = lexer.peek();
|
|
}
|
|
return expr;
|
|
}
|
|
function parseUnary() {
|
|
var token, expr;
|
|
token = lexer.peek();
|
|
if (matchGroup(token, 'unary')) {
|
|
token = lexer.next();
|
|
expr = parseUnary();
|
|
return {
|
|
operator: token.value,
|
|
method: token.method,
|
|
args: [expr]
|
|
};
|
|
}
|
|
return parsePrimary();
|
|
}
|
|
function parsePrimary() {
|
|
var token, expr;
|
|
token = lexer.peek();
|
|
if (isUndef(token)) {
|
|
throw new SyntaxError('Tone.Expr: Unexpected termination of expression');
|
|
}
|
|
if (token.type === 'func') {
|
|
token = lexer.next();
|
|
return parseFunctionCall(token);
|
|
}
|
|
if (token.type === 'value') {
|
|
token = lexer.next();
|
|
return {
|
|
method: token.method,
|
|
args: token.value
|
|
};
|
|
}
|
|
if (matchSyntax(token, '(')) {
|
|
lexer.next();
|
|
expr = parseExpression();
|
|
token = lexer.next();
|
|
if (!matchSyntax(token, ')')) {
|
|
throw new SyntaxError('Expected )');
|
|
}
|
|
return expr;
|
|
}
|
|
throw new SyntaxError('Tone.Expr: Parse error, cannot process token ' + token.value);
|
|
}
|
|
function parseFunctionCall(func) {
|
|
var token, args = [];
|
|
token = lexer.next();
|
|
if (!matchSyntax(token, '(')) {
|
|
throw new SyntaxError('Tone.Expr: Expected ( in a function call "' + func.value + '"');
|
|
}
|
|
token = lexer.peek();
|
|
if (!matchSyntax(token, ')')) {
|
|
args = parseArgumentList();
|
|
}
|
|
token = lexer.next();
|
|
if (!matchSyntax(token, ')')) {
|
|
throw new SyntaxError('Tone.Expr: Expected ) in a function call "' + func.value + '"');
|
|
}
|
|
return {
|
|
method: func.method,
|
|
args: args,
|
|
name: name
|
|
};
|
|
}
|
|
function parseArgumentList() {
|
|
var token, expr, args = [];
|
|
while (true) {
|
|
expr = parseExpression();
|
|
if (isUndef(expr)) {
|
|
break;
|
|
}
|
|
args.push(expr);
|
|
token = lexer.peek();
|
|
if (!matchSyntax(token, ',')) {
|
|
break;
|
|
}
|
|
lexer.next();
|
|
}
|
|
return args;
|
|
}
|
|
return parseExpression();
|
|
};
|
|
Tone.Expr.prototype._eval = function (tree) {
|
|
if (!this.isUndef(tree)) {
|
|
var node = tree.method(tree.args, this);
|
|
this._nodes.push(node);
|
|
return node;
|
|
}
|
|
};
|
|
Tone.Expr.prototype._disposeNodes = function () {
|
|
for (var i = 0; i < this._nodes.length; i++) {
|
|
var node = this._nodes[i];
|
|
if (this.isFunction(node.dispose)) {
|
|
node.dispose();
|
|
} else if (this.isFunction(node.disconnect)) {
|
|
node.disconnect();
|
|
}
|
|
node = null;
|
|
this._nodes[i] = null;
|
|
}
|
|
this._nodes = null;
|
|
};
|
|
Tone.Expr.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._disposeNodes();
|
|
};
|
|
return Tone.Expr;
|
|
}(Tone_core_Tone, Tone_signal_Add, Tone_signal_Subtract, Tone_signal_Multiply, Tone_signal_GreaterThan, Tone_signal_GreaterThanZero, Tone_signal_Abs, Tone_signal_Negate, Tone_signal_Modulo, Tone_signal_Pow);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_signal_EqualPowerGain;
|
|
Tone_signal_EqualPowerGain = function (Tone) {
|
|
'use strict';
|
|
Tone.EqualPowerGain = function () {
|
|
this._eqPower = this.input = this.output = new Tone.WaveShaper(function (val) {
|
|
if (Math.abs(val) < 0.001) {
|
|
return 0;
|
|
} else {
|
|
return this.equalPowerScale(val);
|
|
}
|
|
}.bind(this), 4096);
|
|
};
|
|
Tone.extend(Tone.EqualPowerGain, Tone.SignalBase);
|
|
Tone.EqualPowerGain.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._eqPower.dispose();
|
|
this._eqPower = null;
|
|
return this;
|
|
};
|
|
return Tone.EqualPowerGain;
|
|
}(Tone_core_Tone);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_component_CrossFade;
|
|
Tone_component_CrossFade = function (Tone) {
|
|
'use strict';
|
|
Tone.CrossFade = function (initialFade) {
|
|
this.createInsOuts(2, 1);
|
|
this.a = this.input[0] = new Tone.Gain();
|
|
this.b = this.input[1] = new Tone.Gain();
|
|
this.fade = new Tone.Signal(this.defaultArg(initialFade, 0.5), Tone.Type.NormalRange);
|
|
this._equalPowerA = new Tone.EqualPowerGain();
|
|
this._equalPowerB = new Tone.EqualPowerGain();
|
|
this._invert = new Tone.Expr('1 - $0');
|
|
this.a.connect(this.output);
|
|
this.b.connect(this.output);
|
|
this.fade.chain(this._equalPowerB, this.b.gain);
|
|
this.fade.chain(this._invert, this._equalPowerA, this.a.gain);
|
|
this._readOnly('fade');
|
|
};
|
|
Tone.extend(Tone.CrossFade);
|
|
Tone.CrossFade.prototype.dispose = function () {
|
|
Tone.prototype.dispose.call(this);
|
|
this._writable('fade');
|
|
this._equalPowerA.dispose();
|
|
this._equalPowerA = null;
|
|
this._equalPowerB.dispose();
|
|
this._equalPowerB = null;
|
|
this.fade.dispose();
|
|
this.fade = null;
|
|
this._invert.dispose();
|
|
this._invert = null;
|
|
this.a.dispose();
|
|
this.a = null;
|
|
this.b.dispose();
|
|
this.b = null;
|
|
return this;
|
|
};
|
|
return Tone.CrossFade;
|
|
}(Tone_core_Tone, Tone_signal_Signal, Tone_signal_Expr, Tone_signal_EqualPowerGain);
|
|
var effect;
|
|
'use strict';
|
|
effect = function () {
|
|
var p5sound = master;
|
|
var CrossFade = Tone_component_CrossFade;
|
|
/**
|
|
* Effect is a base class for audio effects in p5. <br>
|
|
* This module handles the nodes and methods that are
|
|
* common and useful for current and future effects.
|
|
*
|
|
*
|
|
* This class is extended by <a href="reference/#/p5.Distortion">p5.Distortion</a>,
|
|
* <a href="reference/#/p5.Compressor">p5.Compressor</a>,
|
|
* <a href="reference/#/p5.Delay">p5.Delay</a>,
|
|
* <a href="reference/#/p5.Filter">p5.Filter</a>,
|
|
* <a href="reference/#/p5.Reverb">p5.Reverb</a>.
|
|
*
|
|
* @class p5.Effect
|
|
* @constructor
|
|
*
|
|
* @param {Object} [ac] Reference to the audio context of the p5 object
|
|
* @param {AudioNode} [input] Gain Node effect wrapper
|
|
* @param {AudioNode} [output] Gain Node effect wrapper
|
|
* @param {Object} [_drywet] Tone.JS CrossFade node (defaults to value: 1)
|
|
* @param {AudioNode} [wet] Effects that extend this class should connect
|
|
* to the wet signal to this gain node, so that dry and wet
|
|
* signals are mixed properly.
|
|
*/
|
|
p5.Effect = function () {
|
|
this.ac = p5sound.audiocontext;
|
|
this.input = this.ac.createGain();
|
|
this.output = this.ac.createGain();
|
|
/**
|
|
* The p5.Effect class is built
|
|
* using Tone.js CrossFade
|
|
* @private
|
|
*/
|
|
this._drywet = new CrossFade(1);
|
|
/**
|
|
* In classes that extend
|
|
* p5.Effect, connect effect nodes
|
|
* to the wet parameter
|
|
*/
|
|
this.wet = this.ac.createGain();
|
|
this.input.connect(this._drywet.a);
|
|
this.wet.connect(this._drywet.b);
|
|
this._drywet.connect(this.output);
|
|
this.connect();
|
|
//Add to the soundArray
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
/**
|
|
* Set the output volume of the filter.
|
|
*
|
|
* @method amp
|
|
* @param {Number} [vol] amplitude between 0 and 1.0
|
|
* @param {Number} [rampTime] create a fade that lasts until rampTime
|
|
* @param {Number} [tFromNow] schedule this event to happen in tFromNow seconds
|
|
*/
|
|
p5.Effect.prototype.amp = function (vol, rampTime, tFromNow) {
|
|
var rampTime = rampTime || 0;
|
|
var tFromNow = tFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var currentVol = this.output.gain.value;
|
|
this.output.gain.cancelScheduledValues(now);
|
|
this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow + 0.001);
|
|
this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime + 0.001);
|
|
};
|
|
/**
|
|
* Link effects together in a chain
|
|
* Example usage: filter.chain(reverb, delay, panner);
|
|
* May be used with an open-ended number of arguments
|
|
*
|
|
* @method chain
|
|
* @param {Object} [arguments] Chain together multiple sound objects
|
|
*/
|
|
p5.Effect.prototype.chain = function () {
|
|
if (arguments.length > 0) {
|
|
this.connect(arguments[0]);
|
|
for (var i = 1; i < arguments.length; i += 1) {
|
|
arguments[i - 1].connect(arguments[i]);
|
|
}
|
|
}
|
|
return this;
|
|
};
|
|
/**
|
|
* Adjust the dry/wet value.
|
|
*
|
|
* @method drywet
|
|
* @param {Number} [fade] The desired drywet value (0 - 1.0)
|
|
*/
|
|
p5.Effect.prototype.drywet = function (fade) {
|
|
if (typeof fade !== 'undefined') {
|
|
this._drywet.fade.value = fade;
|
|
}
|
|
return this._drywet.fade.value;
|
|
};
|
|
/**
|
|
* Send output to a p5.js-sound, Web Audio Node, or use signal to
|
|
* control an AudioParam
|
|
*
|
|
* @method connect
|
|
* @param {Object} unit
|
|
*/
|
|
p5.Effect.prototype.connect = function (unit) {
|
|
var u = unit || p5.soundOut.input;
|
|
this.output.connect(u.input ? u.input : u);
|
|
};
|
|
/**
|
|
* Disconnect all output.
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
p5.Effect.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
};
|
|
p5.Effect.prototype.dispose = function () {
|
|
// remove refernce form soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
this.input.disconnect();
|
|
this.input = undefined;
|
|
this.output.disconnect();
|
|
this.output = undefined;
|
|
this._drywet.disconnect();
|
|
delete this._drywet;
|
|
this.wet.disconnect();
|
|
delete this.wet;
|
|
this.ac = undefined;
|
|
};
|
|
return p5.Effect;
|
|
}(master, Tone_component_CrossFade);
|
|
var filter;
|
|
'use strict';
|
|
filter = function () {
|
|
var p5sound = master;
|
|
var Effect = effect;
|
|
/**
|
|
* <p>A p5.Filter uses a Web Audio Biquad Filter to filter
|
|
* the frequency response of an input source. Subclasses
|
|
* include:</p>
|
|
* * <a href="/reference/#/p5.LowPass"><code>p5.LowPass</code></a>:
|
|
* Allows frequencies below the cutoff frequency to pass through,
|
|
* and attenuates frequencies above the cutoff.<br/>
|
|
* * <a href="/reference/#/p5.HighPass"><code>p5.HighPass</code></a>:
|
|
* The opposite of a lowpass filter. <br/>
|
|
* * <a href="/reference/#/p5.BandPass"><code>p5.BandPass</code></a>:
|
|
* Allows a range of frequencies to pass through and attenuates
|
|
* the frequencies below and above this frequency range.<br/>
|
|
*
|
|
* The <code>.res()</code> method controls either width of the
|
|
* bandpass, or resonance of the low/highpass cutoff frequency.
|
|
*
|
|
* This class extends <a href = "/reference/#/p5.Effect">p5.Effect</a>.
|
|
* Methods <a href = "/reference/#/p5.Effect/amp">amp()</a>, <a href = "/reference/#/p5.Effect/chain">chain()</a>,
|
|
* <a href = "/reference/#/p5.Effect/drywet">drywet()</a>, <a href = "/reference/#/p5.Effect/connect">connect()</a>, and
|
|
* <a href = "/reference/#/p5.Effect/disconnect">disconnect()</a> are available.
|
|
*
|
|
* @class p5.Filter
|
|
* @extends p5.Effect
|
|
* @constructor
|
|
* @param {String} [type] 'lowpass' (default), 'highpass', 'bandpass'
|
|
* @example
|
|
* <div><code>
|
|
* var fft, noise, filter;
|
|
*
|
|
* function setup() {
|
|
* fill(255, 40, 255);
|
|
*
|
|
* filter = new p5.BandPass();
|
|
*
|
|
* noise = new p5.Noise();
|
|
* // disconnect unfiltered noise,
|
|
* // and connect to filter
|
|
* noise.disconnect();
|
|
* noise.connect(filter);
|
|
* noise.start();
|
|
*
|
|
* fft = new p5.FFT();
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(30);
|
|
*
|
|
* // set the BandPass frequency based on mouseX
|
|
* var freq = map(mouseX, 0, width, 20, 10000);
|
|
* filter.freq(freq);
|
|
* // give the filter a narrow band (lower res = wider bandpass)
|
|
* filter.res(50);
|
|
*
|
|
* // draw filtered spectrum
|
|
* var spectrum = fft.analyze();
|
|
* noStroke();
|
|
* for (var i = 0; i < spectrum.length; i++) {
|
|
* var x = map(i, 0, spectrum.length, 0, width);
|
|
* var h = -height + map(spectrum[i], 0, 255, height, 0);
|
|
* rect(x, height, width/spectrum.length, h);
|
|
* }
|
|
*
|
|
* isMouseOverCanvas();
|
|
* }
|
|
*
|
|
* function isMouseOverCanvas() {
|
|
* var mX = mouseX, mY = mouseY;
|
|
* if (mX > 0 && mX < width && mY < height && mY > 0) {
|
|
* noise.amp(0.5, 0.2);
|
|
* } else {
|
|
* noise.amp(0, 0.2);
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
//constructor with inheritance
|
|
p5.Filter = function (type) {
|
|
Effect.call(this);
|
|
//add extend Effect by adding a Biquad Filter
|
|
/**
|
|
* The p5.Filter is built with a
|
|
* <a href="http://www.w3.org/TR/webaudio/#BiquadFilterNode">
|
|
* Web Audio BiquadFilter Node</a>.
|
|
*
|
|
* @property {DelayNode} biquadFilter
|
|
*/
|
|
this.biquad = this.ac.createBiquadFilter();
|
|
this.input.connect(this.biquad);
|
|
this.biquad.connect(this.wet);
|
|
if (type) {
|
|
this.setType(type);
|
|
}
|
|
//Properties useful for the toggle method.
|
|
this._on = true;
|
|
this._untoggledType = this.biquad.type;
|
|
};
|
|
p5.Filter.prototype = Object.create(Effect.prototype);
|
|
/**
|
|
* Filter an audio signal according to a set
|
|
* of filter parameters.
|
|
*
|
|
* @method process
|
|
* @param {Object} Signal An object that outputs audio
|
|
* @param {Number} [freq] Frequency in Hz, from 10 to 22050
|
|
* @param {Number} [res] Resonance/Width of the filter frequency
|
|
* from 0.001 to 1000
|
|
*/
|
|
p5.Filter.prototype.process = function (src, freq, res, time) {
|
|
src.connect(this.input);
|
|
this.set(freq, res, time);
|
|
};
|
|
/**
|
|
* Set the frequency and the resonance of the filter.
|
|
*
|
|
* @method set
|
|
* @param {Number} [freq] Frequency in Hz, from 10 to 22050
|
|
* @param {Number} [res] Resonance (Q) from 0.001 to 1000
|
|
* @param {Number} [timeFromNow] schedule this event to happen
|
|
* seconds from now
|
|
*/
|
|
p5.Filter.prototype.set = function (freq, res, time) {
|
|
if (freq) {
|
|
this.freq(freq, time);
|
|
}
|
|
if (res) {
|
|
this.res(res, time);
|
|
}
|
|
};
|
|
/**
|
|
* Set the filter frequency, in Hz, from 10 to 22050 (the range of
|
|
* human hearing, although in reality most people hear in a narrower
|
|
* range).
|
|
*
|
|
* @method freq
|
|
* @param {Number} freq Filter Frequency
|
|
* @param {Number} [timeFromNow] schedule this event to happen
|
|
* seconds from now
|
|
* @return {Number} value Returns the current frequency value
|
|
*/
|
|
p5.Filter.prototype.freq = function (freq, time) {
|
|
var t = time || 0;
|
|
if (freq <= 0) {
|
|
freq = 1;
|
|
}
|
|
if (typeof freq === 'number') {
|
|
this.biquad.frequency.value = freq;
|
|
this.biquad.frequency.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.biquad.frequency.exponentialRampToValueAtTime(freq, this.ac.currentTime + 0.02 + t);
|
|
} else if (freq) {
|
|
freq.connect(this.biquad.frequency);
|
|
}
|
|
return this.biquad.frequency.value;
|
|
};
|
|
/**
|
|
* Controls either width of a bandpass frequency,
|
|
* or the resonance of a low/highpass cutoff frequency.
|
|
*
|
|
* @method res
|
|
* @param {Number} res Resonance/Width of filter freq
|
|
* from 0.001 to 1000
|
|
* @param {Number} [timeFromNow] schedule this event to happen
|
|
* seconds from now
|
|
* @return {Number} value Returns the current res value
|
|
*/
|
|
p5.Filter.prototype.res = function (res, time) {
|
|
var t = time || 0;
|
|
if (typeof res === 'number') {
|
|
this.biquad.Q.value = res;
|
|
this.biquad.Q.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.biquad.Q.linearRampToValueAtTime(res, this.ac.currentTime + 0.02 + t);
|
|
} else if (res) {
|
|
res.connect(this.biquad.Q);
|
|
}
|
|
return this.biquad.Q.value;
|
|
};
|
|
/**
|
|
* Controls the gain attribute of a Biquad Filter.
|
|
* This is distinctly different from .amp() which is inherited from p5.Effect
|
|
* .amp() controls the volume via the output gain node
|
|
* p5.Filter.gain() controls the gain parameter of a Biquad Filter node.
|
|
*
|
|
* @method gain
|
|
* @param {Number} gain
|
|
* @return {Number} Returns the current or updated gain value
|
|
*/
|
|
p5.Filter.prototype.gain = function (gain, time) {
|
|
var t = time || 0;
|
|
if (typeof gain === 'number') {
|
|
this.biquad.gain.value = gain;
|
|
this.biquad.gain.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.biquad.gain.linearRampToValueAtTime(gain, this.ac.currentTime + 0.02 + t);
|
|
} else if (gain) {
|
|
gain.connect(this.biquad.gain);
|
|
}
|
|
return this.biquad.gain.value;
|
|
};
|
|
/**
|
|
* Toggle function. Switches between the specified type and allpass
|
|
*
|
|
* @method toggle
|
|
* @return {boolean} [Toggle value]
|
|
*/
|
|
p5.Filter.prototype.toggle = function () {
|
|
this._on = !this._on;
|
|
if (this._on === true) {
|
|
this.biquad.type = this._untoggledType;
|
|
} else if (this._on === false) {
|
|
this.biquad.type = 'allpass';
|
|
}
|
|
return this._on;
|
|
};
|
|
/**
|
|
* Set the type of a p5.Filter. Possible types include:
|
|
* "lowpass" (default), "highpass", "bandpass",
|
|
* "lowshelf", "highshelf", "peaking", "notch",
|
|
* "allpass".
|
|
*
|
|
* @method setType
|
|
* @param {String} t
|
|
*/
|
|
p5.Filter.prototype.setType = function (t) {
|
|
this.biquad.type = t;
|
|
this._untoggledType = this.biquad.type;
|
|
};
|
|
p5.Filter.prototype.dispose = function () {
|
|
// remove reference from soundArray
|
|
Effect.prototype.dispose.apply(this);
|
|
this.biquad.disconnect();
|
|
this.biquad = undefined;
|
|
};
|
|
/**
|
|
* Constructor: <code>new p5.LowPass()</code> Filter.
|
|
* This is the same as creating a p5.Filter and then calling
|
|
* its method <code>setType('lowpass')</code>.
|
|
* See p5.Filter for methods.
|
|
*
|
|
* @class p5.LowPass
|
|
* @constructor
|
|
* @extends p5.Filter
|
|
*/
|
|
p5.LowPass = function () {
|
|
p5.Filter.call(this, 'lowpass');
|
|
};
|
|
p5.LowPass.prototype = Object.create(p5.Filter.prototype);
|
|
/**
|
|
* Constructor: <code>new p5.HighPass()</code> Filter.
|
|
* This is the same as creating a p5.Filter and then calling
|
|
* its method <code>setType('highpass')</code>.
|
|
* See p5.Filter for methods.
|
|
*
|
|
* @class p5.HighPass
|
|
* @constructor
|
|
* @extends p5.Filter
|
|
*/
|
|
p5.HighPass = function () {
|
|
p5.Filter.call(this, 'highpass');
|
|
};
|
|
p5.HighPass.prototype = Object.create(p5.Filter.prototype);
|
|
/**
|
|
* Constructor: <code>new p5.BandPass()</code> Filter.
|
|
* This is the same as creating a p5.Filter and then calling
|
|
* its method <code>setType('bandpass')</code>.
|
|
* See p5.Filter for methods.
|
|
*
|
|
* @class p5.BandPass
|
|
* @constructor
|
|
* @extends p5.Filter
|
|
*/
|
|
p5.BandPass = function () {
|
|
p5.Filter.call(this, 'bandpass');
|
|
};
|
|
p5.BandPass.prototype = Object.create(p5.Filter.prototype);
|
|
return p5.Filter;
|
|
}(master, effect);
|
|
var src_eqFilter;
|
|
'use strict';
|
|
src_eqFilter = function () {
|
|
var Filter = filter;
|
|
var p5sound = master;
|
|
/**
|
|
* EQFilter extends p5.Filter with constraints
|
|
* necessary for the p5.EQ
|
|
*
|
|
* @private
|
|
*/
|
|
var EQFilter = function (freq, res) {
|
|
Filter.call(this, 'peaking');
|
|
this.disconnect();
|
|
this.set(freq, res);
|
|
this.biquad.gain.value = 0;
|
|
delete this.input;
|
|
delete this.output;
|
|
delete this._drywet;
|
|
delete this.wet;
|
|
};
|
|
EQFilter.prototype = Object.create(Filter.prototype);
|
|
EQFilter.prototype.amp = function () {
|
|
console.warn('`amp()` is not available for p5.EQ bands. Use `.gain()`');
|
|
};
|
|
EQFilter.prototype.drywet = function () {
|
|
console.warn('`drywet()` is not available for p5.EQ bands.');
|
|
};
|
|
EQFilter.prototype.connect = function (unit) {
|
|
var u = unit || p5.soundOut.input;
|
|
if (this.biquad) {
|
|
this.biquad.connect(u.input ? u.input : u);
|
|
} else {
|
|
this.output.connect(u.input ? u.input : u);
|
|
}
|
|
};
|
|
EQFilter.prototype.disconnect = function () {
|
|
this.biquad.disconnect();
|
|
};
|
|
EQFilter.prototype.dispose = function () {
|
|
// remove reference form soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
this.disconnect();
|
|
delete this.biquad;
|
|
};
|
|
return EQFilter;
|
|
}(filter, master);
|
|
var eq;
|
|
'use strict';
|
|
eq = function () {
|
|
var Effect = effect;
|
|
var EQFilter = src_eqFilter;
|
|
/**
|
|
* p5.EQ is an audio effect that performs the function of a multiband
|
|
* audio equalizer. Equalization is used to adjust the balance of
|
|
* frequency compoenents of an audio signal. This process is commonly used
|
|
* in sound production and recording to change the waveform before it reaches
|
|
* a sound output device. EQ can also be used as an audio effect to create
|
|
* interesting distortions by filtering out parts of the spectrum. p5.EQ is
|
|
* built using a chain of Web Audio Biquad Filter Nodes and can be
|
|
* instantiated with 3 or 8 bands. Bands can be added or removed from
|
|
* the EQ by directly modifying p5.EQ.bands (the array that stores filters).
|
|
*
|
|
* This class extends <a href = "/reference/#/p5.Effect">p5.Effect</a>.
|
|
* Methods <a href = "/reference/#/p5.Effect/amp">amp()</a>, <a href = "/reference/#/p5.Effect/chain">chain()</a>,
|
|
* <a href = "/reference/#/p5.Effect/drywet">drywet()</a>, <a href = "/reference/#/p5.Effect/connect">connect()</a>, and
|
|
* <a href = "/reference/#/p5.Effect/disconnect">disconnect()</a> are available.
|
|
*
|
|
* @class p5.EQ
|
|
* @constructor
|
|
* @extends p5.Effect
|
|
* @param {Number} [_eqsize] Constructor will accept 3 or 8, defaults to 3
|
|
* @return {Object} p5.EQ object
|
|
*
|
|
* @example
|
|
* <div><code>
|
|
* var eq;
|
|
* var band_names;
|
|
* var band_index;
|
|
*
|
|
* var soundFile, play;
|
|
*
|
|
* function preload() {
|
|
* soundFormats('mp3', 'ogg');
|
|
* soundFile = loadSound('assets/beat');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* eq = new p5.EQ(3);
|
|
* soundFile.disconnect();
|
|
* eq.process(soundFile);
|
|
*
|
|
* band_names = ['lows','mids','highs'];
|
|
* band_index = 0;
|
|
* play = false;
|
|
* textAlign(CENTER);
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(30);
|
|
* noStroke();
|
|
* fill(255);
|
|
* text('click to kill',50,25);
|
|
*
|
|
* fill(255, 40, 255);
|
|
* textSize(26);
|
|
* text(band_names[band_index],50,55);
|
|
*
|
|
* fill(255);
|
|
* textSize(9);
|
|
* text('space = play/pause',50,80);
|
|
* }
|
|
*
|
|
* //If mouse is over canvas, cycle to the next band and kill the frequency
|
|
* function mouseClicked() {
|
|
* for (var i = 0; i < eq.bands.length; i++) {
|
|
* eq.bands[i].gain(0);
|
|
* }
|
|
* eq.bands[band_index].gain(-40);
|
|
* if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) {
|
|
* band_index === 2 ? band_index = 0 : band_index++;
|
|
* }
|
|
* }
|
|
*
|
|
* //use space bar to trigger play / pause
|
|
* function keyPressed() {
|
|
* if (key===' ') {
|
|
* play = !play
|
|
* play ? soundFile.loop() : soundFile.pause();
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.EQ = function (_eqsize) {
|
|
Effect.call(this);
|
|
//p5.EQ can be of size (3) or (8), defaults to 3
|
|
_eqsize = _eqsize === 3 || _eqsize === 8 ? _eqsize : 3;
|
|
var factor;
|
|
_eqsize === 3 ? factor = Math.pow(2, 3) : factor = 2;
|
|
/**
|
|
* The p5.EQ is built with abstracted p5.Filter objects.
|
|
* To modify any bands, use methods of the <a
|
|
* href="/reference/#/p5.Filter" title="p5.Filter reference">
|
|
* p5.Filter</a> API, especially `gain` and `freq`.
|
|
* Bands are stored in an array, with indices 0 - 3, or 0 - 7
|
|
* @property {Array} bands
|
|
*
|
|
*/
|
|
this.bands = [];
|
|
var freq, res;
|
|
for (var i = 0; i < _eqsize; i++) {
|
|
if (i === _eqsize - 1) {
|
|
freq = 21000;
|
|
res = 0.01;
|
|
} else if (i === 0) {
|
|
freq = 100;
|
|
res = 0.1;
|
|
} else if (i === 1) {
|
|
freq = _eqsize === 3 ? 360 * factor : 360;
|
|
res = 1;
|
|
} else {
|
|
freq = this.bands[i - 1].freq() * factor;
|
|
res = 1;
|
|
}
|
|
this.bands[i] = this._newBand(freq, res);
|
|
if (i > 0) {
|
|
this.bands[i - 1].connect(this.bands[i].biquad);
|
|
} else {
|
|
this.input.connect(this.bands[i].biquad);
|
|
}
|
|
}
|
|
this.bands[_eqsize - 1].connect(this.output);
|
|
};
|
|
p5.EQ.prototype = Object.create(Effect.prototype);
|
|
/**
|
|
* Process an input by connecting it to the EQ
|
|
* @method process
|
|
* @param {Object} src Audio source
|
|
*/
|
|
p5.EQ.prototype.process = function (src) {
|
|
src.connect(this.input);
|
|
};
|
|
// /**
|
|
// * Set the frequency and gain of each band in the EQ. This method should be
|
|
// * called with 3 or 8 frequency and gain pairs, depending on the size of the EQ.
|
|
// * ex. eq.set(freq0, gain0, freq1, gain1, freq2, gain2);
|
|
// *
|
|
// * @method set
|
|
// * @param {Number} [freq0] Frequency value for band with index 0
|
|
// * @param {Number} [gain0] Gain value for band with index 0
|
|
// * @param {Number} [freq1] Frequency value for band with index 1
|
|
// * @param {Number} [gain1] Gain value for band with index 1
|
|
// * @param {Number} [freq2] Frequency value for band with index 2
|
|
// * @param {Number} [gain2] Gain value for band with index 2
|
|
// * @param {Number} [freq3] Frequency value for band with index 3
|
|
// * @param {Number} [gain3] Gain value for band with index 3
|
|
// * @param {Number} [freq4] Frequency value for band with index 4
|
|
// * @param {Number} [gain4] Gain value for band with index 4
|
|
// * @param {Number} [freq5] Frequency value for band with index 5
|
|
// * @param {Number} [gain5] Gain value for band with index 5
|
|
// * @param {Number} [freq6] Frequency value for band with index 6
|
|
// * @param {Number} [gain6] Gain value for band with index 6
|
|
// * @param {Number} [freq7] Frequency value for band with index 7
|
|
// * @param {Number} [gain7] Gain value for band with index 7
|
|
// */
|
|
p5.EQ.prototype.set = function () {
|
|
if (arguments.length === this.bands.length * 2) {
|
|
for (var i = 0; i < arguments.length; i += 2) {
|
|
this.bands[i / 2].freq(arguments[i]);
|
|
this.bands[i / 2].gain(arguments[i + 1]);
|
|
}
|
|
} else {
|
|
console.error('Argument mismatch. .set() should be called with ' + this.bands.length * 2 + ' arguments. (one frequency and gain value pair for each band of the eq)');
|
|
}
|
|
};
|
|
/**
|
|
* Add a new band. Creates a p5.Filter and strips away everything but
|
|
* the raw biquad filter. This method returns an abstracted p5.Filter,
|
|
* which can be added to p5.EQ.bands, in order to create new EQ bands.
|
|
* @private
|
|
* @method _newBand
|
|
* @param {Number} freq
|
|
* @param {Number} res
|
|
* @return {Object} Abstracted Filter
|
|
*/
|
|
p5.EQ.prototype._newBand = function (freq, res) {
|
|
return new EQFilter(freq, res);
|
|
};
|
|
p5.EQ.prototype.dispose = function () {
|
|
Effect.prototype.dispose.apply(this);
|
|
while (this.bands.length > 0) {
|
|
delete this.bands.pop().dispose();
|
|
}
|
|
delete this.bands;
|
|
};
|
|
return p5.EQ;
|
|
}(effect, src_eqFilter);
|
|
var panner3d;
|
|
'use strict';
|
|
panner3d = function () {
|
|
var p5sound = master;
|
|
var Effect = effect;
|
|
/**
|
|
* Panner3D is based on the <a title="Web Audio Panner docs" href=
|
|
* "https://developer.mozilla.org/en-US/docs/Web/API/PannerNode">
|
|
* Web Audio Spatial Panner Node</a>.
|
|
* This panner is a spatial processing node that allows audio to be positioned
|
|
* and oriented in 3D space.
|
|
*
|
|
* The position is relative to an <a title="Web Audio Listener docs" href=
|
|
* "https://developer.mozilla.org/en-US/docs/Web/API/AudioListener">
|
|
* Audio Context Listener</a>, which can be accessed
|
|
* by <code>p5.soundOut.audiocontext.listener</code>
|
|
*
|
|
*
|
|
* @class p5.Panner3D
|
|
* @constructor
|
|
*/
|
|
p5.Panner3D = function () {
|
|
Effect.call(this);
|
|
/**
|
|
* <a title="Web Audio Panner docs" href=
|
|
* "https://developer.mozilla.org/en-US/docs/Web/API/PannerNode">
|
|
* Web Audio Spatial Panner Node</a>
|
|
*
|
|
* Properties include
|
|
* - <a title="w3 spec for Panning Model"
|
|
* href="https://www.w3.org/TR/webaudio/#idl-def-PanningModelType"
|
|
* >panningModel</a>: "equal power" or "HRTF"
|
|
* - <a title="w3 spec for Distance Model"
|
|
* href="https://www.w3.org/TR/webaudio/#idl-def-DistanceModelType"
|
|
* >distanceModel</a>: "linear", "inverse", or "exponential"
|
|
*
|
|
* @property {AudioNode} panner
|
|
*
|
|
*/
|
|
this.panner = this.ac.createPanner();
|
|
this.panner.panningModel = 'HRTF';
|
|
this.panner.distanceModel = 'linear';
|
|
this.panner.connect(this.output);
|
|
this.input.connect(this.panner);
|
|
};
|
|
p5.Panner3D.prototype = Object.create(Effect.prototype);
|
|
/**
|
|
* Connect an audio sorce
|
|
*
|
|
* @method process
|
|
* @param {Object} src Input source
|
|
*/
|
|
p5.Panner3D.prototype.process = function (src) {
|
|
src.connect(this.input);
|
|
};
|
|
/**
|
|
* Set the X,Y,Z position of the Panner
|
|
* @method set
|
|
* @param {Number} xVal
|
|
* @param {Number} yVal
|
|
* @param {Number} zVal
|
|
* @param {Number} time
|
|
* @return {Array} Updated x, y, z values as an array
|
|
*/
|
|
p5.Panner3D.prototype.set = function (xVal, yVal, zVal, time) {
|
|
this.positionX(xVal, time);
|
|
this.positionY(yVal, time);
|
|
this.positionZ(zVal, time);
|
|
return [
|
|
this.panner.positionX.value,
|
|
this.panner.positionY.value,
|
|
this.panner.positionZ.value
|
|
];
|
|
};
|
|
/**
|
|
* Getter and setter methods for position coordinates
|
|
* @method positionX
|
|
* @return {Number} updated coordinate value
|
|
*/
|
|
/**
|
|
* Getter and setter methods for position coordinates
|
|
* @method positionY
|
|
* @return {Number} updated coordinate value
|
|
*/
|
|
/**
|
|
* Getter and setter methods for position coordinates
|
|
* @method positionZ
|
|
* @return {Number} updated coordinate value
|
|
*/
|
|
p5.Panner3D.prototype.positionX = function (xVal, time) {
|
|
var t = time || 0;
|
|
if (typeof xVal === 'number') {
|
|
this.panner.positionX.value = xVal;
|
|
this.panner.positionX.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.panner.positionX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (xVal) {
|
|
xVal.connect(this.panner.positionX);
|
|
}
|
|
return this.panner.positionX.value;
|
|
};
|
|
p5.Panner3D.prototype.positionY = function (yVal, time) {
|
|
var t = time || 0;
|
|
if (typeof yVal === 'number') {
|
|
this.panner.positionY.value = yVal;
|
|
this.panner.positionY.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.panner.positionY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (yVal) {
|
|
yVal.connect(this.panner.positionY);
|
|
}
|
|
return this.panner.positionY.value;
|
|
};
|
|
p5.Panner3D.prototype.positionZ = function (zVal, time) {
|
|
var t = time || 0;
|
|
if (typeof zVal === 'number') {
|
|
this.panner.positionZ.value = zVal;
|
|
this.panner.positionZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.panner.positionZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (zVal) {
|
|
zVal.connect(this.panner.positionZ);
|
|
}
|
|
return this.panner.positionZ.value;
|
|
};
|
|
/**
|
|
* Set the X,Y,Z position of the Panner
|
|
* @method orient
|
|
* @param {Number} xVal
|
|
* @param {Number} yVal
|
|
* @param {Number} zVal
|
|
* @param {Number} time
|
|
* @return {Array} Updated x, y, z values as an array
|
|
*/
|
|
p5.Panner3D.prototype.orient = function (xVal, yVal, zVal, time) {
|
|
this.orientX(xVal, time);
|
|
this.orientY(yVal, time);
|
|
this.orientZ(zVal, time);
|
|
return [
|
|
this.panner.orientationX.value,
|
|
this.panner.orientationY.value,
|
|
this.panner.orientationZ.value
|
|
];
|
|
};
|
|
/**
|
|
* Getter and setter methods for orient coordinates
|
|
* @method orientX
|
|
* @return {Number} updated coordinate value
|
|
*/
|
|
/**
|
|
* Getter and setter methods for orient coordinates
|
|
* @method orientY
|
|
* @return {Number} updated coordinate value
|
|
*/
|
|
/**
|
|
* Getter and setter methods for orient coordinates
|
|
* @method orientZ
|
|
* @return {Number} updated coordinate value
|
|
*/
|
|
p5.Panner3D.prototype.orientX = function (xVal, time) {
|
|
var t = time || 0;
|
|
if (typeof xVal === 'number') {
|
|
this.panner.orientationX.value = xVal;
|
|
this.panner.orientationX.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.panner.orientationX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (xVal) {
|
|
xVal.connect(this.panner.orientationX);
|
|
}
|
|
return this.panner.orientationX.value;
|
|
};
|
|
p5.Panner3D.prototype.orientY = function (yVal, time) {
|
|
var t = time || 0;
|
|
if (typeof yVal === 'number') {
|
|
this.panner.orientationY.value = yVal;
|
|
this.panner.orientationY.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.panner.orientationY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (yVal) {
|
|
yVal.connect(this.panner.orientationY);
|
|
}
|
|
return this.panner.orientationY.value;
|
|
};
|
|
p5.Panner3D.prototype.orientZ = function (zVal, time) {
|
|
var t = time || 0;
|
|
if (typeof zVal === 'number') {
|
|
this.panner.orientationZ.value = zVal;
|
|
this.panner.orientationZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.panner.orientationZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (zVal) {
|
|
zVal.connect(this.panner.orientationZ);
|
|
}
|
|
return this.panner.orientationZ.value;
|
|
};
|
|
/**
|
|
* Set the rolloff factor and max distance
|
|
* @method setFalloff
|
|
* @param {Number} [maxDistance]
|
|
* @param {Number} [rolloffFactor]
|
|
*/
|
|
p5.Panner3D.prototype.setFalloff = function (maxDistance, rolloffFactor) {
|
|
this.maxDist(maxDistance);
|
|
this.rolloff(rolloffFactor);
|
|
};
|
|
/**
|
|
* Maxium distance between the source and the listener
|
|
* @method maxDist
|
|
* @param {Number} maxDistance
|
|
* @return {Number} updated value
|
|
*/
|
|
p5.Panner3D.prototype.maxDist = function (maxDistance) {
|
|
if (typeof maxDistance === 'number') {
|
|
this.panner.maxDistance = maxDistance;
|
|
}
|
|
return this.panner.maxDistance;
|
|
};
|
|
/**
|
|
* How quickly the volume is reduced as the source moves away from the listener
|
|
* @method rollof
|
|
* @param {Number} rolloffFactor
|
|
* @return {Number} updated value
|
|
*/
|
|
p5.Panner3D.prototype.rolloff = function (rolloffFactor) {
|
|
if (typeof rolloffFactor === 'number') {
|
|
this.panner.rolloffFactor = rolloffFactor;
|
|
}
|
|
return this.panner.rolloffFactor;
|
|
};
|
|
p5.Panner3D.dispose = function () {
|
|
Effect.prototype.dispose.apply(this);
|
|
this.panner.disconnect();
|
|
delete this.panner;
|
|
};
|
|
return p5.Panner3D;
|
|
}(master, effect);
|
|
var listener3d;
|
|
'use strict';
|
|
listener3d = function () {
|
|
var p5sound = master;
|
|
var Effect = effect;
|
|
// /**
|
|
// * listener is a class that can construct both a Spatial Panner
|
|
// * and a Spatial Listener. The panner is based on the
|
|
// * Web Audio Spatial Panner Node
|
|
// * https://www.w3.org/TR/webaudio/#the-listenernode-interface
|
|
// * This panner is a spatial processing node that allows audio to be positioned
|
|
// * and oriented in 3D space.
|
|
// *
|
|
// * The Listener modifies the properties of the Audio Context Listener.
|
|
// * Both objects types use the same methods. The default is a spatial panner.
|
|
// *
|
|
// * <code>p5.Panner3D</code> - Constructs a Spatial Panner<br/>
|
|
// * <code>p5.Listener3D</code> - Constructs a Spatial Listener<br/>
|
|
// *
|
|
// * @class listener
|
|
// * @constructor
|
|
// * @return {Object} p5.Listener3D Object
|
|
// *
|
|
// * @param {Web Audio Node} listener Web Audio Spatial Panning Node
|
|
// * @param {AudioParam} listener.panningModel "equal power" or "HRTF"
|
|
// * @param {AudioParam} listener.distanceModel "linear", "inverse", or "exponential"
|
|
// * @param {String} [type] [Specify construction of a spatial panner or listener]
|
|
// */
|
|
p5.Listener3D = function (type) {
|
|
this.ac = p5sound.audiocontext;
|
|
this.listener = this.ac.listener;
|
|
};
|
|
// /**
|
|
// * Connect an audio sorce
|
|
// * @param {Object} src Input source
|
|
// */
|
|
p5.Listener3D.prototype.process = function (src) {
|
|
src.connect(this.input);
|
|
};
|
|
// /**
|
|
// * Set the X,Y,Z position of the Panner
|
|
// * @param {[Number]} xVal
|
|
// * @param {[Number]} yVal
|
|
// * @param {[Number]} zVal
|
|
// * @param {[Number]} time
|
|
// * @return {[Array]} [Updated x, y, z values as an array]
|
|
// */
|
|
p5.Listener3D.prototype.position = function (xVal, yVal, zVal, time) {
|
|
this.positionX(xVal, time);
|
|
this.positionY(yVal, time);
|
|
this.positionZ(zVal, time);
|
|
return [
|
|
this.listener.positionX.value,
|
|
this.listener.positionY.value,
|
|
this.listener.positionZ.value
|
|
];
|
|
};
|
|
// /**
|
|
// * Getter and setter methods for position coordinates
|
|
// * @return {Number} [updated coordinate value]
|
|
// */
|
|
p5.Listener3D.prototype.positionX = function (xVal, time) {
|
|
var t = time || 0;
|
|
if (typeof xVal === 'number') {
|
|
this.listener.positionX.value = xVal;
|
|
this.listener.positionX.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.listener.positionX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (xVal) {
|
|
xVal.connect(this.listener.positionX);
|
|
}
|
|
return this.listener.positionX.value;
|
|
};
|
|
p5.Listener3D.prototype.positionY = function (yVal, time) {
|
|
var t = time || 0;
|
|
if (typeof yVal === 'number') {
|
|
this.listener.positionY.value = yVal;
|
|
this.listener.positionY.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.listener.positionY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (yVal) {
|
|
yVal.connect(this.listener.positionY);
|
|
}
|
|
return this.listener.positionY.value;
|
|
};
|
|
p5.Listener3D.prototype.positionZ = function (zVal, time) {
|
|
var t = time || 0;
|
|
if (typeof zVal === 'number') {
|
|
this.listener.positionZ.value = zVal;
|
|
this.listener.positionZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.listener.positionZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (zVal) {
|
|
zVal.connect(this.listener.positionZ);
|
|
}
|
|
return this.listener.positionZ.value;
|
|
};
|
|
// cannot define method when class definition is commented
|
|
// /**
|
|
// * Overrides the listener orient() method because Listener has slightly
|
|
// * different params. In human terms, Forward vectors are the direction the
|
|
// * nose is pointing. Up vectors are the direction of the top of the head.
|
|
// *
|
|
// * @method orient
|
|
// * @param {Number} xValF Forward vector X direction
|
|
// * @param {Number} yValF Forward vector Y direction
|
|
// * @param {Number} zValF Forward vector Z direction
|
|
// * @param {Number} xValU Up vector X direction
|
|
// * @param {Number} yValU Up vector Y direction
|
|
// * @param {Number} zValU Up vector Z direction
|
|
// * @param {Number} time
|
|
// * @return {Array} All orienation params
|
|
// */
|
|
p5.Listener3D.prototype.orient = function (xValF, yValF, zValF, xValU, yValU, zValU, time) {
|
|
if (arguments.length === 3 || arguments.length === 4) {
|
|
time = arguments[3];
|
|
this.orientForward(xValF, yValF, zValF, time);
|
|
} else if (arguments.length === 6 || arguments === 7) {
|
|
this.orientForward(xValF, yValF, zValF);
|
|
this.orientUp(xValU, yValU, zValU, time);
|
|
}
|
|
return [
|
|
this.listener.forwardX.value,
|
|
this.listener.forwardY.value,
|
|
this.listener.forwardZ.value,
|
|
this.listener.upX.value,
|
|
this.listener.upY.value,
|
|
this.listener.upZ.value
|
|
];
|
|
};
|
|
p5.Listener3D.prototype.orientForward = function (xValF, yValF, zValF, time) {
|
|
this.forwardX(xValF, time);
|
|
this.forwardY(yValF, time);
|
|
this.forwardZ(zValF, time);
|
|
return [
|
|
this.listener.forwardX,
|
|
this.listener.forwardY,
|
|
this.listener.forwardZ
|
|
];
|
|
};
|
|
p5.Listener3D.prototype.orientUp = function (xValU, yValU, zValU, time) {
|
|
this.upX(xValU, time);
|
|
this.upY(yValU, time);
|
|
this.upZ(zValU, time);
|
|
return [
|
|
this.listener.upX,
|
|
this.listener.upY,
|
|
this.listener.upZ
|
|
];
|
|
};
|
|
// /**
|
|
// * Getter and setter methods for orient coordinates
|
|
// * @return {Number} [updated coordinate value]
|
|
// */
|
|
p5.Listener3D.prototype.forwardX = function (xVal, time) {
|
|
var t = time || 0;
|
|
if (typeof xVal === 'number') {
|
|
this.listener.forwardX.value = xVal;
|
|
this.listener.forwardX.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.listener.forwardX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (xVal) {
|
|
xVal.connect(this.listener.forwardX);
|
|
}
|
|
return this.listener.forwardX.value;
|
|
};
|
|
p5.Listener3D.prototype.forwardY = function (yVal, time) {
|
|
var t = time || 0;
|
|
if (typeof yVal === 'number') {
|
|
this.listener.forwardY.value = yVal;
|
|
this.listener.forwardY.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.listener.forwardY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (yVal) {
|
|
yVal.connect(this.listener.forwardY);
|
|
}
|
|
return this.listener.forwardY.value;
|
|
};
|
|
p5.Listener3D.prototype.forwardZ = function (zVal, time) {
|
|
var t = time || 0;
|
|
if (typeof zVal === 'number') {
|
|
this.listener.forwardZ.value = zVal;
|
|
this.listener.forwardZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.listener.forwardZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (zVal) {
|
|
zVal.connect(this.listener.forwardZ);
|
|
}
|
|
return this.listener.forwardZ.value;
|
|
};
|
|
p5.Listener3D.prototype.upX = function (xVal, time) {
|
|
var t = time || 0;
|
|
if (typeof xVal === 'number') {
|
|
this.listener.upX.value = xVal;
|
|
this.listener.upX.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.listener.upX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (xVal) {
|
|
xVal.connect(this.listener.upX);
|
|
}
|
|
return this.listener.upX.value;
|
|
};
|
|
p5.Listener3D.prototype.upY = function (yVal, time) {
|
|
var t = time || 0;
|
|
if (typeof yVal === 'number') {
|
|
this.listener.upY.value = yVal;
|
|
this.listener.upY.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.listener.upY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (yVal) {
|
|
yVal.connect(this.listener.upY);
|
|
}
|
|
return this.listener.upY.value;
|
|
};
|
|
p5.Listener3D.prototype.upZ = function (zVal, time) {
|
|
var t = time || 0;
|
|
if (typeof zVal === 'number') {
|
|
this.listener.upZ.value = zVal;
|
|
this.listener.upZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.listener.upZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t);
|
|
} else if (zVal) {
|
|
zVal.connect(this.listener.upZ);
|
|
}
|
|
return this.listener.upZ.value;
|
|
};
|
|
return p5.Listener3D;
|
|
}(master, effect);
|
|
var delay;
|
|
'use strict';
|
|
delay = function () {
|
|
var Filter = filter;
|
|
var Effect = effect;
|
|
/**
|
|
* Delay is an echo effect. It processes an existing sound source,
|
|
* and outputs a delayed version of that sound. The p5.Delay can
|
|
* produce different effects depending on the delayTime, feedback,
|
|
* filter, and type. In the example below, a feedback of 0.5 (the
|
|
* defaul value) will produce a looping delay that decreases in
|
|
* volume by 50% each repeat. A filter will cut out the high
|
|
* frequencies so that the delay does not sound as piercing as the
|
|
* original source.
|
|
*
|
|
*
|
|
* This class extends <a href = "/reference/#/p5.Effect">p5.Effect</a>.
|
|
* Methods <a href = "/reference/#/p5.Effect/amp">amp()</a>, <a href = "/reference/#/p5.Effect/chain">chain()</a>,
|
|
* <a href = "/reference/#/p5.Effect/drywet">drywet()</a>, <a href = "/reference/#/p5.Effect/connect">connect()</a>, and
|
|
* <a href = "/reference/#/p5.Effect/disconnect">disconnect()</a> are available.
|
|
* @class p5.Delay
|
|
* @extends p5.Effect
|
|
* @constructor
|
|
* @example
|
|
* <div><code>
|
|
* var noise, env, delay;
|
|
*
|
|
* function setup() {
|
|
* background(0);
|
|
* noStroke();
|
|
* fill(255);
|
|
* textAlign(CENTER);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* noise = new p5.Noise('brown');
|
|
* noise.amp(0);
|
|
* noise.start();
|
|
*
|
|
* delay = new p5.Delay();
|
|
*
|
|
* // delay.process() accepts 4 parameters:
|
|
* // source, delayTime, feedback, filter frequency
|
|
* // play with these numbers!!
|
|
* delay.process(noise, .12, .7, 2300);
|
|
*
|
|
* // play the noise with an envelope,
|
|
* // a series of fades ( time / value pairs )
|
|
* env = new p5.Env(.01, 0.2, .2, .1);
|
|
* }
|
|
*
|
|
* // mouseClick triggers envelope
|
|
* function mouseClicked() {
|
|
* // is mouse over canvas?
|
|
* if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {
|
|
* env.play(noise);
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Delay = function () {
|
|
Effect.call(this);
|
|
this._split = this.ac.createChannelSplitter(2);
|
|
this._merge = this.ac.createChannelMerger(2);
|
|
this._leftGain = this.ac.createGain();
|
|
this._rightGain = this.ac.createGain();
|
|
/**
|
|
* The p5.Delay is built with two
|
|
* <a href="http://www.w3.org/TR/webaudio/#DelayNode">
|
|
* Web Audio Delay Nodes</a>, one for each stereo channel.
|
|
*
|
|
* @property {DelayNode} leftDelay
|
|
*/
|
|
this.leftDelay = this.ac.createDelay();
|
|
/**
|
|
* The p5.Delay is built with two
|
|
* <a href="http://www.w3.org/TR/webaudio/#DelayNode">
|
|
* Web Audio Delay Nodes</a>, one for each stereo channel.
|
|
*
|
|
* @property {DelayNode} rightDelay
|
|
*/
|
|
this.rightDelay = this.ac.createDelay();
|
|
this._leftFilter = new Filter();
|
|
this._rightFilter = new Filter();
|
|
this._leftFilter.disconnect();
|
|
this._rightFilter.disconnect();
|
|
this._leftFilter.biquad.frequency.setValueAtTime(1200, this.ac.currentTime);
|
|
this._rightFilter.biquad.frequency.setValueAtTime(1200, this.ac.currentTime);
|
|
this._leftFilter.biquad.Q.setValueAtTime(0.3, this.ac.currentTime);
|
|
this._rightFilter.biquad.Q.setValueAtTime(0.3, this.ac.currentTime);
|
|
// graph routing
|
|
this.input.connect(this._split);
|
|
this.leftDelay.connect(this._leftGain);
|
|
this.rightDelay.connect(this._rightGain);
|
|
this._leftGain.connect(this._leftFilter.input);
|
|
this._rightGain.connect(this._rightFilter.input);
|
|
this._merge.connect(this.wet);
|
|
this._leftFilter.biquad.gain.setValueAtTime(1, this.ac.currentTime);
|
|
this._rightFilter.biquad.gain.setValueAtTime(1, this.ac.currentTime);
|
|
// default routing
|
|
this.setType(0);
|
|
this._maxDelay = this.leftDelay.delayTime.maxValue;
|
|
// set initial feedback to 0.5
|
|
this.feedback(0.5);
|
|
};
|
|
p5.Delay.prototype = Object.create(Effect.prototype);
|
|
/**
|
|
* Add delay to an audio signal according to a set
|
|
* of delay parameters.
|
|
*
|
|
* @method process
|
|
* @param {Object} Signal An object that outputs audio
|
|
* @param {Number} [delayTime] Time (in seconds) of the delay/echo.
|
|
* Some browsers limit delayTime to
|
|
* 1 second.
|
|
* @param {Number} [feedback] sends the delay back through itself
|
|
* in a loop that decreases in volume
|
|
* each time.
|
|
* @param {Number} [lowPass] Cutoff frequency. Only frequencies
|
|
* below the lowPass will be part of the
|
|
* delay.
|
|
*/
|
|
p5.Delay.prototype.process = function (src, _delayTime, _feedback, _filter) {
|
|
var feedback = _feedback || 0;
|
|
var delayTime = _delayTime || 0;
|
|
if (feedback >= 1) {
|
|
throw new Error('Feedback value will force a positive feedback loop.');
|
|
}
|
|
if (delayTime >= this._maxDelay) {
|
|
throw new Error('Delay Time exceeds maximum delay time of ' + this._maxDelay + ' second.');
|
|
}
|
|
src.connect(this.input);
|
|
this.leftDelay.delayTime.setValueAtTime(delayTime, this.ac.currentTime);
|
|
this.rightDelay.delayTime.setValueAtTime(delayTime, this.ac.currentTime);
|
|
this._leftGain.gain.value = feedback;
|
|
this._rightGain.gain.value = feedback;
|
|
if (_filter) {
|
|
this._leftFilter.freq(_filter);
|
|
this._rightFilter.freq(_filter);
|
|
}
|
|
};
|
|
/**
|
|
* Set the delay (echo) time, in seconds. Usually this value will be
|
|
* a floating point number between 0.0 and 1.0.
|
|
*
|
|
* @method delayTime
|
|
* @param {Number} delayTime Time (in seconds) of the delay
|
|
*/
|
|
p5.Delay.prototype.delayTime = function (t) {
|
|
// if t is an audio node...
|
|
if (typeof t !== 'number') {
|
|
t.connect(this.leftDelay.delayTime);
|
|
t.connect(this.rightDelay.delayTime);
|
|
} else {
|
|
this.leftDelay.delayTime.cancelScheduledValues(this.ac.currentTime);
|
|
this.rightDelay.delayTime.cancelScheduledValues(this.ac.currentTime);
|
|
this.leftDelay.delayTime.linearRampToValueAtTime(t, this.ac.currentTime);
|
|
this.rightDelay.delayTime.linearRampToValueAtTime(t, this.ac.currentTime);
|
|
}
|
|
};
|
|
/**
|
|
* Feedback occurs when Delay sends its signal back through its input
|
|
* in a loop. The feedback amount determines how much signal to send each
|
|
* time through the loop. A feedback greater than 1.0 is not desirable because
|
|
* it will increase the overall output each time through the loop,
|
|
* creating an infinite feedback loop. The default value is 0.5
|
|
*
|
|
* @method feedback
|
|
* @param {Number|Object} feedback 0.0 to 1.0, or an object such as an
|
|
* Oscillator that can be used to
|
|
* modulate this param
|
|
* @returns {Number} Feedback value
|
|
*
|
|
*/
|
|
p5.Delay.prototype.feedback = function (f) {
|
|
// if f is an audio node...
|
|
if (f && typeof f !== 'number') {
|
|
f.connect(this._leftGain.gain);
|
|
f.connect(this._rightGain.gain);
|
|
} else if (f >= 1) {
|
|
throw new Error('Feedback value will force a positive feedback loop.');
|
|
} else if (typeof f === 'number') {
|
|
this._leftGain.gain.value = f;
|
|
this._rightGain.gain.value = f;
|
|
}
|
|
// return value of feedback
|
|
return this._leftGain.gain.value;
|
|
};
|
|
/**
|
|
* Set a lowpass filter frequency for the delay. A lowpass filter
|
|
* will cut off any frequencies higher than the filter frequency.
|
|
*
|
|
* @method filter
|
|
* @param {Number|Object} cutoffFreq A lowpass filter will cut off any
|
|
* frequencies higher than the filter frequency.
|
|
* @param {Number|Object} res Resonance of the filter frequency
|
|
* cutoff, or an object (i.e. a p5.Oscillator)
|
|
* that can be used to modulate this parameter.
|
|
* High numbers (i.e. 15) will produce a resonance,
|
|
* low numbers (i.e. .2) will produce a slope.
|
|
*/
|
|
p5.Delay.prototype.filter = function (freq, q) {
|
|
this._leftFilter.set(freq, q);
|
|
this._rightFilter.set(freq, q);
|
|
};
|
|
/**
|
|
* Choose a preset type of delay. 'pingPong' bounces the signal
|
|
* from the left to the right channel to produce a stereo effect.
|
|
* Any other parameter will revert to the default delay setting.
|
|
*
|
|
* @method setType
|
|
* @param {String|Number} type 'pingPong' (1) or 'default' (0)
|
|
*/
|
|
p5.Delay.prototype.setType = function (t) {
|
|
if (t === 1) {
|
|
t = 'pingPong';
|
|
}
|
|
this._split.disconnect();
|
|
this._leftFilter.disconnect();
|
|
this._rightFilter.disconnect();
|
|
this._split.connect(this.leftDelay, 0);
|
|
this._split.connect(this.rightDelay, 1);
|
|
switch (t) {
|
|
case 'pingPong':
|
|
this._rightFilter.setType(this._leftFilter.biquad.type);
|
|
this._leftFilter.output.connect(this._merge, 0, 0);
|
|
this._rightFilter.output.connect(this._merge, 0, 1);
|
|
this._leftFilter.output.connect(this.rightDelay);
|
|
this._rightFilter.output.connect(this.leftDelay);
|
|
break;
|
|
default:
|
|
this._leftFilter.output.connect(this._merge, 0, 0);
|
|
this._rightFilter.output.connect(this._merge, 0, 1);
|
|
this._leftFilter.output.connect(this.leftDelay);
|
|
this._rightFilter.output.connect(this.rightDelay);
|
|
}
|
|
};
|
|
// DocBlocks for methods inherited from p5.Effect
|
|
/**
|
|
* Set the output level of the delay effect.
|
|
*
|
|
* @method amp
|
|
* @param {Number} volume amplitude between 0 and 1.0
|
|
* @param {Number} [rampTime] create a fade that lasts rampTime
|
|
* @param {Number} [timeFromNow] schedule this event to happen
|
|
* seconds from now
|
|
*/
|
|
/**
|
|
* Send output to a p5.sound or web audio object
|
|
*
|
|
* @method connect
|
|
* @param {Object} unit
|
|
*/
|
|
/**
|
|
* Disconnect all output.
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
p5.Delay.prototype.dispose = function () {
|
|
Effect.prototype.dispose.apply(this);
|
|
this._split.disconnect();
|
|
this._leftFilter.dispose();
|
|
this._rightFilter.dispose();
|
|
this._merge.disconnect();
|
|
this._leftGain.disconnect();
|
|
this._rightGain.disconnect();
|
|
this.leftDelay.disconnect();
|
|
this.rightDelay.disconnect();
|
|
this._split = undefined;
|
|
this._leftFilter = undefined;
|
|
this._rightFilter = undefined;
|
|
this._merge = undefined;
|
|
this._leftGain = undefined;
|
|
this._rightGain = undefined;
|
|
this.leftDelay = undefined;
|
|
this.rightDelay = undefined;
|
|
};
|
|
}(filter, effect);
|
|
var reverb;
|
|
'use strict';
|
|
reverb = function () {
|
|
var CustomError = errorHandler;
|
|
var Effect = effect;
|
|
/**
|
|
* Reverb adds depth to a sound through a large number of decaying
|
|
* echoes. It creates the perception that sound is occurring in a
|
|
* physical space. The p5.Reverb has paramters for Time (how long does the
|
|
* reverb last) and decayRate (how much the sound decays with each echo)
|
|
* that can be set with the .set() or .process() methods. The p5.Convolver
|
|
* extends p5.Reverb allowing you to recreate the sound of actual physical
|
|
* spaces through convolution.
|
|
*
|
|
* This class extends <a href = "/reference/#/p5.Effect">p5.Effect</a>.
|
|
* Methods <a href = "/reference/#/p5.Effect/amp">amp()</a>, <a href = "/reference/#/p5.Effect/chain">chain()</a>,
|
|
* <a href = "/reference/#/p5.Effect/drywet">drywet()</a>, <a href = "/reference/#/p5.Effect/connect">connect()</a>, and
|
|
* <a href = "/reference/#/p5.Effect/disconnect">disconnect()</a> are available.
|
|
*
|
|
* @class p5.Reverb
|
|
* @extends p5.Effect
|
|
* @constructor
|
|
* @example
|
|
* <div><code>
|
|
* var soundFile, reverb;
|
|
* function preload() {
|
|
* soundFile = loadSound('assets/Damscray_DancingTiger.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* reverb = new p5.Reverb();
|
|
* soundFile.disconnect(); // so we'll only hear reverb...
|
|
*
|
|
* // connect soundFile to reverb, process w/
|
|
* // 3 second reverbTime, decayRate of 2%
|
|
* reverb.process(soundFile, 3, 2);
|
|
* soundFile.play();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Reverb = function () {
|
|
Effect.call(this);
|
|
this.convolverNode = this.ac.createConvolver();
|
|
// otherwise, Safari distorts
|
|
this.input.gain.value = 0.5;
|
|
this.input.connect(this.convolverNode);
|
|
this.convolverNode.connect(this.wet);
|
|
// default params
|
|
this._seconds = 3;
|
|
this._decay = 2;
|
|
this._reverse = false;
|
|
this._buildImpulse();
|
|
};
|
|
p5.Reverb.prototype = Object.create(Effect.prototype);
|
|
/**
|
|
* Connect a source to the reverb, and assign reverb parameters.
|
|
*
|
|
* @method process
|
|
* @param {Object} src p5.sound / Web Audio object with a sound
|
|
* output.
|
|
* @param {Number} [seconds] Duration of the reverb, in seconds.
|
|
* Min: 0, Max: 10. Defaults to 3.
|
|
* @param {Number} [decayRate] Percentage of decay with each echo.
|
|
* Min: 0, Max: 100. Defaults to 2.
|
|
* @param {Boolean} [reverse] Play the reverb backwards or forwards.
|
|
*/
|
|
p5.Reverb.prototype.process = function (src, seconds, decayRate, reverse) {
|
|
src.connect(this.input);
|
|
var rebuild = false;
|
|
if (seconds) {
|
|
this._seconds = seconds;
|
|
rebuild = true;
|
|
}
|
|
if (decayRate) {
|
|
this._decay = decayRate;
|
|
}
|
|
if (reverse) {
|
|
this._reverse = reverse;
|
|
}
|
|
if (rebuild) {
|
|
this._buildImpulse();
|
|
}
|
|
};
|
|
/**
|
|
* Set the reverb settings. Similar to .process(), but without
|
|
* assigning a new input.
|
|
*
|
|
* @method set
|
|
* @param {Number} [seconds] Duration of the reverb, in seconds.
|
|
* Min: 0, Max: 10. Defaults to 3.
|
|
* @param {Number} [decayRate] Percentage of decay with each echo.
|
|
* Min: 0, Max: 100. Defaults to 2.
|
|
* @param {Boolean} [reverse] Play the reverb backwards or forwards.
|
|
*/
|
|
p5.Reverb.prototype.set = function (seconds, decayRate, reverse) {
|
|
var rebuild = false;
|
|
if (seconds) {
|
|
this._seconds = seconds;
|
|
rebuild = true;
|
|
}
|
|
if (decayRate) {
|
|
this._decay = decayRate;
|
|
}
|
|
if (reverse) {
|
|
this._reverse = reverse;
|
|
}
|
|
if (rebuild) {
|
|
this._buildImpulse();
|
|
}
|
|
};
|
|
// DocBlocks for methods inherited from p5.Effect
|
|
/**
|
|
* Set the output level of the reverb effect.
|
|
*
|
|
* @method amp
|
|
* @param {Number} volume amplitude between 0 and 1.0
|
|
* @param {Number} [rampTime] create a fade that lasts rampTime
|
|
* @param {Number} [timeFromNow] schedule this event to happen
|
|
* seconds from now
|
|
*/
|
|
/**
|
|
* Send output to a p5.sound or web audio object
|
|
*
|
|
* @method connect
|
|
* @param {Object} unit
|
|
*/
|
|
/**
|
|
* Disconnect all output.
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
/**
|
|
* Inspired by Simple Reverb by Jordan Santell
|
|
* https://github.com/web-audio-components/simple-reverb/blob/master/index.js
|
|
*
|
|
* Utility function for building an impulse response
|
|
* based on the module parameters.
|
|
*
|
|
* @private
|
|
*/
|
|
p5.Reverb.prototype._buildImpulse = function () {
|
|
var rate = this.ac.sampleRate;
|
|
var length = rate * this._seconds;
|
|
var decay = this._decay;
|
|
var impulse = this.ac.createBuffer(2, length, rate);
|
|
var impulseL = impulse.getChannelData(0);
|
|
var impulseR = impulse.getChannelData(1);
|
|
var n, i;
|
|
for (i = 0; i < length; i++) {
|
|
n = this._reverse ? length - i : i;
|
|
impulseL[i] = (Math.random() * 2 - 1) * Math.pow(1 - n / length, decay);
|
|
impulseR[i] = (Math.random() * 2 - 1) * Math.pow(1 - n / length, decay);
|
|
}
|
|
this.convolverNode.buffer = impulse;
|
|
};
|
|
p5.Reverb.prototype.dispose = function () {
|
|
Effect.prototype.dispose.apply(this);
|
|
if (this.convolverNode) {
|
|
this.convolverNode.buffer = null;
|
|
this.convolverNode = null;
|
|
}
|
|
};
|
|
// =======================================================================
|
|
// *** p5.Convolver ***
|
|
// =======================================================================
|
|
/**
|
|
* <p>p5.Convolver extends p5.Reverb. It can emulate the sound of real
|
|
* physical spaces through a process called <a href="
|
|
* https://en.wikipedia.org/wiki/Convolution_reverb#Real_space_simulation">
|
|
* convolution</a>.</p>
|
|
*
|
|
* <p>Convolution multiplies any audio input by an "impulse response"
|
|
* to simulate the dispersion of sound over time. The impulse response is
|
|
* generated from an audio file that you provide. One way to
|
|
* generate an impulse response is to pop a balloon in a reverberant space
|
|
* and record the echo. Convolution can also be used to experiment with
|
|
* sound.</p>
|
|
*
|
|
* <p>Use the method <code>createConvolution(path)</code> to instantiate a
|
|
* p5.Convolver with a path to your impulse response audio file.</p>
|
|
*
|
|
* @class p5.Convolver
|
|
* @extends p5.Effect
|
|
* @constructor
|
|
* @param {String} path path to a sound file
|
|
* @param {Function} [callback] function to call when loading succeeds
|
|
* @param {Function} [errorCallback] function to call if loading fails.
|
|
* This function will receive an error or
|
|
* XMLHttpRequest object with information
|
|
* about what went wrong.
|
|
* @example
|
|
* <div><code>
|
|
* var cVerb, sound;
|
|
* function preload() {
|
|
* // We have both MP3 and OGG versions of all sound assets
|
|
* soundFormats('ogg', 'mp3');
|
|
*
|
|
* // Try replacing 'bx-spring' with other soundfiles like
|
|
* // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox'
|
|
* cVerb = createConvolver('assets/bx-spring.mp3');
|
|
*
|
|
* // Try replacing 'Damscray_DancingTiger' with
|
|
* // 'beat', 'doorbell', lucky_dragons'
|
|
* sound = loadSound('assets/Damscray_DancingTiger.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* // disconnect from master output...
|
|
* sound.disconnect();
|
|
*
|
|
* // ...and process with cVerb
|
|
* // so that we only hear the convolution
|
|
* cVerb.process(sound);
|
|
*
|
|
* sound.play();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Convolver = function (path, callback, errorCallback) {
|
|
Effect.call(this);
|
|
/**
|
|
* Internally, the p5.Convolver uses the a
|
|
* <a href="http://www.w3.org/TR/webaudio/#ConvolverNode">
|
|
* Web Audio Convolver Node</a>.
|
|
*
|
|
* @property {ConvolverNode} convolverNod
|
|
*/
|
|
this.convolverNode = this.ac.createConvolver();
|
|
// otherwise, Safari distorts
|
|
this.input.gain.value = 0.5;
|
|
this.input.connect(this.convolverNode);
|
|
this.convolverNode.connect(this.wet);
|
|
if (path) {
|
|
this.impulses = [];
|
|
this._loadBuffer(path, callback, errorCallback);
|
|
} else {
|
|
// parameters
|
|
this._seconds = 3;
|
|
this._decay = 2;
|
|
this._reverse = false;
|
|
this._buildImpulse();
|
|
}
|
|
};
|
|
p5.Convolver.prototype = Object.create(p5.Reverb.prototype);
|
|
p5.prototype.registerPreloadMethod('createConvolver', p5.prototype);
|
|
/**
|
|
* Create a p5.Convolver. Accepts a path to a soundfile
|
|
* that will be used to generate an impulse response.
|
|
*
|
|
* @method createConvolver
|
|
* @param {String} path path to a sound file
|
|
* @param {Function} [callback] function to call if loading is successful.
|
|
* The object will be passed in as the argument
|
|
* to the callback function.
|
|
* @param {Function} [errorCallback] function to call if loading is not successful.
|
|
* A custom error will be passed in as the argument
|
|
* to the callback function.
|
|
* @return {p5.Convolver}
|
|
* @example
|
|
* <div><code>
|
|
* var cVerb, sound;
|
|
* function preload() {
|
|
* // We have both MP3 and OGG versions of all sound assets
|
|
* soundFormats('ogg', 'mp3');
|
|
*
|
|
* // Try replacing 'bx-spring' with other soundfiles like
|
|
* // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox'
|
|
* cVerb = createConvolver('assets/bx-spring.mp3');
|
|
*
|
|
* // Try replacing 'Damscray_DancingTiger' with
|
|
* // 'beat', 'doorbell', lucky_dragons'
|
|
* sound = loadSound('assets/Damscray_DancingTiger.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* // disconnect from master output...
|
|
* sound.disconnect();
|
|
*
|
|
* // ...and process with cVerb
|
|
* // so that we only hear the convolution
|
|
* cVerb.process(sound);
|
|
*
|
|
* sound.play();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.prototype.createConvolver = function (path, callback, errorCallback) {
|
|
// if loading locally without a server
|
|
if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') {
|
|
alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS');
|
|
}
|
|
var cReverb = new p5.Convolver(path, callback, errorCallback);
|
|
cReverb.impulses = [];
|
|
return cReverb;
|
|
};
|
|
/**
|
|
* Private method to load a buffer as an Impulse Response,
|
|
* assign it to the convolverNode, and add to the Array of .impulses.
|
|
*
|
|
* @param {String} path
|
|
* @param {Function} callback
|
|
* @param {Function} errorCallback
|
|
* @private
|
|
*/
|
|
p5.Convolver.prototype._loadBuffer = function (path, callback, errorCallback) {
|
|
var path = p5.prototype._checkFileFormats(path);
|
|
var self = this;
|
|
var errorTrace = new Error().stack;
|
|
var ac = p5.prototype.getAudioContext();
|
|
var request = new XMLHttpRequest();
|
|
request.open('GET', path, true);
|
|
request.responseType = 'arraybuffer';
|
|
request.onload = function () {
|
|
if (request.status === 200) {
|
|
// on success loading file:
|
|
ac.decodeAudioData(request.response, function (buff) {
|
|
var buffer = {};
|
|
var chunks = path.split('/');
|
|
buffer.name = chunks[chunks.length - 1];
|
|
buffer.audioBuffer = buff;
|
|
self.impulses.push(buffer);
|
|
self.convolverNode.buffer = buffer.audioBuffer;
|
|
if (callback) {
|
|
callback(buffer);
|
|
}
|
|
}, // error decoding buffer. "e" is undefined in Chrome 11/22/2015
|
|
function () {
|
|
var err = new CustomError('decodeAudioData', errorTrace, self.url);
|
|
var msg = 'AudioContext error at decodeAudioData for ' + self.url;
|
|
if (errorCallback) {
|
|
err.msg = msg;
|
|
errorCallback(err);
|
|
} else {
|
|
console.error(msg + '\n The error stack trace includes: \n' + err.stack);
|
|
}
|
|
});
|
|
} else {
|
|
var err = new CustomError('loadConvolver', errorTrace, self.url);
|
|
var msg = 'Unable to load ' + self.url + '. The request status was: ' + request.status + ' (' + request.statusText + ')';
|
|
if (errorCallback) {
|
|
err.message = msg;
|
|
errorCallback(err);
|
|
} else {
|
|
console.error(msg + '\n The error stack trace includes: \n' + err.stack);
|
|
}
|
|
}
|
|
};
|
|
// if there is another error, aside from 404...
|
|
request.onerror = function () {
|
|
var err = new CustomError('loadConvolver', errorTrace, self.url);
|
|
var msg = 'There was no response from the server at ' + self.url + '. Check the url and internet connectivity.';
|
|
if (errorCallback) {
|
|
err.message = msg;
|
|
errorCallback(err);
|
|
} else {
|
|
console.error(msg + '\n The error stack trace includes: \n' + err.stack);
|
|
}
|
|
};
|
|
request.send();
|
|
};
|
|
p5.Convolver.prototype.set = null;
|
|
/**
|
|
* Connect a source to the reverb, and assign reverb parameters.
|
|
*
|
|
* @method process
|
|
* @param {Object} src p5.sound / Web Audio object with a sound
|
|
* output.
|
|
* @example
|
|
* <div><code>
|
|
* var cVerb, sound;
|
|
* function preload() {
|
|
* soundFormats('ogg', 'mp3');
|
|
*
|
|
* cVerb = createConvolver('assets/concrete-tunnel.mp3');
|
|
*
|
|
* sound = loadSound('assets/beat.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* // disconnect from master output...
|
|
* sound.disconnect();
|
|
*
|
|
* // ...and process with (i.e. connect to) cVerb
|
|
* // so that we only hear the convolution
|
|
* cVerb.process(sound);
|
|
*
|
|
* sound.play();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Convolver.prototype.process = function (src) {
|
|
src.connect(this.input);
|
|
};
|
|
/**
|
|
* If you load multiple impulse files using the .addImpulse method,
|
|
* they will be stored as Objects in this Array. Toggle between them
|
|
* with the <code>toggleImpulse(id)</code> method.
|
|
*
|
|
* @property {Array} impulses
|
|
*/
|
|
p5.Convolver.prototype.impulses = [];
|
|
/**
|
|
* Load and assign a new Impulse Response to the p5.Convolver.
|
|
* The impulse is added to the <code>.impulses</code> array. Previous
|
|
* impulses can be accessed with the <code>.toggleImpulse(id)</code>
|
|
* method.
|
|
*
|
|
* @method addImpulse
|
|
* @param {String} path path to a sound file
|
|
* @param {Function} callback function (optional)
|
|
* @param {Function} errorCallback function (optional)
|
|
*/
|
|
p5.Convolver.prototype.addImpulse = function (path, callback, errorCallback) {
|
|
// if loading locally without a server
|
|
if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') {
|
|
alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS');
|
|
}
|
|
this._loadBuffer(path, callback, errorCallback);
|
|
};
|
|
/**
|
|
* Similar to .addImpulse, except that the <code>.impulses</code>
|
|
* Array is reset to save memory. A new <code>.impulses</code>
|
|
* array is created with this impulse as the only item.
|
|
*
|
|
* @method resetImpulse
|
|
* @param {String} path path to a sound file
|
|
* @param {Function} callback function (optional)
|
|
* @param {Function} errorCallback function (optional)
|
|
*/
|
|
p5.Convolver.prototype.resetImpulse = function (path, callback, errorCallback) {
|
|
// if loading locally without a server
|
|
if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') {
|
|
alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS');
|
|
}
|
|
this.impulses = [];
|
|
this._loadBuffer(path, callback, errorCallback);
|
|
};
|
|
/**
|
|
* If you have used <code>.addImpulse()</code> to add multiple impulses
|
|
* to a p5.Convolver, then you can use this method to toggle between
|
|
* the items in the <code>.impulses</code> Array. Accepts a parameter
|
|
* to identify which impulse you wish to use, identified either by its
|
|
* original filename (String) or by its position in the <code>.impulses
|
|
* </code> Array (Number).<br/>
|
|
* You can access the objects in the .impulses Array directly. Each
|
|
* Object has two attributes: an <code>.audioBuffer</code> (type:
|
|
* Web Audio <a href="
|
|
* http://webaudio.github.io/web-audio-api/#the-audiobuffer-interface">
|
|
* AudioBuffer)</a> and a <code>.name</code>, a String that corresponds
|
|
* with the original filename.
|
|
*
|
|
* @method toggleImpulse
|
|
* @param {String|Number} id Identify the impulse by its original filename
|
|
* (String), or by its position in the
|
|
* <code>.impulses</code> Array (Number).
|
|
*/
|
|
p5.Convolver.prototype.toggleImpulse = function (id) {
|
|
if (typeof id === 'number' && id < this.impulses.length) {
|
|
this.convolverNode.buffer = this.impulses[id].audioBuffer;
|
|
}
|
|
if (typeof id === 'string') {
|
|
for (var i = 0; i < this.impulses.length; i++) {
|
|
if (this.impulses[i].name === id) {
|
|
this.convolverNode.buffer = this.impulses[i].audioBuffer;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
};
|
|
p5.Convolver.prototype.dispose = function () {
|
|
Effect.prototype.dispose.apply(this);
|
|
// remove all the Impulse Response buffers
|
|
for (var i in this.impulses) {
|
|
if (this.impulses[i]) {
|
|
this.impulses[i] = null;
|
|
}
|
|
}
|
|
this.convolverNode.disconnect();
|
|
this.concolverNode = null;
|
|
};
|
|
}(errorHandler, effect, sndcore);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_core_TimelineState;
|
|
Tone_core_TimelineState = function (Tone) {
|
|
'use strict';
|
|
Tone.TimelineState = function (initial) {
|
|
Tone.Timeline.call(this);
|
|
this._initial = initial;
|
|
};
|
|
Tone.extend(Tone.TimelineState, Tone.Timeline);
|
|
Tone.TimelineState.prototype.getValueAtTime = function (time) {
|
|
var event = this.get(time);
|
|
if (event !== null) {
|
|
return event.state;
|
|
} else {
|
|
return this._initial;
|
|
}
|
|
};
|
|
Tone.TimelineState.prototype.setStateAtTime = function (state, time) {
|
|
this.add({
|
|
'state': state,
|
|
'time': time
|
|
});
|
|
};
|
|
return Tone.TimelineState;
|
|
}(Tone_core_Tone, Tone_core_Timeline);
|
|
/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/
|
|
var Tone_core_Clock;
|
|
Tone_core_Clock = function (Tone) {
|
|
'use strict';
|
|
Tone.Clock = function () {
|
|
Tone.Emitter.call(this);
|
|
var options = this.optionsObject(arguments, [
|
|
'callback',
|
|
'frequency'
|
|
], Tone.Clock.defaults);
|
|
this.callback = options.callback;
|
|
this._nextTick = 0;
|
|
this._lastState = Tone.State.Stopped;
|
|
this.frequency = new Tone.TimelineSignal(options.frequency, Tone.Type.Frequency);
|
|
this._readOnly('frequency');
|
|
this.ticks = 0;
|
|
this._state = new Tone.TimelineState(Tone.State.Stopped);
|
|
this._boundLoop = this._loop.bind(this);
|
|
this.context.on('tick', this._boundLoop);
|
|
};
|
|
Tone.extend(Tone.Clock, Tone.Emitter);
|
|
Tone.Clock.defaults = {
|
|
'callback': Tone.noOp,
|
|
'frequency': 1,
|
|
'lookAhead': 'auto'
|
|
};
|
|
Object.defineProperty(Tone.Clock.prototype, 'state', {
|
|
get: function () {
|
|
return this._state.getValueAtTime(this.now());
|
|
}
|
|
});
|
|
Tone.Clock.prototype.start = function (time, offset) {
|
|
time = this.toSeconds(time);
|
|
if (this._state.getValueAtTime(time) !== Tone.State.Started) {
|
|
this._state.add({
|
|
'state': Tone.State.Started,
|
|
'time': time,
|
|
'offset': offset
|
|
});
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Clock.prototype.stop = function (time) {
|
|
time = this.toSeconds(time);
|
|
this._state.cancel(time);
|
|
this._state.setStateAtTime(Tone.State.Stopped, time);
|
|
return this;
|
|
};
|
|
Tone.Clock.prototype.pause = function (time) {
|
|
time = this.toSeconds(time);
|
|
if (this._state.getValueAtTime(time) === Tone.State.Started) {
|
|
this._state.setStateAtTime(Tone.State.Paused, time);
|
|
}
|
|
return this;
|
|
};
|
|
Tone.Clock.prototype._loop = function () {
|
|
var now = this.now();
|
|
var lookAhead = this.context.lookAhead;
|
|
var updateInterval = this.context.updateInterval;
|
|
var lagCompensation = this.context.lag * 2;
|
|
var loopInterval = now + lookAhead + updateInterval + lagCompensation;
|
|
while (loopInterval > this._nextTick && this._state) {
|
|
var currentState = this._state.getValueAtTime(this._nextTick);
|
|
if (currentState !== this._lastState) {
|
|
this._lastState = currentState;
|
|
var event = this._state.get(this._nextTick);
|
|
if (currentState === Tone.State.Started) {
|
|
this._nextTick = event.time;
|
|
if (!this.isUndef(event.offset)) {
|
|
this.ticks = event.offset;
|
|
}
|
|
this.emit('start', event.time, this.ticks);
|
|
} else if (currentState === Tone.State.Stopped) {
|
|
this.ticks = 0;
|
|
this.emit('stop', event.time);
|
|
} else if (currentState === Tone.State.Paused) {
|
|
this.emit('pause', event.time);
|
|
}
|
|
}
|
|
var tickTime = this._nextTick;
|
|
if (this.frequency) {
|
|
this._nextTick += 1 / this.frequency.getValueAtTime(this._nextTick);
|
|
if (currentState === Tone.State.Started) {
|
|
this.callback(tickTime);
|
|
this.ticks++;
|
|
}
|
|
}
|
|
}
|
|
};
|
|
Tone.Clock.prototype.getStateAtTime = function (time) {
|
|
time = this.toSeconds(time);
|
|
return this._state.getValueAtTime(time);
|
|
};
|
|
Tone.Clock.prototype.dispose = function () {
|
|
Tone.Emitter.prototype.dispose.call(this);
|
|
this.context.off('tick', this._boundLoop);
|
|
this._writable('frequency');
|
|
this.frequency.dispose();
|
|
this.frequency = null;
|
|
this._boundLoop = null;
|
|
this._nextTick = Infinity;
|
|
this.callback = null;
|
|
this._state.dispose();
|
|
this._state = null;
|
|
};
|
|
return Tone.Clock;
|
|
}(Tone_core_Tone, Tone_signal_TimelineSignal, Tone_core_TimelineState, Tone_core_Emitter);
|
|
var metro;
|
|
'use strict';
|
|
metro = function () {
|
|
var p5sound = master;
|
|
// requires the Tone.js library's Clock (MIT license, Yotam Mann)
|
|
// https://github.com/TONEnoTONE/Tone.js/
|
|
var Clock = Tone_core_Clock;
|
|
p5.Metro = function () {
|
|
this.clock = new Clock({ 'callback': this.ontick.bind(this) });
|
|
this.syncedParts = [];
|
|
this.bpm = 120;
|
|
// gets overridden by p5.Part
|
|
this._init();
|
|
this.prevTick = 0;
|
|
this.tatumTime = 0;
|
|
this.tickCallback = function () {
|
|
};
|
|
};
|
|
p5.Metro.prototype.ontick = function (tickTime) {
|
|
var elapsedTime = tickTime - this.prevTick;
|
|
var secondsFromNow = tickTime - p5sound.audiocontext.currentTime;
|
|
if (elapsedTime - this.tatumTime <= -0.02) {
|
|
return;
|
|
} else {
|
|
// console.log('ok', this.syncedParts[0].phrases[0].name);
|
|
this.prevTick = tickTime;
|
|
// for all of the active things on the metro:
|
|
var self = this;
|
|
this.syncedParts.forEach(function (thisPart) {
|
|
if (!thisPart.isPlaying)
|
|
return;
|
|
thisPart.incrementStep(secondsFromNow);
|
|
// each synced source keeps track of its own beat number
|
|
thisPart.phrases.forEach(function (thisPhrase) {
|
|
var phraseArray = thisPhrase.sequence;
|
|
var bNum = self.metroTicks % phraseArray.length;
|
|
if (phraseArray[bNum] !== 0 && (self.metroTicks < phraseArray.length || !thisPhrase.looping)) {
|
|
thisPhrase.callback(secondsFromNow, phraseArray[bNum]);
|
|
}
|
|
});
|
|
});
|
|
this.metroTicks += 1;
|
|
this.tickCallback(secondsFromNow);
|
|
}
|
|
};
|
|
p5.Metro.prototype.setBPM = function (bpm, rampTime) {
|
|
var beatTime = 60 / (bpm * this.tatums);
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.tatumTime = beatTime;
|
|
var rampTime = rampTime || 0;
|
|
this.clock.frequency.setValueAtTime(this.clock.frequency.value, now);
|
|
this.clock.frequency.linearRampToValueAtTime(bpm, now + rampTime);
|
|
this.bpm = bpm;
|
|
};
|
|
p5.Metro.prototype.getBPM = function () {
|
|
return this.clock.getRate() / this.tatums * 60;
|
|
};
|
|
p5.Metro.prototype._init = function () {
|
|
this.metroTicks = 0;
|
|
};
|
|
// clear existing synced parts, add only this one
|
|
p5.Metro.prototype.resetSync = function (part) {
|
|
this.syncedParts = [part];
|
|
};
|
|
// push a new synced part to the array
|
|
p5.Metro.prototype.pushSync = function (part) {
|
|
this.syncedParts.push(part);
|
|
};
|
|
p5.Metro.prototype.start = function (timeFromNow) {
|
|
var t = timeFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.clock.start(now + t);
|
|
this.setBPM(this.bpm);
|
|
};
|
|
p5.Metro.prototype.stop = function (timeFromNow) {
|
|
var t = timeFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
this.clock.stop(now + t);
|
|
};
|
|
p5.Metro.prototype.beatLength = function (tatums) {
|
|
this.tatums = 1 / tatums / 4;
|
|
};
|
|
}(master, Tone_core_Clock);
|
|
var looper;
|
|
'use strict';
|
|
looper = function () {
|
|
var p5sound = master;
|
|
var BPM = 120;
|
|
/**
|
|
* Set the global tempo, in beats per minute, for all
|
|
* p5.Parts. This method will impact all active p5.Parts.
|
|
*
|
|
* @method setBPM
|
|
* @param {Number} BPM Beats Per Minute
|
|
* @param {Number} rampTime Seconds from now
|
|
*/
|
|
p5.prototype.setBPM = function (bpm, rampTime) {
|
|
BPM = bpm;
|
|
for (var i in p5sound.parts) {
|
|
if (p5sound.parts[i]) {
|
|
p5sound.parts[i].setBPM(bpm, rampTime);
|
|
}
|
|
}
|
|
};
|
|
/**
|
|
* <p>A phrase is a pattern of musical events over time, i.e.
|
|
* a series of notes and rests.</p>
|
|
*
|
|
* <p>Phrases must be added to a p5.Part for playback, and
|
|
* each part can play multiple phrases at the same time.
|
|
* For example, one Phrase might be a kick drum, another
|
|
* could be a snare, and another could be the bassline.</p>
|
|
*
|
|
* <p>The first parameter is a name so that the phrase can be
|
|
* modified or deleted later. The callback is a a function that
|
|
* this phrase will call at every step—for example it might be
|
|
* called <code>playNote(value){}</code>. The array determines
|
|
* which value is passed into the callback at each step of the
|
|
* phrase. It can be numbers, an object with multiple numbers,
|
|
* or a zero (0) indicates a rest so the callback won't be called).</p>
|
|
*
|
|
* @class p5.Phrase
|
|
* @constructor
|
|
* @param {String} name Name so that you can access the Phrase.
|
|
* @param {Function} callback The name of a function that this phrase
|
|
* will call. Typically it will play a sound,
|
|
* and accept two parameters: a time at which
|
|
* to play the sound (in seconds from now),
|
|
* and a value from the sequence array. The
|
|
* time should be passed into the play() or
|
|
* start() method to ensure precision.
|
|
* @param {Array} sequence Array of values to pass into the callback
|
|
* at each step of the phrase.
|
|
* @example
|
|
* <div><code>
|
|
* var mySound, myPhrase, myPart;
|
|
* var pattern = [1,0,0,2,0,2,0,0];
|
|
* var msg = 'click to play';
|
|
*
|
|
* function preload() {
|
|
* mySound = loadSound('assets/beatbox.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* noStroke();
|
|
* fill(255);
|
|
* textAlign(CENTER);
|
|
* masterVolume(0.1);
|
|
*
|
|
* myPhrase = new p5.Phrase('bbox', makeSound, pattern);
|
|
* myPart = new p5.Part();
|
|
* myPart.addPhrase(myPhrase);
|
|
* myPart.setBPM(60);
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(0);
|
|
* text(msg, width/2, height/2);
|
|
* }
|
|
*
|
|
* function makeSound(time, playbackRate) {
|
|
* mySound.rate(playbackRate);
|
|
* mySound.play(time);
|
|
* }
|
|
*
|
|
* function mouseClicked() {
|
|
* if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {
|
|
* myPart.start();
|
|
* msg = 'playing pattern';
|
|
* }
|
|
* }
|
|
*
|
|
* </code></div>
|
|
*/
|
|
p5.Phrase = function (name, callback, sequence) {
|
|
this.phraseStep = 0;
|
|
this.name = name;
|
|
this.callback = callback;
|
|
/**
|
|
* Array of values to pass into the callback
|
|
* at each step of the phrase. Depending on the callback
|
|
* function's requirements, these values may be numbers,
|
|
* strings, or an object with multiple parameters.
|
|
* Zero (0) indicates a rest.
|
|
*
|
|
* @property {Array} sequence
|
|
*/
|
|
this.sequence = sequence;
|
|
};
|
|
/**
|
|
* <p>A p5.Part plays back one or more p5.Phrases. Instantiate a part
|
|
* with steps and tatums. By default, each step represents 1/16th note.</p>
|
|
*
|
|
* <p>See p5.Phrase for more about musical timing.</p>
|
|
*
|
|
* @class p5.Part
|
|
* @constructor
|
|
* @param {Number} [steps] Steps in the part
|
|
* @param {Number} [tatums] Divisions of a beat (default is 1/16, a quarter note)
|
|
* @example
|
|
* <div><code>
|
|
* var box, drum, myPart;
|
|
* var boxPat = [1,0,0,2,0,2,0,0];
|
|
* var drumPat = [0,1,1,0,2,0,1,0];
|
|
* var msg = 'click to play';
|
|
*
|
|
* function preload() {
|
|
* box = loadSound('assets/beatbox.mp3');
|
|
* drum = loadSound('assets/drum.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* noStroke();
|
|
* fill(255);
|
|
* textAlign(CENTER);
|
|
* masterVolume(0.1);
|
|
*
|
|
* var boxPhrase = new p5.Phrase('box', playBox, boxPat);
|
|
* var drumPhrase = new p5.Phrase('drum', playDrum, drumPat);
|
|
* myPart = new p5.Part();
|
|
* myPart.addPhrase(boxPhrase);
|
|
* myPart.addPhrase(drumPhrase);
|
|
* myPart.setBPM(60);
|
|
* masterVolume(0.1);
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(0);
|
|
* text(msg, width/2, height/2);
|
|
* }
|
|
*
|
|
* function playBox(time, playbackRate) {
|
|
* box.rate(playbackRate);
|
|
* box.play(time);
|
|
* }
|
|
*
|
|
* function playDrum(time, playbackRate) {
|
|
* drum.rate(playbackRate);
|
|
* drum.play(time);
|
|
* }
|
|
*
|
|
* function mouseClicked() {
|
|
* if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {
|
|
* myPart.start();
|
|
* msg = 'playing part';
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.Part = function (steps, bLength) {
|
|
this.length = steps || 0;
|
|
// how many beats
|
|
this.partStep = 0;
|
|
this.phrases = [];
|
|
this.isPlaying = false;
|
|
this.noLoop();
|
|
this.tatums = bLength || 0.0625;
|
|
// defaults to quarter note
|
|
this.metro = new p5.Metro();
|
|
this.metro._init();
|
|
this.metro.beatLength(this.tatums);
|
|
this.metro.setBPM(BPM);
|
|
p5sound.parts.push(this);
|
|
this.callback = function () {
|
|
};
|
|
};
|
|
/**
|
|
* Set the tempo of this part, in Beats Per Minute.
|
|
*
|
|
* @method setBPM
|
|
* @param {Number} BPM Beats Per Minute
|
|
* @param {Number} [rampTime] Seconds from now
|
|
*/
|
|
p5.Part.prototype.setBPM = function (tempo, rampTime) {
|
|
this.metro.setBPM(tempo, rampTime);
|
|
};
|
|
/**
|
|
* Returns the Beats Per Minute of this currently part.
|
|
*
|
|
* @method getBPM
|
|
* @return {Number}
|
|
*/
|
|
p5.Part.prototype.getBPM = function () {
|
|
return this.metro.getBPM();
|
|
};
|
|
/**
|
|
* Start playback of this part. It will play
|
|
* through all of its phrases at a speed
|
|
* determined by setBPM.
|
|
*
|
|
* @method start
|
|
* @param {Number} [time] seconds from now
|
|
*/
|
|
p5.Part.prototype.start = function (time) {
|
|
if (!this.isPlaying) {
|
|
this.isPlaying = true;
|
|
this.metro.resetSync(this);
|
|
var t = time || 0;
|
|
this.metro.start(t);
|
|
}
|
|
};
|
|
/**
|
|
* Loop playback of this part. It will begin
|
|
* looping through all of its phrases at a speed
|
|
* determined by setBPM.
|
|
*
|
|
* @method loop
|
|
* @param {Number} [time] seconds from now
|
|
*/
|
|
p5.Part.prototype.loop = function (time) {
|
|
this.looping = true;
|
|
// rest onended function
|
|
this.onended = function () {
|
|
this.partStep = 0;
|
|
};
|
|
var t = time || 0;
|
|
this.start(t);
|
|
};
|
|
/**
|
|
* Tell the part to stop looping.
|
|
*
|
|
* @method noLoop
|
|
*/
|
|
p5.Part.prototype.noLoop = function () {
|
|
this.looping = false;
|
|
// rest onended function
|
|
this.onended = function () {
|
|
this.stop();
|
|
};
|
|
};
|
|
/**
|
|
* Stop the part and cue it to step 0.
|
|
*
|
|
* @method stop
|
|
* @param {Number} [time] seconds from now
|
|
*/
|
|
p5.Part.prototype.stop = function (time) {
|
|
this.partStep = 0;
|
|
this.pause(time);
|
|
};
|
|
/**
|
|
* Pause the part. Playback will resume
|
|
* from the current step.
|
|
*
|
|
* @method pause
|
|
* @param {Number} time seconds from now
|
|
*/
|
|
p5.Part.prototype.pause = function (time) {
|
|
this.isPlaying = false;
|
|
var t = time || 0;
|
|
this.metro.stop(t);
|
|
};
|
|
/**
|
|
* Add a p5.Phrase to this Part.
|
|
*
|
|
* @method addPhrase
|
|
* @param {p5.Phrase} phrase reference to a p5.Phrase
|
|
*/
|
|
p5.Part.prototype.addPhrase = function (name, callback, array) {
|
|
var p;
|
|
if (arguments.length === 3) {
|
|
p = new p5.Phrase(name, callback, array);
|
|
} else if (arguments[0] instanceof p5.Phrase) {
|
|
p = arguments[0];
|
|
} else {
|
|
throw 'invalid input. addPhrase accepts name, callback, array or a p5.Phrase';
|
|
}
|
|
this.phrases.push(p);
|
|
// reset the length if phrase is longer than part's existing length
|
|
if (p.sequence.length > this.length) {
|
|
this.length = p.sequence.length;
|
|
}
|
|
};
|
|
/**
|
|
* Remove a phrase from this part, based on the name it was
|
|
* given when it was created.
|
|
*
|
|
* @method removePhrase
|
|
* @param {String} phraseName
|
|
*/
|
|
p5.Part.prototype.removePhrase = function (name) {
|
|
for (var i in this.phrases) {
|
|
if (this.phrases[i].name === name) {
|
|
this.phrases.splice(i, 1);
|
|
}
|
|
}
|
|
};
|
|
/**
|
|
* Get a phrase from this part, based on the name it was
|
|
* given when it was created. Now you can modify its array.
|
|
*
|
|
* @method getPhrase
|
|
* @param {String} phraseName
|
|
*/
|
|
p5.Part.prototype.getPhrase = function (name) {
|
|
for (var i in this.phrases) {
|
|
if (this.phrases[i].name === name) {
|
|
return this.phrases[i];
|
|
}
|
|
}
|
|
};
|
|
/**
|
|
* Get a phrase from this part, based on the name it was
|
|
* given when it was created. Now you can modify its array.
|
|
*
|
|
* @method replaceSequence
|
|
* @param {String} phraseName
|
|
* @param {Array} sequence Array of values to pass into the callback
|
|
* at each step of the phrase.
|
|
*/
|
|
p5.Part.prototype.replaceSequence = function (name, array) {
|
|
for (var i in this.phrases) {
|
|
if (this.phrases[i].name === name) {
|
|
this.phrases[i].sequence = array;
|
|
}
|
|
}
|
|
};
|
|
p5.Part.prototype.incrementStep = function (time) {
|
|
if (this.partStep < this.length - 1) {
|
|
this.callback(time);
|
|
this.partStep += 1;
|
|
} else {
|
|
if (!this.looping && this.partStep === this.length - 1) {
|
|
console.log('done');
|
|
// this.callback(time);
|
|
this.onended();
|
|
}
|
|
}
|
|
};
|
|
/**
|
|
* Fire a callback function at every step.
|
|
*
|
|
* @method onStep
|
|
* @param {Function} callback The name of the callback
|
|
* you want to fire
|
|
* on every beat/tatum.
|
|
*/
|
|
p5.Part.prototype.onStep = function (callback) {
|
|
this.callback = callback;
|
|
};
|
|
// ===============
|
|
// p5.Score
|
|
// ===============
|
|
/**
|
|
* A Score consists of a series of Parts. The parts will
|
|
* be played back in order. For example, you could have an
|
|
* A part, a B part, and a C part, and play them back in this order
|
|
* <code>new p5.Score(a, a, b, a, c)</code>
|
|
*
|
|
* @class p5.Score
|
|
* @constructor
|
|
* @param {p5.Part} [...parts] One or multiple parts, to be played in sequence.
|
|
*/
|
|
p5.Score = function () {
|
|
// for all of the arguments
|
|
this.parts = [];
|
|
this.currentPart = 0;
|
|
var thisScore = this;
|
|
for (var i in arguments) {
|
|
if (arguments[i] && this.parts[i]) {
|
|
this.parts[i] = arguments[i];
|
|
this.parts[i].nextPart = this.parts[i + 1];
|
|
this.parts[i].onended = function () {
|
|
thisScore.resetPart(i);
|
|
playNextPart(thisScore);
|
|
};
|
|
}
|
|
}
|
|
this.looping = false;
|
|
};
|
|
p5.Score.prototype.onended = function () {
|
|
if (this.looping) {
|
|
// this.resetParts();
|
|
this.parts[0].start();
|
|
} else {
|
|
this.parts[this.parts.length - 1].onended = function () {
|
|
this.stop();
|
|
this.resetParts();
|
|
};
|
|
}
|
|
this.currentPart = 0;
|
|
};
|
|
/**
|
|
* Start playback of the score.
|
|
*
|
|
* @method start
|
|
*/
|
|
p5.Score.prototype.start = function () {
|
|
this.parts[this.currentPart].start();
|
|
this.scoreStep = 0;
|
|
};
|
|
/**
|
|
* Stop playback of the score.
|
|
*
|
|
* @method stop
|
|
*/
|
|
p5.Score.prototype.stop = function () {
|
|
this.parts[this.currentPart].stop();
|
|
this.currentPart = 0;
|
|
this.scoreStep = 0;
|
|
};
|
|
/**
|
|
* Pause playback of the score.
|
|
*
|
|
* @method pause
|
|
*/
|
|
p5.Score.prototype.pause = function () {
|
|
this.parts[this.currentPart].stop();
|
|
};
|
|
/**
|
|
* Loop playback of the score.
|
|
*
|
|
* @method loop
|
|
*/
|
|
p5.Score.prototype.loop = function () {
|
|
this.looping = true;
|
|
this.start();
|
|
};
|
|
/**
|
|
* Stop looping playback of the score. If it
|
|
* is currently playing, this will go into effect
|
|
* after the current round of playback completes.
|
|
*
|
|
* @method noLoop
|
|
*/
|
|
p5.Score.prototype.noLoop = function () {
|
|
this.looping = false;
|
|
};
|
|
p5.Score.prototype.resetParts = function () {
|
|
var self = this;
|
|
this.parts.forEach(function (part) {
|
|
self.resetParts[part];
|
|
});
|
|
};
|
|
p5.Score.prototype.resetPart = function (i) {
|
|
this.parts[i].stop();
|
|
this.parts[i].partStep = 0;
|
|
for (var p in this.parts[i].phrases) {
|
|
if (this.parts[i]) {
|
|
this.parts[i].phrases[p].phraseStep = 0;
|
|
}
|
|
}
|
|
};
|
|
/**
|
|
* Set the tempo for all parts in the score
|
|
*
|
|
* @method setBPM
|
|
* @param {Number} BPM Beats Per Minute
|
|
* @param {Number} rampTime Seconds from now
|
|
*/
|
|
p5.Score.prototype.setBPM = function (bpm, rampTime) {
|
|
for (var i in this.parts) {
|
|
if (this.parts[i]) {
|
|
this.parts[i].setBPM(bpm, rampTime);
|
|
}
|
|
}
|
|
};
|
|
function playNextPart(aScore) {
|
|
aScore.currentPart++;
|
|
if (aScore.currentPart >= aScore.parts.length) {
|
|
aScore.scoreStep = 0;
|
|
aScore.onended();
|
|
} else {
|
|
aScore.scoreStep = 0;
|
|
aScore.parts[aScore.currentPart - 1].stop();
|
|
aScore.parts[aScore.currentPart].start();
|
|
}
|
|
}
|
|
}(master);
|
|
var soundloop;
|
|
'use strict';
|
|
soundloop = function () {
|
|
var p5sound = master;
|
|
var Clock = Tone_core_Clock;
|
|
/**
|
|
* SoundLoop
|
|
*
|
|
* @class p5.SoundLoop
|
|
* @constructor
|
|
*
|
|
* @param {Function} callback this function will be called on each iteration of theloop
|
|
* @param {Number|String} [interval] amount of time or beats for each iteration of the loop
|
|
* defaults to 1
|
|
*
|
|
* @example
|
|
* <div><code>
|
|
* var click;
|
|
* var looper1;
|
|
*
|
|
* function preload() {
|
|
* click = loadSound('assets/drum.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* //the looper's callback is passed the timeFromNow
|
|
* //this value should be used as a reference point from
|
|
* //which to schedule sounds
|
|
* looper1 = new p5.SoundLoop(function(timeFromNow){
|
|
* click.play(timeFromNow);
|
|
* background(255 * (looper1.iterations % 2));
|
|
* }, 2);
|
|
*
|
|
* //stop after 10 iteratios;
|
|
* looper1.maxIterations = 10;
|
|
* //start the loop
|
|
* looper1.start();
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.SoundLoop = function (callback, interval) {
|
|
this.callback = callback;
|
|
/**
|
|
* musicalTimeMode uses <a href = "https://github.com/Tonejs/Tone.js/wiki/Time">Tone.Time</a> convention
|
|
* true if string, false if number
|
|
* @property {Boolean} musicalTimeMode
|
|
*/
|
|
this.musicalTimeMode = typeof this._interval === 'number' ? false : true;
|
|
this._interval = interval || 1;
|
|
/**
|
|
* musicalTimeMode variables
|
|
* modify these only when the interval is specified in musicalTime format as a string
|
|
*/
|
|
this._timeSignature = 4;
|
|
this._bpm = 60;
|
|
this.isPlaying = false;
|
|
/**
|
|
* Set a limit to the number of loops to play. defaults to Infinity
|
|
* @property {Number} maxIterations
|
|
*/
|
|
this.maxIterations = Infinity;
|
|
var self = this;
|
|
this.clock = new Clock({
|
|
'callback': function (time) {
|
|
var timeFromNow = time - p5sound.audiocontext.currentTime;
|
|
/**
|
|
* Do not initiate the callback if timeFromNow is < 0
|
|
* This ususually occurs for a few milliseconds when the page
|
|
* is not fully loaded
|
|
*
|
|
* The callback should only be called until maxIterations is reached
|
|
*/
|
|
if (timeFromNow > 0 && self.iterations <= self.maxIterations) {
|
|
self.callback(timeFromNow);
|
|
}
|
|
},
|
|
'frequency': this._calcFreq()
|
|
});
|
|
};
|
|
/**
|
|
* Start the loop
|
|
* @method start
|
|
* @param {Number} [timeFromNow] schedule a starting time
|
|
*/
|
|
p5.SoundLoop.prototype.start = function (timeFromNow) {
|
|
var t = timeFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
if (!this.isPlaying) {
|
|
this.clock.start(now + t);
|
|
this.isPlaying = true;
|
|
}
|
|
};
|
|
/**
|
|
* Stop the loop
|
|
* @method stop
|
|
* @param {Number} [timeFromNow] schedule a stopping time
|
|
*/
|
|
p5.SoundLoop.prototype.stop = function (timeFromNow) {
|
|
var t = timeFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
if (this.isPlaying) {
|
|
this.clock.stop(now + t);
|
|
this.isPlaying = false;
|
|
}
|
|
};
|
|
/**
|
|
* Pause the loop
|
|
* @method pause
|
|
* @param {Number} [timeFromNow] schedule a pausing time
|
|
*/
|
|
p5.SoundLoop.prototype.pause = function (timeFromNow) {
|
|
var t = timeFromNow || 0;
|
|
if (this.isPlaying) {
|
|
this.clock.pause(t);
|
|
this.isPlaying = false;
|
|
}
|
|
};
|
|
/**
|
|
* Synchronize loops. Use this method to start two more more loops in synchronization
|
|
* or to start a loop in synchronization with a loop that is already playing
|
|
* This method will schedule the implicit loop in sync with the explicit master loop
|
|
* i.e. loopToStart.syncedStart(loopToSyncWith)
|
|
*
|
|
* @method syncedStart
|
|
* @param {Object} otherLoop a p5.SoundLoop to sync with
|
|
* @param {Number} [timeFromNow] Start the loops in sync after timeFromNow seconds
|
|
*/
|
|
p5.SoundLoop.prototype.syncedStart = function (otherLoop, timeFromNow) {
|
|
var t = timeFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
if (!otherLoop.isPlaying) {
|
|
otherLoop.clock.start(now + t);
|
|
otherLoop.isPlaying = true;
|
|
this.clock.start(now + t);
|
|
this.isPlaying = true;
|
|
} else if (otherLoop.isPlaying) {
|
|
var time = otherLoop.clock._nextTick - p5sound.audiocontext.currentTime;
|
|
this.clock.start(now + time);
|
|
this.isPlaying = true;
|
|
}
|
|
};
|
|
/**
|
|
* Updates frequency value, reflected in next callback
|
|
* @private
|
|
* @method _update
|
|
*/
|
|
p5.SoundLoop.prototype._update = function () {
|
|
this.clock.frequency.value = this._calcFreq();
|
|
};
|
|
/**
|
|
* Calculate the frequency of the clock's callback based on bpm, interval, and timesignature
|
|
* @private
|
|
* @method _calcFreq
|
|
* @return {Number} new clock frequency value
|
|
*/
|
|
p5.SoundLoop.prototype._calcFreq = function () {
|
|
//Seconds mode, bpm / timesignature has no effect
|
|
if (typeof this._interval === 'number') {
|
|
this.musicalTimeMode = false;
|
|
return 1 / this._interval;
|
|
} else if (typeof this._interval === 'string') {
|
|
this.musicalTimeMode = true;
|
|
return this._bpm / 60 / this._convertNotation(this._interval) * (this._timeSignature / 4);
|
|
}
|
|
};
|
|
/**
|
|
* Convert notation from musical time format to seconds
|
|
* Uses <a href = "https://github.com/Tonejs/Tone.js/wiki/Time">Tone.Time</a> convention
|
|
* @private
|
|
* @method _convertNotation
|
|
* @param {String} value value to be converted
|
|
* @return {Number} converted value in seconds
|
|
*/
|
|
p5.SoundLoop.prototype._convertNotation = function (value) {
|
|
var type = value.slice(-1);
|
|
value = Number(value.slice(0, -1));
|
|
switch (type) {
|
|
case 'm':
|
|
return this._measure(value);
|
|
case 'n':
|
|
return this._note(value);
|
|
default:
|
|
console.warn('Specified interval is not formatted correctly. See Tone.js ' + 'timing reference for more info: https://github.com/Tonejs/Tone.js/wiki/Time');
|
|
}
|
|
};
|
|
/**
|
|
* Helper conversion methods of measure and note
|
|
* @private
|
|
* @method _measure
|
|
* @private
|
|
* @method _note
|
|
*/
|
|
p5.SoundLoop.prototype._measure = function (value) {
|
|
return value * this._timeSignature;
|
|
};
|
|
p5.SoundLoop.prototype._note = function (value) {
|
|
return this._timeSignature / value;
|
|
};
|
|
/**
|
|
* Getters and Setters, setting any paramter will result in a change in the clock's
|
|
* frequency, that will be reflected after the next callback
|
|
* beats per minute (defaults to 60)
|
|
* @property {Number} bpm
|
|
*/
|
|
Object.defineProperty(p5.SoundLoop.prototype, 'bpm', {
|
|
get: function () {
|
|
return this._bpm;
|
|
},
|
|
set: function (bpm) {
|
|
if (!this.musicalTimeMode) {
|
|
console.warn('Changing the BPM in "seconds" mode has no effect. ' + 'BPM is only relevant in musicalTimeMode ' + 'when the interval is specified as a string ' + '("2n", "4n", "1m"...etc)');
|
|
}
|
|
this._bpm = bpm;
|
|
this._update();
|
|
}
|
|
});
|
|
/**
|
|
* number of quarter notes in a measure (defaults to 4)
|
|
* @property {Number} timeSignature
|
|
*/
|
|
Object.defineProperty(p5.SoundLoop.prototype, 'timeSignature', {
|
|
get: function () {
|
|
return this._timeSignature;
|
|
},
|
|
set: function (timeSig) {
|
|
if (!this.musicalTimeMode) {
|
|
console.warn('Changing the timeSignature in "seconds" mode has no effect. ' + 'BPM is only relevant in musicalTimeMode ' + 'when the interval is specified as a string ' + '("2n", "4n", "1m"...etc)');
|
|
}
|
|
this._timeSignature = timeSig;
|
|
this._update();
|
|
}
|
|
});
|
|
/**
|
|
* length of the loops interval
|
|
* @property {Number|String} interval
|
|
*/
|
|
Object.defineProperty(p5.SoundLoop.prototype, 'interval', {
|
|
get: function () {
|
|
return this._interval;
|
|
},
|
|
set: function (interval) {
|
|
this.musicalTimeMode = typeof interval === 'Number' ? false : true;
|
|
this._interval = interval;
|
|
this._update();
|
|
}
|
|
});
|
|
/**
|
|
* how many times the callback has been called so far
|
|
* @property {Number} iterations
|
|
* @readonly
|
|
*/
|
|
Object.defineProperty(p5.SoundLoop.prototype, 'iterations', {
|
|
get: function () {
|
|
return this.clock.ticks;
|
|
}
|
|
});
|
|
return p5.SoundLoop;
|
|
}(master, Tone_core_Clock);
|
|
var compressor;
|
|
compressor = function () {
|
|
'use strict';
|
|
var p5sound = master;
|
|
var Effect = effect;
|
|
var CustomError = errorHandler;
|
|
/**
|
|
* Compressor is an audio effect class that performs dynamics compression
|
|
* on an audio input source. This is a very commonly used technique in music
|
|
* and sound production. Compression creates an overall louder, richer,
|
|
* and fuller sound by lowering the volume of louds and raising that of softs.
|
|
* Compression can be used to avoid clipping (sound distortion due to
|
|
* peaks in volume) and is especially useful when many sounds are played
|
|
* at once. Compression can be used on indivudal sound sources in addition
|
|
* to the master output.
|
|
*
|
|
* This class extends <a href = "/reference/#/p5.Effect">p5.Effect</a>.
|
|
* Methods <a href = "/reference/#/p5.Effect/amp">amp()</a>, <a href = "/reference/#/p5.Effect/chain">chain()</a>,
|
|
* <a href = "/reference/#/p5.Effect/drywet">drywet()</a>, <a href = "/reference/#/p5.Effect/connect">connect()</a>, and
|
|
* <a href = "/reference/#/p5.Effect/disconnect">disconnect()</a> are available.
|
|
*
|
|
* @class p5.Compressor
|
|
* @constructor
|
|
* @extends p5.Effect
|
|
*
|
|
*
|
|
*/
|
|
p5.Compressor = function () {
|
|
Effect.call(this);
|
|
/**
|
|
* The p5.Compressor is built with a <a href="https://www.w3.org/TR/webaudio/#the-dynamicscompressornode-interface"
|
|
* target="_blank" title="W3 spec for Dynamics Compressor Node">Web Audio Dynamics Compressor Node
|
|
* </a>
|
|
* @property {AudioNode} compressor
|
|
*/
|
|
this.compressor = this.ac.createDynamicsCompressor();
|
|
this.input.connect(this.compressor);
|
|
this.compressor.connect(this.wet);
|
|
};
|
|
p5.Compressor.prototype = Object.create(Effect.prototype);
|
|
/**
|
|
* Performs the same function as .connect, but also accepts
|
|
* optional parameters to set compressor's audioParams
|
|
* @method process
|
|
*
|
|
* @param {Object} src Sound source to be connected
|
|
*
|
|
* @param {Number} [attack] The amount of time (in seconds) to reduce the gain by 10dB,
|
|
* default = .003, range 0 - 1
|
|
* @param {Number} [knee] A decibel value representing the range above the
|
|
* threshold where the curve smoothly transitions to the "ratio" portion.
|
|
* default = 30, range 0 - 40
|
|
* @param {Number} [ratio] The amount of dB change in input for a 1 dB change in output
|
|
* default = 12, range 1 - 20
|
|
* @param {Number} [threshold] The decibel value above which the compression will start taking effect
|
|
* default = -24, range -100 - 0
|
|
* @param {Number} [release] The amount of time (in seconds) to increase the gain by 10dB
|
|
* default = .25, range 0 - 1
|
|
*/
|
|
p5.Compressor.prototype.process = function (src, attack, knee, ratio, threshold, release) {
|
|
src.connect(this.input);
|
|
this.set(attack, knee, ratio, threshold, release);
|
|
};
|
|
/**
|
|
* Set the paramters of a compressor.
|
|
* @method set
|
|
* @param {Number} attack The amount of time (in seconds) to reduce the gain by 10dB,
|
|
* default = .003, range 0 - 1
|
|
* @param {Number} knee A decibel value representing the range above the
|
|
* threshold where the curve smoothly transitions to the "ratio" portion.
|
|
* default = 30, range 0 - 40
|
|
* @param {Number} ratio The amount of dB change in input for a 1 dB change in output
|
|
* default = 12, range 1 - 20
|
|
* @param {Number} threshold The decibel value above which the compression will start taking effect
|
|
* default = -24, range -100 - 0
|
|
* @param {Number} release The amount of time (in seconds) to increase the gain by 10dB
|
|
* default = .25, range 0 - 1
|
|
*/
|
|
p5.Compressor.prototype.set = function (attack, knee, ratio, threshold, release) {
|
|
if (typeof attack !== 'undefined') {
|
|
this.attack(attack);
|
|
}
|
|
if (typeof knee !== 'undefined') {
|
|
this.knee(knee);
|
|
}
|
|
if (typeof ratio !== 'undefined') {
|
|
this.ratio(ratio);
|
|
}
|
|
if (typeof threshold !== 'undefined') {
|
|
this.threshold(threshold);
|
|
}
|
|
if (typeof release !== 'undefined') {
|
|
this.release(release);
|
|
}
|
|
};
|
|
/**
|
|
* Get current attack or set value w/ time ramp
|
|
*
|
|
*
|
|
* @method attack
|
|
* @param {Number} [attack] Attack is the amount of time (in seconds) to reduce the gain by 10dB,
|
|
* default = .003, range 0 - 1
|
|
* @param {Number} [time] Assign time value to schedule the change in value
|
|
*/
|
|
p5.Compressor.prototype.attack = function (attack, time) {
|
|
var t = time || 0;
|
|
if (typeof attack == 'number') {
|
|
this.compressor.attack.value = attack;
|
|
this.compressor.attack.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.compressor.attack.linearRampToValueAtTime(attack, this.ac.currentTime + 0.02 + t);
|
|
} else if (typeof attack !== 'undefined') {
|
|
attack.connect(this.compressor.attack);
|
|
}
|
|
return this.compressor.attack.value;
|
|
};
|
|
/**
|
|
* Get current knee or set value w/ time ramp
|
|
*
|
|
* @method knee
|
|
* @param {Number} [knee] A decibel value representing the range above the
|
|
* threshold where the curve smoothly transitions to the "ratio" portion.
|
|
* default = 30, range 0 - 40
|
|
* @param {Number} [time] Assign time value to schedule the change in value
|
|
*/
|
|
p5.Compressor.prototype.knee = function (knee, time) {
|
|
var t = time || 0;
|
|
if (typeof knee == 'number') {
|
|
this.compressor.knee.value = knee;
|
|
this.compressor.knee.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.compressor.knee.linearRampToValueAtTime(knee, this.ac.currentTime + 0.02 + t);
|
|
} else if (typeof knee !== 'undefined') {
|
|
knee.connect(this.compressor.knee);
|
|
}
|
|
return this.compressor.knee.value;
|
|
};
|
|
/**
|
|
* Get current ratio or set value w/ time ramp
|
|
* @method ratio
|
|
*
|
|
* @param {Number} [ratio] The amount of dB change in input for a 1 dB change in output
|
|
* default = 12, range 1 - 20
|
|
* @param {Number} [time] Assign time value to schedule the change in value
|
|
*/
|
|
p5.Compressor.prototype.ratio = function (ratio, time) {
|
|
var t = time || 0;
|
|
if (typeof ratio == 'number') {
|
|
this.compressor.ratio.value = ratio;
|
|
this.compressor.ratio.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.compressor.ratio.linearRampToValueAtTime(ratio, this.ac.currentTime + 0.02 + t);
|
|
} else if (typeof ratio !== 'undefined') {
|
|
ratio.connect(this.compressor.ratio);
|
|
}
|
|
return this.compressor.ratio.value;
|
|
};
|
|
/**
|
|
* Get current threshold or set value w/ time ramp
|
|
* @method threshold
|
|
*
|
|
* @param {Number} threshold The decibel value above which the compression will start taking effect
|
|
* default = -24, range -100 - 0
|
|
* @param {Number} [time] Assign time value to schedule the change in value
|
|
*/
|
|
p5.Compressor.prototype.threshold = function (threshold, time) {
|
|
var t = time || 0;
|
|
if (typeof threshold == 'number') {
|
|
this.compressor.threshold.value = threshold;
|
|
this.compressor.threshold.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.compressor.threshold.linearRampToValueAtTime(threshold, this.ac.currentTime + 0.02 + t);
|
|
} else if (typeof threshold !== 'undefined') {
|
|
threshold.connect(this.compressor.threshold);
|
|
}
|
|
return this.compressor.threshold.value;
|
|
};
|
|
/**
|
|
* Get current release or set value w/ time ramp
|
|
* @method release
|
|
*
|
|
* @param {Number} release The amount of time (in seconds) to increase the gain by 10dB
|
|
* default = .25, range 0 - 1
|
|
*
|
|
* @param {Number} [time] Assign time value to schedule the change in value
|
|
*/
|
|
p5.Compressor.prototype.release = function (release, time) {
|
|
var t = time || 0;
|
|
if (typeof release == 'number') {
|
|
this.compressor.release.value = release;
|
|
this.compressor.release.cancelScheduledValues(this.ac.currentTime + 0.01 + t);
|
|
this.compressor.release.linearRampToValueAtTime(release, this.ac.currentTime + 0.02 + t);
|
|
} else if (typeof number !== 'undefined') {
|
|
release.connect(this.compressor.release);
|
|
}
|
|
return this.compressor.release.value;
|
|
};
|
|
/**
|
|
* Return the current reduction value
|
|
*
|
|
* @method reduction
|
|
* @return {Number} Value of the amount of gain reduction that is applied to the signal
|
|
*/
|
|
p5.Compressor.prototype.reduction = function () {
|
|
return this.compressor.reduction.value;
|
|
};
|
|
p5.Compressor.prototype.dispose = function () {
|
|
Effect.prototype.dispose.apply(this);
|
|
this.compressor.disconnect();
|
|
this.compressor = undefined;
|
|
};
|
|
return p5.Compressor;
|
|
}(master, effect, errorHandler);
|
|
var soundRecorder;
|
|
'use strict';
|
|
soundRecorder = function () {
|
|
var p5sound = master;
|
|
var ac = p5sound.audiocontext;
|
|
/**
|
|
* <p>Record sounds for playback and/or to save as a .wav file.
|
|
* The p5.SoundRecorder records all sound output from your sketch,
|
|
* or can be assigned a specific source with setInput().</p>
|
|
* <p>The record() method accepts a p5.SoundFile as a parameter.
|
|
* When playback is stopped (either after the given amount of time,
|
|
* or with the stop() method), the p5.SoundRecorder will send its
|
|
* recording to that p5.SoundFile for playback.</p>
|
|
*
|
|
* @class p5.SoundRecorder
|
|
* @constructor
|
|
* @example
|
|
* <div><code>
|
|
* var mic, recorder, soundFile;
|
|
* var state = 0;
|
|
*
|
|
* function setup() {
|
|
* background(200);
|
|
* // create an audio in
|
|
* mic = new p5.AudioIn();
|
|
*
|
|
* // prompts user to enable their browser mic
|
|
* mic.start();
|
|
*
|
|
* // create a sound recorder
|
|
* recorder = new p5.SoundRecorder();
|
|
*
|
|
* // connect the mic to the recorder
|
|
* recorder.setInput(mic);
|
|
*
|
|
* // this sound file will be used to
|
|
* // playback & save the recording
|
|
* soundFile = new p5.SoundFile();
|
|
*
|
|
* text('keyPress to record', 20, 20);
|
|
* }
|
|
*
|
|
* function keyPressed() {
|
|
* // make sure user enabled the mic
|
|
* if (state === 0 && mic.enabled) {
|
|
*
|
|
* // record to our p5.SoundFile
|
|
* recorder.record(soundFile);
|
|
*
|
|
* background(255,0,0);
|
|
* text('Recording!', 20, 20);
|
|
* state++;
|
|
* }
|
|
* else if (state === 1) {
|
|
* background(0,255,0);
|
|
*
|
|
* // stop recorder and
|
|
* // send result to soundFile
|
|
* recorder.stop();
|
|
*
|
|
* text('Stopped', 20, 20);
|
|
* state++;
|
|
* }
|
|
*
|
|
* else if (state === 2) {
|
|
* soundFile.play(); // play the result!
|
|
* save(soundFile, 'mySound.wav');
|
|
* state++;
|
|
* }
|
|
* }
|
|
* </div></code>
|
|
*/
|
|
p5.SoundRecorder = function () {
|
|
this.input = ac.createGain();
|
|
this.output = ac.createGain();
|
|
this.recording = false;
|
|
this.bufferSize = 1024;
|
|
this._channels = 2;
|
|
// stereo (default)
|
|
this._clear();
|
|
// initialize variables
|
|
this._jsNode = ac.createScriptProcessor(this.bufferSize, this._channels, 2);
|
|
this._jsNode.onaudioprocess = this._audioprocess.bind(this);
|
|
/**
|
|
* callback invoked when the recording is over
|
|
* @private
|
|
* @type Function(Float32Array)
|
|
*/
|
|
this._callback = function () {
|
|
};
|
|
// connections
|
|
this._jsNode.connect(p5.soundOut._silentNode);
|
|
this.setInput();
|
|
// add this p5.SoundFile to the soundArray
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
/**
|
|
* Connect a specific device to the p5.SoundRecorder.
|
|
* If no parameter is given, p5.SoundRecorer will record
|
|
* all audible p5.sound from your sketch.
|
|
*
|
|
* @method setInput
|
|
* @param {Object} [unit] p5.sound object or a web audio unit
|
|
* that outputs sound
|
|
*/
|
|
p5.SoundRecorder.prototype.setInput = function (unit) {
|
|
this.input.disconnect();
|
|
this.input = null;
|
|
this.input = ac.createGain();
|
|
this.input.connect(this._jsNode);
|
|
this.input.connect(this.output);
|
|
if (unit) {
|
|
unit.connect(this.input);
|
|
} else {
|
|
p5.soundOut.output.connect(this.input);
|
|
}
|
|
};
|
|
/**
|
|
* Start recording. To access the recording, provide
|
|
* a p5.SoundFile as the first parameter. The p5.SoundRecorder
|
|
* will send its recording to that p5.SoundFile for playback once
|
|
* recording is complete. Optional parameters include duration
|
|
* (in seconds) of the recording, and a callback function that
|
|
* will be called once the complete recording has been
|
|
* transfered to the p5.SoundFile.
|
|
*
|
|
* @method record
|
|
* @param {p5.SoundFile} soundFile p5.SoundFile
|
|
* @param {Number} [duration] Time (in seconds)
|
|
* @param {Function} [callback] The name of a function that will be
|
|
* called once the recording completes
|
|
*/
|
|
p5.SoundRecorder.prototype.record = function (sFile, duration, callback) {
|
|
this.recording = true;
|
|
if (duration) {
|
|
this.sampleLimit = Math.round(duration * ac.sampleRate);
|
|
}
|
|
if (sFile && callback) {
|
|
this._callback = function () {
|
|
this.buffer = this._getBuffer();
|
|
sFile.setBuffer(this.buffer);
|
|
callback();
|
|
};
|
|
} else if (sFile) {
|
|
this._callback = function () {
|
|
this.buffer = this._getBuffer();
|
|
sFile.setBuffer(this.buffer);
|
|
};
|
|
}
|
|
};
|
|
/**
|
|
* Stop the recording. Once the recording is stopped,
|
|
* the results will be sent to the p5.SoundFile that
|
|
* was given on .record(), and if a callback function
|
|
* was provided on record, that function will be called.
|
|
*
|
|
* @method stop
|
|
*/
|
|
p5.SoundRecorder.prototype.stop = function () {
|
|
this.recording = false;
|
|
this._callback();
|
|
this._clear();
|
|
};
|
|
p5.SoundRecorder.prototype._clear = function () {
|
|
this._leftBuffers = [];
|
|
this._rightBuffers = [];
|
|
this.recordedSamples = 0;
|
|
this.sampleLimit = null;
|
|
};
|
|
/**
|
|
* internal method called on audio process
|
|
*
|
|
* @private
|
|
* @param {AudioProcessorEvent} event
|
|
*/
|
|
p5.SoundRecorder.prototype._audioprocess = function (event) {
|
|
if (this.recording === false) {
|
|
return;
|
|
} else if (this.recording === true) {
|
|
// if we are past the duration, then stop... else:
|
|
if (this.sampleLimit && this.recordedSamples >= this.sampleLimit) {
|
|
this.stop();
|
|
} else {
|
|
// get channel data
|
|
var left = event.inputBuffer.getChannelData(0);
|
|
var right = event.inputBuffer.getChannelData(1);
|
|
// clone the samples
|
|
this._leftBuffers.push(new Float32Array(left));
|
|
this._rightBuffers.push(new Float32Array(right));
|
|
this.recordedSamples += this.bufferSize;
|
|
}
|
|
}
|
|
};
|
|
p5.SoundRecorder.prototype._getBuffer = function () {
|
|
var buffers = [];
|
|
buffers.push(this._mergeBuffers(this._leftBuffers));
|
|
buffers.push(this._mergeBuffers(this._rightBuffers));
|
|
return buffers;
|
|
};
|
|
p5.SoundRecorder.prototype._mergeBuffers = function (channelBuffer) {
|
|
var result = new Float32Array(this.recordedSamples);
|
|
var offset = 0;
|
|
var lng = channelBuffer.length;
|
|
for (var i = 0; i < lng; i++) {
|
|
var buffer = channelBuffer[i];
|
|
result.set(buffer, offset);
|
|
offset += buffer.length;
|
|
}
|
|
return result;
|
|
};
|
|
p5.SoundRecorder.prototype.dispose = function () {
|
|
this._clear();
|
|
// remove reference from soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
this._callback = function () {
|
|
};
|
|
if (this.input) {
|
|
this.input.disconnect();
|
|
}
|
|
this.input = null;
|
|
this._jsNode = null;
|
|
};
|
|
/**
|
|
* Save a p5.SoundFile as a .wav audio file.
|
|
*
|
|
* @method saveSound
|
|
* @param {p5.SoundFile} soundFile p5.SoundFile that you wish to save
|
|
* @param {String} name name of the resulting .wav file.
|
|
*/
|
|
p5.prototype.saveSound = function (soundFile, name) {
|
|
var leftChannel, rightChannel;
|
|
leftChannel = soundFile.buffer.getChannelData(0);
|
|
// handle mono files
|
|
if (soundFile.buffer.numberOfChannels > 1) {
|
|
rightChannel = soundFile.buffer.getChannelData(1);
|
|
} else {
|
|
rightChannel = leftChannel;
|
|
}
|
|
var interleaved = interleave(leftChannel, rightChannel);
|
|
// create the buffer and view to create the .WAV file
|
|
var buffer = new window.ArrayBuffer(44 + interleaved.length * 2);
|
|
var view = new window.DataView(buffer);
|
|
// write the WAV container,
|
|
// check spec at: https://ccrma.stanford.edu/courses/422/projects/WaveFormat/
|
|
// RIFF chunk descriptor
|
|
writeUTFBytes(view, 0, 'RIFF');
|
|
view.setUint32(4, 36 + interleaved.length * 2, true);
|
|
writeUTFBytes(view, 8, 'WAVE');
|
|
// FMT sub-chunk
|
|
writeUTFBytes(view, 12, 'fmt ');
|
|
view.setUint32(16, 16, true);
|
|
view.setUint16(20, 1, true);
|
|
// stereo (2 channels)
|
|
view.setUint16(22, 2, true);
|
|
view.setUint32(24, 44100, true);
|
|
view.setUint32(28, 44100 * 4, true);
|
|
view.setUint16(32, 4, true);
|
|
view.setUint16(34, 16, true);
|
|
// data sub-chunk
|
|
writeUTFBytes(view, 36, 'data');
|
|
view.setUint32(40, interleaved.length * 2, true);
|
|
// write the PCM samples
|
|
var lng = interleaved.length;
|
|
var index = 44;
|
|
var volume = 1;
|
|
for (var i = 0; i < lng; i++) {
|
|
view.setInt16(index, interleaved[i] * (32767 * volume), true);
|
|
index += 2;
|
|
}
|
|
p5.prototype.writeFile([view], name, 'wav');
|
|
};
|
|
// helper methods to save waves
|
|
function interleave(leftChannel, rightChannel) {
|
|
var length = leftChannel.length + rightChannel.length;
|
|
var result = new Float32Array(length);
|
|
var inputIndex = 0;
|
|
for (var index = 0; index < length;) {
|
|
result[index++] = leftChannel[inputIndex];
|
|
result[index++] = rightChannel[inputIndex];
|
|
inputIndex++;
|
|
}
|
|
return result;
|
|
}
|
|
function writeUTFBytes(view, offset, string) {
|
|
var lng = string.length;
|
|
for (var i = 0; i < lng; i++) {
|
|
view.setUint8(offset + i, string.charCodeAt(i));
|
|
}
|
|
}
|
|
}(sndcore, master);
|
|
var peakdetect;
|
|
'use strict';
|
|
peakdetect = function () {
|
|
/**
|
|
* <p>PeakDetect works in conjunction with p5.FFT to
|
|
* look for onsets in some or all of the frequency spectrum.
|
|
* </p>
|
|
* <p>
|
|
* To use p5.PeakDetect, call <code>update</code> in the draw loop
|
|
* and pass in a p5.FFT object.
|
|
* </p>
|
|
* <p>
|
|
* You can listen for a specific part of the frequency spectrum by
|
|
* setting the range between <code>freq1</code> and <code>freq2</code>.
|
|
* </p>
|
|
*
|
|
* <p><code>threshold</code> is the threshold for detecting a peak,
|
|
* scaled between 0 and 1. It is logarithmic, so 0.1 is half as loud
|
|
* as 1.0.</p>
|
|
*
|
|
* <p>
|
|
* The update method is meant to be run in the draw loop, and
|
|
* <b>frames</b> determines how many loops must pass before
|
|
* another peak can be detected.
|
|
* For example, if the frameRate() = 60, you could detect the beat of a
|
|
* 120 beat-per-minute song with this equation:
|
|
* <code> framesPerPeak = 60 / (estimatedBPM / 60 );</code>
|
|
* </p>
|
|
*
|
|
* <p>
|
|
* Based on example contribtued by @b2renger, and a simple beat detection
|
|
* explanation by <a
|
|
* href="http://www.airtightinteractive.com/2013/10/making-audio-reactive-visuals/"
|
|
* target="_blank">Felix Turner</a>.
|
|
* </p>
|
|
*
|
|
* @class p5.PeakDetect
|
|
* @constructor
|
|
* @param {Number} [freq1] lowFrequency - defaults to 20Hz
|
|
* @param {Number} [freq2] highFrequency - defaults to 20000 Hz
|
|
* @param {Number} [threshold] Threshold for detecting a beat between 0 and 1
|
|
* scaled logarithmically where 0.1 is 1/2 the loudness
|
|
* of 1.0. Defaults to 0.35.
|
|
* @param {Number} [framesPerPeak] Defaults to 20.
|
|
* @example
|
|
* <div><code>
|
|
*
|
|
* var cnv, soundFile, fft, peakDetect;
|
|
* var ellipseWidth = 10;
|
|
*
|
|
* function setup() {
|
|
* background(0);
|
|
* noStroke();
|
|
* fill(255);
|
|
* textAlign(CENTER);
|
|
*
|
|
* soundFile = loadSound('assets/beat.mp3');
|
|
*
|
|
* // p5.PeakDetect requires a p5.FFT
|
|
* fft = new p5.FFT();
|
|
* peakDetect = new p5.PeakDetect();
|
|
*
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(0);
|
|
* text('click to play/pause', width/2, height/2);
|
|
*
|
|
* // peakDetect accepts an fft post-analysis
|
|
* fft.analyze();
|
|
* peakDetect.update(fft);
|
|
*
|
|
* if ( peakDetect.isDetected ) {
|
|
* ellipseWidth = 50;
|
|
* } else {
|
|
* ellipseWidth *= 0.95;
|
|
* }
|
|
*
|
|
* ellipse(width/2, height/2, ellipseWidth, ellipseWidth);
|
|
* }
|
|
*
|
|
* // toggle play/stop when canvas is clicked
|
|
* function mouseClicked() {
|
|
* if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {
|
|
* if (soundFile.isPlaying() ) {
|
|
* soundFile.stop();
|
|
* } else {
|
|
* soundFile.play();
|
|
* }
|
|
* }
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.PeakDetect = function (freq1, freq2, threshold, _framesPerPeak) {
|
|
// framesPerPeak determines how often to look for a beat.
|
|
// If a beat is provided, try to look for a beat based on bpm
|
|
this.framesPerPeak = _framesPerPeak || 20;
|
|
this.framesSinceLastPeak = 0;
|
|
this.decayRate = 0.95;
|
|
this.threshold = threshold || 0.35;
|
|
this.cutoff = 0;
|
|
// how much to increase the cutoff
|
|
// TO DO: document this / figure out how to make it accessible
|
|
this.cutoffMult = 1.5;
|
|
this.energy = 0;
|
|
this.penergy = 0;
|
|
// TO DO: document this property / figure out how to make it accessible
|
|
this.currentValue = 0;
|
|
/**
|
|
* isDetected is set to true when a peak is detected.
|
|
*
|
|
* @attribute isDetected {Boolean}
|
|
* @default false
|
|
*/
|
|
this.isDetected = false;
|
|
this.f1 = freq1 || 40;
|
|
this.f2 = freq2 || 20000;
|
|
// function to call when a peak is detected
|
|
this._onPeak = function () {
|
|
};
|
|
};
|
|
/**
|
|
* The update method is run in the draw loop.
|
|
*
|
|
* Accepts an FFT object. You must call .analyze()
|
|
* on the FFT object prior to updating the peakDetect
|
|
* because it relies on a completed FFT analysis.
|
|
*
|
|
* @method update
|
|
* @param {p5.FFT} fftObject A p5.FFT object
|
|
*/
|
|
p5.PeakDetect.prototype.update = function (fftObject) {
|
|
var nrg = this.energy = fftObject.getEnergy(this.f1, this.f2) / 255;
|
|
if (nrg > this.cutoff && nrg > this.threshold && nrg - this.penergy > 0) {
|
|
// trigger callback
|
|
this._onPeak();
|
|
this.isDetected = true;
|
|
// debounce
|
|
this.cutoff = nrg * this.cutoffMult;
|
|
this.framesSinceLastPeak = 0;
|
|
} else {
|
|
this.isDetected = false;
|
|
if (this.framesSinceLastPeak <= this.framesPerPeak) {
|
|
this.framesSinceLastPeak++;
|
|
} else {
|
|
this.cutoff *= this.decayRate;
|
|
this.cutoff = Math.max(this.cutoff, this.threshold);
|
|
}
|
|
}
|
|
this.currentValue = nrg;
|
|
this.penergy = nrg;
|
|
};
|
|
/**
|
|
* onPeak accepts two arguments: a function to call when
|
|
* a peak is detected. The value of the peak,
|
|
* between 0.0 and 1.0, is passed to the callback.
|
|
*
|
|
* @method onPeak
|
|
* @param {Function} callback Name of a function that will
|
|
* be called when a peak is
|
|
* detected.
|
|
* @param {Object} [val] Optional value to pass
|
|
* into the function when
|
|
* a peak is detected.
|
|
* @example
|
|
* <div><code>
|
|
* var cnv, soundFile, fft, peakDetect;
|
|
* var ellipseWidth = 0;
|
|
*
|
|
* function setup() {
|
|
* cnv = createCanvas(100,100);
|
|
* textAlign(CENTER);
|
|
*
|
|
* soundFile = loadSound('assets/beat.mp3');
|
|
* fft = new p5.FFT();
|
|
* peakDetect = new p5.PeakDetect();
|
|
*
|
|
* setupSound();
|
|
*
|
|
* // when a beat is detected, call triggerBeat()
|
|
* peakDetect.onPeak(triggerBeat);
|
|
* }
|
|
*
|
|
* function draw() {
|
|
* background(0);
|
|
* fill(255);
|
|
* text('click to play', width/2, height/2);
|
|
*
|
|
* fft.analyze();
|
|
* peakDetect.update(fft);
|
|
*
|
|
* ellipseWidth *= 0.95;
|
|
* ellipse(width/2, height/2, ellipseWidth, ellipseWidth);
|
|
* }
|
|
*
|
|
* // this function is called by peakDetect.onPeak
|
|
* function triggerBeat() {
|
|
* ellipseWidth = 50;
|
|
* }
|
|
*
|
|
* // mouseclick starts/stops sound
|
|
* function setupSound() {
|
|
* cnv.mouseClicked( function() {
|
|
* if (soundFile.isPlaying() ) {
|
|
* soundFile.stop();
|
|
* } else {
|
|
* soundFile.play();
|
|
* }
|
|
* });
|
|
* }
|
|
* </code></div>
|
|
*/
|
|
p5.PeakDetect.prototype.onPeak = function (callback, val) {
|
|
var self = this;
|
|
self._onPeak = function () {
|
|
callback(self.energy, val);
|
|
};
|
|
};
|
|
}();
|
|
var gain;
|
|
'use strict';
|
|
gain = function () {
|
|
var p5sound = master;
|
|
/**
|
|
* A gain node is usefull to set the relative volume of sound.
|
|
* It's typically used to build mixers.
|
|
*
|
|
* @class p5.Gain
|
|
* @constructor
|
|
* @example
|
|
* <div><code>
|
|
*
|
|
* // load two soundfile and crossfade beetween them
|
|
* var sound1,sound2;
|
|
* var gain1, gain2, gain3;
|
|
*
|
|
* function preload(){
|
|
* soundFormats('ogg', 'mp3');
|
|
* sound1 = loadSound('../_files/Damscray_01');
|
|
* sound2 = loadSound('../_files/beat.mp3');
|
|
* }
|
|
*
|
|
* function setup() {
|
|
* createCanvas(400,200);
|
|
*
|
|
* // create a 'master' gain to which we will connect both soundfiles
|
|
* gain3 = new p5.Gain();
|
|
* gain3.connect();
|
|
*
|
|
* // setup first sound for playing
|
|
* sound1.rate(1);
|
|
* sound1.loop();
|
|
* sound1.disconnect(); // diconnect from p5 output
|
|
*
|
|
* gain1 = new p5.Gain(); // setup a gain node
|
|
* gain1.setInput(sound1); // connect the first sound to its input
|
|
* gain1.connect(gain3); // connect its output to the 'master'
|
|
*
|
|
* sound2.rate(1);
|
|
* sound2.disconnect();
|
|
* sound2.loop();
|
|
*
|
|
* gain2 = new p5.Gain();
|
|
* gain2.setInput(sound2);
|
|
* gain2.connect(gain3);
|
|
*
|
|
* }
|
|
*
|
|
* function draw(){
|
|
* background(180);
|
|
*
|
|
* // calculate the horizontal distance beetween the mouse and the right of the screen
|
|
* var d = dist(mouseX,0,width,0);
|
|
*
|
|
* // map the horizontal position of the mouse to values useable for volume control of sound1
|
|
* var vol1 = map(mouseX,0,width,0,1);
|
|
* var vol2 = 1-vol1; // when sound1 is loud, sound2 is quiet and vice versa
|
|
*
|
|
* gain1.amp(vol1,0.5,0);
|
|
* gain2.amp(vol2,0.5,0);
|
|
*
|
|
* // map the vertical position of the mouse to values useable for 'master volume control'
|
|
* var vol3 = map(mouseY,0,height,0,1);
|
|
* gain3.amp(vol3,0.5,0);
|
|
* }
|
|
*</code></div>
|
|
*
|
|
*/
|
|
p5.Gain = function () {
|
|
this.ac = p5sound.audiocontext;
|
|
this.input = this.ac.createGain();
|
|
this.output = this.ac.createGain();
|
|
// otherwise, Safari distorts
|
|
this.input.gain.value = 0.5;
|
|
this.input.connect(this.output);
|
|
// add to the soundArray
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
/**
|
|
* Connect a source to the gain node.
|
|
*
|
|
* @method setInput
|
|
* @param {Object} src p5.sound / Web Audio object with a sound
|
|
* output.
|
|
*/
|
|
p5.Gain.prototype.setInput = function (src) {
|
|
src.connect(this.input);
|
|
};
|
|
/**
|
|
* Send output to a p5.sound or web audio object
|
|
*
|
|
* @method connect
|
|
* @param {Object} unit
|
|
*/
|
|
p5.Gain.prototype.connect = function (unit) {
|
|
var u = unit || p5.soundOut.input;
|
|
this.output.connect(u.input ? u.input : u);
|
|
};
|
|
/**
|
|
* Disconnect all output.
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
p5.Gain.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
};
|
|
/**
|
|
* Set the output level of the gain node.
|
|
*
|
|
* @method amp
|
|
* @param {Number} volume amplitude between 0 and 1.0
|
|
* @param {Number} [rampTime] create a fade that lasts rampTime
|
|
* @param {Number} [timeFromNow] schedule this event to happen
|
|
* seconds from now
|
|
*/
|
|
p5.Gain.prototype.amp = function (vol, rampTime, tFromNow) {
|
|
var rampTime = rampTime || 0;
|
|
var tFromNow = tFromNow || 0;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var currentVol = this.output.gain.value;
|
|
this.output.gain.cancelScheduledValues(now);
|
|
this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow);
|
|
this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime);
|
|
};
|
|
p5.Gain.prototype.dispose = function () {
|
|
// remove reference from soundArray
|
|
var index = p5sound.soundArray.indexOf(this);
|
|
p5sound.soundArray.splice(index, 1);
|
|
this.output.disconnect();
|
|
this.input.disconnect();
|
|
this.output = undefined;
|
|
this.input = undefined;
|
|
};
|
|
}(master, sndcore);
|
|
var audioVoice;
|
|
'use strict';
|
|
audioVoice = function () {
|
|
var p5sound = master;
|
|
/**
|
|
* Base class for monophonic synthesizers. Any extensions of this class
|
|
* should follow the API and implement the methods below in order to
|
|
* remain compatible with p5.PolySynth();
|
|
*
|
|
* @class p5.AudioVoice
|
|
* @constructor
|
|
*/
|
|
p5.AudioVoice = function () {
|
|
this.ac = p5sound.audiocontext;
|
|
this.output = this.ac.createGain();
|
|
this.connect();
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
/**
|
|
* This method converts midi notes specified as a string "C4", "Eb3"...etc
|
|
* to frequency
|
|
* @private
|
|
* @method _setNote
|
|
* @param {String} note
|
|
*/
|
|
p5.AudioVoice.prototype._setNote = function (note) {
|
|
var wholeNotes = {
|
|
A: 21,
|
|
B: 23,
|
|
C: 24,
|
|
D: 26,
|
|
E: 28,
|
|
F: 29,
|
|
G: 31
|
|
};
|
|
var value = wholeNotes[note[0]];
|
|
var octave = typeof Number(note.slice(-1)) === 'number' ? note.slice(-1) : 0;
|
|
value += 12 * octave;
|
|
value = note[1] === '#' ? value + 1 : note[1] === 'b' ? value - 1 : value;
|
|
//return midi value converted to frequency
|
|
return p5.prototype.midiToFreq(value);
|
|
};
|
|
p5.AudioVoice.prototype.play = function (note, velocity, secondsFromNow, sustime) {
|
|
};
|
|
p5.AudioVoice.prototype.triggerAttack = function (note, velocity, secondsFromNow) {
|
|
};
|
|
p5.AudioVoice.prototype.triggerRelease = function (secondsFromNow) {
|
|
};
|
|
p5.AudioVoice.prototype.amp = function (vol, rampTime) {
|
|
};
|
|
/**
|
|
* Connect to p5 objects or Web Audio Nodes
|
|
* @method connect
|
|
* @param {Object} unit
|
|
*/
|
|
p5.AudioVoice.prototype.connect = function (unit) {
|
|
var u = unit || p5sound.input;
|
|
this.output.connect(u.input ? u.input : u);
|
|
};
|
|
/**
|
|
* Disconnect from soundOut
|
|
* @method disconnect
|
|
*/
|
|
p5.AudioVoice.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
};
|
|
p5.AudioVoice.prototype.dispose = function () {
|
|
this.output.disconnect();
|
|
delete this.output;
|
|
};
|
|
return p5.AudioVoice;
|
|
}(master);
|
|
var monosynth;
|
|
'use strict';
|
|
monosynth = function () {
|
|
var p5sound = master;
|
|
var AudioVoice = audioVoice;
|
|
/**
|
|
* An MonoSynth is used as a single voice for sound synthesis.
|
|
* This is a class to be used in conjonction with the PolySynth
|
|
* class. Custom synthetisers should be built inheriting from
|
|
* this class.
|
|
*
|
|
* @class p5.MonoSynth
|
|
* @constructor
|
|
* @example
|
|
* <div><code>
|
|
* var monosynth;
|
|
* var x;
|
|
*
|
|
* function setup() {
|
|
* monosynth = new p5.MonoSynth();
|
|
* monosynth.loadPreset('simpleBass');
|
|
* monosynth.play(45,1,x=0,1);
|
|
* monosynth.play(49,1,x+=1,0.25);
|
|
* monosynth.play(50,1,x+=0.25,0.25);
|
|
* monosynth.play(49,1,x+=0.5,0.25);
|
|
* monosynth.play(50,1,x+=0.25,0.25);
|
|
* }
|
|
* </code></div>
|
|
**/
|
|
p5.MonoSynth = function () {
|
|
AudioVoice.call(this);
|
|
this.oscillator = new p5.Oscillator();
|
|
// this.oscillator.disconnect();
|
|
this.env = new p5.Env();
|
|
this.env.setRange(1, 0);
|
|
this.env.setExp(true);
|
|
//set params
|
|
this.setADSR(0.02, 0.25, 0.05, 0.35);
|
|
// filter
|
|
this.filter = new p5.Filter('highpass');
|
|
this.filter.set(5, 1);
|
|
// oscillator --> env --> filter --> this.output (gain) --> p5.soundOut
|
|
this.oscillator.disconnect();
|
|
this.oscillator.connect(this.filter);
|
|
this.env.disconnect();
|
|
this.env.setInput(this.oscillator);
|
|
// this.env.connect(this.filter);
|
|
this.filter.connect(this.output);
|
|
this.oscillator.start();
|
|
this.connect();
|
|
//Audiovoices are connected to soundout by default
|
|
this._isOn = false;
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
p5.MonoSynth.prototype = Object.create(p5.AudioVoice.prototype);
|
|
/**
|
|
* Play tells the MonoSynth to start playing a note. This method schedules
|
|
* the calling of .triggerAttack and .triggerRelease.
|
|
*
|
|
* @method play
|
|
* @param {String | Number} note the note you want to play, specified as a
|
|
* frequency in Hertz (Number) or as a midi
|
|
* value in Note/Octave format ("C4", "Eb3"...etc")
|
|
* See <a href = "https://github.com/Tonejs/Tone.js/wiki/Instruments">
|
|
* Tone</a>. Defaults to 440 hz.
|
|
* @param {Number} [velocity] velocity of the note to play (ranging from 0 to 1)
|
|
* @param {Number} [secondsFromNow] time from now (in seconds) at which to play
|
|
* @param {Number} [sustainTime] time to sustain before releasing the envelope
|
|
*
|
|
*/
|
|
p5.MonoSynth.prototype.play = function (note, velocity, secondsFromNow, susTime) {
|
|
// set range of env (TO DO: allow this to be scheduled in advance)
|
|
var susTime = susTime || this.sustain;
|
|
this.susTime = susTime;
|
|
this.triggerAttack(note, velocity, secondsFromNow);
|
|
this.triggerRelease(secondsFromNow + susTime);
|
|
};
|
|
/**
|
|
* Trigger the Attack, and Decay portion of the Envelope.
|
|
* Similar to holding down a key on a piano, but it will
|
|
* hold the sustain level until you let go.
|
|
*
|
|
* @param {String | Number} note the note you want to play, specified as a
|
|
* frequency in Hertz (Number) or as a midi
|
|
* value in Note/Octave format ("C4", "Eb3"...etc")
|
|
* See <a href = "https://github.com/Tonejs/Tone.js/wiki/Instruments">
|
|
* Tone</a>. Defaults to 440 hz
|
|
* @param {Number} [velocity] velocity of the note to play (ranging from 0 to 1)
|
|
* @param {Number} [secondsFromNow] time from now (in seconds) at which to play
|
|
* @method triggerAttack
|
|
*/
|
|
p5.MonoSynth.prototype.triggerAttack = function (note, velocity, secondsFromNow) {
|
|
var secondsFromNow = secondsFromNow || 0;
|
|
//triggerAttack uses ._setNote to convert a midi string to a frequency if necessary
|
|
var freq = typeof note === 'string' ? this._setNote(note) : typeof note === 'number' ? note : 440;
|
|
var vel = velocity || 1;
|
|
this._isOn = true;
|
|
this.oscillator.freq(freq, 0, secondsFromNow);
|
|
this.env.ramp(this.output, secondsFromNow, vel);
|
|
};
|
|
/**
|
|
* Trigger the release of the Envelope. This is similar to releasing
|
|
* the key on a piano and letting the sound fade according to the
|
|
* release level and release time.
|
|
*
|
|
* @param {Number} secondsFromNow time to trigger the release
|
|
* @method triggerRelease
|
|
*/
|
|
p5.MonoSynth.prototype.triggerRelease = function (secondsFromNow) {
|
|
var secondsFromNow = secondsFromNow || 0;
|
|
this.env.ramp(this.output, secondsFromNow, 0);
|
|
this._isOn = false;
|
|
};
|
|
/**
|
|
* Set values like a traditional
|
|
* <a href="https://en.wikipedia.org/wiki/Synthesizer#/media/File:ADSR_parameter.svg">
|
|
* ADSR envelope
|
|
* </a>.
|
|
*
|
|
* @method setADSR
|
|
* @param {Number} attackTime Time (in seconds before envelope
|
|
* reaches Attack Level
|
|
* @param {Number} [decayTime] Time (in seconds) before envelope
|
|
* reaches Decay/Sustain Level
|
|
* @param {Number} [susRatio] Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,
|
|
* where 1.0 = attackLevel, 0.0 = releaseLevel.
|
|
* The susRatio determines the decayLevel and the level at which the
|
|
* sustain portion of the envelope will sustain.
|
|
* For example, if attackLevel is 0.4, releaseLevel is 0,
|
|
* and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is
|
|
* increased to 1.0 (using <code>setRange</code>),
|
|
* then decayLevel would increase proportionally, to become 0.5.
|
|
* @param {Number} [releaseTime] Time in seconds from now (defaults to 0)
|
|
*/
|
|
p5.MonoSynth.prototype.setADSR = function (attack, decay, sustain, release) {
|
|
this.env.setADSR(attack, decay, sustain, release);
|
|
};
|
|
/**
|
|
* Getters and Setters
|
|
* @property {Number} attack
|
|
*/
|
|
/**
|
|
* @property {Number} decay
|
|
*/
|
|
/**
|
|
* @property {Number} sustain
|
|
*/
|
|
/**
|
|
* @property {Number} release
|
|
*/
|
|
Object.defineProperties(p5.MonoSynth.prototype, {
|
|
'attack': {
|
|
get: function () {
|
|
return this.env.aTime;
|
|
},
|
|
set: function (attack) {
|
|
this.env.setADSR(attack, this.env.dTime, this.env.sPercent, this.env.rTime);
|
|
}
|
|
},
|
|
'decay': {
|
|
get: function () {
|
|
return this.env.dTime;
|
|
},
|
|
set: function (decay) {
|
|
this.env.setADSR(this.env.aTime, decay, this.env.sPercent, this.env.rTime);
|
|
}
|
|
},
|
|
'sustain': {
|
|
get: function () {
|
|
return this.env.sPercent;
|
|
},
|
|
set: function (sustain) {
|
|
this.env.setADSR(this.env.aTime, this.env.dTime, sustain, this.env.rTime);
|
|
}
|
|
},
|
|
'release': {
|
|
get: function () {
|
|
return this.env.rTime;
|
|
},
|
|
set: function (release) {
|
|
this.env.setADSR(this.env.aTime, this.env.dTime, this.env.sPercent, release);
|
|
}
|
|
}
|
|
});
|
|
/**
|
|
* MonoSynth amp
|
|
* @method amp
|
|
* @param {Number} vol desired volume
|
|
* @param {Number} [rampTime] Time to reach new volume
|
|
* @return {Number} new volume value
|
|
*/
|
|
p5.MonoSynth.prototype.amp = function (vol, rampTime) {
|
|
var t = rampTime || 0;
|
|
if (typeof vol !== 'undefined') {
|
|
this.oscillator.amp(vol, t);
|
|
}
|
|
return this.oscillator.amp().value;
|
|
};
|
|
/**
|
|
* Connect to a p5.sound / Web Audio object.
|
|
*
|
|
* @method connect
|
|
* @param {Object} unit A p5.sound or Web Audio object
|
|
*/
|
|
p5.MonoSynth.prototype.connect = function (unit) {
|
|
var u = unit || p5sound.input;
|
|
this.output.connect(u.input ? u.input : u);
|
|
};
|
|
/**
|
|
* Disconnect all outputs
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
p5.MonoSynth.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
};
|
|
/**
|
|
* Get rid of the MonoSynth and free up its resources / memory.
|
|
*
|
|
* @method dispose
|
|
*/
|
|
p5.MonoSynth.prototype.dispose = function () {
|
|
AudioVoice.prototype.dispose.apply(this);
|
|
this.filter.dispose();
|
|
this.env.dispose();
|
|
try {
|
|
this.oscillator.dispose();
|
|
} catch (e) {
|
|
console.error('mono synth default oscillator already disposed');
|
|
}
|
|
};
|
|
}(master, audioVoice);
|
|
var polysynth;
|
|
'use strict';
|
|
polysynth = function () {
|
|
var p5sound = master;
|
|
var TimelineSignal = Tone_signal_TimelineSignal;
|
|
/**
|
|
* An AudioVoice is used as a single voice for sound synthesis.
|
|
* The PolySynth class holds an array of AudioVoice, and deals
|
|
* with voices allocations, with setting notes to be played, and
|
|
* parameters to be set.
|
|
*
|
|
* @class p5.PolySynth
|
|
* @constructor
|
|
*
|
|
* @param {Number} [synthVoice] A monophonic synth voice inheriting
|
|
* the AudioVoice class. Defaults to p5.MonoSynth
|
|
* @param {Number} [polyValue] Number of voices, defaults to 8;
|
|
*
|
|
*
|
|
* @example
|
|
* <div><code>
|
|
* var polysynth;
|
|
* function setup() {
|
|
* polysynth = new p5.PolySynth();
|
|
* polysynth.play(53,1,0,3);
|
|
* polysynth.play(60,1,0,2.9);
|
|
* polysynth.play(69,1,0,3);
|
|
* polysynth.play(71,1,0,3);
|
|
* polysynth.play(74,1,0,3);
|
|
* }
|
|
* </code></div>
|
|
*
|
|
**/
|
|
p5.PolySynth = function (audioVoice, polyValue) {
|
|
//audiovoices will contain polyValue many monophonic synths
|
|
this.audiovoices = [];
|
|
/**
|
|
* An object that holds information about which notes have been played and
|
|
* which notes are currently being played. New notes are added as keys
|
|
* on the fly. While a note has been attacked, but not released, the value of the
|
|
* key is the audiovoice which is generating that note. When notes are released,
|
|
* the value of the key becomes undefined.
|
|
* @property notes
|
|
*/
|
|
this.notes = {};
|
|
//indices of the most recently used, and least recently used audiovoice
|
|
this._newest = 0;
|
|
this._oldest = 0;
|
|
/**
|
|
* A PolySynth must have at least 1 voice, defaults to 8
|
|
* @property polyvalue
|
|
*/
|
|
this.polyValue = polyValue || 8;
|
|
/**
|
|
* Monosynth that generates the sound for each note that is triggered. The
|
|
* p5.PolySynth defaults to using the p5.MonoSynth as its voice.
|
|
* @property AudioVoice
|
|
*/
|
|
this.AudioVoice = audioVoice === undefined ? p5.MonoSynth : audioVoice;
|
|
/**
|
|
* This value must only change as a note is attacked or released. Due to delay
|
|
* and sustain times, Tone.TimelineSignal is required to schedule the change in value.
|
|
* @private
|
|
* @property {Tone.TimelineSignal} _voicesInUse
|
|
*/
|
|
this._voicesInUse = new TimelineSignal(0);
|
|
this.output = p5sound.audiocontext.createGain();
|
|
this.connect();
|
|
//Construct the appropriate number of audiovoices
|
|
this._allocateVoices();
|
|
p5sound.soundArray.push(this);
|
|
};
|
|
/**
|
|
* Construct the appropriate number of audiovoices
|
|
* @private
|
|
* @method _allocateVoices
|
|
*/
|
|
p5.PolySynth.prototype._allocateVoices = function () {
|
|
for (var i = 0; i < this.polyValue; i++) {
|
|
this.audiovoices.push(new this.AudioVoice());
|
|
this.audiovoices[i].disconnect();
|
|
this.audiovoices[i].connect(this.output);
|
|
}
|
|
};
|
|
/**
|
|
* Play a note by triggering noteAttack and noteRelease with sustain time
|
|
*
|
|
* @method play
|
|
* @param {Number} [note] midi note to play (ranging from 0 to 127 - 60 being a middle C)
|
|
* @param {Number} [velocity] velocity of the note to play (ranging from 0 to 1)
|
|
* @param {Number} [secondsFromNow] time from now (in seconds) at which to play
|
|
* @param {Number} [sustainTime] time to sustain before releasing the envelope
|
|
*/
|
|
p5.PolySynth.prototype.play = function (note, velocity, secondsFromNow, susTime) {
|
|
var susTime = susTime || 1;
|
|
this.noteAttack(note, velocity, secondsFromNow);
|
|
this.noteRelease(note, secondsFromNow + susTime);
|
|
};
|
|
/**
|
|
* noteADSR sets the envelope for a specific note that has just been triggered.
|
|
* Using this method modifies the envelope of whichever audiovoice is being used
|
|
* to play the desired note. The envelope should be reset before noteRelease is called
|
|
* in order to prevent the modified envelope from being used on other notes.
|
|
*
|
|
* @method noteADSR
|
|
* @param {Number} [note] Midi note on which ADSR should be set.
|
|
* @param {Number} [attackTime] Time (in seconds before envelope
|
|
* reaches Attack Level
|
|
* @param {Number} [decayTime] Time (in seconds) before envelope
|
|
* reaches Decay/Sustain Level
|
|
* @param {Number} [susRatio] Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,
|
|
* where 1.0 = attackLevel, 0.0 = releaseLevel.
|
|
* The susRatio determines the decayLevel and the level at which the
|
|
* sustain portion of the envelope will sustain.
|
|
* For example, if attackLevel is 0.4, releaseLevel is 0,
|
|
* and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is
|
|
* increased to 1.0 (using <code>setRange</code>),
|
|
* then decayLevel would increase proportionally, to become 0.5.
|
|
* @param {Number} [releaseTime] Time in seconds from now (defaults to 0)
|
|
**/
|
|
p5.PolySynth.prototype.noteADSR = function (note, a, d, s, r, timeFromNow) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var timeFromNow = timeFromNow || 0;
|
|
var t = now + timeFromNow;
|
|
this.audiovoices[this.notes[note].getValueAtTime(t)].setADSR(a, d, s, r);
|
|
};
|
|
/**
|
|
* Set the PolySynths global envelope. This method modifies the envelopes of each
|
|
* monosynth so that all notes are played with this envelope.
|
|
*
|
|
* @method setADSR
|
|
* @param {Number} [note] Midi note on which ADSR should be set.
|
|
* @param {Number} [attackTime] Time (in seconds before envelope
|
|
* reaches Attack Level
|
|
* @param {Number} [decayTime] Time (in seconds) before envelope
|
|
* reaches Decay/Sustain Level
|
|
* @param {Number} [susRatio] Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,
|
|
* where 1.0 = attackLevel, 0.0 = releaseLevel.
|
|
* The susRatio determines the decayLevel and the level at which the
|
|
* sustain portion of the envelope will sustain.
|
|
* For example, if attackLevel is 0.4, releaseLevel is 0,
|
|
* and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is
|
|
* increased to 1.0 (using <code>setRange</code>),
|
|
* then decayLevel would increase proportionally, to become 0.5.
|
|
* @param {Number} [releaseTime] Time in seconds from now (defaults to 0)
|
|
**/
|
|
p5.PolySynth.prototype.setADSR = function (a, d, s, r) {
|
|
this.audiovoices.forEach(function (voice) {
|
|
voice.setADSR(a, d, s, r);
|
|
});
|
|
};
|
|
/**
|
|
* Trigger the Attack, and Decay portion of a MonoSynth.
|
|
* Similar to holding down a key on a piano, but it will
|
|
* hold the sustain level until you let go.
|
|
*
|
|
* @method noteAttack
|
|
* @param {Number} [note] midi note on which attack should be triggered.
|
|
* @param {Number} [velocity] velocity of the note to play (ranging from 0 to 1)/
|
|
* @param {Number} [secondsFromNow] time from now (in seconds)
|
|
*
|
|
*/
|
|
p5.PolySynth.prototype.noteAttack = function (_note, _velocity, secondsFromNow) {
|
|
var now = p5sound.audiocontext.currentTime;
|
|
//this value goes to the audiovoices which handle their own scheduling
|
|
var tFromNow = secondsFromNow || 0;
|
|
//this value is used by this._voicesInUse
|
|
var t = now + tFromNow;
|
|
//Convert note to frequency if necessary. This is because entries into this.notes
|
|
//should be based on frequency for the sake of consistency.
|
|
var note = typeof _note === 'string' ? this.AudioVoice.prototype._setNote(_note) : typeof _note === 'number' ? _note : 440;
|
|
var velocity = _velocity === undefined ? 1 : _velocity;
|
|
var currentVoice;
|
|
//Release the note if it is already playing
|
|
if (this.notes[note] !== undefined && this.notes[note].getValueAtTime(t) !== null) {
|
|
this.noteRelease(note, 0);
|
|
}
|
|
//Check to see how many voices are in use at the time the note will start
|
|
if (this._voicesInUse.getValueAtTime(t) < this.polyValue) {
|
|
currentVoice = this._voicesInUse.getValueAtTime(t);
|
|
} else {
|
|
currentVoice = this._oldest;
|
|
var oldestNote = p5.prototype.freqToMidi(this.audiovoices[this._oldest].oscillator.freq().value);
|
|
this.noteRelease(oldestNote);
|
|
this._oldest = (this._oldest + 1) % (this.polyValue - 1);
|
|
}
|
|
//Overrite the entry in the notes object. A note (frequency value)
|
|
//corresponds to the index of the audiovoice that is playing it
|
|
this.notes[note] = new TimelineSignal();
|
|
this.notes[note].setValueAtTime(currentVoice, t);
|
|
//Find the scheduled change in this._voicesInUse that will be previous to this new note
|
|
//Add 1 and schedule this value at time 't', when this note will start playing
|
|
var previousVal = this._voicesInUse._searchBefore(t) === null ? 0 : this._voicesInUse._searchBefore(t).value;
|
|
this._voicesInUse.setValueAtTime(previousVal + 1, t);
|
|
//Then update all scheduled values that follow to increase by 1
|
|
this._updateAfter(t, 1);
|
|
this._newest = currentVoice;
|
|
//The audiovoice handles the actual scheduling of the note
|
|
if (typeof velocity === 'number') {
|
|
var maxRange = 1 / this._voicesInUse.getValueAtTime(t) * 2;
|
|
velocity = velocity > maxRange ? maxRange : velocity;
|
|
}
|
|
this.audiovoices[currentVoice].triggerAttack(note, velocity, tFromNow);
|
|
};
|
|
/**
|
|
* Private method to ensure accurate values of this._voicesInUse
|
|
* Any time a new value is scheduled, it is necessary to increment all subsequent
|
|
* scheduledValues after attack, and decrement all subsequent
|
|
* scheduledValues after release
|
|
*
|
|
* @private
|
|
* @param {[type]} time [description]
|
|
* @param {[type]} value [description]
|
|
* @return {[type]} [description]
|
|
*/
|
|
p5.PolySynth.prototype._updateAfter = function (time, value) {
|
|
if (this._voicesInUse._searchAfter(time) === null) {
|
|
return;
|
|
} else {
|
|
this._voicesInUse._searchAfter(time).value += value;
|
|
var nextTime = this._voicesInUse._searchAfter(time).time;
|
|
this._updateAfter(nextTime, value);
|
|
}
|
|
};
|
|
/**
|
|
* Trigger the Release of an AudioVoice note. This is similar to releasing
|
|
* the key on a piano and letting the sound fade according to the
|
|
* release level and release time.
|
|
*
|
|
* @method noteRelease
|
|
* @param {Number} [note] midi note on which attack should be triggered.
|
|
* @param {Number} [secondsFromNow] time to trigger the release
|
|
*
|
|
*/
|
|
p5.PolySynth.prototype.noteRelease = function (_note, secondsFromNow) {
|
|
//Make sure note is in frequency inorder to query the this.notes object
|
|
var note = typeof _note === 'string' ? this.AudioVoice.prototype._setNote(_note) : typeof _note === 'number' ? _note : this.audiovoices[this._newest].oscillator.freq().value;
|
|
var now = p5sound.audiocontext.currentTime;
|
|
var tFromNow = secondsFromNow || 0;
|
|
var t = now + tFromNow;
|
|
if (this.notes[note].getValueAtTime(t) === null) {
|
|
console.warn('Cannot release a note that is not already playing');
|
|
} else {
|
|
//Find the scheduled change in this._voicesInUse that will be previous to this new note
|
|
//subtract 1 and schedule this value at time 't', when this note will stop playing
|
|
var previousVal = this._voicesInUse._searchBefore(t) === null ? 0 : this._voicesInUse._searchBefore(t).value;
|
|
this._voicesInUse.setValueAtTime(previousVal - 1, t);
|
|
//Then update all scheduled values that follow to decrease by 1
|
|
this._updateAfter(t, -1);
|
|
this.audiovoices[this.notes[note].getValueAtTime(t)].triggerRelease(tFromNow);
|
|
this.notes[note].setValueAtTime(null, t);
|
|
this._newest = this._newest === 0 ? 0 : (this._newest - 1) % (this.polyValue - 1);
|
|
}
|
|
};
|
|
/**
|
|
* Connect to a p5.sound / Web Audio object.
|
|
*
|
|
* @method connect
|
|
* @param {Object} unit A p5.sound or Web Audio object
|
|
*/
|
|
p5.PolySynth.prototype.connect = function (unit) {
|
|
var u = unit || p5sound.input;
|
|
this.output.connect(u.input ? u.input : u);
|
|
};
|
|
/**
|
|
* Disconnect all outputs
|
|
*
|
|
* @method disconnect
|
|
*/
|
|
p5.PolySynth.prototype.disconnect = function () {
|
|
this.output.disconnect();
|
|
};
|
|
/**
|
|
* Get rid of the MonoSynth and free up its resources / memory.
|
|
*
|
|
* @method dispose
|
|
*/
|
|
p5.PolySynth.prototype.dispose = function () {
|
|
this.audiovoices.forEach(function (voice) {
|
|
voice.dispose();
|
|
});
|
|
this.output.disconnect();
|
|
delete this.output;
|
|
};
|
|
}(master, Tone_signal_TimelineSignal, sndcore);
|
|
var distortion;
|
|
'use strict';
|
|
distortion = function () {
|
|
var Effect = effect;
|
|
/*
|
|
* Adapted from [Kevin Ennis on StackOverflow](http://stackoverflow.com/questions/22312841/waveshaper-node-in-webaudio-how-to-emulate-distortion)
|
|
*/
|
|
function makeDistortionCurve(amount) {
|
|
var k = typeof amount === 'number' ? amount : 50;
|
|
var numSamples = 44100;
|
|
var curve = new Float32Array(numSamples);
|
|
var deg = Math.PI / 180;
|
|
var i = 0;
|
|
var x;
|
|
for (; i < numSamples; ++i) {
|
|
x = i * 2 / numSamples - 1;
|
|
curve[i] = (3 + k) * x * 20 * deg / (Math.PI + k * Math.abs(x));
|
|
}
|
|
return curve;
|
|
}
|
|
/**
|
|
* A Distortion effect created with a Waveshaper Node,
|
|
* with an approach adapted from
|
|
* [Kevin Ennis](http://stackoverflow.com/questions/22312841/waveshaper-node-in-webaudio-how-to-emulate-distortion)
|
|
*
|
|
* This class extends <a href = "/reference/#/p5.Effect">p5.Effect</a>.
|
|
* Methods <a href = "/reference/#/p5.Effect/amp">amp()</a>, <a href = "/reference/#/p5.Effect/chain">chain()</a>,
|
|
* <a href = "/reference/#/p5.Effect/drywet">drywet()</a>, <a href = "/reference/#/p5.Effect/connect">connect()</a>, and
|
|
* <a href = "/reference/#/p5.Effect/disconnect">disconnect()</a> are available.
|
|
*
|
|
* @class p5.Distortion
|
|
* @extends p5.Effect
|
|
* @constructor
|
|
* @param {Number} [amount=0.25] Unbounded distortion amount.
|
|
* Normal values range from 0-1.
|
|
* @param {String} [oversample='none'] 'none', '2x', or '4x'.
|
|
*
|
|
*/
|
|
p5.Distortion = function (amount, oversample) {
|
|
Effect.call(this);
|
|
if (typeof amount === 'undefined') {
|
|
amount = 0.25;
|
|
}
|
|
if (typeof amount !== 'number') {
|
|
throw new Error('amount must be a number');
|
|
}
|
|
if (typeof oversample === 'undefined') {
|
|
oversample = '2x';
|
|
}
|
|
if (typeof oversample !== 'string') {
|
|
throw new Error('oversample must be a String');
|
|
}
|
|
var curveAmount = p5.prototype.map(amount, 0, 1, 0, 2000);
|
|
/**
|
|
* The p5.Distortion is built with a
|
|
* <a href="http://www.w3.org/TR/webaudio/#WaveShaperNode">
|
|
* Web Audio WaveShaper Node</a>.
|
|
*
|
|
* @property {AudioNode} WaveShaperNode
|
|
*/
|
|
this.waveShaperNode = this.ac.createWaveShaper();
|
|
this.amount = curveAmount;
|
|
this.waveShaperNode.curve = makeDistortionCurve(curveAmount);
|
|
this.waveShaperNode.oversample = oversample;
|
|
this.input.connect(this.waveShaperNode);
|
|
this.waveShaperNode.connect(this.wet);
|
|
};
|
|
p5.Distortion.prototype = Object.create(Effect.prototype);
|
|
/**
|
|
* Process a sound source, optionally specify amount and oversample values.
|
|
*
|
|
* @method process
|
|
* @param {Number} [amount=0.25] Unbounded distortion amount.
|
|
* Normal values range from 0-1.
|
|
* @param {String} [oversample='none'] 'none', '2x', or '4x'.
|
|
*/
|
|
p5.Distortion.prototype.process = function (src, amount, oversample) {
|
|
src.connect(this.input);
|
|
this.set(amount, oversample);
|
|
};
|
|
/**
|
|
* Set the amount and oversample of the waveshaper distortion.
|
|
*
|
|
* @method set
|
|
* @param {Number} [amount=0.25] Unbounded distortion amount.
|
|
* Normal values range from 0-1.
|
|
* @param {String} [oversample='none'] 'none', '2x', or '4x'.
|
|
*/
|
|
p5.Distortion.prototype.set = function (amount, oversample) {
|
|
if (amount) {
|
|
var curveAmount = p5.prototype.map(amount, 0, 1, 0, 2000);
|
|
this.amount = curveAmount;
|
|
this.waveShaperNode.curve = makeDistortionCurve(curveAmount);
|
|
}
|
|
if (oversample) {
|
|
this.waveShaperNode.oversample = oversample;
|
|
}
|
|
};
|
|
/**
|
|
* Return the distortion amount, typically between 0-1.
|
|
*
|
|
* @method getAmount
|
|
* @return {Number} Unbounded distortion amount.
|
|
* Normal values range from 0-1.
|
|
*/
|
|
p5.Distortion.prototype.getAmount = function () {
|
|
return this.amount;
|
|
};
|
|
/**
|
|
* Return the oversampling.
|
|
*
|
|
* @method getOversample
|
|
*
|
|
* @return {String} Oversample can either be 'none', '2x', or '4x'.
|
|
*/
|
|
p5.Distortion.prototype.getOversample = function () {
|
|
return this.waveShaperNode.oversample;
|
|
};
|
|
p5.Distortion.prototype.dispose = function () {
|
|
Effect.prototype.dispose.apply(this);
|
|
this.waveShaperNode.disconnect();
|
|
this.waveShaperNode = null;
|
|
};
|
|
}(effect);
|
|
var src_app;
|
|
'use strict';
|
|
src_app = function () {
|
|
var p5SOUND = sndcore;
|
|
return p5SOUND;
|
|
}(sndcore, master, helpers, errorHandler, panner, soundfile, amplitude, fft, signal, oscillator, env, pulse, noise, audioin, filter, eq, panner3d, listener3d, delay, reverb, metro, looper, soundloop, compressor, soundRecorder, peakdetect, gain, monosynth, polysynth, distortion, audioVoice, monosynth, polysynth);
|
|
})); |