diff --git a/index.bs b/index.bs index 9d40f1b1c..2dac84def 100644 --- a/index.bs +++ b/index.bs @@ -930,17 +930,18 @@ Attributes : onstatechange :: - A property used to set the EventHandler for an + A property used to set an [=event handler=] for an event that is dispatched to {{BaseAudioContext}} when the state of the AudioContext has changed (i.e. when the corresponding promise - would have resolved). An event of type - {{Event}} will be dispatched to the event + would have resolved). The event type of this event handler is + statechange. An event that uses the + {{Event}} interface will be dispatched to the event handler, which can query the AudioContext's state directly. A newly-created AudioContext will always begin in the suspended state, and a state change event will be fired whenever the state changes to a different state. This - event is fired before the {{oncomplete}} event + event is fired before the {{complete}} event is fired. : sampleRate @@ -1185,7 +1186,7 @@ Methods In this case an {{IndexSizeError}} MUST be thrown. 
-		bufferSize: The {{ScriptProcessorNode/bufferSize}} parameter determines the buffer size in units of sample-frames. If it's not passed in, or if the value is 0, then the implementation will choose the best buffer size for the given environment, which will be constant power of 2 throughout the lifetime of the node. Otherwise if the author explicitly specifies the bufferSize, it MUST be one of the following values: 256, 512, 1024, 2048, 4096, 8192, 16384. This value controls how frequently the {{ScriptProcessorNode/onaudioprocess}} event is dispatched and how many sample-frames need to be processed each call. Lower values for {{ScriptProcessorNode/bufferSize}} will result in a lower (better) latency. Higher values will be necessary to avoid audio breakup and glitches. It is recommended for authors to not specify this buffer size and allow the implementation to pick a good buffer size to balance between latency and audio quality. If the value of this parameter is not one of the allowed power-of-2 values listed above, an {{IndexSizeError}} MUST be thrown.
+		bufferSize: The {{ScriptProcessorNode/bufferSize}} parameter determines the buffer size in units of sample-frames. If it's not passed in, or if the value is 0, then the implementation will choose the best buffer size for the given environment, which will be constant power of 2 throughout the lifetime of the node. Otherwise if the author explicitly specifies the bufferSize, it MUST be one of the following values: 256, 512, 1024, 2048, 4096, 8192, 16384. This value controls how frequently the {{ScriptProcessorNode/audioprocess}} event is dispatched and how many sample-frames need to be processed each call. Lower values for {{ScriptProcessorNode/bufferSize}} will result in a lower (better) latency. Higher values will be necessary to avoid audio breakup and glitches. It is recommended for authors to not specify this buffer size and allow the implementation to pick a good buffer size to balance between latency and audio quality. If the value of this parameter is not one of the allowed power-of-2 values listed above, an {{IndexSizeError}} MUST be thrown.
 		numberOfInputChannels: This parameter determines the number of channels for this node's input. The default value is 2. Values of up to 32 must be supported. A {{NotSupportedError}} must be thrown if the number of channels is not supported.
 		numberOfOutputChannels: This parameter determines the number of channels for this node's output. The default value is 2. Values of up to 32 must be supported. A {{NotSupportedError}} must be thrown if the number of channels is not supported.
