Version 0.8.10.1

dart/sdk/lib/web_audio/dart2js/web_audio_dart2js.dart

 /**
  * High-fidelity audio programming in the browser.
  */
 library dart.dom.web_audio;
 
 import 'dart:async';
 import 'dart:collection';
 import 'dart:_collection-dev' hide deprecated;
 import 'dart:html';
 import 'dart:html_common';
@@ skipping 136 matching lines @@
   void stop(num when) {
     if (JS('bool', '!!#.stop', this)) {
       JS('void', '#.stop(#)', this, when);
     } else {
       JS('void', '#.noteOff(#)', this, when);
     }
   }
   // To suppress missing implicit constructor warnings.
   factory AudioBufferSourceNode._() { throw new UnsupportedError("Not supported"); }
 
+  /**
+   * Static factory designed to expose `ended` events to event
+   * handlers that are not necessarily instances of [AudioBufferSourceNode].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
   @DomName('AudioBufferSourceNode.endedEvent')
   @DocsEditable()
   @Experimental() // untriaged
   static const EventStreamProvider<Event> endedEvent = const EventStreamProvider<Event>('ended');
 
   @DomName('AudioBufferSourceNode.FINISHED_STATE')
   @DocsEditable()
   static const int FINISHED_STATE = 3;
 
   @DomName('AudioBufferSourceNode.PLAYING_STATE')
@@ skipping 41 matching lines @@
   void noteGrainOn(num when, num grainOffset, num grainDuration) native;
 
   @DomName('AudioBufferSourceNode.noteOff')
   @DocsEditable()
   void noteOff(num when) native;
 
   @DomName('AudioBufferSourceNode.noteOn')
   @DocsEditable()
   void noteOn(num when) native;
 
+  /// Stream of `ended` events handled by this [AudioBufferSourceNode].
   @DomName('AudioBufferSourceNode.onended')
   @DocsEditable()
   @Experimental() // untriaged
   Stream<Event> get onEnded => endedEvent.forTarget(this);
 
 }
 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 
 @DomName('AudioContext')
 // https://dvcs.w3.org/hg/audio/raw-file/tip/webaudio/specification.html#AudioContext-section
 @Experimental()
 class AudioContext extends EventTarget native "AudioContext,webkitAudioContext" {
   // To suppress missing implicit constructor warnings.
   factory AudioContext._() { throw new UnsupportedError("Not supported"); }
 
+  /**
+   * Static factory designed to expose `complete` events to event
+   * handlers that are not necessarily instances of [AudioContext].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
   @DomName('AudioContext.completeEvent')
   @DocsEditable()
   static const EventStreamProvider<Event> completeEvent = const EventStreamProvider<Event>('complete');
 
   /// Checks if this type is supported on the current platform.
   static bool get supported => JS('bool', '!!(window.AudioContext || window.webkitAudioContext)');
 
   @DomName('AudioContext.activeSourceCount')
   @DocsEditable()
   final int activeSourceCount;
@@ skipping 109 matching lines @@
     _decodeAudioData(audioData,
         (value) { completer.complete(value); },
         (error) { completer.completeError(error); });
     return completer.future;
   }
 
   @DomName('AudioContext.startRendering')
   @DocsEditable()
   void startRendering() native;
 
+  /// Stream of `complete` events handled by this [AudioContext].
   @DomName('AudioContext.oncomplete')
   @DocsEditable()
   Stream<Event> get onComplete => completeEvent.forTarget(this);
 
   factory AudioContext() => JS('AudioContext',
       'new (window.AudioContext || window.webkitAudioContext)()');
 
   GainNode createGain() {
     if (JS('bool', '#.createGain !== undefined', this)) {
       return JS('GainNode', '#.createGain()', this);
@@ skipping 502 matching lines @@
 
 
 @DocsEditable()
 @DomName('OscillatorNode')
 // https://dvcs.w3.org/hg/audio/raw-file/tip/webaudio/specification.html#dfn-OscillatorNode
 @Experimental()
 class OscillatorNode extends AudioSourceNode native "OscillatorNode,Oscillator" {
   // To suppress missing implicit constructor warnings.
   factory OscillatorNode._() { throw new UnsupportedError("Not supported"); }
 
+  /**
+   * Static factory designed to expose `ended` events to event
+   * handlers that are not necessarily instances of [OscillatorNode].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
   @DomName('OscillatorNode.endedEvent')
   @DocsEditable()
   @Experimental() // untriaged
   static const EventStreamProvider<Event> endedEvent = const EventStreamProvider<Event>('ended');
 
   @DomName('OscillatorNode.FINISHED_STATE')
   @DocsEditable()
   static const int FINISHED_STATE = 3;
 
   @DomName('OscillatorNode.PLAYING_STATE')
@@ skipping 38 matching lines @@
   void setPeriodicWave(PeriodicWave periodicWave) native;
 
   @DomName('OscillatorNode.start')
   @DocsEditable()
   void start(num when) native;
 
   @DomName('OscillatorNode.stop')
   @DocsEditable()
   void stop(num when) native;
 
+  /// Stream of `ended` events handled by this [OscillatorNode].
   @DomName('OscillatorNode.onended')
   @DocsEditable()
   @Experimental() // untriaged
   Stream<Event> get onEnded => endedEvent.forTarget(this);
 }
 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 
@@ skipping 67 matching lines @@
 
 
 @DocsEditable()
 @DomName('ScriptProcessorNode')
 // https://dvcs.w3.org/hg/audio/raw-file/tip/webaudio/specification.html#ScriptProcessorNode
 @Experimental()
 class ScriptProcessorNode extends AudioNode native "ScriptProcessorNode,JavaScriptAudioNode" {
   // To suppress missing implicit constructor warnings.
   factory ScriptProcessorNode._() { throw new UnsupportedError("Not supported"); }
 
+  /**
+   * Static factory designed to expose `audioprocess` events to event
+   * handlers that are not necessarily instances of [ScriptProcessorNode].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
   @DomName('ScriptProcessorNode.audioprocessEvent')
   @DocsEditable()
   @Experimental() // untriaged
   static const EventStreamProvider<AudioProcessingEvent> audioProcessEvent = const EventStreamProvider<AudioProcessingEvent>('audioprocess');
 
   @DomName('ScriptProcessorNode.bufferSize')
   @DocsEditable()
   final int bufferSize;
 
-  /**
+  /// Stream of `audioprocess` events handled by this [ScriptProcessorNode].
+/**
    * Get a Stream that fires events when AudioProcessingEvents occur.
    * This particular stream is special in that it only allows one listener to a
    * given stream. Converting the returned Stream [asBroadcast] will likely ruin
    * the soft-real-time properties which which these events are fired and can
    * be processed.
    */
   @DomName('ScriptProcessorNode.onaudioprocess')
   @DocsEditable()
   @Experimental() // untriaged
   Stream<AudioProcessingEvent> get onAudioProcess => audioProcessEvent.forTarget(this);
@@ skipping 12 matching lines @@
   factory WaveShaperNode._() { throw new UnsupportedError("Not supported"); }
 
   @DomName('WaveShaperNode.curve')
   @DocsEditable()
   Float32List curve;
 
   @DomName('WaveShaperNode.oversample')
   @DocsEditable()
   String oversample;
 }