File: HRTFElevation.h

package info (click to toggle)
chromium-browser 57.0.2987.98-1~deb8u1
  • links: PTS, VCS
  • area: main
  • in suites: jessie
  • size: 2,637,852 kB
  • ctags: 2,544,394
  • sloc: cpp: 12,815,961; ansic: 3,676,222; python: 1,147,112; asm: 526,608; java: 523,212; xml: 286,794; perl: 92,654; sh: 86,408; objc: 73,271; makefile: 27,698; cs: 18,487; yacc: 13,031; tcl: 12,957; pascal: 4,875; ml: 4,716; lex: 3,904; sql: 3,862; ruby: 1,982; lisp: 1,508; php: 1,368; exp: 404; awk: 325; csh: 117; jsp: 39; sed: 37
file content (131 lines) | stat: -rw-r--r-- 5,416 bytes parent folder | download
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
/*
 * Copyright (C) 2010 Google Inc. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1.  Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 * 2.  Redistributions in binary form must reproduce the above copyright
 *     notice, this list of conditions and the following disclaimer in the
 *     documentation and/or other materials provided with the distribution.
 * 3.  Neither the name of Apple Computer, Inc. ("Apple") nor the names of
 *     its contributors may be used to endorse or promote products derived
 *     from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef HRTFElevation_h
#define HRTFElevation_h

#include "platform/audio/HRTFKernel.h"
#include "wtf/Allocator.h"
#include "wtf/Noncopyable.h"
#include "wtf/PassRefPtr.h"
#include "wtf/RefPtr.h"
#include "wtf/text/CString.h"
#include "wtf/text/WTFString.h"
#include <memory>

namespace blink {

// HRTFElevation contains all of the HRTFKernels (one left ear and one right ear
// per azimuth angle) for a particular elevation.

class PLATFORM_EXPORT HRTFElevation {
  USING_FAST_MALLOC(HRTFElevation);
  WTF_MAKE_NONCOPYABLE(HRTFElevation);

 public:
  // Loads and returns an HRTFElevation with the given HRTF database subject
  // name and elevation from browser (or WebKit.framework) resources.
  // Normally, there will only be a single HRTF database set, but this API
  // supports the possibility of multiple ones with different names.
  // Interpolated azimuths will be generated based on InterpolationFactor.
  // Valid values for elevation are -45 -> +90 in 15 degree increments.
  static std::unique_ptr<HRTFElevation>
  createForSubject(const String& subjectName, int elevation, float sampleRate);

  // Given two HRTFElevations, and an interpolation factor x: 0 -> 1, returns an
  // interpolated HRTFElevation.
  static std::unique_ptr<HRTFElevation> createByInterpolatingSlices(
      HRTFElevation* hrtfElevation1,
      HRTFElevation* hrtfElevation2,
      float x,
      float sampleRate);

  // Returns the list of left or right ear HRTFKernels for all the azimuths
  // going from 0 to 360 degrees.
  HRTFKernelList* kernelListL() { return m_kernelListL.get(); }
  HRTFKernelList* kernelListR() { return m_kernelListR.get(); }

  double elevationAngle() const { return m_elevationAngle; }
  unsigned numberOfAzimuths() const { return NumberOfTotalAzimuths; }
  float sampleRate() const { return m_sampleRate; }

  // Returns the left and right kernels for the given azimuth index.
  // The interpolated delays based on azimuthBlend: 0 -> 1 are returned in
  // frameDelayL and frameDelayR.
  void getKernelsFromAzimuth(double azimuthBlend,
                             unsigned azimuthIndex,
                             HRTFKernel*& kernelL,
                             HRTFKernel*& kernelR,
                             double& frameDelayL,
                             double& frameDelayR);

  // Spacing, in degrees, between every azimuth loaded from resource.
  static const unsigned AzimuthSpacing;

  // Number of azimuths loaded from resource.
  static const unsigned NumberOfRawAzimuths;

  // Interpolates by this factor to get the total number of azimuths from every
  // azimuth loaded from resource.
  static const unsigned InterpolationFactor;

  // Total number of azimuths after interpolation.
  static const unsigned NumberOfTotalAzimuths;

  // Given a specific azimuth and elevation angle, returns the left and right
  // HRTFKernel.
  // Valid values for azimuth are 0 -> 345 in 15 degree increments.
  // Valid values for elevation are -45 -> +90 in 15 degree increments.
  // Returns true on success.
  static bool calculateKernelsForAzimuthElevation(
      int azimuth,
      int elevation,
      float sampleRate,
      const String& subjectName,
      std::unique_ptr<HRTFKernel>& kernelL,
      std::unique_ptr<HRTFKernel>& kernelR);

 private:
  HRTFElevation(std::unique_ptr<HRTFKernelList> kernelListL,
                std::unique_ptr<HRTFKernelList> kernelListR,
                int elevation,
                float sampleRate)
      : m_kernelListL(std::move(kernelListL)),
        m_kernelListR(std::move(kernelListR)),
        m_elevationAngle(elevation),
        m_sampleRate(sampleRate) {}

  std::unique_ptr<HRTFKernelList> m_kernelListL;
  std::unique_ptr<HRTFKernelList> m_kernelListR;
  double m_elevationAngle;
  float m_sampleRate;
};

}  // namespace blink

#endif  // HRTFElevation_h