DAFFUtils.h

Go to the documentation of this file.

/*
 * -------------------------------------------------------------------------------------
 *
 *  OpenDAFF - A free, open source software package for directional audio data
 *  Copyright 2016 Institute of Technical Acoustics, RWTH Aachen University
 *  OpenDAFF is distributed under the Apache License Version 2.0.
 *
 *  ------------------------------------------------------------------------------------
 *
 */

#ifndef IW_DAFF_UTILS
#define IW_DAFF_UTILS

#include <DAFFDefs.h>

#include <string>
#include <cmath>

namespace DAFF
{
    static const float PI_F = acos( -1.0f );
    static const double PI_D = acos( -1.0f );
    static const float HALF_PI_F = PI_F / 2.0f;
    static const float TWO_PI_F = 2.0f * PI_F;
    static const double EPSILON_D = 1.0e-6;
}


class DAFF_API DAFFUtils
{
public:
    static void getLibraryVersion( DAFFVersion& version );


    static std::string StrDirection( int iView, double dAngle1Deg, double dAngle2Deg, int precision = 9, int leadingzeros = 3 );


    static std::string StrDirectionCompact( int iView, double dAngle1Deg, double dAngle2Deg, int precision = 9, int leadingzeros = 3 );

    static std::string StrError( int iErrorcode );

    static std::string StrContentType( int iContentType );
    
    static std::string StrShortContentType( int iContentType );

    static std::string StrMetadataKeyType( int iKeyType );

    static std::string StrQuantizationType( int iQuantizationType );


    static void NormalizeDirection( int iView, float fAngle1DegIn, float fAngle2DegIn, float& fAngle1DegOut, float& fAngle2DegOut);


    static std::string Float2StrNice( float f, int precision, bool showpos, int leadingzeros = 0 );


    static std::string Double2StrNice( double d, int precision, bool showpos, int leadingzeros=0 );
    


    // --= Angle conversion and normalization =--

    inline static float grad2radf( float phi )
    {
        return phi * DAFF::PI_F / 180.0f;
    };

    inline static float rad2gradf( float phi )
    { 
        return phi * 180.0f / DAFF::PI_F; 
    };

    inline static double grad2rad( double phi )
    {
        return phi * DAFF::PI_D / 180.0f;
    };

    inline static double rad2grad( double phi )
    { 
        return phi * 180.0f / DAFF::PI_D;
    };

private:
    inline DAFFUtils() {};
    inline DAFFUtils( const DAFFUtils& ) {};
    inline ~DAFFUtils() {};
};

#endif // IW_DAFF_UTILS