minidsp_generators.c

Go to the documentation of this file.

 
#include "minidsp.h"
#include "minidsp_internal.h"
 
/* -----------------------------------------------------------------------
 * Public API: Signal generators
 * -----------------------------------------------------------------------*/
 
void MD_sine_wave(double *output, unsigned N, double amplitude,
                  double freq, double sample_rate)
{
    MD_CHECK_VOID(output != NULL, MD_ERR_NULL_POINTER, "output is NULL");
    MD_CHECK_VOID(N > 0, MD_ERR_INVALID_SIZE, "N must be > 0");
    MD_CHECK_VOID(sample_rate > 0.0, MD_ERR_INVALID_RANGE, "sample_rate must be > 0");
    double phase_step = 2.0 * M_PI * freq / sample_rate;
    for (unsigned i = 0; i < N; i++)
        output[i] = amplitude * sin(phase_step * (double)i);
}
 
void MD_white_noise(double *output, unsigned N, double amplitude,
                    unsigned seed)
{
    MD_CHECK_VOID(output != NULL, MD_ERR_NULL_POINTER, "output is NULL");
    MD_CHECK_VOID(N > 0, MD_ERR_INVALID_SIZE, "N must be > 0");
 
    /* 64-bit LCG (Knuth MMIX constants) for uniform doubles in (0, 1).
     * Self-contained so we don't need POSIX drand48. */
    unsigned long long state = (unsigned long long)seed;
 
    /* Box-Muller transform: convert pairs of uniform random numbers
     * into pairs of Gaussian random numbers (mean 0, std dev 1),
     * then scale by the requested amplitude.
     *
     * For each pair (u1, u2) drawn from (0, 1]:
     *   z0 = sqrt(-2 ln u1) * cos(2 pi u2)
     *   z1 = sqrt(-2 ln u1) * sin(2 pi u2) */
    unsigned i = 0;
    while (i + 1 < N) {
        state = state * 6364136223846793005ULL + 1442695040888963407ULL;
        double u1 = (double)(state >> 11) * 0x1.0p-53;
        if (u1 < DBL_MIN) u1 = DBL_MIN;
        state = state * 6364136223846793005ULL + 1442695040888963407ULL;
        double u2 = (double)(state >> 11) * 0x1.0p-53;
 
        double r = sqrt(-2.0 * log(u1));
        double theta = 2.0 * M_PI * u2;
        output[i]     = amplitude * r * cos(theta);
        output[i + 1] = amplitude * r * sin(theta);
        i += 2;
    }
    /* If N is odd, generate one extra pair and use only the first value */
    if (i < N) {
        state = state * 6364136223846793005ULL + 1442695040888963407ULL;
        double u1 = (double)(state >> 11) * 0x1.0p-53;
        if (u1 < DBL_MIN) u1 = DBL_MIN;
        state = state * 6364136223846793005ULL + 1442695040888963407ULL;
        double u2 = (double)(state >> 11) * 0x1.0p-53;
        output[i] = amplitude * sqrt(-2.0 * log(u1)) * cos(2.0 * M_PI * u2);
    }
}
 
void MD_impulse(double *output, unsigned N, double amplitude, unsigned position)
{
    MD_CHECK_VOID(output != NULL, MD_ERR_NULL_POINTER, "output is NULL");
    MD_CHECK_VOID(N > 0, MD_ERR_INVALID_SIZE, "N must be > 0");
    MD_CHECK_VOID(position < N, MD_ERR_INVALID_RANGE, "position must be < N");
    memset(output, 0, N * sizeof(double));
    output[position] = amplitude;
}
 
void MD_chirp_linear(double *output, unsigned N, double amplitude,
                     double f_start, double f_end, double sample_rate)
{
    MD_CHECK_VOID(output != NULL, MD_ERR_NULL_POINTER, "output is NULL");
    MD_CHECK_VOID(N > 0, MD_ERR_INVALID_SIZE, "N must be > 0");
    MD_CHECK_VOID(sample_rate > 0.0, MD_ERR_INVALID_RANGE, "sample_rate must be > 0");
 
    if (N == 1) {
        output[0] = 0.0;
        return;
    }
 
    double T = (double)(N - 1) / sample_rate;
    double chirp_rate = (f_end - f_start) / T;
 
    for (unsigned i = 0; i < N; i++) {
        double t = (double)i / sample_rate;
        double phase = 2.0 * M_PI * (f_start * t + 0.5 * chirp_rate * t * t);
        output[i] = amplitude * sin(phase);
    }
}
 
void MD_chirp_log(double *output, unsigned N, double amplitude,
                  double f_start, double f_end, double sample_rate)
{
    MD_CHECK_VOID(output != NULL, MD_ERR_NULL_POINTER, "output is NULL");
    MD_CHECK_VOID(N > 0, MD_ERR_INVALID_SIZE, "N must be > 0");
    MD_CHECK_VOID(sample_rate > 0.0, MD_ERR_INVALID_RANGE, "sample_rate must be > 0");
    MD_CHECK_VOID(f_start > 0.0, MD_ERR_INVALID_RANGE, "f_start must be > 0");
    MD_CHECK_VOID(f_end > 0.0, MD_ERR_INVALID_RANGE, "f_end must be > 0");
    MD_CHECK_VOID(f_start != f_end, MD_ERR_INVALID_RANGE, "f_start must != f_end");
 
    if (N == 1) {
        output[0] = 0.0;
        return;
    }
 
    double T = (double)(N - 1) / sample_rate;
    double ratio = f_end / f_start;
    double log_ratio = log(ratio);
 
    for (unsigned i = 0; i < N; i++) {
        double t = (double)i / sample_rate;
        double phase = 2.0 * M_PI * f_start * T
                     * (pow(ratio, t / T) - 1.0) / log_ratio;
        output[i] = amplitude * sin(phase);
    }
}
 
