Deprecated: Function create_function() is deprecated in /home/c00p/www/lib/geshi/geshi.php on line 4698
//------------------------------------------------------------------------------
//  Pd Spectral Toolkit
//
//  freqtopolar~.c
//
//  Converts magnitude and frequency to polar coordinates
//
//  Created by Cooper Baker on 6/30/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


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


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

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

    // needed for signalinlet_new call in freqtopolar_new
    t_float inlet_2;

    // variable for overlap factor
    t_float overlap;

    // pointer to array of accumulated phase values
    t_float* phase_accum;

    // the local sample rate
    t_float sample_rate;

} t_freqtopolar;


//------------------------------------------------------------------------------
// function prototypes
//------------------------------------------------------------------------------
static t_int* freqtopolar_perform     ( t_int* io );
static void   freqtopolar_dsp         ( t_freqtopolar* object, t_signal **sig );
static void   freqtopolar_overlap     ( t_freqtopolar* object, t_floatarg overlap );
static void*  freqtopolar_new         ( t_symbol* symbol, t_int items, t_atom* list );
static void   freqtopolar_free        ( t_freqtopolar* object );
void          freqtopolar_tilde_setup ( void );


//------------------------------------------------------------------------------
// freqtopolar_perform - the signal processing function of this object
//------------------------------------------------------------------------------
static t_int* freqtopolar_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_freqtopolar* object      = ( t_freqtopolar* )( 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 phase;
    t_float bin_freq;
    t_float bin_offset;
    t_float frequency;
    t_float magnitude;

    // 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 with phase of last bin
        phase += phase_accum[ n ];

        // wrap accumulated phase between positive and negative pi
        phase = WrapPosNegPi( phase );

        // store accuulated phase for next dsp loop
        phase_accum[ n ] = phase;


        // store output samples
        //----------------------------------------------------------------------
        out1[ n ] = magnitude;
        out2[ n ] = phase;
    }

    // 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 ] );
}


//------------------------------------------------------------------------------
// freqtopolar_dsp - installs this object's dsp function in pd's callback list
//------------------------------------------------------------------------------
static void freqtopolar_dsp( t_freqtopolar* 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
    (
        freqtopolar_perform,
        6,
        sig[ 0 ]->s_vec,
        sig[ 1 ]->s_vec,
        sig[ 2 ]->s_vec,
        sig[ 3 ]->s_vec,
        sig[ 0 ]->s_n,
        object
    );
}


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


//------------------------------------------------------------------------------
// freqtopolar_new - instantiates a copy of this object in pd
//------------------------------------------------------------------------------
static void* freqtopolar_new( t_symbol* symbol, t_int items, t_atom* list )
{
    // create a pointer to this object
    t_freqtopolar* object = ( t_freqtopolar* )pd_new( freqtopolar_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 )
    {
        freqtopolar_overlap( object, atom_getfloatarg( 0, ( int )items, list ) );
    }
    else
    {
        object->overlap = 1;
    }

    return object;
}


//------------------------------------------------------------------------------
// freqtopolar_free - garbage collection
//------------------------------------------------------------------------------
static void freqtopolar_free( t_freqtopolar* 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;
    }
}


//------------------------------------------------------------------------------
// freqtopolar_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 freqtopolar_tilde_setup( void )
{
    // creates an instance of this object and describes it to pd
    freqtopolar_class = class_new( gensym( "freqtopolar~" ), ( t_newmethod )freqtopolar_new, ( t_method )freqtopolar_free, sizeof( t_freqtopolar ), 0, A_GIMME, 0 );

    // declares leftmost inlet as a signal inlet
    CLASS_MAINSIGNALIN( freqtopolar_class, t_freqtopolar, inlet_1 );

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

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


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