1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
/*
* Copyright (C) 2011 Google Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of
* its contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef AudioParamTimeline_h
#define AudioParamTimeline_h
#include "core/dom/DOMTypedArray.h"
#include "modules/webaudio/AbstractAudioContext.h"
#include "wtf/Forward.h"
#include "wtf/Threading.h"
#include "wtf/Vector.h"
namespace blink {
class AudioParamTimeline {
DISALLOW_NEW();
public:
AudioParamTimeline()
{
}
void setValueAtTime(float value, double time, ExceptionState&);
void linearRampToValueAtTime(float value, double time, ExceptionState&);
void exponentialRampToValueAtTime(float value, double time, ExceptionState&);
void setTargetAtTime(float target, double time, double timeConstant, ExceptionState&);
void setValueCurveAtTime(DOMFloat32Array* curve, double time, double duration, ExceptionState&);
void cancelScheduledValues(double startTime, ExceptionState&);
// hasValue is set to true if a valid timeline value is returned.
// otherwise defaultValue is returned.
float valueForContextTime(AbstractAudioContext*, float defaultValue, bool& hasValue);
// Given the time range in frames, calculates parameter values into the values buffer and
// returns the last parameter value calculated for "values" or the defaultValue if none were
// calculated. controlRate is the rate (number per second) at which parameter values will be
// calculated. It should equal sampleRate for sample-accurate parameter changes, and otherwise
// will usually match the render quantum size such that the parameter value changes once per
// render quantum.
float valuesForFrameRange(size_t startFrame, size_t endFrame, float defaultValue, float* values, unsigned numberOfValues, double sampleRate, double controlRate);
// Returns true if this AudioParam has any events on it.
bool hasValues() const;
private:
class ParamEvent {
public:
enum Type {
SetValue,
LinearRampToValue,
ExponentialRampToValue,
SetTarget,
SetValueCurve,
LastType
};
static ParamEvent createLinearRampEvent(float value, double time);
static ParamEvent createExponentialRampEvent(float value, double time);
static ParamEvent createSetValueEvent(float value, double time);
static ParamEvent createSetTargetEvent(float value, double time, double timeConstant);
static ParamEvent createSetValueCurveEvent(DOMFloat32Array* curve, double time, double duration);
Type getType() const { return m_type; }
float value() const { return m_value; }
double time() const { return m_time; }
double timeConstant() const { return m_timeConstant; }
double duration() const { return m_duration; }
DOMFloat32Array* curve() { return m_curve.get(); }
private:
ParamEvent(Type type, float value, double time, double timeConstant, double duration, PassRefPtr<DOMFloat32Array> curve)
: m_type(type)
, m_value(value)
, m_time(time)
, m_timeConstant(timeConstant)
, m_duration(duration)
, m_curve(curve)
{
}
Type m_type;
float m_value;
double m_time;
// Only used for SetTarget events
double m_timeConstant;
// Only used for SetValueCurve events.
double m_duration;
RefPtr<DOMFloat32Array> m_curve;
};
void insertEvent(const ParamEvent&, ExceptionState&);
float valuesForFrameRangeImpl(size_t startFrame, size_t endFrame, float defaultValue, float* values, unsigned numberOfValues, double sampleRate, double controlRate);
// Produce a nice string describing the event in human-readable form.
String eventToString(const ParamEvent&);
Vector<ParamEvent> m_events;
mutable Mutex m_eventsLock;
};
} // namespace blink
#endif // AudioParamTimeline_h
|
