import Tone from "../core/Tone"; import "../component/AmplitudeEnvelope"; import "../source/OmniOscillator"; import "../instrument/Monophonic"; /** * @class Tone.Synth is composed simply of a Tone.OmniOscillator * routed through a Tone.AmplitudeEnvelope. * * * @constructor * @extends {Tone.Monophonic} * @param {Object} [options] the options available for the synth * see defaults below * @example * var synth = new Tone.Synth().toMaster(); * synth.triggerAttackRelease("C4", "8n"); */ Tone.Synth = function(options){ //get the defaults options = Tone.defaultArg(options, Tone.Synth.defaults); Tone.Monophonic.call(this, options); /** * The oscillator. * @type {Tone.OmniOscillator} */ this.oscillator = new Tone.OmniOscillator(options.oscillator); /** * The frequency control. * @type {Frequency} * @signal */ this.frequency = this.oscillator.frequency; /** * The detune control. * @type {Cents} * @signal */ this.detune = this.oscillator.detune; /** * The amplitude envelope. * @type {Tone.AmplitudeEnvelope} */ this.envelope = new Tone.AmplitudeEnvelope(options.envelope); //connect the oscillators to the output this.oscillator.chain(this.envelope, this.output); this._readOnly(["oscillator", "frequency", "detune", "envelope"]); }; Tone.extend(Tone.Synth, Tone.Monophonic); /** * @const * @static * @type {Object} */ Tone.Synth.defaults = { "oscillator" : { "type" : "triangle" }, "envelope" : { "attack" : 0.005, "decay" : 0.1, "sustain" : 0.3, "release" : 1 } }; /** * start the attack portion of the envelope * @param {Time} [time=now] the time the attack should start * @param {number} [velocity=1] the velocity of the note (0-1) * @returns {Tone.Synth} this * @private */ Tone.Synth.prototype._triggerEnvelopeAttack = function(time, velocity){ //the envelopes this.envelope.triggerAttack(time, velocity); this.oscillator.start(time); //if there is no release portion, stop the oscillator if (this.envelope.sustain === 0){ this.oscillator.stop(time + this.envelope.attack + this.envelope.decay); } return this; }; /** * start the release portion of the envelope * @param {Time} [time=now] the time the release should start * @returns {Tone.Synth} this * @private */ Tone.Synth.prototype._triggerEnvelopeRelease = function(time){ time = this.toSeconds(time); this.envelope.triggerRelease(time); this.oscillator.stop(time + this.envelope.release); return this; }; /** * clean up * @returns {Tone.Synth} this */ Tone.Synth.prototype.dispose = function(){ Tone.Monophonic.prototype.dispose.call(this); this._writable(["oscillator", "frequency", "detune", "envelope"]); this.oscillator.dispose(); this.oscillator = null; this.envelope.dispose(); this.envelope = null; this.frequency = null; this.detune = null; return this; }; export default Tone.Synth;