mirror of
https://github.com/Tonejs/Tone.js
synced 2024-11-17 00:58:09 +00:00
98 lines
No EOL
2.5 KiB
JavaScript
98 lines
No EOL
2.5 KiB
JavaScript
define(["Tone/core/Tone", "Tone/type/Type", "Tone/core/Master"], function(Tone){
|
|
|
|
"use strict";
|
|
|
|
/**
|
|
* @class Base-class for all instruments
|
|
*
|
|
* @constructor
|
|
* @extends {Tone}
|
|
*/
|
|
Tone.Instrument = function(options){
|
|
|
|
//get the defaults
|
|
options = Tone.defaultArg(options, Tone.Instrument.defaults);
|
|
Tone.call(this);
|
|
|
|
/**
|
|
* The output and volume triming node
|
|
* @type {Tone.Volume}
|
|
* @private
|
|
*/
|
|
this._volume = this.output = new Tone.Volume(options.volume);
|
|
|
|
/**
|
|
* The volume of the output in decibels.
|
|
* @type {Decibels}
|
|
* @signal
|
|
* @example
|
|
* source.volume.value = -6;
|
|
*/
|
|
this.volume = this._volume.volume;
|
|
this._readOnly("volume");
|
|
};
|
|
|
|
Tone.extend(Tone.Instrument);
|
|
|
|
/**
|
|
* the default attributes
|
|
* @type {object}
|
|
*/
|
|
Tone.Instrument.defaults = {
|
|
/** the volume of the output in decibels */
|
|
"volume" : 0
|
|
};
|
|
|
|
/**
|
|
* @abstract
|
|
* @param {string|number} note the note to trigger
|
|
* @param {Time} [time=now] the time to trigger the ntoe
|
|
* @param {number} [velocity=1] the velocity to trigger the note
|
|
*/
|
|
Tone.Instrument.prototype.triggerAttack = Tone.noOp;
|
|
|
|
/**
|
|
* @abstract
|
|
* @param {Time} [time=now] when to trigger the release
|
|
*/
|
|
Tone.Instrument.prototype.triggerRelease = Tone.noOp;
|
|
|
|
/**
|
|
* Trigger the attack and then the release after the duration.
|
|
* @param {Frequency} note The note to trigger.
|
|
* @param {Time} duration How long the note should be held for before
|
|
* triggering the release. This value must be greater than 0.
|
|
* @param {Time} [time=now] When the note should be triggered.
|
|
* @param {NormalRange} [velocity=1] The velocity the note should be triggered at.
|
|
* @returns {Tone.Instrument} this
|
|
* @example
|
|
* //trigger "C4" for the duration of an 8th note
|
|
* synth.triggerAttackRelease("C4", "8n");
|
|
*/
|
|
Tone.Instrument.prototype.triggerAttackRelease = function(note, duration, time, velocity){
|
|
if (Tone.isUndef(time)){
|
|
time = this.now() + this.blockTime;
|
|
} else {
|
|
time = this.toSeconds(time);
|
|
}
|
|
duration = this.toSeconds(duration);
|
|
this.triggerAttack(note, time, velocity);
|
|
this.triggerRelease(time + duration);
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* clean up
|
|
* @returns {Tone.Instrument} this
|
|
*/
|
|
Tone.Instrument.prototype.dispose = function(){
|
|
Tone.prototype.dispose.call(this);
|
|
this._volume.dispose();
|
|
this._volume = null;
|
|
this._writable(["volume"]);
|
|
this.volume = null;
|
|
return this;
|
|
};
|
|
|
|
return Tone.Instrument;
|
|
}); |