fna-workbench

fna-workbench Git Source Tree


Root/src/Audio/SoundEffectInstance.cs

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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
#region License
/* FNA - XNA4 Reimplementation for Desktop Platforms
 * Copyright 2009-2016 Ethan Lee and the MonoGame Team
 *
 * Released under the Microsoft Public License.
 * See LICENSE for details.
 */
#endregion
 
#region Using Statements
using System;
#endregion
 
namespace Microsoft.Xna.Framework.Audio
{
    public class SoundEffectInstance : IDisposable
    {
        #region Public Properties
 
        public bool IsDisposed
        {
            get;
            protected set;
        }
 
        private bool INTERNAL_looped = false;
        public virtual bool IsLooped
        {
            get
            {
                return INTERNAL_looped;
            }
            set
            {
                INTERNAL_looped = value;
                if (INTERNAL_alSource != null)
                {
                    AudioDevice.ALDevice.SetSourceLooped(
                        INTERNAL_alSource,
                        value
                    );
                }
            }
        }
 
        private float INTERNAL_pan = 0.0f;
        public float Pan
        {
            get
            {
                return INTERNAL_pan;
            }
            set
            {
                INTERNAL_pan = value;
                if (INTERNAL_alSource != null)
                {
                    AudioDevice.ALDevice.SetSourcePan(
                        INTERNAL_alSource,
                        value
                    );
                }
            }
        }
 
        private float INTERNAL_pitch = 0f;
        public float Pitch
        {
            get
            {
                return INTERNAL_pitch;
            }
            set
            {
                INTERNAL_pitch = value;
                if (INTERNAL_alSource != null)
                {
                    AudioDevice.ALDevice.SetSourcePitch(
                        INTERNAL_alSource,
                        value,
                        !INTERNAL_isXACTSource
                    );
                }
            }
        }
 
        public SoundState State
        {
            get
            {
                if (INTERNAL_alSource == null)
                {
                    return SoundState.Stopped;
                }
                SoundState result = AudioDevice.ALDevice.GetSourceState(
                    INTERNAL_alSource
                );
                if (result == SoundState.Stopped && isDynamic)
                {
                    // Force playing at all times for DSFI!
                    return SoundState.Playing;
                }
                return result;
            }
        }
 
        private float INTERNAL_volume = 1.0f;
        public float Volume
        {
            get
            {
                return INTERNAL_volume;
            }
            set
            {
                INTERNAL_volume = value;
                if (INTERNAL_alSource != null)
                {
                    AudioDevice.ALDevice.SetSourceVolume(
                        INTERNAL_alSource,
                        value
                    );
                }
            }
        }
 
        #endregion
 
        #region Internal Variables: XACT Filters
 
        internal byte FilterType;
 
        #endregion
 
        #region Private Variables: XNA Implementation
 
        private SoundEffect INTERNAL_parentEffect;
        private WeakReference selfReference;
 
        internal bool isDynamic;
 
        /* FNA' XACT runtime wraps around SoundEffect for audio output.
         * Only problem: XACT pitch has no boundaries, SoundEffect does.
         * So, we're going to use this to tell the pitch clamp to STFU.
         * -flibit
         */
        internal bool INTERNAL_isXACTSource = false;
 
        #endregion
 
        #region Private Variables: AL Source, EffectSlot
 
        internal IALSource INTERNAL_alSource;
        private IALReverb INTERNAL_alReverb;
 
        #endregion
 
        #region Private Variables: 3D Audio
 
        protected Vector3 position = new Vector3(0.0f, 0.0f, 0.1f);
 
        // Used to prevent outdated positional audio data from being used
        protected bool INTERNAL_positionalAudio = false;
 
        #endregion
 
        #region Internal Constructor
 
        internal SoundEffectInstance(SoundEffect parent)
        {
            INTERNAL_parentEffect = parent;
            if (INTERNAL_parentEffect != null)
            {
                selfReference = new WeakReference(this);
                INTERNAL_parentEffect.Instances.Add(selfReference);
            }
            isDynamic = false;
        }
 
        #endregion
 
        #region Destructor
 
        ~SoundEffectInstance()
        {
            Dispose();
        }
 
        #endregion
 
        #region Public Dispose Method
 
        public virtual void Dispose()
        {
            if (!IsDisposed)
            {
                Stop(true);
                if (INTERNAL_parentEffect != null)
                {
                    INTERNAL_parentEffect.Instances.Remove(selfReference);
                    selfReference = null;
                }
                IsDisposed = true;
            }
        }
 
        #endregion
 
        #region Public 3D Audio Methods
 
