// This file is part of the 64k demo project.
// It defines the public interface and data structures for the synth.
// Supports spectrogram registration, voice triggering, and real-time rendering.

#pragma once

#include "dct.h"
#include <cstdint>

// Based on tracker score analysis (see generated/music_data.cc)
// Max simultaneous patterns: 5, recommended: 10 each
// Using 16 for comfortable headroom
#define MAX_VOICES 16
#define MAX_SPECTROGRAMS 16

struct Spectrogram {
  const float* spectral_data_a; // Front buffer
  const float* spectral_data_b; // Back buffer (for double-buffering)
  int num_frames;
};

void synth_init();
void synth_shutdown();

// Register a spectrogram for playback. Returns an ID or -1.
int synth_register_spectrogram(const Spectrogram* spec);
void synth_unregister_spectrogram(int spectrogram_id);

// Double-buffering API for thread-safe updates
float* synth_begin_update(int spectrogram_id);
void synth_commit_update(int spectrogram_id);

void synth_trigger_voice(int spectrogram_id, float volume, float pan);
void synth_render(float* output_buffer, int num_frames);

int synth_get_active_voice_count();
float synth_get_output_peak();