void MD_square_wave(double *output, unsigned N, double amplitude,
                    double freq, double sample_rate)
{
    MD_CHECK_VOID(output != NULL, MD_ERR_NULL_POINTER, "output is NULL");
    MD_CHECK_VOID(N > 0, MD_ERR_INVALID_SIZE, "N must be > 0");
    MD_CHECK_VOID(sample_rate > 0.0, MD_ERR_INVALID_RANGE, "sample_rate must be > 0");
    double phase_step = 2.0 * M_PI * freq / sample_rate;
    for (unsigned i = 0; i < N; i++) {
        double phase = fmod(phase_step * (double)i, 2.0 * M_PI);
        if (phase < 0.0) phase += 2.0 * M_PI;
        if (phase == 0.0 || phase == M_PI)
            output[i] = 0.0;
        else if (phase < M_PI)
            output[i] = amplitude;
        else
            output[i] = -amplitude;
    }
}
 
void MD_sawtooth_wave(double *output, unsigned N, double amplitude,
                      double freq, double sample_rate)
{
    MD_CHECK_VOID(output != NULL, MD_ERR_NULL_POINTER, "output is NULL");
    MD_CHECK_VOID(N > 0, MD_ERR_INVALID_SIZE, "N must be > 0");
    MD_CHECK_VOID(sample_rate > 0.0, MD_ERR_INVALID_RANGE, "sample_rate must be > 0");
    double phase_step = 2.0 * M_PI * freq / sample_rate;
    for (unsigned i = 0; i < N; i++) {
        double phase = fmod(phase_step * (double)i, 2.0 * M_PI);
        if (phase < 0.0) phase += 2.0 * M_PI;
        output[i] = amplitude * (phase / M_PI - 1.0);
    }
}
 
void MD_shepard_tone(double *output, unsigned N, double amplitude,
                     double base_freq, double sample_rate,
                     double rate_octaves_per_sec, unsigned num_octaves)
{
    MD_CHECK_VOID(output != NULL, MD_ERR_NULL_POINTER, "output is NULL");
    MD_CHECK_VOID(N > 0, MD_ERR_INVALID_SIZE, "N must be > 0");
    MD_CHECK_VOID(sample_rate > 0.0, MD_ERR_INVALID_RANGE, "sample_rate must be > 0");
    MD_CHECK_VOID(base_freq > 0.0, MD_ERR_INVALID_RANGE, "base_freq must be > 0");
    MD_CHECK_VOID(num_octaves > 0, MD_ERR_INVALID_SIZE, "num_octaves must be > 0");
 
    double rate    = rate_octaves_per_sec;
    double center  = (double)(num_octaves - 1) / 2.0;
    double sigma   = (double)num_octaves / 4.0;
    double nyquist = sample_rate / 2.0;
    double margin  = 5.0 * sigma;
 
    /* Determine the range of layer indices needed.
     *
     * Layer k has octave offset from the Gaussian centre at time t:
     *   d_k(t) = k − center + rate · t
     *
     * A layer is relevant if |d_k(t)| ≤ 5σ for at least one t in
     * [0, duration].  For rate > 0 (rising), d_k increases with time,
     * so early layers start below centre and later ones rise above it.
     * Extra layers below the initial configuration are needed to replace
     * those that drift above the Gaussian on the high side.  For rate < 0
     * (falling), the mirror logic applies. */
    double duration = (N > 1) ? (double)(N - 1) / sample_rate : 0.0;
    double drift    = rate * duration;
 
    int k_min = (int)floor(center - margin - fmax(0.0, drift));
    int k_max = (int)ceil(center + margin - fmin(0.0, drift));
    unsigned total_layers = (unsigned)(k_max - k_min + 1);
 
    /* Per-layer phase accumulators (zero-initialised). */
    double *phases = calloc(total_layers, sizeof(double));
    MD_CHECK_VOID(phases != NULL, MD_ERR_ALLOC_FAILED, "calloc failed");
    memset(output, 0, N * sizeof(double));
 
    for (unsigned i = 0; i < N; i++) {
        double t = (double)i / sample_rate;
        for (int k = k_min; k <= k_max; k++) {
            /* d = octave distance from Gaussian centre (continuous) */
            double d = (double)k - center + rate * t;
 
            /* Skip layers outside the significant Gaussian tail */
            if (fabs(d) > margin) continue;
 
            double freq = base_freq * pow(2.0, d);
            unsigned idx = (unsigned)(k - k_min);
            phases[idx] += 2.0 * M_PI * freq / sample_rate;
 
            /* Skip frequencies outside the audible / Nyquist range */
            if (freq >= nyquist || freq < 20.0) continue;
 
            double gauss = exp(-0.5 * d * d / (sigma * sigma));
            /* Keep phase bounded to preserve floating-point precision */
            if (phases[idx] > 4.0 * M_PI)
                phases[idx] = fmod(phases[idx], 2.0 * M_PI);
            output[i] += gauss * sin(phases[idx]);
        }
    }
 
    free(phases);
 
    /* Normalise so the peak absolute value equals the requested amplitude. */
    double peak = 0.0;
    for (unsigned i = 0; i < N; i++) {
        double a = fabs(output[i]);
        if (a > peak) peak = a;
    }
    if (peak > 0.0) {
        double scale = amplitude / peak;
        for (unsigned i = 0; i < N; i++)
            output[i] *= scale;
    }
}