mirror of
https://github.com/Tonejs/Tone.js
synced 2025-01-10 02:48:47 +00:00
78 lines
No EOL
1.9 KiB
JavaScript
78 lines
No EOL
1.9 KiB
JavaScript
define(["Tone/core/Tone", "Tone/core/Master", "Tone/core/Note"], function(Tone){
|
|
|
|
"use strict";
|
|
|
|
/**
|
|
* @class Base-class for all instruments
|
|
*
|
|
* @constructor
|
|
* @extends {Tone}
|
|
*/
|
|
Tone.Instrument = function(){
|
|
|
|
/**
|
|
* the output
|
|
* @type {GainNode}
|
|
*/
|
|
this.output = this.context.createGain();
|
|
};
|
|
|
|
Tone.extend(Tone.Instrument);
|
|
|
|
/**
|
|
* @abstract
|
|
* @param {string|number} note the note to trigger
|
|
* @param {Tone.Time} [time=now] the time to trigger the ntoe
|
|
* @param {number} [velocity=1] the velocity to trigger the note
|
|
*/
|
|
Tone.Instrument.prototype.triggerAttack = function(){};
|
|
|
|
/**
|
|
* @abstract
|
|
* @param {Tone.Time} [time=now] when to trigger the release
|
|
*/
|
|
Tone.Instrument.prototype.triggerRelease = function(){};
|
|
|
|
/**
|
|
* trigger the attack and then the release
|
|
* @param {string|number} note the note to trigger
|
|
* @param {Tone.Time} duration the duration of the note
|
|
* @param {Tone.Time} [time=now] the time of the attack
|
|
* @param {number} velocity the velocity
|
|
*/
|
|
Tone.Instrument.prototype.triggerAttackRelease = function(note, duration, time, velocity){
|
|
time = this.toSeconds(time);
|
|
duration = this.toSeconds(duration);
|
|
this.triggerAttack(note, time, velocity);
|
|
this.triggerRelease(time + duration);
|
|
};
|
|
|
|
/**
|
|
* bulk setter
|
|
* @param {Object} params the params
|
|
*/
|
|
Tone.Instrument.prototype.set = function(params) {
|
|
if (!this.isUndef(params.volume)) this.setVolume(params.volume);
|
|
};
|
|
|
|
/**
|
|
* gets the setVolume method from {@link Tone.Master}
|
|
* @method
|
|
*/
|
|
Tone.Instrument.prototype.setVolume = Tone.Master.setVolume;
|
|
|
|
/**
|
|
* gets the setVolume method from {@link Tone.Master}
|
|
* @method
|
|
*/
|
|
Tone.Instrument.prototype.setVolume = Tone.Master.setVolume;
|
|
|
|
/**
|
|
* clean up
|
|
*/
|
|
Tone.Instrument.prototype.dispose = function(){
|
|
Tone.prototype.dispose.call(this);
|
|
};
|
|
|
|
return Tone.Instrument;
|
|
}); |