2 * Copyright (C) 2010 Google Inc. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of
14 * its contributors may be used to endorse or promote products derived
15 * from this software without specific prior written permission.
17 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
18 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
21 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
24 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 #ifndef HRTFDatabaseLoader_h
30 #define HRTFDatabaseLoader_h
32 #include "platform/audio/HRTFDatabase.h"
33 #include "platform/heap/Handle.h"
34 #include "public/platform/WebThread.h"
35 #include "wtf/HashMap.h"
36 #include "wtf/ThreadingPrimitives.h"
40 // HRTFDatabaseLoader will asynchronously load the default HRTFDatabase in a new thread.
42 class PLATFORM_EXPORT HRTFDatabaseLoader FINAL : public GarbageCollectedFinalized<HRTFDatabaseLoader> {
44 // Lazily creates a HRTFDatabaseLoader (if not already created) for the given sample-rate
45 // and starts loading asynchronously (when created the first time).
46 // Returns the HRTFDatabaseLoader.
47 // Must be called from the main thread.
48 static HRTFDatabaseLoader* createAndLoadAsynchronouslyIfNecessary(float sampleRate);
50 // Both constructor and destructor must be called from the main thread.
51 ~HRTFDatabaseLoader();
53 // Returns true once the default database has been completely loaded.
54 bool isLoaded() const;
56 // waitForLoaderThreadCompletion() may be called more than once and is thread-safe.
57 void waitForLoaderThreadCompletion();
59 HRTFDatabase* database() { return m_hrtfDatabase.get(); }
61 float databaseSampleRate() const { return m_databaseSampleRate; }
63 // Called in asynchronous loading thread.
66 void trace(Visitor*) { }
69 // Both constructor and destructor must be called from the main thread.
70 explicit HRTFDatabaseLoader(float sampleRate);
72 // If it hasn't already been loaded, creates a new thread and initiates asynchronous loading of the default database.
73 // This must be called from the main thread.
74 void loadAsynchronously();
76 OwnPtr<HRTFDatabase> m_hrtfDatabase;
78 // Holding a m_threadLock is required when accessing m_databaseLoaderThread since we access it from multiple threads.
80 OwnPtr<WebThread> m_databaseLoaderThread;
82 float m_databaseSampleRate;
87 #endif // HRTFDatabaseLoader_h