@@ -1787,7 +1788,7 @@ Constructors 1. queue a media element task to fire an event - named `statechange` at the {{AudioContext}}. + named {{BaseAudioContext/statechange}} at the {{AudioContext}}. 1. Attempt to acquire system resources to use a @@ -1808,9 +1809,8 @@ Constructors 1. Set the {{BaseAudioContext/state}} attribute of the {{AudioContext}} to "{{AudioContextState/running}}". - 1. Fire an event to - {{BaseAudioContext/onstatechange}} {{EventHandler}} at the - {{AudioContext}}. + 1. Fire an event named + {{BaseAudioContext/statechange}} at the {{AudioContext}}. Note: It is unfortunately not possible to programatically notify authors @@ -1919,11 +1919,12 @@ Attributes : onsinkchange :: - An {{EventHandler}} for {{AudioContext/setSinkId()}}. This event will - be dispatched when changing the output device is completed. + An [=event handler=] for {{AudioContext/setSinkId()}}. The event type of + this event handler is sinkchange. This event will be + dispatched when changing the output device is completed. NOTE: This is not dispatched for the initial device selection in the - construction of {{AudioContext}}. The {{BaseAudioContext/onstatechange}} + construction of {{AudioContext}}. The {{BaseAudioContext/statechange}} event is available to check the readiness of the initial output device. @@ -1989,7 +1990,7 @@ Methods 1. queue a media element task to fire - an event named `statechange` at the {{AudioContext}}. + an event named {{BaseAudioContext/statechange}} at the {{AudioContext}}. When an {{AudioContext}} is closed, any @@ -2196,7 +2197,7 @@ Methods 1. queue a media element task to fire - an event named `statechange` at the {{AudioContext}}. + an event named {{BaseAudioContext/statechange}} at the {{AudioContext}}.
@@ -2267,7 +2268,7 @@ Methods 1. queue a media element task to fire - an event named `statechange` at the {{AudioContext}}. + an event named {{BaseAudioContext/statechange}} at the {{AudioContext}}.
While an {{AudioContext}} is suspended, @@ -2360,9 +2361,8 @@ Methods 1. Set the {{BaseAudioContext/state}} attribute of the {{AudioContext}} to "{{AudioContextState/suspended}}". - 1. Fire an event to - {{BaseAudioContext/onstatechange}} {{EventHandler}} at the - associated {{AudioContext}}. + 1. Fire an event named + {{BaseAudioContext/statechange}} at the associated {{AudioContext}}. 1. Attempt to acquire system resources to use a following audio output device based on {{AudioContext/[[sink ID]]}} @@ -2381,9 +2381,8 @@ Methods 1. Resolve |p|. - 1. Fire an event to - {{AudioContext/onsinkchange}} {{EventHandler}} at the associated - {{AudioContext}}. + 1. Fire an event named + {{sinkchange}} at the associated {{AudioContext}}. 1. If |wasRunning| is true: @@ -2399,9 +2398,8 @@ Methods 1. Set the {{BaseAudioContext/state}} attribute of the {{AudioContext}} to "{{AudioContextState/running}}". - 1. Fire an event to - {{BaseAudioContext/onstatechange}} {{EventHandler}} at the - associated {{AudioContext}}. + 1. Fire an event named + {{BaseAudioContext/statechange}} at the associated {{AudioContext}}. @@ -2605,7 +2603,9 @@ Dictionary {{AudioTimestamp}} Members
: onupdate :: - An EventHandler for AudioRenderCapacityEvent. + The event type of this event handler is update. Events + dispatched to the event handler will use the + {{AudioRenderCapacityEvent}} interface.
@@ -2615,14 +2615,15 @@ Dictionary {{AudioTimestamp}} Members
: start(options) :: Starts metric collection and analysis. This will repeatedly - dispatch an {{AudioRenderCapacityEvent}} to - {{AudioRenderCapacity/onupdate}} EventHandler with the given - update interval in {{AudioRenderCapacityOptions}}. + fire an event named + {{AudioRenderCapacity/update}} at {{AudioRenderCapacity}}, using + {{AudioRenderCapacityEvent}}, with the given update interval in + {{AudioRenderCapacityOptions}}. : stop() :: Stops metric collection and analysis. It also stops dispatching - {{AudioRenderCapacityEvent}}. + {{AudioRenderCapacity/update}} events.

@@ -2861,8 +2862,9 @@ Attributes

: oncomplete :: - An EventHandler of type OfflineAudioCompletionEvent. - It is the last event fired on an {{OfflineAudioContext}}. + The event type of this event handler is complete. The event + dispatched to the event handler will use the {{OfflineAudioCompletionEvent}} + interface. It is the last event fired on an {{OfflineAudioContext}}.

