The Tor Browser: content/media/webaudio/blink/HRTFDatabase.h@b8a032363ba2

Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6

     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  */

    29 #ifndef HRTFDatabase_h

    30 #define HRTFDatabase_h

    32 #include "HRTFElevation.h"

    33 #include "nsAutoRef.h"

    34 #include "nsTArray.h"

    35 #include "mozilla/MemoryReporting.h"

    37 namespace WebCore {

    39 class HRTFKernel;

    41 class HRTFDatabase {

    42 public:

    43     static nsReturnRef<HRTFDatabase> create(float sampleRate);

    45     // getKernelsFromAzimuthElevation() returns a left and right ear kernel, and an interpolated left and right frame delay for the given azimuth and elevation.

    46     // azimuthBlend must be in the range 0 -> 1.

    47     // Valid values for azimuthIndex are 0 -> HRTFElevation::NumberOfTotalAzimuths - 1 (corresponding to angles of 0 -> 360).

    48     // Valid values for elevationAngle are MinElevation -> MaxElevation.

    49     void getKernelsFromAzimuthElevation(double azimuthBlend, unsigned azimuthIndex, double elevationAngle, HRTFKernel* &kernelL, HRTFKernel* &kernelR, double& frameDelayL, double& frameDelayR);

    51     // Returns the number of different azimuth angles.

    52     static unsigned numberOfAzimuths() { return HRTFElevation::NumberOfTotalAzimuths; }

    54     float sampleRate() const { return m_sampleRate; }

    56     // Number of elevations loaded from resource.

    57     static const unsigned NumberOfRawElevations;

    59     size_t sizeOfIncludingThis(mozilla::MallocSizeOf aMallocSizeOf) const;

    61 private:

    62     HRTFDatabase(const HRTFDatabase& other) MOZ_DELETE;

    63     void operator=(const HRTFDatabase& other) MOZ_DELETE;

    65     explicit HRTFDatabase(float sampleRate);

    67     // Minimum and maximum elevation angles (inclusive) for a HRTFDatabase.

    68     static const int MinElevation;

    69     static const int MaxElevation;

    70     static const unsigned RawElevationAngleSpacing;

    72     // Interpolates by this factor to get the total number of elevations from every elevation loaded from resource.

    73     static const unsigned InterpolationFactor;

    75     // Total number of elevations after interpolation.

    76     static const unsigned NumberOfTotalElevations;

    78     // Returns the index for the correct HRTFElevation given the elevation angle.

    79     static unsigned indexFromElevationAngle(double);

    81     nsTArray<nsAutoRef<HRTFElevation> > m_elevations;

    82     float m_sampleRate;

    83 };

    85 } // namespace WebCore

    87 template <>

    88 class nsAutoRefTraits<WebCore::HRTFDatabase> :

    89     public nsPointerRefTraits<WebCore::HRTFDatabase> {

    90 public:

    91     static void Release(WebCore::HRTFDatabase* ptr) { delete(ptr); }

    92 };

    94 #endif // HRTFDatabase_h

The Tor Browser / file revision

content/media/webaudio/blink/HRTFDatabase.h@b8a032363ba2

content/media/webaudio/blink/HRTFDatabase.h