1 /* 2 * Copyright (C) 2010, Google Inc. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * 1. Redistributions of source code must retain the above copyright 8 * notice, this list of conditions and the following disclaimer. 9 * 2. Redistributions in binary form must reproduce the above copyright 10 * notice, this list of conditions and the following disclaimer in the 11 * documentation and/or other materials provided with the distribution. 12 * 13 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND ANY 14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 15 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 16 * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY 17 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 18 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 19 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON 20 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 21 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 22 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 23 */ 24 25 // A cached (non-streamed), memory-resident audio source 26 [ 27 Conditional=WEB_AUDIO 28 ] interface AudioBufferSourceNode : AudioSourceNode { 29 [CustomSetter, SetterRaisesException] attribute AudioBuffer buffer; 30 31 const unsigned short UNSCHEDULED_STATE = 0; 32 const unsigned short SCHEDULED_STATE = 1; 33 const unsigned short PLAYING_STATE = 2; 34 const unsigned short FINISHED_STATE = 3; 35 36 readonly attribute unsigned short playbackState; 37 38 readonly attribute AudioParam gain; 39 readonly attribute AudioParam playbackRate; 40 41 attribute boolean loop; // This is the proper attribute name from the specification. 42 43 attribute double loopStart; 44 attribute double loopEnd; 45 46 [MeasureAs=WebAudioStart] void start(double when); 47 [MeasureAs=WebAudioStart, ImplementedAs=startGrain] void start(double when, double grainOffset); 48 [MeasureAs=WebAudioStart, ImplementedAs=startGrain] void start(double when, double grainOffset, double grainDuration); 49 void stop(double when); 50 51 [DeprecateAs=WebAudioLooping, ImplementedAs=loop] attribute boolean looping; // This is an alias for the .loop attribute for backwards compatibility. 52 53 [MeasureAs=LegacyWebAudio] void noteOn(double when); 54 [MeasureAs=LegacyWebAudio] void noteGrainOn(double when, double grainOffset, double grainDuration); 55 void noteOff(double when); 56 57 attribute EventHandler onended; 58 }; 59