ame_Ambisonics.hpp

Go to the documentation of this file.

 
#pragma once
 
#include "ame_AudioBuffer.hpp"
#include "ame_Math.hpp"
#include "ame_Util.hpp"
 
#include <array>
#include <cassert>
#include <cstdint>
 
namespace ame::dsp
{
template <typename FloatType>
struct Polar
{
    FloatType azimuth {};   
    FloatType elevation {}; 
};
 
template <typename FloatType>
struct Ambisonics3D1st
{
    FloatType w {};
    FloatType y {};
    FloatType z {};
    FloatType x {};
};
 
template <typename FloatType>
struct Ambisonics2D1st
{
    FloatType w {};
    FloatType y {};
    FloatType x {};
};
 
template <typename FloatType>
constexpr void encodeAmbisonics1st (FloatType in, Ambisonics3D1st<FloatType>& out, const Polar<FloatType>& pos)
{
    out.w = in;
    out.x = in * cos (pos.azimuth) * cos (pos.elevation);
    out.y = in * sin (pos.azimuth) * cos (pos.elevation);
    out.z = in * sin (pos.elevation);
}
 
template <typename FloatType>
constexpr void encodeAmbisonics1st (FloatType in, Ambisonics2D1st<FloatType>& out, const FloatType azimuth)
{
    out.w = in;
    out.x = in * cos (azimuth);
    out.y = in * sin (azimuth);
}
 
template <typename FloatType>
constexpr FloatType decodeAmbisonics1st (const Ambisonics3D1st<FloatType>& in, const Polar<FloatType>& pos)
{
    FloatType out = in.w;
    out += in.x / (cos (pos.azimuth) * cos (pos.azimuth));
    out += in.y / (sin (pos.azimuth) * cos (pos.azimuth));
    out += in.z / sin (pos.elevation);
    return out;
}
 
template <typename FloatType>
constexpr FloatType decodeAmbisonics1st (const Ambisonics2D1st<FloatType>& in, const FloatType azimuth)
{
    FloatType out = in.w;
    out += in.x / cos (azimuth);
    out += in.y / sin (azimuth);
    return out;
}
 
} // namespace ame::dsp