//------------------------------------------------------------------------------
//  Pd Spectral Toolkit
//
//  freqtocar~.c
//
//  Converts magnitude and frequency to cartesian coordinates
//
//  Created by Cooper Baker on 7/7/12.
//  Updated for 64 Bit Support in September 2019.
//  Copyright (C) 2019 Cooper Baker. All Rights Reserved.
//------------------------------------------------------------------------------


//------------------------------------------------------------------------------
// headers
//------------------------------------------------------------------------------

// main header for pd
#include "m_pd.h"

// utility header for Pd Spectral Toolkit project
#include "utility.h"

// c standard library used for realloc and free
#include <stdlib.h>

// c standard library used for memset and memcpy
#include <string.h>

// disable compiler warnings on windows
#ifdef NT
#pragma warning( disable : 4244 )
#pragma warning( disable : 4305 )
#endif


//------------------------------------------------------------------------------
// freqtocar_class - pointer to this object's definition
//------------------------------------------------------------------------------
static t_class* freqtocar_class;


//------------------------------------------------------------------------------
// freqtocar - data structure holding this object's data
//------------------------------------------------------------------------------
typedef struct freqtocar
{
    // this object - must always be first variable in struct
    t_object object;

    // needed for CLASS_MAINSIGNALIN macro call in freqtocar_tilde_setup
    t_float inlet_1;

    // needed for signalinlet_new call in freqtocar_new
    t_float inlet_2;

    // variable for overlap factor
    t_float overlap;

    // pointer to temporary phase deviation (delta) data array
    t_float* delta_array_temp;

    // pointer to array of previous phase deviation (delta) info
    t_float* phase_accum;

    // the local sample rate
    t_float sample_rate;

} t_freqtocar;


//------------------------------------------------------------------------------
// function prototypes
//------------------------------------------------------------------------------
static t_int* freqtocar_perform     ( t_int* io );
static void   freqtocar_dsp         ( t_freqtocar* object, t_signal **sig );
static void   freqtocar_overlap     ( t_freqtocar* object, t_floatarg overlap );
static void*  freqtocar_new         ( t_symbol* symbol, t_int items, t_atom* list );
static void   freqtocar_free        ( t_freqtocar* object );
void          freqtocar_tilde_setup ( void );


//------------------------------------------------------------------------------
// freqtocar_perform - the signal processing function of this object
//------------------------------------------------------------------------------
static t_int* freqtocar_perform( t_int* io )
{
    // store variables from dsp input/output array
    t_float*     in1         = ( t_float*     )( io[ 1 ] );
    t_float*     in2         = ( t_float*     )( io[ 2 ] );
    t_float*     out1        = ( t_float*     )( io[ 3 ] );
    t_float*     out2        = ( t_float*     )( io[ 4 ] );
    t_float      frames      = ( t_int        )( io[ 5 ] );
    t_freqtocar* object      = ( t_freqtocar* )( io[ 6 ] );

    // store values from object's data structure
    t_float*     phase_accum = object->phase_accum;
    t_float      sample_rate = object->sample_rate;
    t_float      overlap     = object->overlap;

    // note
    //--------------------------------------------------------------------------
    // in re-blocked pd patches, sample rate is reported as parent
    // sample rate multiplied by overlap factor
    sample_rate = sample_rate / overlap;

    // signal vector iterator variable
    t_int n = -1;

    // allocate calculation variables
    t_float magnitude;
    t_float phase;
    t_float real;
    t_float imaginary;
    t_float bin_freq;
    t_float bin_offset;
    t_float frequency;

    // the dsp loop
    while( ++n < frames )
    {
        // magnitude ( inlet 1 )
        //----------------------------------------------------------------------

        // store magnitude value
        magnitude = in1[ n ];


        // frequency to phase ( inlet 2 )
        //----------------------------------------------------------------------

        // store input frequency
        frequency = in2[ n ];

        // calculate center frequency of each bin
        bin_freq = ( ( t_float )n / frames ) * sample_rate;

        // calculate center of bin offset from each frequency
        bin_offset = frequency - bin_freq;

        // calculate phase of each bins contents
        phase = bin_offset / ( ( ( sample_rate * overlap ) / frames ) / C_2_PI );

        // accumulate phase in each bin
        phase_accum[ n ] += phase;

        // note
        //----------------------------------------------------------------------
        // phase wrapping is unnecessary here because cosine and sine do not
        // need wrapped phase to perform their calculations.  By not wrapping
        // phase the computation of this dsp loop is significantly more efficient.

        real      = magnitude * Cosine( phase_accum[ n ] );
        imaginary = magnitude * Sine  ( phase_accum[ n ] );

        // store output samples
        //----------------------------------------------------------------------
        out1[ n ] = real;
        out2[ n ] = imaginary;
    }

    // return the dsp input/output array address plus one more than its size
    // to provide a pointer to the next perform function in pd's call list
    return &( io[ 7 ] );
}


