IpatchUnit_SF2

IpatchUnit_SF2 — Unit types and conversions for SoundFont

Stability Level

Stable, unless otherwise indicated

Synopsis

int                 ipatch_unit_sf2_abs_pitch_to_dls_abs_pitch
                                                        (int sf2_abs_pitch);
int                 ipatch_unit_dls_abs_pitch_to_sf2_abs_pitch
                                                        (int dls_abs_pitch);
double              ipatch_unit_sf2_abs_pitch_to_hertz  (int sf2_abs_pitch);
int                 ipatch_unit_hertz_to_sf2_abs_pitch  (double hz);
double              ipatch_unit_sf2_ofs_pitch_to_multiplier
                                                        (int sf2_ofs_pitch);
int                 ipatch_unit_multiplier_to_sf2_ofs_pitch
                                                        (double multiplier);
int                 ipatch_unit_sf2_abs_time_to_dls_abs_time
                                                        (int sf2_abs_time);
int                 ipatch_unit_dls_abs_time_to_sf2_abs_time
                                                        (int dls_abs_time);
double              ipatch_unit_sf2_abs_time_to_seconds (int sf2_abs_time);
int                 ipatch_unit_seconds_to_sf2_abs_time (double sec);
double              ipatch_unit_sf2_ofs_time_to_multiplier
                                                        (int sf2_ofs_time);
int                 ipatch_unit_multiplier_to_sf2_ofs_time
                                                        (double multiplier);
int                 ipatch_unit_centibels_to_dls_gain   (int centibel);
int                 ipatch_unit_dls_gain_to_centibels   (int dls_gain);
double              ipatch_unit_centibels_to_decibels   (int cb);
int                 ipatch_unit_decibels_to_centibels   (double db);
double              ipatch_unit_tenth_percent_to_percent
                                                        (int tenth_percent);
int                 ipatch_unit_percent_to_tenth_percent
                                                        (double percent);

Description

Details

ipatch_unit_sf2_abs_pitch_to_dls_abs_pitch ()

int                 ipatch_unit_sf2_abs_pitch_to_dls_abs_pitch
                                                        (int sf2_abs_pitch);

Converts a value from SF2 absolute pitch to DLS absolute pitch.

sf2_abs_pitch = 1200 * log2(f/8.176) f = 8.176 * 2^(sf2_abs_pitch/1200)

dls_abs_pitch = (1200 * log2(f/440) + 6900) * 65536 f = 440 * 2^((dls_abs_pitch / 65536 - 6900) / 1200)

sf2_abs_pitch :

Value in SF2 absolute pitch

Returns :

Value converted to DLS absolute pitch

ipatch_unit_dls_abs_pitch_to_sf2_abs_pitch ()

int                 ipatch_unit_dls_abs_pitch_to_sf2_abs_pitch
                                                        (int dls_abs_pitch);

Converts a value from DLS absolute pitch to SF2 absolute pitch. See ipatch_unit_sf2_abs_pitch_to_dls_abs_pitch()

dls_abs_pitch :

Value in DLS absolute pitch

Returns :

Value converted to SF2 absolute pitch

ipatch_unit_sf2_abs_pitch_to_hertz ()

double              ipatch_unit_sf2_abs_pitch_to_hertz  (int sf2_abs_pitch);

Convert SoundFont absolute pitch to frequency in Hertz.

sf2_abs_pitch :

Value in SoundFont absolute pitch

Returns :

Value in Hertz (cycles per second)

ipatch_unit_hertz_to_sf2_abs_pitch ()

int                 ipatch_unit_hertz_to_sf2_abs_pitch  (double hz);

Convert frequency in Hertz to SoundFont absolute pitch.

hz :

Hertz (cycles per second) value

Returns :

Converted value in SoundFont absolute pitch.

ipatch_unit_sf2_ofs_pitch_to_multiplier ()

double              ipatch_unit_sf2_ofs_pitch_to_multiplier
                                                        (int sf2_ofs_pitch);

Convert SoundFont offset pitch (cents) to multiplier factor.

sf2_ofs_pitch :

Value in SoundFont offset pitch

Returns :

Multiplier factor

ipatch_unit_multiplier_to_sf2_ofs_pitch ()

int                 ipatch_unit_multiplier_to_sf2_ofs_pitch
                                                        (double multiplier);