        public void Apply3D(AudioListener listener, AudioEmitter emitter)
        {
            if (INTERNAL_alSource == null)
            {
                return;
            }
 
            // Set up orientation matrix
            Matrix orientation = Matrix.CreateWorld(Vector3.Zero, listener.Forward, listener.Up);
 
            // Set up our final position according to orientation of listener
            position = Vector3.Transform(emitter.Position - listener.Position, orientation);
            if (position != Vector3.Zero)
            {
                position.Normalize();
            }
 
            // Set the position based on relative positon
            AudioDevice.ALDevice.SetSourcePosition(
                INTERNAL_alSource,
                position
            );
 
            // We positional now
            INTERNAL_positionalAudio = true;
        }
 
        public void Apply3D(AudioListener[] listeners, AudioEmitter emitter)
        {
            throw new NotSupportedException("OpenAL can only make use of one listener.");
        }
 
        #endregion
 
        #region Public Playback Methods
 
        public virtual void Play()
        {
            if (State != SoundState.Stopped)
            {
                return;
            }
 
            if (INTERNAL_alSource != null)
            {
                // The sound has stopped, but hasn't cleaned up yet...
                AudioDevice.ALDevice.StopAndDisposeSource(INTERNAL_alSource);
                INTERNAL_alSource = null;
            }
 
            INTERNAL_alSource = AudioDevice.ALDevice.GenSource(
                INTERNAL_parentEffect.INTERNAL_buffer
            );
            if (INTERNAL_alSource == null)
            {
                FNAPlatform.Log("WARNING: AL SOURCE WAS NOT AVAILABLE. SKIPPING.");
                return;
            }
 
            // Apply Pan/Position
            if (INTERNAL_positionalAudio)
            {
                INTERNAL_positionalAudio = false;
                AudioDevice.ALDevice.SetSourcePosition(
                    INTERNAL_alSource,
                    position
                );
            }
            else
            {
                Pan = Pan;
            }
 
            // Reassign Properties, in case the AL properties need to be applied.
            Volume = Volume;
            IsLooped = IsLooped;
            Pitch = Pitch;
 
            // Apply EFX
            if (INTERNAL_alReverb != null)
            {
                AudioDevice.ALDevice.SetSourceReverb(
                    INTERNAL_alSource,
                    INTERNAL_alReverb
                );
            }
 
            AudioDevice.ALDevice.PlaySource(INTERNAL_alSource);
        }
 
        public void Pause()
        {
            if (INTERNAL_alSource != null && State == SoundState.Playing)
            {
                AudioDevice.ALDevice.PauseSource(INTERNAL_alSource);
            }
        }
 
        public void Resume()
        {
            if (INTERNAL_alSource == null)
            {
                // XNA4 just plays if we've not started yet.
                Play();
            }
            else if (State == SoundState.Paused)
            {
                AudioDevice.ALDevice.ResumeSource(INTERNAL_alSource);
            }
        }
 
        public void Stop()
        {
            if (INTERNAL_alSource != null)
            {
                // TODO: GraphicsResource-like reference management -flibit
                if (AudioDevice.ALDevice != null)
                {
                    AudioDevice.ALDevice.StopAndDisposeSource(INTERNAL_alSource);
                    DynamicSoundEffectInstance dsfi = this as DynamicSoundEffectInstance;
                    if (dsfi != null && AudioDevice.DynamicInstancePool.Contains(dsfi))
                    {
                        AudioDevice.DynamicInstancePool.Remove(dsfi);
                    }
                }
                INTERNAL_alSource = null;
            }
        }
 
        public void Stop(bool immediate)
        {
            Stop();
        }
 
        #endregion
 
        #region Internal Effects Methods
 
        internal void INTERNAL_applyReverb(IALReverb reverb)
        {
            INTERNAL_alReverb = reverb;
            if (INTERNAL_alSource != null)
            {
                AudioDevice.ALDevice.SetSourceReverb(
                    INTERNAL_alSource,
                    INTERNAL_alReverb
                );
            }
        }
 
        internal void INTERNAL_applyLowPassFilter(float hfGain)
        {
            if (INTERNAL_alSource != null)
            {
                AudioDevice.ALDevice.SetSourceLowPassFilter(INTERNAL_alSource, hfGain);
            }
        }
 
        internal void INTERNAL_applyHighPassFilter(float lfGain)
        {
            if (INTERNAL_alSource != null)
            {
                AudioDevice.ALDevice.SetSourceHighPassFilter(INTERNAL_alSource, lfGain);
            }
        }
 
        internal void INTERNAL_applyBandPassFilter(float hfGain, float lfGain)
        {
            if (INTERNAL_alSource != null)
            {
                AudioDevice.ALDevice.SetSourceBandPassFilter(INTERNAL_alSource, hfGain, lfGain);
            }
        }
 
        #endregion
    }
}

Archive Download this file

Branches

Number of commits:
Page rendered in 0.08523s using 11 queries.