mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-22 09:45:41 +00:00
Bug 1403944 - Remove Web Audio Editor actor and spec; r=vporof
Differential Revision: https://phabricator.services.mozilla.com/D19528 --HG-- extra : moz-landing-system : lando
This commit is contained in:
yulia
parent
f3cd627b57
commit
fe4252e6e1
@ -18,7 +18,7 @@ async function testTarget(client, target) {
|
||||
let desc = await target.getActorDescription("storage");
|
||||
is(desc.typeName, "storage",
|
||||
"target.getActorDescription() returns definition data for corresponding actor");
|
||||
is(desc.events["start-context"].type, "startContext",
|
||||
is(desc.events["stores-update"].type, "storesUpdate",
|
||||
"target.getActorDescription() returns event data for corresponding actor");
|
||||
|
||||
desc = await target.getActorDescription("nope");
|
||||
@ -26,7 +26,7 @@ async function testTarget(client, target) {
|
||||
desc = await target.getActorDescription();
|
||||
is(desc, undefined, "target.getActorDescription() returns undefined for undefined actor");
|
||||
|
||||
let hasMethod = await target.actorHasMethod("localStorage", "getType");
|
||||
let hasMethod = await target.actorHasMethod("storage", "listStores");
|
||||
is(hasMethod, true,
|
||||
"target.actorHasMethod() returns true for existing actor with method");
|
||||
hasMethod = await target.actorHasMethod("localStorage", "nope");
|
||||
|
||||
@ -73,7 +73,6 @@ devtools.jar:
|
||||
skin/images/arrowhead-up.svg (themes/images/arrowhead-up.svg)
|
||||
skin/images/breadcrumbs-divider.svg (themes/images/breadcrumbs-divider.svg)
|
||||
skin/images/checkbox.svg (themes/images/checkbox.svg)
|
||||
skin/images/filters.svg (themes/images/filters.svg)
|
||||
skin/images/filter-swatch.svg (themes/images/filter-swatch.svg)
|
||||
skin/images/aboutdebugging-connect-icon.svg (themes/images/aboutdebugging-connect-icon.svg)
|
||||
skin/images/aboutdebugging-firefox-aurora.svg (themes/images/aboutdebugging-firefox-aurora.svg)
|
||||
@ -97,7 +96,6 @@ devtools.jar:
|
||||
skin/breadcrumbs.css (themes/breadcrumbs.css)
|
||||
skin/chart.css (themes/chart.css)
|
||||
skin/widgets.css (themes/widgets.css)
|
||||
skin/images/power.svg (themes/images/power.svg)
|
||||
skin/rules.css (themes/rules.css)
|
||||
skin/images/command-paintflashing.svg (themes/images/command-paintflashing.svg)
|
||||
skin/images/command-screenshot.svg (themes/images/command-screenshot.svg)
|
||||
|
||||
@ -59,7 +59,6 @@ DevToolsModules(
|
||||
'styles.js',
|
||||
'stylesheets.js',
|
||||
'thread.js',
|
||||
'webaudio.js',
|
||||
'webbrowser.js',
|
||||
'webconsole.js',
|
||||
)
|
||||
@ -91,8 +90,5 @@ with Files('storage.js'):
|
||||
with Files('stylesheets.js'):
|
||||
BUG_COMPONENT = ('DevTools', 'Style Editor')
|
||||
|
||||
with Files('webaudio.js'):
|
||||
BUG_COMPONENT = ('DevTools', 'Web Audio Editor')
|
||||
|
||||
with Files('webconsole.js'):
|
||||
BUG_COMPONENT = ('DevTools', 'Console')
|
||||
|
||||
@ -172,8 +172,7 @@ function enumObjectProperties(objectActor, options) {
|
||||
|
||||
// It appears that getOwnPropertyNames always returns indexed properties
|
||||
// first, so we can safely slice `names` for/against indexed properties.
|
||||
// We do such clever operation to optimize very large array inspection,
|
||||
// like webaudio buffers.
|
||||
// We do such clever operation to optimize very large array inspection.
|
||||
if (options.ignoreIndexedProperties) {
|
||||
// Keep items after `sliceIndex` index
|
||||
names = names.slice(sliceIndex);
|
||||
|
||||
@ -163,11 +163,6 @@ const ActorRegistry = {
|
||||
constructor: "InspectorActor",
|
||||
type: { target: true },
|
||||
});
|
||||
this.registerModule("devtools/server/actors/webaudio", {
|
||||
prefix: "webaudio",
|
||||
constructor: "WebAudioActor",
|
||||
type: { target: true },
|
||||
});
|
||||
this.registerModule("devtools/server/actors/stylesheets", {
|
||||
prefix: "styleSheets",
|
||||
constructor: "StyleSheetsActor",
|
||||
|
||||
@ -1,121 +0,0 @@
|
||||
{
|
||||
"OscillatorNode": {
|
||||
"source": true,
|
||||
"properties": {
|
||||
"type": {},
|
||||
"frequency": {
|
||||
"param": true
|
||||
},
|
||||
"detune": {
|
||||
"param": true
|
||||
}
|
||||
}
|
||||
},
|
||||
"GainNode": {
|
||||
"properties": { "gain": { "param": true }}
|
||||
},
|
||||
"DelayNode": {
|
||||
"properties": { "delayTime": { "param": true }}
|
||||
},
|
||||
"AudioBufferSourceNode": {
|
||||
"source": true,
|
||||
"properties": {
|
||||
"buffer": { "Buffer": true },
|
||||
"playbackRate": {
|
||||
"param": true
|
||||
},
|
||||
"loop": {},
|
||||
"loopStart": {},
|
||||
"loopEnd": {}
|
||||
}
|
||||
},
|
||||
"ScriptProcessorNode": {
|
||||
"properties": { "bufferSize": { "readonly": true }}
|
||||
},
|
||||
"PannerNode": {
|
||||
"properties": {
|
||||
"panningModel": {},
|
||||
"distanceModel": {},
|
||||
"refDistance": {},
|
||||
"maxDistance": {},
|
||||
"rolloffFactor": {},
|
||||
"coneInnerAngle": {},
|
||||
"coneOuterAngle": {},
|
||||
"coneOuterGain": {}
|
||||
}
|
||||
},
|
||||
"ConvolverNode": {
|
||||
"properties": {
|
||||
"buffer": { "Buffer": true },
|
||||
"normalize": {}
|
||||
}
|
||||
},
|
||||
"DynamicsCompressorNode": {
|
||||
"properties": {
|
||||
"threshold": { "param": true },
|
||||
"knee": { "param": true },
|
||||
"ratio": { "param": true },
|
||||
"reduction": {},
|
||||
"attack": { "param": true },
|
||||
"release": { "param": true }
|
||||
}
|
||||
},
|
||||
"BiquadFilterNode": {
|
||||
"properties": {
|
||||
"type": {},
|
||||
"frequency": { "param": true },
|
||||
"Q": { "param": true },
|
||||
"detune": { "param": true },
|
||||
"gain": { "param": true }
|
||||
}
|
||||
},
|
||||
"WaveShaperNode": {
|
||||
"properties": {
|
||||
"curve": { "Float32Array": true },
|
||||
"oversample": {}
|
||||
}
|
||||
},
|
||||
"AnalyserNode": {
|
||||
"properties": {
|
||||
"fftSize": {},
|
||||
"minDecibels": {},
|
||||
"maxDecibels": {},
|
||||
"smoothingTimeConstant": {},
|
||||
"frequencyBinCount": { "readonly": true }
|
||||
}
|
||||
},
|
||||
"AudioDestinationNode": {
|
||||
"unbypassable": true
|
||||
},
|
||||
"ChannelSplitterNode": {
|
||||
"unbypassable": true
|
||||
},
|
||||
"ChannelMergerNode": {
|
||||
"unbypassable": true
|
||||
},
|
||||
"MediaElementAudioSourceNode": {
|
||||
"source": true
|
||||
},
|
||||
"MediaStreamAudioSourceNode": {
|
||||
"source": true
|
||||
},
|
||||
"MediaStreamAudioDestinationNode": {
|
||||
"unbypassable": true,
|
||||
"properties": {
|
||||
"stream": { "MediaStream": true }
|
||||
}
|
||||
},
|
||||
"StereoPannerNode": {
|
||||
"properties": {
|
||||
"pan": { "param": true }
|
||||
}
|
||||
},
|
||||
"ConstantSourceNode": {
|
||||
"source": true,
|
||||
"properties": {
|
||||
"offset": { "param": true }
|
||||
}
|
||||
},
|
||||
"IIRFilterNode": {
|
||||
}
|
||||
}
|
||||
@ -1,373 +0,0 @@
|
||||
/**
|
||||
* web-audio-automation-timeline - 1.0.3
|
||||
* https://github.com/jsantell/web-audio-automation-timeline
|
||||
* MIT License, copyright (c) 2014 Jordan Santell
|
||||
*/
|
||||
!function(e){if("object"==typeof exports&&"undefined"!=typeof module)module.exports=e();else if("function"==typeof define&&define.amd)define([],e);else{var f;"undefined"!=typeof window?f=window:"undefined"!=typeof global?f=global:"undefined"!=typeof self&&(f=self),f.Timeline=e()}}(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
|
||||
module.exports = require("./lib/timeline").Timeline;
|
||||
|
||||
},{"./lib/timeline":4}],2:[function(require,module,exports){
|
||||
var F = require("./formulas");
|
||||
|
||||
function TimelineEvent (eventName, value, time, timeConstant, duration) {
|
||||
this.type = eventName;
|
||||
this.value = value;
|
||||
this.time = time;
|
||||
this.constant = timeConstant || 0;
|
||||
this.duration = duration || 0;
|
||||
}
|
||||
exports.TimelineEvent = TimelineEvent;
|
||||
|
||||
|
||||
TimelineEvent.prototype.exponentialApproach = function (lastValue, time) {
|
||||
return F.exponentialApproach(this.time, lastValue, this.value, this.constant, time);
|
||||
}
|
||||
|
||||
TimelineEvent.prototype.extractValueFromCurve = function (time) {
|
||||
return F.extractValueFromCurve(this.time, this.value, this.value.length, this.duration, time);
|
||||
}
|
||||
|
||||
TimelineEvent.prototype.linearInterpolate = function (next, time) {
|
||||
return F.linearInterpolate(this.time, this.value, next.time, next.value, time);
|
||||
}
|
||||
|
||||
TimelineEvent.prototype.exponentialInterpolate = function (next, time) {
|
||||
return F.exponentialInterpolate(this.time, this.value, next.time, next.value, time);
|
||||
}
|
||||
|
||||
},{"./formulas":3}],3:[function(require,module,exports){
|
||||
var EPSILON = 0.0000000001;
|
||||
|
||||
exports.linearInterpolate = function (t0, v0, t1, v1, t) {
|
||||
return v0 + (v1 - v0) * ((t - t0) / (t1 - t0));
|
||||
};
|
||||
|
||||
exports.exponentialInterpolate = function (t0, v0, t1, v1, t) {
|
||||
return v0 * Math.pow(v1 / v0, (t - t0) / (t1 - t0));
|
||||
};
|
||||
|
||||
exports.extractValueFromCurve = function (start, curve, curveLength, duration, t) {
|
||||
var ratio;
|
||||
|
||||
// If time is after duration, return the last curve value,
|
||||
// or if ratio is >= 1
|
||||
if (t >= start + duration || (ratio = Math.max((t - start) / duration, 0)) >= 1) {
|
||||
return curve[curveLength - 1];
|
||||
}
|
||||
|
||||
return curve[~~(curveLength * ratio)];
|
||||
};
|
||||
|
||||
exports.exponentialApproach = function (t0, v0, v1, timeConstant, t) {
|
||||
return v1 + (v0 - v1) * Math.exp(-(t - t0) / timeConstant);
|
||||
};
|
||||
|
||||
// Since we are going to accumulate error by adding 0.01 multiple times
|
||||
// in a loop, we want to fuzz the equality check in `getValueAtTime`
|
||||
exports.fuzzyEqual = function (lhs, rhs) {
|
||||
return Math.abs(lhs - rhs) < EPSILON;
|
||||
};
|
||||
|
||||
exports.EPSILON = EPSILON;
|
||||
|
||||
},{}],4:[function(require,module,exports){
|
||||
var TimelineEvent = require("./event").TimelineEvent;
|
||||
var F = require("./formulas");
|
||||
|
||||
exports.Timeline = Timeline;
|
||||
|
||||
function Timeline (defaultValue) {
|
||||
this.events = [];
|
||||
|
||||
this._value = defaultValue || 0;
|
||||
}
|
||||
|
||||
Timeline.prototype.getEventCount = function () {
|
||||
return this.events.length;
|
||||
};
|
||||
|
||||
Timeline.prototype.value = function () {
|
||||
return this._value;
|
||||
};
|
||||
|
||||
Timeline.prototype.setValue = function (value) {
|
||||
if (this.events.length === 0) {
|
||||
this._value = value;
|
||||
}
|
||||
};
|
||||
|
||||
Timeline.prototype.getValue = function () {
|
||||
if (this.events.length) {
|
||||
throw new Error("Can only call `getValue` when there are 0 events.");
|
||||
}
|
||||
|
||||
return this._value;
|
||||
};
|
||||
|
||||
Timeline.prototype.getValueAtTime = function (time) {
|
||||
return this._getValueAtTimeHelper(time);
|
||||
};
|
||||
|
||||
Timeline.prototype._getValueAtTimeHelper = function (time) {
|
||||
var bailOut = false;
|
||||
var previous = null;
|
||||
var next = null;
|
||||
var lastComputedValue = null; // Used for `setTargetAtTime` nodes
|
||||
var events = this.events;
|
||||
var e;
|
||||
|
||||
for (var i = 0; !bailOut && i < events.length; i++) {
|
||||
if (F.fuzzyEqual(time, events[i].time)) {
|
||||
// Find the last event with the same time as `time`
|
||||
do {
|
||||
++i;
|
||||
} while (i < events.length && F.fuzzyEqual(time, events[i].time));
|
||||
|
||||
e = events[i - 1];
|
||||
|
||||
// `setTargetAtTime` can be handled no matter what their next event is (if they have one)
|
||||
if (e.type === "setTargetAtTime") {
|
||||
lastComputedValue = this._lastComputedValue(e);
|
||||
return e.exponentialApproach(lastComputedValue, time);
|
||||
}
|
||||
|
||||
// `setValueCurveAtTime` events can be handled no matter what their next event node is
|
||||
// (if they have one)
|
||||
if (e.type === "setValueCurveAtTime") {
|
||||
return e.extractValueFromCurve(time);
|
||||
}
|
||||
|
||||
// For other event types
|
||||
return e.value;
|
||||
}
|
||||
previous = next;
|
||||
next = events[i];
|
||||
|
||||
if (time < events[i].time) {
|
||||
bailOut = true;
|
||||
}
|
||||
}
|
||||
|
||||
// Handle the case where the time is past all of the events
|
||||
if (!bailOut) {
|
||||
previous = next;
|
||||
next = null;
|
||||
}
|
||||
|
||||
// Just return the default value if we did not find anything
|
||||
if (!previous && !next) {
|
||||
return this._value;
|
||||
}
|
||||
|
||||
// If the requested time is before all of the existing events
|
||||
if (!previous) {
|
||||
return this._value;
|
||||
}
|
||||
|
||||
// `setTargetAtTime` can be handled no matter what their next event is (if they have one)
|
||||
if (previous.type === "setTargetAtTime") {
|
||||
lastComputedValue = this._lastComputedValue(previous);
|
||||
return previous.exponentialApproach(lastComputedValue, time);
|
||||
}
|
||||
|
||||
// `setValueCurveAtTime` events can be handled no matter what their next event node is
|
||||
// (if they have one)
|
||||
if (previous.type === "setValueCurveAtTime") {
|
||||
return previous.extractValueFromCurve(time);
|
||||
}
|
||||
|
||||
if (!next) {
|
||||
if (~["setValueAtTime", "linearRampToValueAtTime", "exponentialRampToValueAtTime"].indexOf(previous.type)) {
|
||||
return previous.value;
|
||||
}
|
||||
if (previous.type === "setValueCurveAtTime") {
|
||||
return previous.extractValueFromCurve(time);
|
||||
}
|
||||
if (previous.type === "setTargetAtTime") {
|
||||
throw new Error("unreached");
|
||||
}
|
||||
throw new Error("unreached");
|
||||
}
|
||||
|
||||
// Finally handle the case where we have both a previous and a next event
|
||||
// First handle the case where our range ends up in a ramp event
|
||||
if (next.type === "linearRampToValueAtTime") {
|
||||
return previous.linearInterpolate(next, time);
|
||||
} else if (next.type === "exponentialRampToValueAtTime") {
|
||||
return previous.exponentialInterpolate(next, time);
|
||||
}
|
||||
|
||||
// Now handle all other cases
|
||||
if (~["setValueAtTime", "linearRampToValueAtTime", "exponentialRampToValueAtTime"].indexOf(previous.type)) {
|
||||
// If the next event type is neither linear or exponential ramp,
|
||||
// the value is constant.
|
||||
return previous.value;
|
||||
}
|
||||
if (previous.type === "setValueCurveAtTime") {
|
||||
return previous.extractValueFromCurve(time);
|
||||
}
|
||||
if (previous.type === "setTargetAtTime") {
|
||||
throw new Error("unreached");
|
||||
}
|
||||
throw new Error("unreached");
|
||||
};
|
||||
|
||||
Timeline.prototype._insertEvent = function (ev) {
|
||||
var events = this.events;
|
||||
|
||||
if (ev.type === "setValueCurveAtTime") {
|
||||
if (!ev.value || !ev.value.length) {
|
||||
throw new Error("NS_ERROR_DOM_SYNTAX_ERR");
|
||||
}
|
||||
}
|
||||
|
||||
if (ev.type === "setTargetAtTime") {
|
||||
if (F.fuzzyEqual(ev.constant, 0)) {
|
||||
throw new Error("NS_ERROR_DOM_SYNTAX_ERR");
|
||||
}
|
||||
}
|
||||
|
||||
// Make sure that non-curve events don't fall within the duration of a
|
||||
// curve event.
|
||||
for (var i = 0; i < events.length; i++) {
|
||||
if (events[i].type === "setValueCurveAtTime" &&
|
||||
events[i].time <= ev.time &&
|
||||
(events[i].time + events[i].duration) >= ev.time) {
|
||||
throw new Error("NS_ERROR_DOM_SYNTAX_ERR");
|
||||
}
|
||||
}
|
||||
|
||||
// Make sure that curve events don't fall in a range which includes other
|
||||
// events.
|
||||
if (ev.type === "setValueCurveAtTime") {
|
||||
for (var i = 0; i < events.length; i++) {
|
||||
if (events[i].time > ev.time &&
|
||||
events[i].time < (ev.time + ev.duration)) {
|
||||
throw new Error("NS_ERROR_DOM_SYNTAX_ERR");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Make sure that invalid values are not used for exponential curves
|
||||
if (ev.type === "exponentialRampToValueAtTime") {
|
||||
if (ev.value <= 0) throw new Error("NS_ERROR_DOM_SYNTAX_ERR");
|
||||
var prev = this._getPreviousEvent(ev.time);
|
||||
if (prev) {
|
||||
if (prev.value <= 0) {
|
||||
throw new Error("NS_ERROR_DOM_SYNTAX_ERR");
|
||||
}
|
||||
} else {
|
||||
if (this._value <= 0) {
|
||||
throw new Error("NS_ERROR_DOM_SYNTAX_ERR");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
for (var i = 0; i < events.length; i++) {
|
||||
if (ev.time === events[i].time) {
|
||||
if (ev.type === events[i].type) {
|
||||
// If times and types are equal, replace the event;
|
||||
events[i] = ev;
|
||||
} else {
|
||||
// Otherwise, place the element after the last event of another type
|
||||
do { i++; }
|
||||
while (i < events.length && ev.type !== events[i].type && ev.time === events[i].time);
|
||||
events.splice(i, 0, ev);
|
||||
}
|
||||
return;
|
||||
}
|
||||
// Otherwise, place the event right after the latest existing event
|
||||
if (ev.time < events[i].time) {
|
||||
events.splice(i, 0, ev);
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
// If we couldn't find a place for the event, just append it to the list
|
||||
this.events.push(ev);
|
||||
};
|
||||
|
||||
Timeline.prototype._getPreviousEvent = function (time) {
|
||||
var previous = null, next = null;
|
||||
var bailOut = false;
|
||||
var events = this.events;
|
||||
|
||||
for (var i = 0; !bailOut && i < events.length; i++) {
|
||||
if (time === events[i]) {
|
||||
do { ++i; }
|
||||
while (i < events.length && time === events[i].time);
|
||||
return events[i - 1];
|
||||
}
|
||||
previous = next;
|
||||
next = events[i];
|
||||
if (time < events[i].time) {
|
||||
bailOut = true;
|
||||
}
|
||||
}
|
||||
|
||||
// Handle the case where the time is past all the events
|
||||
if (!bailOut) {
|
||||
previous = next;
|
||||
}
|
||||
|
||||
return previous;
|
||||
};
|
||||
|
||||
/**
|
||||
* Calculates the previous value of the timeline, used for
|
||||
* `setTargetAtTime` nodes. Takes an event, and returns
|
||||
* the previous computed value for any sample taken during that
|
||||
* exponential approach node.
|
||||
*/
|
||||
Timeline.prototype._lastComputedValue = function (event) {
|
||||
// If equal times, return the value for the previous event, before
|
||||
// the `setTargetAtTime` node.
|
||||
var lastEvent = this._getPreviousEvent(event.time - F.EPSILON);
|
||||
|
||||
// If no event before the setTargetAtTime event, then return the
|
||||
// intrinsic value.
|
||||
if (!lastEvent) {
|
||||
return this._value;
|
||||
}
|
||||
// Otherwise, return the value for the previous event, which should
|
||||
// always be the last computed value (? I think?)
|
||||
else {
|
||||
return lastEvent.value;
|
||||
}
|
||||
};
|
||||
|
||||
Timeline.prototype.setValueAtTime = function (value, startTime) {
|
||||
this._insertEvent(new TimelineEvent("setValueAtTime", value, startTime));
|
||||
};
|
||||
|
||||
Timeline.prototype.linearRampToValueAtTime = function (value, endTime) {
|
||||
this._insertEvent(new TimelineEvent("linearRampToValueAtTime", value, endTime));
|
||||
};
|
||||
|
||||
Timeline.prototype.exponentialRampToValueAtTime = function (value, endTime) {
|
||||
this._insertEvent(new TimelineEvent("exponentialRampToValueAtTime", value, endTime));
|
||||
};
|
||||
|
||||
Timeline.prototype.setTargetAtTime = function (value, startTime, timeConstant) {
|
||||
this._insertEvent(new TimelineEvent("setTargetAtTime", value, startTime, timeConstant));
|
||||
};
|
||||
|
||||
Timeline.prototype.setValueCurveAtTime = function (value, startTime, duration) {
|
||||
this._insertEvent(new TimelineEvent("setValueCurveAtTime", value, startTime, null, duration));
|
||||
};
|
||||
|
||||
Timeline.prototype.cancelScheduledValues = function (time) {
|
||||
for (var i = 0; i < this.events.length; i++) {
|
||||
if (this.events[i].time >= time) {
|
||||
this.events = this.events.slice(0, i);
|
||||
break;
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
Timeline.prototype.cancelAllEvents = function () {
|
||||
this.events.length = 0;
|
||||
};
|
||||
|
||||
},{"./event":2,"./formulas":3}]},{},[1])(1)
|
||||
});
|
||||
@ -8,8 +8,6 @@ DevToolsModules(
|
||||
'accessibility.js',
|
||||
'actor-registry-utils.js',
|
||||
'actor-registry.js',
|
||||
'audionodes.json',
|
||||
'automation-timeline.js',
|
||||
'breakpoint-actor-map.js',
|
||||
'call-watcher.js',
|
||||
'closest-scripts.js',
|
||||
|
||||
@ -1,862 +0,0 @@
|
||||
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||
"use strict";
|
||||
|
||||
/* global XPCNativeWrapper */
|
||||
|
||||
const { Cu } = require("chrome");
|
||||
|
||||
const protocol = require("devtools/shared/protocol");
|
||||
const { CallWatcher } = require("devtools/server/actors/utils/call-watcher");
|
||||
const { createValueGrip } = require("devtools/server/actors/object/utils");
|
||||
const AutomationTimeline = require("./utils/automation-timeline");
|
||||
const {
|
||||
audionodeSpec,
|
||||
webAudioSpec,
|
||||
} = require("devtools/shared/specs/webaudio");
|
||||
const { WebAudioFront } = require("devtools/shared/fronts/webaudio");
|
||||
|
||||
const Services = require("Services");
|
||||
|
||||
const AUDIO_NODE_DEFINITION = require("devtools/server/actors/utils/audionodes.json");
|
||||
const ENABLE_AUTOMATION = false;
|
||||
const AUTOMATION_GRANULARITY = 2000;
|
||||
const AUTOMATION_GRANULARITY_MAX = 6000;
|
||||
|
||||
const AUDIO_GLOBALS = [
|
||||
"BaseAudioContext", "AudioContext", "AudioNode", "AudioParam",
|
||||
];
|
||||
|
||||
/**
|
||||
* An Audio Node actor allowing communication to a specific audio node in the
|
||||
* Audio Context graph.
|
||||
*/
|
||||
var AudioNodeActor = exports.AudioNodeActor = protocol.ActorClassWithSpec(audionodeSpec, {
|
||||
form: function() {
|
||||
return {
|
||||
// actorID is set when this is added to a pool
|
||||
actor: this.actorID,
|
||||
type: this.type,
|
||||
source: this.source,
|
||||
bypassable: this.bypassable,
|
||||
};
|
||||
},
|
||||
|
||||
/**
|
||||
* Create the Audio Node actor.
|
||||
*
|
||||
* @param DebuggerServerConnection conn
|
||||
* The server connection.
|
||||
* @param AudioNode node
|
||||
* The AudioNode that was created.
|
||||
*/
|
||||
initialize: function(conn, node) {
|
||||
protocol.Actor.prototype.initialize.call(this, conn);
|
||||
|
||||
// Store ChromeOnly property `id` to identify AudioNode,
|
||||
// rather than storing a strong reference, and store a weak
|
||||
// ref to underlying node for controlling.
|
||||
this.nativeID = node.id;
|
||||
this.node = Cu.getWeakReference(node);
|
||||
|
||||
// Stores the AutomationTimelines for this node's AudioParams.
|
||||
this.automation = {};
|
||||
|
||||
try {
|
||||
this.type = getConstructorName(node);
|
||||
} catch (e) {
|
||||
this.type = "";
|
||||
}
|
||||
|
||||
this.source = !!AUDIO_NODE_DEFINITION[this.type].source;
|
||||
this.bypassable = !AUDIO_NODE_DEFINITION[this.type].unbypassable;
|
||||
|
||||
// Create automation timelines for all AudioParams
|
||||
Object.keys(AUDIO_NODE_DEFINITION[this.type].properties || {})
|
||||
.filter(isAudioParam.bind(null, node))
|
||||
.forEach(paramName => {
|
||||
this.automation[paramName] = new AutomationTimeline(node[paramName].defaultValue);
|
||||
});
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns the string name of the audio type.
|
||||
*
|
||||
* DEPRECATED: Use `audionode.type` instead, left here for legacy reasons.
|
||||
*/
|
||||
getType: function() {
|
||||
return this.type;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns a boolean indicating if the AudioNode has been "bypassed",
|
||||
* via `AudioNodeActor#bypass` method.
|
||||
*
|
||||
* @return Boolean
|
||||
*/
|
||||
isBypassed: function() {
|
||||
const node = this.node.get();
|
||||
if (node === null) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Cast to boolean incase `passThrough` is undefined,
|
||||
// like for AudioDestinationNode
|
||||
return !!node.passThrough;
|
||||
},
|
||||
|
||||
/**
|
||||
* Takes a boolean, either enabling or disabling the "passThrough" option
|
||||
* on an AudioNode. If a node is bypassed, an effects processing node (like gain,
|
||||
* biquad), will allow the audio stream to pass through the node, unaffected.
|
||||
* Returns the bypass state of the node.
|
||||
*
|
||||
* @param Boolean enable
|
||||
* Whether the bypass value should be set on or off.
|
||||
* @return Boolean
|
||||
*/
|
||||
bypass: function(enable) {
|
||||
const node = this.node.get();
|
||||
|
||||
if (node === null) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
if (this.bypassable) {
|
||||
node.passThrough = enable;
|
||||
}
|
||||
|
||||
return this.isBypassed();
|
||||
},
|
||||
|
||||
/**
|
||||
* Changes a param on the audio node. Responds with either `undefined`
|
||||
* on success, or a description of the error upon param set failure.
|
||||
*
|
||||
* @param String param
|
||||
* Name of the AudioParam to change.
|
||||
* @param String value
|
||||
* Value to change AudioParam to.
|
||||
*/
|
||||
setParam: function(param, value) {
|
||||
const node = this.node.get();
|
||||
|
||||
if (node === null) {
|
||||
return CollectedAudioNodeError();
|
||||
}
|
||||
|
||||
try {
|
||||
if (isAudioParam(node, param)) {
|
||||
node[param].value = value;
|
||||
this.automation[param].setValue(value);
|
||||
} else {
|
||||
node[param] = value;
|
||||
}
|
||||
return undefined;
|
||||
} catch (e) {
|
||||
return constructError(e);
|
||||
}
|
||||
},
|
||||
|
||||
/**
|
||||
* Gets a param on the audio node.
|
||||
*
|
||||
* @param String param
|
||||
* Name of the AudioParam to fetch.
|
||||
*/
|
||||
getParam: function(param) {
|
||||
const node = this.node.get();
|
||||
|
||||
if (node === null) {
|
||||
return CollectedAudioNodeError();
|
||||
}
|
||||
|
||||
// Check to see if it's an AudioParam -- if so,
|
||||
// return the `value` property of the parameter.
|
||||
const value = isAudioParam(node, param) ? node[param].value : node[param];
|
||||
|
||||
// Return the grip form of the value; at this time,
|
||||
// there shouldn't be any non-primitives at the moment, other than
|
||||
// AudioBuffer or Float32Array references and the like,
|
||||
// so this just formats the value to be displayed in the VariablesView,
|
||||
// without using real grips and managing via actor pools.
|
||||
const grip = createValueGrip(value, null, createObjectGrip);
|
||||
|
||||
return grip;
|
||||
},
|
||||
|
||||
/**
|
||||
* Get an object containing key-value pairs of additional attributes
|
||||
* to be consumed by a front end, like if a property should be read only,
|
||||
* or is a special type (Float32Array, Buffer, etc.)
|
||||
*
|
||||
* @param String param
|
||||
* Name of the AudioParam whose flags are desired.
|
||||
*/
|
||||
getParamFlags: function(param) {
|
||||
return ((AUDIO_NODE_DEFINITION[this.type] || {}).properties || {})[param];
|
||||
},
|
||||
|
||||
/**
|
||||
* Get an array of objects each containing a `param` and `value` property,
|
||||
* corresponding to a property name and current value of the audio node.
|
||||
*/
|
||||
getParams: function(param) {
|
||||
const props = Object.keys(AUDIO_NODE_DEFINITION[this.type].properties || {});
|
||||
return props.map(prop =>
|
||||
({ param: prop, value: this.getParam(prop), flags: this.getParamFlags(prop) }));
|
||||
},
|
||||
|
||||
/**
|
||||
* Connects this audionode to an AudioParam via `node.connect(param)`.
|
||||
*/
|
||||
connectParam: function(destActor, paramName, output) {
|
||||
const srcNode = this.node.get();
|
||||
const destNode = destActor.node.get();
|
||||
|
||||
if (srcNode === null || destNode === null) {
|
||||
return CollectedAudioNodeError();
|
||||
}
|
||||
|
||||
try {
|
||||
// Connect via the unwrapped node, so we can call the
|
||||
// patched method that fires the webaudio actor's `connect-param` event.
|
||||
// Connect directly to the wrapped `destNode`, otherwise
|
||||
// the patched method thinks this is a new node and won't be
|
||||
// able to find it in `_nativeToActorID`.
|
||||
XPCNativeWrapper.unwrap(srcNode).connect(destNode[paramName], output);
|
||||
} catch (e) {
|
||||
return constructError(e);
|
||||
}
|
||||
return undefined;
|
||||
},
|
||||
|
||||
/**
|
||||
* Connects this audionode to another via `node.connect(dest)`.
|
||||
*/
|
||||
connectNode: function(destActor, output, input) {
|
||||
const srcNode = this.node.get();
|
||||
const destNode = destActor.node.get();
|
||||
|
||||
if (srcNode === null || destNode === null) {
|
||||
return CollectedAudioNodeError();
|
||||
}
|
||||
|
||||
try {
|
||||
// Connect via the unwrapped node, so we can call the
|
||||
// patched method that fires the webaudio actor's `connect-node` event.
|
||||
// Connect directly to the wrapped `destNode`, otherwise
|
||||
// the patched method thinks this is a new node and won't be
|
||||
// able to find it in `_nativeToActorID`.
|
||||
XPCNativeWrapper.unwrap(srcNode).connect(destNode, output, input);
|
||||
} catch (e) {
|
||||
return constructError(e);
|
||||
}
|
||||
return undefined;
|
||||
},
|
||||
|
||||
/**
|
||||
* Disconnects this audionode from all connections via `node.disconnect()`.
|
||||
*/
|
||||
disconnect: function(destActor, output) {
|
||||
const node = this.node.get();
|
||||
|
||||
if (node === null) {
|
||||
return CollectedAudioNodeError();
|
||||
}
|
||||
|
||||
try {
|
||||
// Disconnect via the unwrapped node, so we can call the
|
||||
// patched method that fires the webaudio actor's `disconnect` event.
|
||||
XPCNativeWrapper.unwrap(node).disconnect(output);
|
||||
} catch (e) {
|
||||
return constructError(e);
|
||||
}
|
||||
return undefined;
|
||||
},
|
||||
|
||||
getAutomationData: function(paramName) {
|
||||
const timeline = this.automation[paramName];
|
||||
if (!timeline) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const values = [];
|
||||
let i = 0;
|
||||
|
||||
if (!timeline.events.length) {
|
||||
return { events: timeline.events, values };
|
||||
}
|
||||
|
||||
const firstEvent = timeline.events[0];
|
||||
const lastEvent = timeline.events[timeline.events.length - 1];
|
||||
// `setValueCurveAtTime` will have a duration value -- other
|
||||
// events will have duration of `0`.
|
||||
const timeDelta = (lastEvent.time + lastEvent.duration) - firstEvent.time;
|
||||
const scale = timeDelta / AUTOMATION_GRANULARITY;
|
||||
|
||||
for (; i < AUTOMATION_GRANULARITY; i++) {
|
||||
const delta = firstEvent.time + (i * scale);
|
||||
const value = timeline.getValueAtTime(delta);
|
||||
values.push({ delta, value });
|
||||
}
|
||||
|
||||
// If the last event is setTargetAtTime, the automation
|
||||
// doesn't actually begin until the event's time, and exponentially
|
||||
// approaches the target value. In this case, we add more values
|
||||
// until we're "close enough" to the target.
|
||||
if (lastEvent.type === "setTargetAtTime") {
|
||||
for (; i < AUTOMATION_GRANULARITY_MAX; i++) {
|
||||
const delta = firstEvent.time + (++i * scale);
|
||||
const value = timeline.getValueAtTime(delta);
|
||||
values.push({ delta, value });
|
||||
}
|
||||
}
|
||||
|
||||
return { events: timeline.events, values };
|
||||
},
|
||||
|
||||
/**
|
||||
* Called via WebAudioActor, registers an automation event
|
||||
* for the AudioParam called.
|
||||
*
|
||||
* @param String paramName
|
||||
* Name of the AudioParam.
|
||||
* @param String eventName
|
||||
* Name of the automation event called.
|
||||
* @param Array args
|
||||
* Arguments passed into the automation call.
|
||||
*/
|
||||
addAutomationEvent: function(paramName, eventName, args = []) {
|
||||
const node = this.node.get();
|
||||
const timeline = this.automation[paramName];
|
||||
|
||||
if (node === null) {
|
||||
return CollectedAudioNodeError();
|
||||
}
|
||||
|
||||
if (!timeline || !node[paramName][eventName]) {
|
||||
return InvalidCommandError();
|
||||
}
|
||||
|
||||
try {
|
||||
// Using the unwrapped node and parameter, the corresponding
|
||||
// WebAudioActor event will be fired, subsequently calling
|
||||
// `_recordAutomationEvent`. Some finesse is required to handle
|
||||
// the cast of TypedArray arguments over the protocol, which is
|
||||
// taken care of below. The event will cast the argument back
|
||||
// into an array to be broadcasted from WebAudioActor, but the
|
||||
// double-casting will only occur when starting from `addAutomationEvent`,
|
||||
// which is only used in tests.
|
||||
const param = XPCNativeWrapper.unwrap(node[paramName]);
|
||||
const contentGlobal = Cu.getGlobalForObject(param);
|
||||
const contentArgs = Cu.cloneInto(args, contentGlobal);
|
||||
|
||||
// If calling `setValueCurveAtTime`, the first argument
|
||||
// is a Float32Array, which won't be able to be serialized
|
||||
// over the protocol. Cast a normal array to a Float32Array here.
|
||||
if (eventName === "setValueCurveAtTime") {
|
||||
// Create a Float32Array from the content, seeding with an array
|
||||
// from the same scope.
|
||||
const curve = new contentGlobal.Float32Array(contentArgs[0]);
|
||||
contentArgs[0] = curve;
|
||||
}
|
||||
|
||||
// Apply the args back from the content scope, which is necessary
|
||||
// due to the method wrapping changing in bug 1130901 to be exported
|
||||
// directly to the content scope.
|
||||
param[eventName].apply(param, contentArgs);
|
||||
} catch (e) {
|
||||
return constructError(e);
|
||||
}
|
||||
return undefined;
|
||||
},
|
||||
|
||||
/**
|
||||
* Registers the automation event in the AudioNodeActor's
|
||||
* internal timeline. Called when setting automation via
|
||||
* `addAutomationEvent`, or from the WebAudioActor's listening
|
||||
* to the event firing via content.
|
||||
*
|
||||
* @param String paramName
|
||||
* Name of the AudioParam.
|
||||
* @param String eventName
|
||||
* Name of the automation event called.
|
||||
* @param Array args
|
||||
* Arguments passed into the automation call.
|
||||
*/
|
||||
_recordAutomationEvent: function(paramName, eventName, args) {
|
||||
const timeline = this.automation[paramName];
|
||||
timeline[eventName].apply(timeline, args);
|
||||
},
|
||||
});
|
||||
|
||||
/**
|
||||
* The Web Audio Actor handles simple interaction with an BaseAudioContext
|
||||
* high-level methods. After instantiating this actor, you'll need to set it
|
||||
* up by calling setup().
|
||||
*/
|
||||
exports.WebAudioActor = protocol.ActorClassWithSpec(webAudioSpec, {
|
||||
initialize: function(conn, targetActor) {
|
||||
protocol.Actor.prototype.initialize.call(this, conn);
|
||||
this.targetActor = targetActor;
|
||||
|
||||
this._onContentFunctionCall = this._onContentFunctionCall.bind(this);
|
||||
|
||||
// Store ChromeOnly ID (`nativeID` property on AudioNodeActor) mapped
|
||||
// to the associated actorID, so we don't have to expose `nativeID`
|
||||
// to the client in any way.
|
||||
this._nativeToActorID = new Map();
|
||||
|
||||
this._onGlobalDestroyed = this._onGlobalDestroyed.bind(this);
|
||||
this._onGlobalCreated = this._onGlobalCreated.bind(this);
|
||||
},
|
||||
|
||||
destroy: function(conn) {
|
||||
protocol.Actor.prototype.destroy.call(this, conn);
|
||||
this.finalize();
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns definition of all AudioNodes, such as AudioParams, and
|
||||
* flags.
|
||||
*/
|
||||
getDefinition: function() {
|
||||
return AUDIO_NODE_DEFINITION;
|
||||
},
|
||||
|
||||
/**
|
||||
* Starts waiting for the current target actor's document global to be
|
||||
* created, in order to instrument the Canvas context and become
|
||||
* aware of everything the content does with Web Audio.
|
||||
*
|
||||
* See ContentObserver and WebAudioInstrumenter for more details.
|
||||
*/
|
||||
setup: function({ reload }) {
|
||||
// Used to track when something is happening with the web audio API
|
||||
// the first time, to ultimately fire `start-context` event
|
||||
this._firstNodeCreated = false;
|
||||
|
||||
// Clear out stored nativeIDs on reload as we do not want to track
|
||||
// AudioNodes that are no longer on this document.
|
||||
this._nativeToActorID.clear();
|
||||
|
||||
if (this._initialized) {
|
||||
if (reload) {
|
||||
this.targetActor.window.location.reload();
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
this._initialized = true;
|
||||
|
||||
this._callWatcher = new CallWatcher(this.conn, this.targetActor);
|
||||
this._callWatcher.onCall = this._onContentFunctionCall;
|
||||
this._callWatcher.setup({
|
||||
tracedGlobals: AUDIO_GLOBALS,
|
||||
startRecording: true,
|
||||
performReload: reload,
|
||||
holdWeak: true,
|
||||
storeCalls: false,
|
||||
});
|
||||
// Bind to `window-ready` so we can reenable recording on the
|
||||
// call watcher
|
||||
this.targetActor.on("window-ready", this._onGlobalCreated);
|
||||
// Bind to the `window-destroyed` event so we can unbind events between
|
||||
// the global destruction and the `finalize` cleanup method on the actor.
|
||||
this.targetActor.on("window-destroyed", this._onGlobalDestroyed);
|
||||
},
|
||||
|
||||
/**
|
||||
* Invoked whenever an instrumented function is called, like an
|
||||
* BaseAudioContext method or an AudioNode method.
|
||||
*/
|
||||
_onContentFunctionCall: function(functionCall) {
|
||||
const { name } = functionCall.details;
|
||||
|
||||
// All Web Audio nodes inherit from AudioNode's prototype, so
|
||||
// hook into the `connect` and `disconnect` methods
|
||||
if (WebAudioFront.NODE_ROUTING_METHODS.has(name)) {
|
||||
this._handleRoutingCall(functionCall);
|
||||
} else if (WebAudioFront.NODE_CREATION_METHODS.has(name)) {
|
||||
this._handleCreationCall(functionCall);
|
||||
} else if (ENABLE_AUTOMATION && WebAudioFront.AUTOMATION_METHODS.has(name)) {
|
||||
this._handleAutomationCall(functionCall);
|
||||
}
|
||||
},
|
||||
|
||||
_handleRoutingCall: function(functionCall) {
|
||||
const { caller, args, name } = functionCall.details;
|
||||
const source = caller;
|
||||
const dest = args[0];
|
||||
const isAudioPar = dest ? getConstructorName(dest) === "AudioParam" : false;
|
||||
|
||||
// audionode.connect(param)
|
||||
if (name === "connect" && isAudioPar) {
|
||||
this._onConnectParam(source, dest);
|
||||
} else if (name === "connect") {
|
||||
// audionode.connect(node)
|
||||
this._onConnectNode(source, dest);
|
||||
} else if (name === "disconnect") {
|
||||
// audionode.disconnect()
|
||||
this._onDisconnectNode(source);
|
||||
}
|
||||
},
|
||||
|
||||
_handleCreationCall: function(functionCall) {
|
||||
const { caller, result } = functionCall.details;
|
||||
// Keep track of the first node created, so we can alert
|
||||
// the front end that an audio context is being used since
|
||||
// we're not hooking into the constructor itself, just its
|
||||
// instance's methods.
|
||||
if (!this._firstNodeCreated) {
|
||||
// Fire the start-up event if this is the first node created
|
||||
// and trigger a `create-node` event for the context destination
|
||||
this._onStartContext();
|
||||
this._onCreateNode(caller.destination);
|
||||
this._firstNodeCreated = true;
|
||||
}
|
||||
this._onCreateNode(result);
|
||||
},
|
||||
|
||||
_handleAutomationCall: function(functionCall) {
|
||||
let { caller, name, args } = functionCall.details;
|
||||
const wrappedParam = new XPCNativeWrapper(caller);
|
||||
|
||||
// Sanitize arguments, as these should all be numbers,
|
||||
// with the exception of a TypedArray, which needs
|
||||
// casted to an Array
|
||||
args = sanitizeAutomationArgs(args);
|
||||
|
||||
const nodeActor = this._getActorByNativeID(wrappedParam._parentID);
|
||||
nodeActor._recordAutomationEvent(wrappedParam._paramName, name, args);
|
||||
|
||||
this._onAutomationEvent({
|
||||
node: nodeActor,
|
||||
paramName: wrappedParam._paramName,
|
||||
eventName: name,
|
||||
args: args,
|
||||
});
|
||||
},
|
||||
|
||||
/**
|
||||
* Stops listening for document global changes and puts this actor
|
||||
* to hibernation. This method is called automatically just before the
|
||||
* actor is destroyed.
|
||||
*/
|
||||
finalize: function() {
|
||||
if (!this._initialized) {
|
||||
return;
|
||||
}
|
||||
this._initialized = false;
|
||||
|
||||
try {
|
||||
Services.obs.removeObserver(this, "webaudio-node-demise");
|
||||
} catch (e) {
|
||||
// Maybe we've shutdown already and it's too late to remove the observer. So avoid
|
||||
// NS_ERROR_FAILURE errors with this silent try/catch.
|
||||
}
|
||||
|
||||
this.targetActor.off("window-destroyed", this._onGlobalDestroyed);
|
||||
this.targetActor.off("window-ready", this._onGlobalCreated);
|
||||
this.targetActor = null;
|
||||
this._nativeToActorID = null;
|
||||
this._callWatcher.eraseRecording();
|
||||
this._callWatcher.finalize();
|
||||
this._callWatcher = null;
|
||||
},
|
||||
|
||||
/**
|
||||
* Helper for constructing an AudioNodeActor, assigning to
|
||||
* internal weak map, and tracking via `manage` so it is assigned
|
||||
* an `actorID`.
|
||||
*/
|
||||
_constructAudioNode: function(node) {
|
||||
// Ensure AudioNode is wrapped.
|
||||
node = new XPCNativeWrapper(node);
|
||||
|
||||
this._instrumentParams(node);
|
||||
|
||||
const actor = new AudioNodeActor(this.conn, node);
|
||||
this.manage(actor);
|
||||
this._nativeToActorID.set(node.id, actor.actorID);
|
||||
return actor;
|
||||
},
|
||||
|
||||
/**
|
||||
* Takes an XrayWrapper node, and attaches the node's `nativeID`
|
||||
* to the AudioParams as `_parentID`, as well as the the type of param
|
||||
* as a string on `_paramName`.
|
||||
*/
|
||||
_instrumentParams: function(node) {
|
||||
const type = getConstructorName(node);
|
||||
Object.keys(AUDIO_NODE_DEFINITION[type].properties || {})
|
||||
.filter(isAudioParam.bind(null, node))
|
||||
.forEach(paramName => {
|
||||
const param = node[paramName];
|
||||
param._parentID = node.id;
|
||||
param._paramName = paramName;
|
||||
});
|
||||
},
|
||||
|
||||
/**
|
||||
* Takes an AudioNode and returns the stored actor for it.
|
||||
* In some cases, we won't have an actor stored (for example,
|
||||
* connecting to an AudioDestinationNode, since it's implicitly
|
||||
* created), so make a new actor and store that.
|
||||
*/
|
||||
_getActorByNativeID: function(nativeID) {
|
||||
// Ensure we have a Number, rather than a string
|
||||
// return via notification.
|
||||
nativeID = ~~nativeID;
|
||||
|
||||
const actorID = this._nativeToActorID.get(nativeID);
|
||||
const actor = actorID != null ? this.conn.getActor(actorID) : null;
|
||||
return actor;
|
||||
},
|
||||
|
||||
/**
|
||||
* Called on first audio node creation, signifying audio context usage
|
||||
*/
|
||||
_onStartContext: function() {
|
||||
Services.obs.addObserver(this, "webaudio-node-demise");
|
||||
this.emit("start-context");
|
||||
},
|
||||
|
||||
/**
|
||||
* Called when one audio node is connected to another.
|
||||
*/
|
||||
_onConnectNode: function(source, dest) {
|
||||
const sourceActor = this._getActorByNativeID(source.id);
|
||||
const destActor = this._getActorByNativeID(dest.id);
|
||||
|
||||
this.emit("connect-node", {
|
||||
source: sourceActor,
|
||||
dest: destActor,
|
||||
});
|
||||
},
|
||||
|
||||
/**
|
||||
* Called when an audio node is connected to an audio param.
|
||||
*/
|
||||
_onConnectParam: function(source, param) {
|
||||
const sourceActor = this._getActorByNativeID(source.id);
|
||||
const destActor = this._getActorByNativeID(param._parentID);
|
||||
this.emit("connect-param", {
|
||||
source: sourceActor,
|
||||
dest: destActor,
|
||||
param: param._paramName,
|
||||
});
|
||||
},
|
||||
|
||||
/**
|
||||
* Called when an audio node is disconnected.
|
||||
*/
|
||||
_onDisconnectNode: function(node) {
|
||||
const actor = this._getActorByNativeID(node.id);
|
||||
this.emit("disconnect-node", actor);
|
||||
},
|
||||
|
||||
/**
|
||||
* Called when a parameter changes on an audio node
|
||||
*/
|
||||
_onParamChange: function(node, param, value) {
|
||||
const actor = this._getActorByNativeID(node.id);
|
||||
this.emit("param-change", {
|
||||
source: actor,
|
||||
param: param,
|
||||
value: value,
|
||||
});
|
||||
},
|
||||
|
||||
/**
|
||||
* Called on node creation.
|
||||
*/
|
||||
_onCreateNode: function(node) {
|
||||
const actor = this._constructAudioNode(node);
|
||||
this.emit("create-node", actor);
|
||||
},
|
||||
|
||||
/**
|
||||
* Called by the ObserverService when webaudio-node-demise events are emitted.
|
||||
*/
|
||||
observe: function(subject, topic, data) {
|
||||
switch (topic) {
|
||||
case "webaudio-node-demise":
|
||||
// Cast the data to an integer.
|
||||
this._handleNodeDestroyed(~~data);
|
||||
break;
|
||||
}
|
||||
},
|
||||
|
||||
/**
|
||||
* Handles `webaudio-node-demise` events. Emits the associated actor to the front if
|
||||
* found.
|
||||
* @param {Number} nodeNativeID The ID for the audio node.
|
||||
*/
|
||||
_handleNodeDestroyed: function(nodeNativeID) {
|
||||
const actor = this._getActorByNativeID(nodeNativeID);
|
||||
|
||||
// If actorID exists, emit; in the case where we get demise
|
||||
// notifications for a document that no longer exists,
|
||||
// the mapping should not be found, so we do not emit an event.
|
||||
if (actor) {
|
||||
this._nativeToActorID.delete(nodeNativeID);
|
||||
this.emit("destroy-node", actor);
|
||||
}
|
||||
},
|
||||
|
||||
/**
|
||||
* Ensures that the new global has recording on
|
||||
* so we can proxy the function calls.
|
||||
*/
|
||||
_onGlobalCreated: function() {
|
||||
// Used to track when something is happening with the web audio API
|
||||
// the first time, to ultimately fire `start-context` event
|
||||
this._firstNodeCreated = false;
|
||||
|
||||
// Clear out stored nativeIDs on reload as we do not want to track
|
||||
// AudioNodes that are no longer on this document.
|
||||
this._nativeToActorID.clear();
|
||||
|
||||
this._callWatcher.resumeRecording();
|
||||
},
|
||||
|
||||
/**
|
||||
* Fired when an automation event is added to an AudioNode.
|
||||
*/
|
||||
_onAutomationEvent: function({node, paramName, eventName, args}) {
|
||||
this.emit("automation-event", {
|
||||
node: node,
|
||||
paramName: paramName,
|
||||
eventName: eventName,
|
||||
args: args,
|
||||
});
|
||||
},
|
||||
|
||||
/**
|
||||
* Called when the underlying ContentObserver fires `global-destroyed`
|
||||
* so we can cleanup some things between the global being destroyed and
|
||||
* when the actor's `finalize` method gets called.
|
||||
*/
|
||||
_onGlobalDestroyed: function({id}) {
|
||||
if (this._callWatcher._tracedWindowId !== id) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (this._nativeToActorID) {
|
||||
this._nativeToActorID.clear();
|
||||
}
|
||||
Services.obs.removeObserver(this, "webaudio-node-demise");
|
||||
},
|
||||
});
|
||||
|
||||
/**
|
||||
* Determines whether or not property is an AudioParam.
|
||||
*
|
||||
* @param AudioNode node
|
||||
* An AudioNode.
|
||||
* @param String prop
|
||||
* Property of `node` to evaluate to see if it's an AudioParam.
|
||||
* @return Boolean
|
||||
*/
|
||||
function isAudioParam(node, prop) {
|
||||
return !!(node[prop] && /AudioParam/.test(node[prop].toString()));
|
||||
}
|
||||
|
||||
/**
|
||||
* Takes an `Error` object and constructs a JSON-able response
|
||||
*
|
||||
* @param Error err
|
||||
* A TypeError, RangeError, etc.
|
||||
* @return Object
|
||||
*/
|
||||
function constructError(err) {
|
||||
return {
|
||||
message: err.message,
|
||||
type: err.constructor.name,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates and returns a JSON-able response used to indicate
|
||||
* attempt to access an AudioNode that has been GC'd.
|
||||
*
|
||||
* @return Object
|
||||
*/
|
||||
function CollectedAudioNodeError() {
|
||||
return {
|
||||
message: "AudioNode has been garbage collected and can no longer be reached.",
|
||||
type: "UnreachableAudioNode",
|
||||
};
|
||||
}
|
||||
|
||||
function InvalidCommandError() {
|
||||
return {
|
||||
message: "The command on AudioNode is invalid.",
|
||||
type: "InvalidCommand",
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Takes an object and converts it's `toString()` form, like
|
||||
* "[object OscillatorNode]" or "[object Float32Array]",
|
||||
* or XrayWrapper objects like "[object XrayWrapper [object Array]]"
|
||||
* to a string of just the constructor name, like "OscillatorNode",
|
||||
* or "Float32Array".
|
||||
*/
|
||||
function getConstructorName(obj) {
|
||||
return Object.prototype.toString.call(obj).match(/\[object ([^\[\]]*)\]\]?$/)[1];
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a grip-like object to pass in renderable information
|
||||
* to the front-end for things like Float32Arrays, AudioBuffers,
|
||||
* without tracking them in an actor pool.
|
||||
*/
|
||||
function createObjectGrip(value) {
|
||||
return {
|
||||
type: "object",
|
||||
preview: {
|
||||
kind: "ObjectWithText",
|
||||
text: "",
|
||||
},
|
||||
class: getConstructorName(value),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts all TypedArrays of the array that cannot
|
||||
* be passed over the wire into a normal Array equivilent.
|
||||
*/
|
||||
function sanitizeAutomationArgs(args) {
|
||||
return args.reduce((newArgs, el) => {
|
||||
const isArray = typeof el === "object" && getConstructorName(el) === "Float32Array";
|
||||
newArgs.push(isArray ? castToArray(el) : el);
|
||||
return newArgs;
|
||||
}, []);
|
||||
}
|
||||
|
||||
/**
|
||||
* Casts TypedArray to a normal array via a
|
||||
* new scope.
|
||||
*/
|
||||
function castToArray(typedArray) {
|
||||
// The Xray machinery for TypedArrays denies indexed access on the grounds
|
||||
// that it's slow, and advises callers to do a structured clone instead.
|
||||
const global = Cu.getGlobalForObject(this);
|
||||
const safeView = Cu.cloneInto(typedArray.subarray(), global);
|
||||
return copyInto([], safeView);
|
||||
}
|
||||
|
||||
/**
|
||||
* Copies values of an array-like `source` into
|
||||
* a similarly array-like `dest`.
|
||||
*/
|
||||
function copyInto(dest, source) {
|
||||
for (let i = 0; i < source.length; i++) {
|
||||
dest[i] = source[i];
|
||||
}
|
||||
return dest;
|
||||
}
|
||||
@ -263,11 +263,6 @@ const Types = exports.__TypesForTests = [
|
||||
spec: "devtools/shared/specs/targets/worker",
|
||||
front: "devtools/shared/fronts/targets/worker",
|
||||
},
|
||||
{
|
||||
types: ["audionode", "webaudio"],
|
||||
spec: "devtools/shared/specs/webaudio",
|
||||
front: null,
|
||||
},
|
||||
{
|
||||
types: ["console"],
|
||||
spec: "devtools/shared/specs/webconsole",
|
||||
|
||||
@ -51,6 +51,5 @@ DevToolsModules(
|
||||
'symbol-iterator.js',
|
||||
'symbol.js',
|
||||
'timeline.js',
|
||||
'webaudio.js',
|
||||
'webconsole.js',
|
||||
)
|
||||
|
||||
@ -1,164 +0,0 @@
|
||||
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||||
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||||
"use strict";
|
||||
|
||||
const {
|
||||
Arg,
|
||||
Option,
|
||||
RetVal,
|
||||
generateActorSpec,
|
||||
types,
|
||||
} = require("devtools/shared/protocol");
|
||||
|
||||
exports.NODE_CREATION_METHODS = [
|
||||
"createBufferSource", "createMediaElementSource", "createMediaStreamSource",
|
||||
"createMediaStreamDestination", "createScriptProcessor", "createAnalyser",
|
||||
"createGain", "createDelay", "createBiquadFilter", "createIIRFilter",
|
||||
"createWaveShaper", "createPanner", "createConvolver", "createChannelSplitter",
|
||||
"createChannelMerger", "createDynamicsCompressor", "createOscillator",
|
||||
"createStereoPanner", "createConstantSource",
|
||||
];
|
||||
|
||||
exports.AUTOMATION_METHODS = [
|
||||
"setValueAtTime", "linearRampToValueAtTime", "exponentialRampToValueAtTime",
|
||||
"setTargetAtTime", "setValueCurveAtTime", "cancelScheduledValues",
|
||||
];
|
||||
|
||||
exports.NODE_ROUTING_METHODS = [
|
||||
"connect", "disconnect",
|
||||
];
|
||||
|
||||
types.addActorType("audionode");
|
||||
const audionodeSpec = generateActorSpec({
|
||||
typeName: "audionode",
|
||||
|
||||
methods: {
|
||||
getType: { response: { type: RetVal("string") }},
|
||||
isBypassed: {
|
||||
response: { bypassed: RetVal("boolean") },
|
||||
},
|
||||
bypass: {
|
||||
request: { enable: Arg(0, "boolean") },
|
||||
response: { bypassed: RetVal("boolean") },
|
||||
},
|
||||
setParam: {
|
||||
request: {
|
||||
param: Arg(0, "string"),
|
||||
value: Arg(1, "nullable:primitive"),
|
||||
},
|
||||
response: { error: RetVal("nullable:json") },
|
||||
},
|
||||
getParam: {
|
||||
request: {
|
||||
param: Arg(0, "string"),
|
||||
},
|
||||
response: { text: RetVal("nullable:primitive") },
|
||||
},
|
||||
getParamFlags: {
|
||||
request: { param: Arg(0, "string") },
|
||||
response: { flags: RetVal("nullable:primitive") },
|
||||
},
|
||||
getParams: {
|
||||
response: { params: RetVal("json") },
|
||||
},
|
||||
connectParam: {
|
||||
request: {
|
||||
destActor: Arg(0, "audionode"),
|
||||
paramName: Arg(1, "string"),
|
||||
output: Arg(2, "nullable:number"),
|
||||
},
|
||||
response: { error: RetVal("nullable:json") },
|
||||
},
|
||||
connectNode: {
|
||||
request: {
|
||||
destActor: Arg(0, "audionode"),
|
||||
output: Arg(1, "nullable:number"),
|
||||
input: Arg(2, "nullable:number"),
|
||||
},
|
||||
response: { error: RetVal("nullable:json") },
|
||||
},
|
||||
disconnect: {
|
||||
request: { output: Arg(0, "nullable:number") },
|
||||
response: { error: RetVal("nullable:json") },
|
||||
},
|
||||
getAutomationData: {
|
||||
request: { paramName: Arg(0, "string") },
|
||||
response: { values: RetVal("nullable:json") },
|
||||
},
|
||||
addAutomationEvent: {
|
||||
request: {
|
||||
paramName: Arg(0, "string"),
|
||||
eventName: Arg(1, "string"),
|
||||
args: Arg(2, "nullable:json"),
|
||||
},
|
||||
response: { error: RetVal("nullable:json") },
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
exports.audionodeSpec = audionodeSpec;
|
||||
|
||||
const webAudioSpec = generateActorSpec({
|
||||
typeName: "webaudio",
|
||||
|
||||
/**
|
||||
* Events emitted by this actor.
|
||||
*/
|
||||
events: {
|
||||
"start-context": {
|
||||
type: "startContext",
|
||||
},
|
||||
"connect-node": {
|
||||
type: "connectNode",
|
||||
source: Option(0, "audionode"),
|
||||
dest: Option(0, "audionode"),
|
||||
},
|
||||
"disconnect-node": {
|
||||
type: "disconnectNode",
|
||||
source: Arg(0, "audionode"),
|
||||
},
|
||||
"connect-param": {
|
||||
type: "connectParam",
|
||||
source: Option(0, "audionode"),
|
||||
dest: Option(0, "audionode"),
|
||||
param: Option(0, "string"),
|
||||
},
|
||||
"change-param": {
|
||||
type: "changeParam",
|
||||
source: Option(0, "audionode"),
|
||||
param: Option(0, "string"),
|
||||
value: Option(0, "string"),
|
||||
},
|
||||
"create-node": {
|
||||
type: "createNode",
|
||||
source: Arg(0, "audionode"),
|
||||
},
|
||||
"destroy-node": {
|
||||
type: "destroyNode",
|
||||
source: Arg(0, "audionode"),
|
||||
},
|
||||
"automation-event": {
|
||||
type: "automationEvent",
|
||||
node: Option(0, "audionode"),
|
||||
paramName: Option(0, "string"),
|
||||
eventName: Option(0, "string"),
|
||||
args: Option(0, "json"),
|
||||
},
|
||||
},
|
||||
|
||||
methods: {
|
||||
getDefinition: {
|
||||
response: { definition: RetVal("json") },
|
||||
},
|
||||
setup: {
|
||||
request: { reload: Option(0, "boolean") },
|
||||
oneway: true,
|
||||
},
|
||||
finalize: {
|
||||
oneway: true,
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
exports.webAudioSpec = webAudioSpec;
|
||||
Loading…
Reference in New Issue
Block a user