Convert multiplier factor to SoundFont offset pitch (cents).

multiplier :

Multiplier factor

Returns :

Converted value in SoundFont offset pitch (cents).

ipatch_unit_sf2_abs_time_to_dls_abs_time ()

int                 ipatch_unit_sf2_abs_time_to_dls_abs_time
                                                        (int sf2_abs_time);

Convert a value from SF2 absolute time to DLS absolute time.

sf2_abs_time = 1200 * log2 (seconds) seconds = 2^(sf2_abs_time / 1200)

dls_abs_time = 1200 * log2 (seconds) * 65536 seconds = 2^(dls_abs_time / (1200 * 65536))

sf2_abs_time :

Value in SF2 absolute time (timecents)

Returns :

Value converted to DLS absolute time.

ipatch_unit_dls_abs_time_to_sf2_abs_time ()

int                 ipatch_unit_dls_abs_time_to_sf2_abs_time
                                                        (int dls_abs_time);

Convert a value from DLS absolute time to SF2 absolute time. See ipatch_unit_sf2_abs_time_to_dls_abs_time()

dls_abs_time :

Value in DLS absolute time

Returns :

Value converted to SF2 absolute time

ipatch_unit_sf2_abs_time_to_seconds ()

double              ipatch_unit_sf2_abs_time_to_seconds (int sf2_abs_time);

Convert a value from SoundFont absolute time (timecents) to seconds.

sf2_abs_time :

Value in SoundFont absolute time

Returns :

Value in seconds

ipatch_unit_seconds_to_sf2_abs_time ()

int                 ipatch_unit_seconds_to_sf2_abs_time (double sec);

Convert value from seconds to SoundFont absolute time (timecents).

sec :

Value in seconds

Returns :

Value in SoundFont absolute time

ipatch_unit_sf2_ofs_time_to_multiplier ()

double              ipatch_unit_sf2_ofs_time_to_multiplier
                                                        (int sf2_ofs_time);

Convert a value from SoundFont offset time (timecents) to a multiplier.

sf2_ofs_time :

Value in SoundFont offset time (timecents)

Returns :

Multiplier factor

ipatch_unit_multiplier_to_sf2_ofs_time ()

int                 ipatch_unit_multiplier_to_sf2_ofs_time
                                                        (double multiplier);

Convert value from a multiplier to SoundFont offset time (timecents).

multiplier :

Multiplier factor

Returns :

Value in SoundFont offset time (timecents)

ipatch_unit_centibels_to_dls_gain ()

int                 ipatch_unit_centibels_to_dls_gain   (int centibel);

Convert a value from centibels to DLS gain (1/655360th of a dB).

V = target amplitude, v = original amplitude centibel = 200 * log10 (v / V) dls_gain = 200 * 65536 * log10 (V / v)

centibel :

Value in centibels (10th of a Decibel)

Returns :

Value converted to DLS gain

ipatch_unit_dls_gain_to_centibels ()

int                 ipatch_unit_dls_gain_to_centibels   (int dls_gain);

Convert a value from DLS gain to centibels.

dls_gain :

Value in DLS gain (1/655360th of a dB)

Returns :

Value converted to centibels.

ipatch_unit_centibels_to_decibels ()

double              ipatch_unit_centibels_to_decibels   (int cb);

Convert a value from Centibels to Decibels.

cb :

Value in Centibels (10th of a Decibel)

Returns :

Value in Decibels

ipatch_unit_decibels_to_centibels ()

int                 ipatch_unit_decibels_to_centibels   (double db);

Convert Decibels to Centibels (10ths of a dB)

db :

Value in Decibels

Returns :

Converted value in Centibels (10ths of a Decibel)

ipatch_unit_tenth_percent_to_percent ()

double              ipatch_unit_tenth_percent_to_percent
                                                        (int tenth_percent);

Convert a value from 10ths of a Percent to Percent.

tenth_percent :

Value in 10ths of a Percent (Percent * 10)

Returns :

Value in Percent

ipatch_unit_percent_to_tenth_percent ()

int                 ipatch_unit_percent_to_tenth_percent
                                                        (double percent);

Convert Percent to 10ths of a Percent (Percent * 10)

percent :

Value in Percent

Returns :

Converted value in 10ths of a Percent