@@ -2946,7 +2948,7 @@ Methods

  • queue a media element task to fire an event named - `complete` using an instance of {{OfflineAudioCompletionEvent}} + {{OfflineAudioContext/complete}} using an instance of {{OfflineAudioCompletionEvent}} whose `renderedBuffer` property is set to {{[[rendered buffer]]}}. @@ -3019,7 +3021,7 @@ Methods 1. queue a media element task to fire - an event named `statechange` at the {{OfflineAudioContext}}. + an event named {{BaseAudioContext/statechange}} at the {{OfflineAudioContext}}. @@ -4960,18 +4962,14 @@ Attributes
    : onended :: - A property used to set the EventHandler (described - in - HTML[[!HTML]]) for the ended event that is - dispatched for {{AudioScheduledSourceNode}} node + A property used to set an [=event handler=] for the ended + event type that is dispatched to {{AudioScheduledSourceNode}} node types. When the source node has stopped playing (as determined - by the concrete node), an event of type {{Event}} - (described in - HTML [[!HTML]]) will be dispatched to the event - handler. + by the concrete node), an event that uses the {{Event}} interface will be + dispatched to the event handler. For all {{AudioScheduledSourceNode}}s, the - onended event is dispatched when the stop time + {{AudioScheduledSourceNode/ended}} event is dispatched when the stop time determined by {{AudioScheduledSourceNode/stop()}} is reached. For an {{AudioBufferSourceNode}}, the event is also dispatched because the {{AudioBufferSourceNode/start(when, offset, duration)/duration}} has been @@ -6622,7 +6620,7 @@ Attributes number of channels equal to the numberOfInputChannels parameter of the createScriptProcessor() method. This AudioBuffer is only valid - while in the scope of the {{ScriptProcessorNode/onaudioprocess}} function. + while in the scope of the {{ScriptProcessorNode/audioprocess}} event handler functions. Its values will be meaningless outside of this scope. : outputBuffer @@ -6631,7 +6629,7 @@ Attributes will have a number of channels equal to the numberOfOutputChannels parameter of the createScriptProcessor() method. Script code within the scope of - the {{ScriptProcessorNode/onaudioprocess}} function is + the {{ScriptProcessorNode/audioprocess}} event handler functions are expected to modify the {{Float32Array}} arrays representing channel data in this AudioBuffer. Any script modifications to this AudioBuffer outside of this scope will not @@ -10257,8 +10255,8 @@ macros: The {{ScriptProcessorNode}} is constructed with a {{BaseAudioContext/createScriptProcessor(bufferSize, numberOfInputChannels, numberOfOutputChannels)/bufferSize}} which MUST be one of the following values: 256, 512, 1024, 2048, 4096, 8192, 16384. This value controls how -frequently the {{ScriptProcessorNode/onaudioprocess}} event is dispatched and how -many sample-frames need to be processed each call. {{ScriptProcessorNode/onaudioprocess}} events are only +frequently the {{ScriptProcessorNode/audioprocess}} event is dispatched and how +many sample-frames need to be processed each call. {{ScriptProcessorNode/audioprocess}} events are only dispatched if the {{ScriptProcessorNode}} has at least one input or one output connected. Lower numbers for {{ScriptProcessorNode/bufferSize}} will result in @@ -10287,17 +10285,15 @@ Attributes : bufferSize :: The size of the buffer (in sample-frames) which needs to be - processed each time {{ScriptProcessorNode/onaudioprocess}} is called. + processed each time {{ScriptProcessorNode/audioprocess}} is fired. Legal values are (256, 512, 1024, 2048, 4096, 8192, 16384). : onaudioprocess :: - A property used to set the EventHandler (described - in - HTML[[!HTML]]) for the {{ScriptProcessorNode/onaudioprocess}} event that - is dispatched to {{ScriptProcessorNode}} node - types. An event of type {{AudioProcessingEvent}} - will be dispatched to the event handler. + A property used to set an [=event handler=] for the + audioprocess event type that is dispatched to + {{ScriptProcessorNode}} node types. The event dispatched to the event + handler uses the {{AudioProcessingEvent}} interface.
    @@ -11096,7 +11092,7 @@ the rendering thread will invoke the algorithm below: 1. Construct a callback function from |processorCtor| with the argument of |deserializedOptions|. If any exceptions are thrown in the callback, queue a task to the control thread to fire an event named - `processorerror` using {{ErrorEvent}} at |nodeReference|. + {{AudioWorkletNode/processorerror}} using {{ErrorEvent}} at |nodeReference|. 1. Empty the [=pending processor construction data=] slot. @@ -11281,7 +11277,7 @@ Attributes constructor, process method, or any user-defined class method, the processor will queue a media - element task to fire an event named `processorerror` using + element task to fire an event named processorerror using ErrorEvent at the associated {{AudioWorkletNode}}. @@ -12430,7 +12426,7 @@ task queue=] of its associated {{BaseAudioContext}}. 1. Queue a task to the control thread fire an - {{ErrorEvent}} named processorerror at the + {{ErrorEvent}} named {{AudioWorkletNode/processorerror}} at the associated {{AudioWorkletNode}}. 5. If this {{AudioNode}} is a destination node,