13
0
livetrax/share/web_surfaces/builtin/mixer/toolkit/modules/eqband.js

186 lines
6.8 KiB
JavaScript
Raw Normal View History

2020-06-21 17:29:27 -04:00
/*
* This file is part of Toolkit.
*
* Toolkit is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public
* License as published by the Free Software Foundation; either
* version 3 of the License, or (at your option) any later version.
*
* Toolkit is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU General
* Public License along with this program; if not, write to the
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301 USA
*/
"use strict";
(function(w, TK){
var type_to_mode = {
parametric: "circular",
notch: "line-vertical",
lowpass1: "block-right",
lowpass2: "block-right",
lowpass3: "block-right",
lowpass4: "block-right",
highpass1: "block-left",
highpass2: "block-left",
highpass3: "block-left",
highpass4: "block-left",
"low-shelf": "line-vertical",
"high-shelf": "line-vertical",
};
var type_to_pref = {
parametric: ["left", "top", "right", "bottom"],
notch: ["left", "right", "top", "bottom"],
lowpass1: ["left", "top-left", "bottom-left", "right", "top-right", "bottom-right", "top", "bottom"],
lowpass2: ["left", "top-left", "bottom-left", "right", "top-right", "bottom-right", "top", "bottom"],
lowpass3: ["left", "top-left", "bottom-left", "right", "top-right", "bottom-right", "top", "bottom"],
lowpass4: ["left", "top-left", "bottom-left", "right", "top-right", "bottom-right", "top", "bottom"],
highpass1: ["right", "top-right", "bottom-right", "left", "top-left", "bottom-left", "top", "bottom"],
highpass2: ["right", "top-right", "bottom-right", "left", "top-left", "bottom-left", "top", "bottom"],
highpass3: ["right", "top-right", "bottom-right", "left", "top-left", "bottom-left", "top", "bottom"],
highpass4: ["right", "top-right", "bottom-right", "left", "top-left", "bottom-left", "top", "bottom"],
"low-shelf": ["left", "right", "top", "bottom"],
"high-shelf": ["left", "right", "top", "bottom"],
};
TK.EqBand = TK.class({
/**
* An TK.EqBand extends a {@link TK.ResponseHandle} and holds a
* dependent {@link TK.Filter}. It is used as a fully functional representation
* of a single equalizer band in {@link TK.Equalizer} TK.EqBand needs a {@link TK.Chart}
* or any other derivate to be drawn in.
*
* @class TK.EqBand
*
* @param {Object} [options={ }] - An object containing initial options.
*
* @property {String|Function} [options.type="parametric"] - The type of the filter.
* Possible values are <code>parametric</code>, <code>notch</code>,
* <code>low-shelf</code>, <code>high-shelf</code>, <code>lowpass[n]</code> or
* <code>highpass[n]</code>.
* @property {Number} options.freq - Frequency setting. This is an alias for the option <code>x</code>
* defined by {@link TK.ResponseHandle}.
* @property {Number} options.gain - Gain setting. This is an alias for the option <code>y</code>
* defined by {@link TK.ResponseHandle}.
* @property {Number} options.q - Quality setting. This is an alias for the option <code>z</code>
* defined by {@link TK.ResponseHandle}.
*
* @extends TK.ResponseHandle
*/
_class: "EqBand",
Extends: TK.ResponseHandle,
_options: Object.assign(Object.create(TK.ResponseHandle.prototype._options), {
type: "string|function",
gain: "number",
freq: "number",
x: "number",
y: "number",
z: "number",
q: "number",
}),
options: {
type: "parametric"
},
static_events: {
set_freq: function(v) { this.set("x", v); },
set_gain: function(v) { this.set("y", v); },
set_q: function(v) { this.set("z", v); },
useraction: function(k, v) {
if (k === 'x') this.set("freq", v);
if (k === 'y') this.set("gain", v);
if (k === 'z') this.set("q", v);
},
},
initialize: function (options) {
/**
* @member {TK.Filter} TK.EqBand#filter - The filter providing the graphical calculations.
*/
this.filter = new TK.Filter({
type: options.type,
});
TK.ResponseHandle.prototype.initialize.call(this, options);
if (options.mode) var _m = options.mode;
this.set("type", this.options.type);
if (_m) this.set("mode", options.mode);
if (options.x !== void(0))
this.set("x", options.x);
else if (options.freq !== void(0))
this.set("freq", options.freq);
if (options.y !== void(0))
this.set("y", options.y);
else if (options.gain !== void(0))
this.set("gain", options.gain);
if (options.z !== void(0))
this.set("z", options.z);
else if (options.q !== void(0))
this.set("q", options.q);
/**
* @member {HTMLDivElement} TK.EqBand#element - The main SVG group.
* Has class <code>toolkit-eqband</code>.
*/
TK.add_class(this.element, "toolkit-eqband");
this.filter.reset();
},
/**
* Calculate the gain for a given frequency in Hz.
*
* @method TK.EqBand#freq2gain
*
* @param {number} freq - The frequency.
*
* @returns {number} The gain at the given frequency.
*/
freq2gain: function (freq) {
return this.filter.get_freq2gain()(freq);
},
// GETTER & SETTER
set: function (key, value) {
switch (key) {
case "type":
if (typeof value === "string") {
var mode = type_to_mode[value];
var pref = type_to_pref[value];
if (!mode) {
TK.warn("Unsupported type:", value);
return;
}
this.set("mode", mode);
this.set("preferences", pref);
this.set("show_axis", mode === "line-vertical");
}
this.filter.set("type", value);
break;
case "freq":
case "gain":
case "q":
value = this.filter.set(key, value);
break;
case "x":
value = this.range_x.snap(value);
break;
case "y":
value = this.range_y.snap(value);
break;
case "z":
value = this.range_z.snap(value);
break;
}
return TK.ResponseHandle.prototype.set.call(this, key, value);
}
});
})(this, this.TK);