//------------------------------------------------------------------------------
// freqtocar_dsp - installs this object's dsp function in pd's callback list
//------------------------------------------------------------------------------
static void freqtocar_dsp( t_freqtocar* object, t_signal **sig )
{
    // calculate memory size for realloc and memset
    t_int memory_size = sig[ 0 ]->s_n * sizeof( t_float );

    // allocate enough memory to hold signal vector data
    object->phase_accum = realloc( object->phase_accum,  memory_size );

    // set allocated memory values to 0
    memset( object->phase_accum, 0, memory_size );

    // store sample rate for use in dsp loop
    object->sample_rate = sig[ 0 ]->s_sr;

    // dsp_add arguments
    //--------------------------------------------------------------------------
    // perform routine
    // number of passed parameters
    // inlet 1 sample vector
    // inlet 2 sample vector
    // outlet 1 sample vector
    // outlet 2 sample vector
    // sample frames to process (vector size)
    // pointer to this object
    dsp_add
    (
        freqtocar_perform,
        6,
        sig[ 0 ]->s_vec,
        sig[ 1 ]->s_vec,
        sig[ 2 ]->s_vec,
        sig[ 3 ]->s_vec,
        sig[ 0 ]->s_n,
        object
    );
}


//------------------------------------------------------------------------------
// freqtocar_overlap - sets the overlap factor for use in dsp calculations
//------------------------------------------------------------------------------
static void freqtocar_overlap( t_freqtocar* object, t_floatarg overlap )
{
    object->overlap = ClipMin( overlap, 1 );
}


//------------------------------------------------------------------------------
// freqtocar_new - instantiates a copy of this object in pd
//------------------------------------------------------------------------------
static void* freqtocar_new( t_symbol* symbol, t_int items, t_atom* list )
{
    // create a pointer to this object
    t_freqtocar* object = ( t_freqtocar* )pd_new( freqtocar_class );

    // create a second signal inlet
    signalinlet_new( &object->object, object->inlet_2 );

    // create a float inlet to receive overlap factor value
    inlet_new( &object->object, &object->object.ob_pd, gensym( "float" ), gensym( "overlap" ) );

    // create two signal outlets for this object
    outlet_new( &object->object, gensym( "signal" ) );
    outlet_new( &object->object, gensym( "signal" ) );

    // initialize variables
    object->phase_accum = NULL;

    // handle overlap argument
    if( items )
    {
        freqtocar_overlap( object, atom_getfloatarg( 0, ( int )items, list ) );
    }
    else
    {
        object->overlap = 1;
    }

    return object;
}


//------------------------------------------------------------------------------
// freqtocar_free - garbage collection
//------------------------------------------------------------------------------
static void freqtocar_free( t_freqtocar* object )
{
    // if memory is allocated
    if( object->phase_accum )
    {
        // deallocate the memory
        free( object->phase_accum );

        // set the memory pointer to null
        object->phase_accum = NULL;
    }
}


//------------------------------------------------------------------------------
// freqtocar_tilde_setup - describes the attributes of this object to pd so it may be properly instantiated
// (must always be named with _tilde replacing ~ in the object name)
//------------------------------------------------------------------------------
void freqtocar_tilde_setup( void )
{
    // creates an instance of this object and describes it to pd
    freqtocar_class = class_new( gensym( "freqtocar~" ), ( t_newmethod )freqtocar_new, ( t_method )freqtocar_free, sizeof( t_freqtocar ), 0, A_GIMME, 0 );

    // declares leftmost inlet as a signal inlet
    CLASS_MAINSIGNALIN( freqtocar_class, t_freqtocar, inlet_1 );

    // installs freqtocar_dsp so that it will be called when dsp is turned on
    class_addmethod( freqtocar_class, ( t_method )freqtocar_dsp, gensym( "dsp" ), 0 );

    // associate a method with the "overlap" symbol for subsequent overlap inlet handling
    class_addmethod( freqtocar_class, ( t_method )freqtocar_overlap, gensym( "overlap" ), A_FLOAT, 0 );
}


//------------------------------------------------------------------------------
// EOF
//------------------------------------------------------------------------------