summaryrefslogtreecommitdiffstats
path: root/src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.h')
-rw-r--r--src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.h69
1 files changed, 69 insertions, 0 deletions
diff --git a/src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.h b/src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.h
new file mode 100644
index 000000000..956811df4
--- /dev/null
+++ b/src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.h
@@ -0,0 +1,69 @@
+/*
+Copyright 2018 Google Inc. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS-IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+#ifndef RESONANCE_AUDIO_AMBISONICS_HOA_ROTATOR_H_
+#define RESONANCE_AUDIO_AMBISONICS_HOA_ROTATOR_H_
+
+#include <vector>
+
+#include "Eigen/Dense"
+#include "base/audio_buffer.h"
+#include "base/misc_math.h"
+
+namespace vraudio {
+
+// Rotator for higher order ambisonic sound fields. It supports ACN channel
+// ordering and SN3D normalization (AmbiX).
+class HoaRotator {
+ public:
+ // Constructs a sound field rotator of an arbitrary ambisonic order.
+ //
+ // @param ambisonic_order Order of ambisonic sound field.
+ explicit HoaRotator(int ambisonic_order);
+
+ // Performs a smooth inplace rotation of a sound field buffer from
+ // |current_rotation_| to |target_rotation|.
+ //
+ // @param target_rotation Target rotation to be applied to the input buffer.
+ // @param input Higher order sound field input buffer to be rotated.
+ // @param output Pointer to output buffer.
+ // @return True if rotation has been applied.
+ bool Process(const WorldRotation& target_rotation, const AudioBuffer& input,
+ AudioBuffer* output);
+
+ private:
+ // Updates the rotation matrix with using supplied WorldRotation.
+ //
+ // @param rotation World rotation.
+ void UpdateRotationMatrix(const WorldRotation& rotation);
+
+ // Order of the ambisonic sound field handled by the rotator.
+ const int ambisonic_order_;
+
+ // Current rotation which is used in the interpolation process in order to
+ // compute new rotation matrix. Initialized with an identity rotation.
+ WorldRotation current_rotation_;
+
+ // Spherical harmonics rotation sub-matrices for each order.
+ std::vector<Eigen::MatrixXf> rotation_matrices_;
+
+ // Final spherical harmonics rotation matrix.
+ Eigen::MatrixXf rotation_matrix_;
+};
+
+} // namespace vraudio
+
+#endif // RESONANCE_AUDIO_AMBISONICS_HOA_ROTATOR_H_