OLD | NEW |
1 /* | 1 /* |
2 * Copyright (C) 2010, Google Inc. All rights reserved. | 2 * Copyright (C) 2010, Google Inc. All rights reserved. |
3 * | 3 * |
4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
5 * modification, are permitted provided that the following conditions | 5 * modification, are permitted provided that the following conditions |
6 * are met: | 6 * are met: |
7 * 1. Redistributions of source code must retain the above copyright | 7 * 1. Redistributions of source code must retain the above copyright |
8 * notice, this list of conditions and the following disclaimer. | 8 * notice, this list of conditions and the following disclaimer. |
9 * 2. Redistributions in binary form must reproduce the above copyright | 9 * 2. Redistributions in binary form must reproduce the above copyright |
10 * notice, this list of conditions and the following disclaimer in the | 10 * notice, this list of conditions and the following disclaimer in the |
(...skipping 19 matching lines...) Expand all Loading... |
30 #include "modules/webaudio/AudioSummingJunction.h" | 30 #include "modules/webaudio/AudioSummingJunction.h" |
31 #include "platform/audio/AudioBus.h" | 31 #include "platform/audio/AudioBus.h" |
32 #include "wtf/Allocator.h" | 32 #include "wtf/Allocator.h" |
33 #include "wtf/HashSet.h" | 33 #include "wtf/HashSet.h" |
34 #include <memory> | 34 #include <memory> |
35 | 35 |
36 namespace blink { | 36 namespace blink { |
37 | 37 |
38 class AudioNodeOutput; | 38 class AudioNodeOutput; |
39 | 39 |
40 // An AudioNodeInput represents an input to an AudioNode and can be connected fr
om one or more AudioNodeOutputs. | 40 // An AudioNodeInput represents an input to an AudioNode and can be connected |
41 // In the case of multiple connections, the input will act as a unity-gain summi
ng junction, mixing all the outputs. | 41 // from one or more AudioNodeOutputs. In the case of multiple connections, the |
42 // The number of channels of the input's bus is the maximum of the number of cha
nnels of all its connections. | 42 // input will act as a unity-gain summing junction, mixing all the outputs. The |
| 43 // number of channels of the input's bus is the maximum of the number of |
| 44 // channels of all its connections. |
43 | 45 |
44 class AudioNodeInput final : public AudioSummingJunction { | 46 class AudioNodeInput final : public AudioSummingJunction { |
45 USING_FAST_MALLOC(AudioNodeInput); | 47 USING_FAST_MALLOC(AudioNodeInput); |
46 | 48 |
47 public: | 49 public: |
48 static std::unique_ptr<AudioNodeInput> create(AudioHandler&); | 50 static std::unique_ptr<AudioNodeInput> create(AudioHandler&); |
49 | 51 |
50 // AudioSummingJunction | 52 // AudioSummingJunction |
51 void didUpdate() override; | 53 void didUpdate() override; |
52 | 54 |
53 // Can be called from any thread. | 55 // Can be called from any thread. |
54 AudioHandler& handler() const { return m_handler; } | 56 AudioHandler& handler() const { return m_handler; } |
55 | 57 |
56 // Must be called with the context's graph lock. | 58 // Must be called with the context's graph lock. |
57 void connect(AudioNodeOutput&); | 59 void connect(AudioNodeOutput&); |
58 void disconnect(AudioNodeOutput&); | 60 void disconnect(AudioNodeOutput&); |
59 | 61 |
60 // disable() will take the output out of the active connections list and set a
side in a disabled list. | 62 // disable() will take the output out of the active connections list and set |
| 63 // aside in a disabled list. |
61 // enable() will put the output back into the active connections list. | 64 // enable() will put the output back into the active connections list. |
62 // Must be called with the context's graph lock. | 65 // Must be called with the context's graph lock. |
63 void enable(AudioNodeOutput&); | 66 void enable(AudioNodeOutput&); |
64 void disable(AudioNodeOutput&); | 67 void disable(AudioNodeOutput&); |
65 | 68 |
66 // pull() processes all of the AudioNodes connected to us. | 69 // pull() processes all of the AudioNodes connected to us. |
67 // In the case of multiple connections it sums the result into an internal sum
ming bus. | 70 // In the case of multiple connections it sums the result into an internal |
68 // In the single connection case, it allows in-place processing where possible
using inPlaceBus. | 71 // summing bus. In the single connection case, it allows in-place processing |
69 // It returns the bus which it rendered into, returning inPlaceBus if in-place
processing was performed. | 72 // where possible using inPlaceBus. It returns the bus which it rendered |
| 73 // into, returning inPlaceBus if in-place processing was performed. |
70 // Called from context's audio thread. | 74 // Called from context's audio thread. |
71 AudioBus* pull(AudioBus* inPlaceBus, size_t framesToProcess); | 75 AudioBus* pull(AudioBus* inPlaceBus, size_t framesToProcess); |
72 | 76 |
73 // bus() contains the rendered audio after pull() has been called for each tim
e quantum. | 77 // bus() contains the rendered audio after pull() has been called for each |
| 78 // time quantum. |
74 // Called from context's audio thread. | 79 // Called from context's audio thread. |
75 AudioBus* bus(); | 80 AudioBus* bus(); |
76 | 81 |
77 // updateInternalBus() updates m_internalSummingBus appropriately for the numb
er of channels. | 82 // updateInternalBus() updates m_internalSummingBus appropriately for the |
78 // This must be called when we own the context's graph lock in the audio threa
d at the very start or end of the render quantum. | 83 // number of channels. This must be called when we own the context's graph |
| 84 // lock in the audio thread at the very start or end of the render quantum. |
79 void updateInternalBus(); | 85 void updateInternalBus(); |
80 | 86 |
81 // The number of channels of the connection with the largest number of channel
s. | 87 // The number of channels of the connection with the largest number of |
| 88 // channels. |
82 unsigned numberOfChannels() const; | 89 unsigned numberOfChannels() const; |
83 | 90 |
84 private: | 91 private: |
85 explicit AudioNodeInput(AudioHandler&); | 92 explicit AudioNodeInput(AudioHandler&); |
86 | 93 |
87 // This reference is safe because the AudioHandler owns this AudioNodeInput | 94 // This reference is safe because the AudioHandler owns this AudioNodeInput |
88 // object. | 95 // object. |
89 AudioHandler& m_handler; | 96 AudioHandler& m_handler; |
90 | 97 |
91 // m_disabledOutputs contains the AudioNodeOutputs which are disabled (will | 98 // m_disabledOutputs contains the AudioNodeOutputs which are disabled (will |
92 // not be processed) by the audio graph rendering. But, from JavaScript's | 99 // not be processed) by the audio graph rendering. But, from JavaScript's |
93 // perspective, these outputs are still connected to us. | 100 // perspective, these outputs are still connected to us. |
94 // Generally, these represent disabled connections from "notes" which have | 101 // Generally, these represent disabled connections from "notes" which have |
95 // finished playing but are not yet garbage collected. | 102 // finished playing but are not yet garbage collected. |
96 // These raw pointers are safe. Owner AudioNodes of these AudioNodeOutputs | 103 // These raw pointers are safe. Owner AudioNodes of these AudioNodeOutputs |
97 // manage their lifetime, and AudioNode::dispose() disconnects all of | 104 // manage their lifetime, and AudioNode::dispose() disconnects all of |
98 // connections. | 105 // connections. |
99 HashSet<AudioNodeOutput*> m_disabledOutputs; | 106 HashSet<AudioNodeOutput*> m_disabledOutputs; |
100 | 107 |
101 // Called from context's audio thread. | 108 // Called from context's audio thread. |
102 AudioBus* internalSummingBus(); | 109 AudioBus* internalSummingBus(); |
103 void sumAllConnections(AudioBus* summingBus, size_t framesToProcess); | 110 void sumAllConnections(AudioBus* summingBus, size_t framesToProcess); |
104 | 111 |
105 RefPtr<AudioBus> m_internalSummingBus; | 112 RefPtr<AudioBus> m_internalSummingBus; |
106 }; | 113 }; |
107 | 114 |
108 } // namespace blink | 115 } // namespace blink |
109 | 116 |
110 #endif // AudioNodeInput_h | 117 #endif // AudioNodeInput_h |
OLD | NEW |