OLD | NEW |
1 /* | 1 /* |
2 * Copyright (C) 2010, Google Inc. All rights reserved. | 2 * Copyright (C) 2010, Google Inc. All rights reserved. |
3 * Copyright (C) 2011 Apple Inc. All rights reserved. | 3 * Copyright (C) 2011 Apple Inc. All rights reserved. |
4 * | 4 * |
5 * Redistribution and use in source and binary forms, with or without | 5 * Redistribution and use in source and binary forms, with or without |
6 * modification, are permitted provided that the following conditions | 6 * modification, are permitted provided that the following conditions |
7 * are met: | 7 * are met: |
8 * 1. Redistributions of source code must retain the above copyright | 8 * 1. Redistributions of source code must retain the above copyright |
9 * notice, this list of conditions and the following disclaimer. | 9 * notice, this list of conditions and the following disclaimer. |
10 * 2. Redistributions in binary form must reproduce the above copyright | 10 * 2. Redistributions in binary form must reproduce the above copyright |
11 * notice, this list of conditions and the following disclaimer in the | 11 * notice, this list of conditions and the following disclaimer in the |
12 * documentation and/or other materials provided with the distribution. | 12 * documentation and/or other materials provided with the distribution. |
13 * | 13 * |
14 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND AN
Y | 14 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND AN
Y |
15 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | 15 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED |
16 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | 16 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
17 * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR AN
Y | 17 * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR AN
Y |
18 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | 18 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES |
19 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | 19 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; |
20 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND O
N | 20 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND O
N |
21 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 21 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | 22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
23 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 23 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
24 */ | 24 */ |
25 | 25 |
26 [ | 26 [ |
27 NoInterfaceObject, | 27 NoInterfaceObject, |
28 Conditional=WEB_AUDIO, | 28 Conditional=WEB_AUDIO, |
29 ActiveDOMObject, | 29 ActiveDOMObject, |
30 CustomConstructor, | 30 CustomConstructor |
31 EventTarget | 31 ] interface AudioContext : EventTarget { |
32 ] interface AudioContext { | |
33 // All rendered audio ultimately connects to destination, which represents t
he audio hardware. | 32 // All rendered audio ultimately connects to destination, which represents t
he audio hardware. |
34 readonly attribute AudioDestinationNode destination; | 33 readonly attribute AudioDestinationNode destination; |
35 | 34 |
36 // All scheduled times are relative to this time in seconds. | 35 // All scheduled times are relative to this time in seconds. |
37 readonly attribute float currentTime; | 36 readonly attribute float currentTime; |
38 | 37 |
39 // All AudioNodes in the context run at this sample-rate (sample-frames per
second). | 38 // All AudioNodes in the context run at this sample-rate (sample-frames per
second). |
40 readonly attribute float sampleRate; | 39 readonly attribute float sampleRate; |
41 | 40 |
42 // All panning is relative to this listener. | 41 // All panning is relative to this listener. |
43 readonly attribute AudioListener listener; | 42 readonly attribute AudioListener listener; |
44 | 43 |
45 // Number of AudioBufferSourceNodes that are currently playing. | 44 // Number of AudioBufferSourceNodes that are currently playing. |
46 readonly attribute unsigned long activeSourceCount; | 45 readonly attribute unsigned long activeSourceCount; |
47 | 46 |
48 [RaisesException] AudioBuffer createBuffer(unsigned long numberOfChannels, u
nsigned long numberOfFrames, float sampleRate); | 47 [RaisesException] AudioBuffer createBuffer(unsigned long numberOfChannels, u
nsigned long numberOfFrames, float sampleRate); |
49 [RaisesException] AudioBuffer createBuffer(ArrayBuffer? buffer, boolean mixT
oMono); | 48 [RaisesException] AudioBuffer createBuffer(ArrayBuffer? buffer, boolean mixT
oMono); |
50 | 49 |
51 // Asynchronous audio file data decoding. | 50 // Asynchronous audio file data decoding. |
52 [RaisesException] void decodeAudioData(ArrayBuffer audioData, AudioBufferCal
lback successCallback, optional AudioBufferCallback errorCallback); | 51 [RaisesException] void decodeAudioData(ArrayBuffer audioData, AudioBufferCal
lback successCallback, optional AudioBufferCallback errorCallback); |
53 | 52 |
54 // Sources | 53 // Sources |
55 AudioBufferSourceNode createBufferSource(); | 54 AudioBufferSourceNode createBufferSource(); |
56 | 55 |
57 [RaisesException] MediaElementAudioSourceNode createMediaElementSource(HTMLM
ediaElement mediaElement); | 56 [RaisesException] MediaElementAudioSourceNode createMediaElementSource(HTMLM
ediaElement mediaElement); |
58 | 57 |
59 [RaisesException] MediaStreamAudioSourceNode createMediaStreamSource(MediaSt
ream mediaStream); | 58 [RaisesException] MediaStreamAudioSourceNode createMediaStreamSource(MediaSt
ream mediaStream); |
60 MediaStreamAudioDestinationNode createMediaStreamDestination(); | 59 MediaStreamAudioDestinationNode createMediaStreamDestination(); |
61 | 60 |
62 // Processing nodes | 61 // Processing nodes |
63 GainNode createGain(); | 62 GainNode createGain(); |
64 [RaisesException] DelayNode createDelay(optional double maxDelayTime); | 63 [RaisesException] DelayNode createDelay(optional double maxDelayTime); |
65 BiquadFilterNode createBiquadFilter(); | 64 BiquadFilterNode createBiquadFilter(); |
66 WaveShaperNode createWaveShaper(); | 65 WaveShaperNode createWaveShaper(); |
67 PannerNode createPanner(); | 66 PannerNode createPanner(); |
68 ConvolverNode createConvolver(); | 67 ConvolverNode createConvolver(); |
69 DynamicsCompressorNode createDynamicsCompressor(); | 68 DynamicsCompressorNode createDynamicsCompressor(); |
70 AnalyserNode createAnalyser(); | 69 AnalyserNode createAnalyser(); |
71 [RaisesException] ScriptProcessorNode createScriptProcessor(unsigned long bu
fferSize, optional unsigned long numberOfInputChannels, optional unsigned long n
umberOfOutputChannels); | 70 [RaisesException] ScriptProcessorNode createScriptProcessor(unsigned long bu
fferSize, optional unsigned long numberOfInputChannels, optional unsigned long n
umberOfOutputChannels); |
72 OscillatorNode createOscillator(); | 71 OscillatorNode createOscillator(); |
73 [RaisesException] WaveTable createWaveTable(Float32Array real, Float32Array
imag); | 72 [RaisesException] PeriodicWave createPeriodicWave(Float32Array real, Float32
Array imag); |
74 | 73 |
75 // Channel splitting and merging | 74 // Channel splitting and merging |
76 [RaisesException] ChannelSplitterNode createChannelSplitter(optional unsigne
d long numberOfOutputs); | 75 [RaisesException] ChannelSplitterNode createChannelSplitter(optional unsigne
d long numberOfOutputs); |
77 [RaisesException] ChannelMergerNode createChannelMerger(optional unsigned lo
ng numberOfInputs); | 76 [RaisesException] ChannelMergerNode createChannelMerger(optional unsigned lo
ng numberOfInputs); |
78 | 77 |
79 // Offline rendering | 78 // Offline rendering |
80 // void prepareOfflineBufferRendering(unsigned long numberOfChannels, unsign
ed long numberOfFrames, float sampleRate); | 79 // void prepareOfflineBufferRendering(unsigned long numberOfChannels, unsign
ed long numberOfFrames, float sampleRate); |
81 attribute EventListener oncomplete; | 80 attribute EventListener oncomplete; |
82 void startRendering(); | 81 void startRendering(); |
83 | 82 |
84 [MeasureAs=LegacyWebAudio, ImplementedAs=createGain] GainNode createGainNode
(); | 83 [MeasureAs=LegacyWebAudio, ImplementedAs=createGain] GainNode createGainNode
(); |
85 [MeasureAs=LegacyWebAudio, ImplementedAs=createDelay, RaisesException] Delay
Node createDelayNode(optional double maxDelayTime); | 84 [MeasureAs=LegacyWebAudio, ImplementedAs=createDelay, RaisesException] Delay
Node createDelayNode(optional double maxDelayTime); |
86 | 85 |
87 [MeasureAs=LegacyWebAudio, ImplementedAs=createScriptProcessor, RaisesExcept
ion] ScriptProcessorNode createJavaScriptNode(unsigned long bufferSize, optional
unsigned long numberOfInputChannels, optional unsigned long numberOfOutputChann
els); | 86 [MeasureAs=LegacyWebAudio, ImplementedAs=createScriptProcessor, RaisesExcept
ion] ScriptProcessorNode createJavaScriptNode(unsigned long bufferSize, optional
unsigned long numberOfInputChannels, optional unsigned long numberOfOutputChann
els); |
88 | 87 |
89 }; | 88 }; |
OLD | NEW |