rockbox.ffi.dsp — io.github.tsirysndr/rockbox-clj-ffi 0.1.1

The DSP pipeline: EQ, tone, surround, compressor, ReplayGain, resampler.

The underlying dsp_config is a process-wide singleton, so only one DSP handle may exist at a time and it must be used from one thread. A handle is an opaque MemorySegment; every function takes it as the first argument. Free it with free (or use with-dsp).

eq-enable clj

(eq-enable p enable?)

flush clj

(flush p)

free clj

(free p)

Free the native handle. Safe to call with nil.

new-dsp clj

(new-dsp sample-rate)

Create a DSP pipeline for the given input sample rate (Hz).

process clj

(process p samples)

Run interleaved stereo S16 samples (a short-array) through the pipeline. Returns a new short-array (length may differ — the resampler buffers).

set-channel-config clj

(set-channel-config p mode)

set-compressor clj

(set-compressor p threshold makeup-gain ratio knee release-time attack-time)

set-eq-band clj

(set-eq-band p band cutoff-hz q gain-db)

Configure one EQ band (0..9). Band 0 is a low shelf, 9 a high shelf.

set-eq-precut clj

(set-eq-precut p db)

set-input-frequency clj

(set-input-frequency p hz)

set-replaygain clj

(set-replaygain p mode noclip? preamp-db)

mode: rockbox.ffi.enums/dsp-replaygain-mode (:track :album :shuffle :off).

set-replaygain-gains clj

(set-replaygain-gains p
                      &
                      {:keys [track-gain-db album-gain-db track-peak album-peak]
                       :or {track-gain-db Float/NaN
                            album-gain-db Float/NaN
                            track-peak Float/NaN
                            album-peak Float/NaN}})

Per-track gains in plain dB / peaks as linear amplitude (1.0 = full scale). Omit any absent tag — it defaults to the ABI's NaN sentinel.

set-replaygain-gains-raw clj

(set-replaygain-gains-raw p track-gain album-gain track-peak album-peak)

Native Q7.24 linear factors (the raw_* fields from metadata), 0 = untagged.

set-stereo-width clj

(set-stereo-width p percent)

set-surround clj

(set-surround p delay-ms balance fx1 fx2)

set-tone clj

(set-tone p bass-db treble-db)

set-tone-cutoffs clj

(set-tone-cutoffs p bass-hz treble-hz)

sine-stereo clj

(sine-stereo freq-hz seconds rate)

(sine-stereo freq-hz seconds rate amplitude)

Generate seconds of a sine as an interleaved stereo short-array.

with-dsp clj macro

(with-dsp [sym sample-rate] & body)

Bind sym to a fresh DSP handle for sample-rate, run body, then free it.