The Tor Browser / file comparison

comparison: content/media/webaudio/blink/HRTFDatabaseLoader.h

content/media/webaudio/blink/HRTFDatabaseLoader.h

branch
TOR_BUG_9701
changeset 13
44a2da4a2ab2
equal deleted inserted replaced
-1:000000000000 0:48887bcc019d
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 *
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.
16 *
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.
27 */
28
29 #ifndef HRTFDatabaseLoader_h
30 #define HRTFDatabaseLoader_h
31
32 #include "nsHashKeys.h"
33 #include "mozilla/RefPtr.h"
34 #include "mozilla/MemoryReporting.h"
35 #include "mozilla/Mutex.h"
36 #include "HRTFDatabase.h"
37
38 template <class EntryType> class nsTHashtable;
39 template <class T> class nsAutoRef;
40
41 namespace WebCore {
42
43 // HRTFDatabaseLoader will asynchronously load the default HRTFDatabase in a new thread.
44
45 class HRTFDatabaseLoader {
46 public:
47 // Lazily creates a HRTFDatabaseLoader (if not already created) for the given sample-rate
48 // and starts loading asynchronously (when created the first time).
49 // Returns the HRTFDatabaseLoader.
50 // Must be called from the main thread.
51 static mozilla::TemporaryRef<HRTFDatabaseLoader> createAndLoadAsynchronouslyIfNecessary(float sampleRate);
52
53 // AddRef and Release may be called from any thread.
54 void AddRef()
55 {
56 #if defined(DEBUG) || defined(NS_BUILD_REFCNT_LOGGING)
57 int count =
58 #endif
59 ++m_refCnt;
60 MOZ_ASSERT(count > 0, "invalid ref count");
61 NS_LOG_ADDREF(this, count, "HRTFDatabaseLoader", sizeof(*this));
62 }
63
64 void Release()
65 {
66 // The last reference can't be removed on a non-main thread because
67 // the object can be accessed on the main thread from the hash
68 // table via createAndLoadAsynchronouslyIfNecessary().
69 int count = m_refCnt;
70 MOZ_ASSERT(count > 0, "extra release");
71 // Optimization attempt to possibly skip proxying the release to the
72 // main thread.
73 if (count != 1 && m_refCnt.compareExchange(count, count - 1)) {
74 NS_LOG_RELEASE(this, count - 1, "HRTFDatabaseLoader");
75 return;
76 }
77
78 ProxyRelease();
79 }
80
81 // Returns true once the default database has been completely loaded.
82 bool isLoaded() const;
83
84 // waitForLoaderThreadCompletion() may be called more than once,
85 // on any thread except m_databaseLoaderThread.
86 void waitForLoaderThreadCompletion();
87
88 HRTFDatabase* database() { return m_hrtfDatabase.get(); }
89
90 float databaseSampleRate() const { return m_databaseSampleRate; }
91
92 static void shutdown();
93
94 // Called in asynchronous loading thread.
95 void load();
96
97 size_t sizeOfIncludingThis(mozilla::MallocSizeOf aMallocSizeOf) const;
98
99 private:
100 // Both constructor and destructor must be called from the main thread.
101 explicit HRTFDatabaseLoader(float sampleRate);
102 ~HRTFDatabaseLoader();
103
104 void ProxyRelease(); // any thread
105 void MainThreadRelease(); // main thread only
106 class ProxyReleaseEvent;
107
108 // If it hasn't already been loaded, creates a new thread and initiates asynchronous loading of the default database.
109 // This must be called from the main thread.
110 void loadAsynchronously();
111
112 // Map from sample-rate to loader.
113 class LoaderByRateEntry : public nsFloatHashKey {
114 public:
115 LoaderByRateEntry(KeyTypePointer aKey)
116 : nsFloatHashKey(aKey)
117 , mLoader() // so PutEntry() will zero-initialize
118 {
119 }
120 HRTFDatabaseLoader* mLoader;
121 };
122
123 static PLDHashOperator shutdownEnumFunc(LoaderByRateEntry *entry,
124 void* unused);
125
126 // Keeps track of loaders on a per-sample-rate basis.
127 static nsTHashtable<LoaderByRateEntry> *s_loaderMap; // singleton
128
129 mozilla::Atomic<int> m_refCnt;
130
131 nsAutoRef<HRTFDatabase> m_hrtfDatabase;
132
133 // Holding a m_threadLock is required when accessing m_databaseLoaderThread.
134 mozilla::Mutex m_threadLock;
135 PRThread* m_databaseLoaderThread;
136
137 float m_databaseSampleRate;
138 };
139
140 } // namespace WebCore
141
142 #endif // HRTFDatabaseLoader_h

Mercurial Repository: The Tor Browser

Europalab SCM Repository Server

mercurial