SPB Git

Repository Public

EngineAudioTests.swift 32.8 KB 641 lines swift

1// ORIX DJ2// File: Packages/ORIXDJCore/Tests/ORIXDJEngineTests/EngineAudioTests.swift3// Description: Objective audio tests of the engine rendered offline: playback fidelity, gain, EQ, filters, crossfader,4//              tempo, key lock, pitch, loops, sync, routing, limiter, automation timing. Every number is measured.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import Foundation9import ORIXAnalysis10import ORIXDSP11@testable import ORIXDJEngine12import ORIXScript13import Testing1415let SR = 48000.01617func rms(_ x: ArraySlice<Float>) -> Double { (x.reduce(0.0) { $0 + Double($1) * Double($1) } / Double(max(1, x.count))).squareRoot() }18func peak(_ x: ArraySlice<Float>) -> Float { x.reduce(0) { max($0, abs($1)) } }19func db(_ ratio: Double) -> Double { 20 * log10(max(ratio, 1e-12)) }2021/// Dominant frequency by counting positive zero crossings with sub-sample interpolation.22func frequency(_ x: ArraySlice<Float>, sampleRate: Double = SR) -> Double {23    var first = -1.0, last = -1.0, count = 024    let a = Array(x)25    for i in 1 ..< a.count where a[i - 1] < 0 && a[i] >= 0 {26        let t = Double(i - 1) + Double(-a[i - 1]) / Double(a[i] - a[i - 1])27        if first < 0 { first = t } else { count += 1 }28        last = t29    }30    return count > 0 ? Double(count) * sampleRate / (last - first) : 031}3233/// Sample indices where the signal first exceeds `threshold` after at least `gap` quiet samples.34func onsets(_ x: [Float], threshold: Float = 0.2, gap: Int = 2000) -> [Int] {35    var out: [Int] = []; var quiet = gap36    for (i, v) in x.enumerated() {37        if abs(v) >= threshold { if quiet >= gap { out.append(i) }; quiet = 0 } else { quiet += 1 }38    }39    return out40}4142func makeEngine(sampleRate: Double = SR, buffer: Int = 256) -> DJEngine {43    var c = EngineConfiguration(); c.sampleRate = sampleRate; c.bufferFrames = buffer44    let e = DJEngine(configuration: c)45    // Tests measure the raw path unless they say otherwise.46    e.set(.mixer("master.limiter"), .bool(false))47    e.set(.mixer("crossfader"), .number(0.5)); e.set(.mixer("curve"), .string("linear"))48    // Let the limiter's bypass cross-fade (12 ms, 5 ms look-ahead) finish before anything is measured.49    _ = e.renderOffline(frames: 4096)50    return e51}5253@discardableResult func load(_ e: DJEngine, _ deck: Int, _ samples: [Float], right: [Float]? = nil, sampleRate: Double = SR, bpm: Double? = nil, firstBeat: Double = 0, title: String = "test") -> TrackBuffer {54    let buffer = TrackBuffer(left: samples, right: right ?? samples, sampleRate: sampleRate)55    let grid = bpm.map { BeatGrid(bpm: $0, firstBeatSeconds: firstBeat, downbeatIndex: 0) }56    #expect(e.load(deck: deck, buffer: buffer, info: LoadedTrack(title: title, duration: buffer.duration, sampleRate: sampleRate, grid: grid)))57    return buffer58}5960@Suite struct PlaybackTests {61    @Test func unityPlaybackIsTransparent() {62        let e = makeEngine()63        let src = SignalSynth.pinkNoise(seconds: 2, sampleRate: SR, amplitude: 0.3)64        load(e, 0, src)65        e.set(.mixer("crossfader"), .number(0))66        e.play(deck: 0)67        let out = e.renderOffline(frames: 48000)[0]68        // After the 4 ms start fade the output is the source, sample for sample.69        var maxError: Float = 070        for i in 2400 ..< 48000 { maxError = max(maxError, abs(out[i] - src[i])) }71        #expect(maxError < 1e-6, "max error \(maxError)")72        #expect(e.renderState.clippedBlocks == 0)73    }7475    @Test func faderTrimAndMasterGainsAreAccurate() {76        for (volume, gain, master) in [(-6.0, 0.0, 0.0), (-20.0, 6.0, -3.0), (0.0, -12.0, 3.0)] {77            let e = makeEngine()78            load(e, 0, SignalSynth.sine(frequency: 1000, seconds: 2, sampleRate: SR, amplitude: 0.25))79            e.set(.mixer("crossfader"), .number(0))80            e.set(.deck(0, "volume"), .gain(volume)); e.set(.deck(0, "gain"), .gain(gain)); e.set(.mixer("master.volume"), .gain(master))81            e.play(deck: 0)82            let out = e.renderOffline(frames: 48000)[0]83            let measured = db(rms(out[24000...]) / (0.25 / 2.0.squareRoot()))84            #expect(abs(measured - (volume + gain + master)) < 0.02, "expected \(volume + gain + master) dB, measured \(measured)")85        }86    }8788    @Test func silenceAtFloor() {89        let e = makeEngine()90        load(e, 0, SignalSynth.sine(frequency: 1000, seconds: 1, sampleRate: SR))91        e.set(.deck(0, "volume"), .gain(-60))92        e.play(deck: 0)93        let out = e.renderOffline(frames: 24000)[0]94        #expect(peak(out[4800...]) == 0)95    }9697    @Test func eqBandsAndKill() {98        func level(_ f: Double, _ key: String, _ value: Double) -> Double {99            let e = makeEngine()100            load(e, 0, SignalSynth.sine(frequency: f, seconds: 2, sampleRate: SR, amplitude: 0.25))101            e.set(.mixer("crossfader"), .number(0)); e.set(.deck(0, key), .gain(value))102            e.play(deck: 0)103            return db(rms(e.renderOffline(frames: 72000)[0][36000...]) / (0.25 / 2.0.squareRoot()))104        }105        // Boost and cut reach the shelf / peak gain in band and leave the far bands alone.106        #expect(abs(level(40, "eq.low", 6) - 6) < 0.5)107        #expect(abs(level(40, "eq.low", -12) - -12) < 1)108        #expect(abs(level(8000, "eq.low", -12)) < 0.3)109        #expect(abs(level(1000, "eq.mid", -12) - -12) < 0.3)110        #expect(abs(level(12000, "eq.high", 6) - 6) < 0.5)111        #expect(abs(level(60, "eq.high", -12)) < 0.3)112        // Full kill at the bottom of the range.113        #expect(level(40, "eq.low", -26) < -50)114        #expect(level(12000, "eq.high", -26) < -50)115    }116117    @Test func channelFilters() {118        func level(_ f: Double, _ key: String, _ value: Value) -> Double {119            let e = makeEngine()120            load(e, 0, SignalSynth.sine(frequency: f, seconds: 2, sampleRate: SR, amplitude: 0.25))121            e.set(.mixer("crossfader"), .number(0)); e.set(.deck(0, "filter.resonance"), .number(0.707)); e.set(.deck(0, key), value)122            e.play(deck: 0)123            return db(rms(e.renderOffline(frames: 72000)[0][36000...]) / (0.25 / 2.0.squareRoot()))124        }125        #expect(abs(level(1000, "filter.highpass", .frequency(1000)) - -3.01) < 0.2)126        #expect(abs(level(100, "filter.highpass", .frequency(1000)) - -40) < 1)127        #expect(abs(level(1000, "filter.lowpass", .frequency(1000)) - -3.01) < 0.2)128        // Above the corner a digital low-pass falls faster than 12 dB/octave as it nears Nyquist.129        #expect(level(10000, "filter.lowpass", .frequency(1000)) < -40)130        // Knob: right opens a high-pass, left closes a low-pass, centre is transparent.131        #expect(level(100, "filter", .number(0.8)) < -30)132        #expect(level(8000, "filter", .number(-0.8)) < -30)133        #expect(abs(level(1000, "filter", .number(0))) < 0.01)134    }135136    @Test func crossfaderCurves() {137        func levels(_ curve: String, _ x: Double) -> (Double, Double) {138            let e = makeEngine()139            load(e, 0, SignalSynth.sine(frequency: 1000, seconds: 1, sampleRate: SR, amplitude: 0.25), right: [Float](repeating: 0, count: 48000))140            load(e, 1, [Float](repeating: 0, count: 48000), right: SignalSynth.sine(frequency: 1000, seconds: 1, sampleRate: SR, amplitude: 0.25))141            e.set(.mixer("curve"), .string(curve)); e.set(.mixer("crossfader"), .number(x))142            e.play(deck: 0); e.play(deck: 1)143            // Deck A is left-only here because deck B's left channel is silent, and vice versa on the right.144            let out = e.renderOffline(frames: 36000)145            let ref = 0.25 / 2.0.squareRoot()146            return (db(rms(out[0][18000...]) / ref), db(rms(out[1][18000...]) / ref))147        }148        var r = levels("smooth", 0.5); #expect(abs(r.0 - -3.01) < 0.05); #expect(abs(r.1 - -3.01) < 0.05)149        r = levels("smooth", 0); #expect(abs(r.0) < 0.01); #expect(r.1 < -100)150        r = levels("smooth", 1); #expect(r.0 < -100); #expect(abs(r.1) < 0.01)151        r = levels("linear", 0.5); #expect(abs(r.0) < 0.01); #expect(abs(r.1) < 0.01)152        r = levels("linear", 0.75); #expect(abs(r.0 - -6.02) < 0.05); #expect(abs(r.1) < 0.01)153        r = levels("cut", 0.9); #expect(abs(r.0) < 0.01); #expect(abs(r.1) < 0.01)154        r = levels("cut", 1); #expect(r.0 < -100)155    }156157    @Test func varispeedChangesPitchAndSpeed() {158        let e = makeEngine()159        load(e, 0, SignalSynth.sine(frequency: 1000, seconds: 4, sampleRate: SR, amplitude: 0.25))160        e.set(.deck(0, "rate"), .number(1.25))161        e.play(deck: 0)162        let out = e.renderOffline(frames: 96000)[0]163        #expect(abs(frequency(out[24000...]) - 1250) < 0.05)164        #expect(abs(e.deckStatus(0).position - 2.5) < 0.01)165    }166167    @Test func sampleRateConversionKeepsPitchAndDuration() {168        let e = makeEngine()169        load(e, 0, SignalSynth.sine(frequency: 1000, seconds: 3, sampleRate: 44100, amplitude: 0.25), sampleRate: 44100)170        e.set(.mixer("crossfader"), .number(0))171        e.play(deck: 0)172        let out = e.renderOffline(frames: 96000)[0]173        #expect(abs(frequency(out[24000...]) - 1000) < 0.02)174        #expect(abs(e.deckStatus(0).position - 2.0) < 0.001)175        #expect(abs(db(rms(out[24000...]) / (0.25 / 2.0.squareRoot()))) < 0.01)176    }177178    @Test func keyLockKeepsPitchWhileTempoChanges() {179        for rate in [0.8, 0.92, 1.0, 1.06, 1.25] {180            let e = makeEngine()181            load(e, 0, SignalSynth.sine(frequency: 440, seconds: 8, sampleRate: SR, amplitude: 0.25))182            e.set(.mixer("crossfader"), .number(0))183            e.set(.deck(0, "keylock"), .bool(true)); e.set(.deck(0, "rate"), .number(rate))184            e.play(deck: 0)185            let out = e.renderOffline(frames: 192_000)[0]186            let f = frequency(out[48000...])187            #expect(abs(f - 440) < 0.5, "rate \(rate): \(f) Hz")188            // Playhead speed equals the rate.189            #expect(abs(e.deckStatus(0).position - 4 * rate) < 0.06, "rate \(rate): position \(e.deckStatus(0).position)")190            let level = db(rms(out[48000...]) / (0.25 / 2.0.squareRoot()))191            #expect(abs(level) < 1.0, "rate \(rate): level \(level) dB")192        }193    }194195    @Test func keyShiftTransposesWithoutChangingTempo() {196        for semitones in [-5.0, 3.0, 7.0, 12.0] {197            let e = makeEngine()198            load(e, 0, SignalSynth.sine(frequency: 440, seconds: 8, sampleRate: SR, amplitude: 0.25))199            e.set(.deck(0, "keyShift"), .number(semitones))200            e.play(deck: 0)201            let out = e.renderOffline(frames: 192_000)[0]202            let expected = 440 * pow(2, semitones / 12)203            let f = frequency(out[48000...])204            #expect(abs(f - expected) / expected < 0.002, "\(semitones) st: \(f) Hz, expected \(expected)")205            #expect(abs(e.deckStatus(0).position - 4) < 0.06)206        }207    }208209    @Test func keyLockPreservesBeatTiming() {210        // 120 BPM clicks played 5 % faster with key lock: clicks arrive every 0.5 / 1.05 s.211        let e = makeEngine()212        load(e, 0, SignalSynth.clickTrack(bpm: 120, seconds: 12, sampleRate: SR), bpm: 120)213        e.set(.mixer("crossfader"), .number(0))214        e.set(.deck(0, "keylock"), .bool(true)); e.set(.deck(0, "rate"), .number(1.05))215        e.play(deck: 0)216        let out = e.renderOffline(frames: 480_000)[0]217        let hits = onsets(out, threshold: 0.15)218        #expect(hits.count >= 19)219        let expected = 0.5 / 1.05 * SR220        var worst = 0.0221        for k in 2 ..< hits.count { worst = max(worst, abs(Double(hits[k] - hits[1]) - Double(k - 1) * expected)) }222        // The stretcher works in 21 ms frames; clicks may move by a few milliseconds but must not drift.223        #expect(worst / SR * 1000 < 12, "worst click deviation \(worst / SR * 1000) ms")224    }225226    @Test func reverseAndBrake() {227        let e = makeEngine()228        let src = SignalSynth.sweep(from: 200, to: 2000, seconds: 2, sampleRate: SR)229        load(e, 0, src)230        e.set(.mixer("crossfader"), .number(0))231        e.seek(deck: 0, seconds: 1)232        e.set(.deck(0, "reverse"), .bool(true))233        e.play(deck: 0)234        let out = e.renderOffline(frames: 24000)[0]235        var maxError: Float = 0236        for i in 2400 ..< 24000 { maxError = max(maxError, abs(out[i] - src[48000 - i])) }237        #expect(maxError < 1e-5)238        e.set(.deck(0, "reverse"), .bool(false))239        e.brake(deck: 0, seconds: 0.5)240        _ = e.renderOffline(frames: 48000)241        #expect(!e.deckStatus(0).playing)242    }243244    @Test func trackEndStopsAndReports() {245        let e = makeEngine()246        load(e, 0, SignalSynth.sine(frequency: 500, seconds: 0.5, sampleRate: SR))247        let box = EventBox()248        e.onEvent = { box.add($0) }249        e.play(deck: 0)250        _ = e.renderOffline(frames: 48000)251        #expect(!e.deckStatus(0).playing)252        #expect(box.events.contains(.deck(0, "trackEnd")))253    }254255    @Test func transportIsClickFree() {256        // Pausing and seeking in the middle of a loud low tone must not produce steps. (A start from silence is257        // deliberately sample-exact and unsmoothed; here it begins on a zero crossing.)258        let e = makeEngine()259        load(e, 0, SignalSynth.sine(frequency: 80, seconds: 6, sampleRate: SR, amplitude: 0.8))260        e.set(.mixer("crossfader"), .number(0))261        var out: [Float] = []262        e.play(deck: 0); out += e.renderOffline(frames: 10000)[0]263        e.seek(deck: 0, seconds: 2.0031); out += e.renderOffline(frames: 10000)[0]264        e.pause(deck: 0); out += e.renderOffline(frames: 4000)[0]265        var maxStep: Float = 0266        for i in 1 ..< out.count { maxStep = max(maxStep, abs(out[i] - out[i - 1])) }267        // An 80 Hz sine at 0.8 moves 0.0084 per sample; the de-click adds a 4 ms slope, never a jump.268        #expect(maxStep < 0.03, "largest sample-to-sample step \(maxStep)")269    }270}271272final class EventBox: @unchecked Sendable {273    private let lock = NSLock()274    private var stored: [EngineEvent] = []275    func add(_ e: EngineEvent) { lock.lock(); stored.append(e); lock.unlock() }276    var events: [EngineEvent] { lock.lock(); defer { lock.unlock() }; return stored }277}278279@Suite struct DeckFeatureTests {280    @Test func loopIsSampleExact() {281        let e = makeEngine()282        load(e, 0, SignalSynth.clickTrack(bpm: 120, seconds: 20, sampleRate: SR), bpm: 120)283        e.set(.mixer("crossfader"), .number(0))284        e.seek(deck: 0, seconds: 2.0)285        #expect(e.loop(deck: 0, beats: 2) == nil)286        e.play(deck: 0)287        let out = e.renderOffline(frames: 48000 * 6)[0]288        let hits = onsets(out, threshold: 0.15)289        // A 2-beat loop at 120 BPM: a click every 24 000 samples, forever.290        #expect(hits.count >= 11)291        // The seam correction may move the threshold crossing of the click at the loop start by a few samples;292        // from one pass of the loop to the next the timing is exact.293        for k in 1 ..< hits.count { #expect(abs(hits[k] - hits[k - 1] - 24000) <= 4) }294        for k in 4 ..< hits.count { #expect(hits[k] - hits[k - 2] == 48000) }295        let s = e.deckStatus(0)296        #expect(s.position >= 2.0 && s.position < 3.0)297        #expect(s.loop?.active == true)298        e.scaleLoop(deck: 0, by: 0.5)299        _ = e.renderOffline(frames: 48000)300        #expect(e.deckStatus(0).position < 2.5)301        e.loopExit(deck: 0)302        _ = e.renderOffline(frames: 96000)303        #expect(e.deckStatus(0).position > 3.0)304    }305306    @Test func quantizedCuesAndHotCues() {307        let e = makeEngine()308        load(e, 0, SignalSynth.clickTrack(bpm: 120, seconds: 30, sampleRate: SR), bpm: 120)309        e.seek(deck: 0, seconds: 4.07)310        _ = e.renderOffline(frames: 256)311        e.setHotcue(deck: 0, index: 0)312        e.setCue(deck: 0)313        #expect(e.deckStatus(0).hotcues[0] == 4.0)314        #expect(e.deckStatus(0).cuePoint == 4.0)315        e.set(.deck(0, "quantize"), .bool(false))316        e.seek(deck: 0, seconds: 6.07); _ = e.renderOffline(frames: 256)317        e.setHotcue(deck: 0, index: 1)318        #expect(abs((e.deckStatus(0).hotcues[1] ?? 0) - 6.07) < 1e-6)319        #expect(e.hotcue(deck: 0, index: 2) != nil)320        #expect(e.hotcue(deck: 0, index: 0) == nil)321        _ = e.renderOffline(frames: 4800)322        #expect(e.deckStatus(0).playing)323        #expect(abs(e.deckStatus(0).position - 4.1) < 0.01)324        e.cue(deck: 0); _ = e.renderOffline(frames: 512)325        #expect(!e.deckStatus(0).playing)326        #expect(e.deckStatus(0).position == 4.0)327        e.jump(deck: 0, beats: 8); _ = e.renderOffline(frames: 512)328        #expect(e.deckStatus(0).position == 8.0)329    }330331    @Test func syncMatchesTempoAndPhase() {332        let e = makeEngine()333        load(e, 0, SignalSynth.clickTrack(bpm: 120, seconds: 60, sampleRate: SR), bpm: 120)334        // Deck B: 126 BPM, first beat 80 ms into the file, heard on the right channel only.335        let b = SignalSynth.clickTrack(bpm: 126, seconds: 60, sampleRate: SR, offsetSeconds: 0.08)336        load(e, 1, [Float](repeating: 0, count: b.count), right: b, bpm: 126, firstBeat: 0.08)337        let silentRight = SignalSynth.clickTrack(bpm: 120, seconds: 60, sampleRate: SR)338        load(e, 0, silentRight, right: [Float](repeating: 0, count: silentRight.count), bpm: 120)339        e.play(deck: 0)340        _ = e.renderOffline(frames: 48000 * 3 + 7000)341        e.set(.deck(1, "sync"), .bool(true))342        _ = e.renderOffline(frames: 2048)343        e.play(deck: 1)344        let out = e.renderOffline(frames: 48000 * 12)345        #expect(abs(e.deckStatus(1).bpm - 120) < 0.05)346        let a = onsets(out[0], threshold: 0.15), bHits = onsets(out[1], threshold: 0.15)347        #expect(bHits.count >= 20)348        var worst = 0.0, sum = 0.0349        for h in bHits.dropFirst(2) {350            let nearest = a.min { abs($0 - h) < abs($1 - h) }!351            worst = max(worst, Double(abs(nearest - h))); sum += Double(abs(nearest - h))352        }353        let mean = sum / Double(bHits.count - 2)354        print("=== ORIX-SYNC === mean \(mean / SR * 1000) ms, worst \(worst / SR * 1000) ms over \(bHits.count - 2) beats === END ===")355        #expect(worst / SR * 1000 < 3.0, "worst phase error \(worst / SR * 1000) ms")356    }357358    @Test func masterClockFollowsTheMasterDeck() {359        let e = makeEngine()360        load(e, 0, SignalSynth.clickTrack(bpm: 128, seconds: 30, sampleRate: SR), bpm: 128)361        #expect(e.service().masterDeck == nil)362        e.play(deck: 0)363        _ = e.renderOffline(frames: 48000 * 2)364        let c = e.service()365        #expect(c.masterDeck == 0)366        #expect(abs(c.bpm - 128) < 1e-6)367        // The clock's beat phase equals the deck's beat phase.368        let deckBeat = e.deckStatus(0).beat369        #expect(abs((c.beat - deckBeat).truncatingRemainder(dividingBy: 4)) < 1e-6)370        e.set(.deck(0, "rate"), .number(1.0625))371        _ = e.renderOffline(frames: 48000)372        #expect(abs(e.service().bpm - 136) < 0.01)373    }374375    @Test func routingCueBusAndSplitCue() {376        let e = makeEngine()377        load(e, 0, SignalSynth.sine(frequency: 500, seconds: 2, sampleRate: SR, amplitude: 0.25))378        load(e, 1, SignalSynth.sine(frequency: 2000, seconds: 2, sampleRate: SR, amplitude: 0.25))379        e.set(.mixer("crossfader"), .number(0))380        e.set(.deck(1, "cue"), .bool(true)); e.set(.deck(1, "volume"), .gain(-60))381        var r = DJEngine.Routing(); r.cueLeft = 2; r.cueRight = 3382        e.setRouting(r)383        e.play(deck: 0); e.play(deck: 1)384        var out = e.renderOffline(frames: 48000, channels: 4)385        // Master carries deck A only; the cue output carries deck B pre-fader although its fader is down.386        #expect(abs(frequency(out[0][12000...]) - 500) < 0.5)387        #expect(abs(frequency(out[2][12000...]) - 2000) < 0.5)388        #expect(abs(db(rms(out[3][12000...]) / (0.25 / 2.0.squareRoot()))) < 0.05)389        // Cue mix fully to master: the headphones hear the master.390        e.set(.mixer("cue.mix"), .number(1))391        out = e.renderOffline(frames: 24000, channels: 4)392        #expect(abs(frequency(out[2][12000...]) - 500) < 0.5)393        // Split cue on a stereo device: master left, cue right.394        e.set(.mixer("cue.mix"), .number(0))395        r = DJEngine.Routing(); r.splitCue = true396        e.setRouting(r)397        out = e.renderOffline(frames: 24000, channels: 2)398        #expect(abs(frequency(out[0][12000...]) - 500) < 0.5)399        #expect(abs(frequency(out[1][12000...]) - 2000) < 0.5)400    }401402    @Test func limiterAndClipIndicator() {403        func run(limiter: Bool) -> (Float, UInt32, Float) {404            let e = makeEngine()405            e.set(.mixer("master.limiter"), .bool(limiter))406            _ = e.renderOffline(frames: 4096) // switching the limiter cross-fades over 12 ms407            e.core.resetCounters()408            for d in 0 ..< 3 { load(e, d, SignalSynth.sine(frequency: 200 + Double(d) * 37, seconds: 3, sampleRate: SR, amplitude: 0.9)); e.set(.deck(d, "assign"), .number(2)); e.play(deck: d) }409            let out = e.renderOffline(frames: 96000)[0]410            return (peak(out[24000...]), e.renderState.clippedBlocks, e.renderState.limiterReductionDB)411        }412        let off = run(limiter: false)413        #expect(off.0 > 1.5)414        #expect(off.1 > 0)415        let on = run(limiter: true)416        // Ceiling of the master limiter is -1 dBFS.417        #expect(on.0 <= 0.8913 * 1.012, "peak with limiter \(on.0)")418        #expect(on.1 == 0)419        #expect(on.2 < -3)420    }421422    @Test func effectsRackOrderEnableAndRemoval() {423        let e = makeEngine()424        load(e, 0, SignalSynth.sine(frequency: 1000, seconds: 6, sampleRate: SR, amplitude: 0.25))425        e.set(.mixer("crossfader"), .number(0))426        e.play(deck: 0)427        let ref = 0.25 / 2.0.squareRoot()428        func level() -> Double { db(rms(e.renderOffline(frames: 24000)[0][12000...]) / ref) }429        let hp = e.insertEffect(.highpass, rack: 0)430        #expect(hp == 0)431        #expect(e.insertEffect(.highpass, rack: 0) == 0)432        e.setEffectParameter(rack: 0, slot: hp, index: 0, value: 10000)433        #expect(abs(level()) < 0.01)434        e.setEffectEnabled(rack: 0, slot: hp, true)435        #expect(level() < -35)436        let dist = e.insertEffect(.distortion, rack: 0)437        e.moveEffect(rack: 0, from: dist, to: 0)438        #expect(e.rackStatus(0).map(\.kind) == [.distortion, .highpass])439        #expect(e.rackStatus(0)[1].enabled)440        #expect(level() < -35)441        e.removeEffect(rack: 0, slot: 0)442        #expect(e.rackStatus(0).map(\.kind) == [.highpass])443        #expect(level() < -35)444        e.bypassAllEffects()445        #expect(abs(level()) < 0.01)446        #expect(!e.rackStatus(0)[0].enabled)447        // Master rack through the parameter address space.448        #expect(e.set(.fx(.lowpass, "cutoff"), .frequency(100)) == nil)449        #expect(e.set(.fx(.lowpass, "enabled"), .bool(true)) == nil)450        #expect(level() < -35)451        #expect(e.value(of: .fx(.lowpass, "cutoff")) == .frequency(100))452        for k in EffectKind.allCases.prefix(rackSlotCount) { _ = e.insertEffect(k, rack: 1) }453        #expect(e.insertEffect(.noise, rack: 1) == -1)454    }455}456457@Suite struct AutomationLiveTests {458    func compile(_ s: String) -> Program { ScriptCompiler.compile(s).program! }459460    @Test func scriptActionsLandOnExactSamples() {461        let e = makeEngine()462        let host = AutomationHost(engine: e)463        host.lookaheadSeconds = 0.02464        load(e, 0, SignalSynth.clickTrack(bpm: 120, seconds: 120, sampleRate: SR), right: [Float](repeating: 0, count: 120 * 48000), bpm: 120)465        let b = SignalSynth.clickTrack(bpm: 120, seconds: 120, sampleRate: SR)466        load(e, 1, [Float](repeating: 0, count: b.count), right: b, bpm: 120)467        let playStart = Int(e.sampleTime)468        e.play(deck: 0)469        _ = host.renderOffline(frames: 48000 + 3333)470        let program = compile("automation \"Drop\" quantize bar {\n at bar 2 { deck.B.play() }\n at bar 4 { deck.B.pause() }\n at beat 15 { deck.B.play() }\n wait 5bars }")471        host.start(program)472        let startSample = Int(e.sampleTime)473        let out = host.renderOffline(frames: 48000 * 14)474        // Deck A clicks mark the grid; deck B must start exactly on those samples.475        let a = onsets(out[0], threshold: 0.15), bHits = onsets(out[1], threshold: 0.15)476        #expect(bHits.count >= 4)477        var worst = 0478        for h in bHits { worst = max(worst, a.map { abs($0 - h) }.min()!) }479        let s = host.stats480        print("=== ORIX-AUTOMATION-TIMING === tracked \(s.trackedEvents) late \(s.lateEvents) maxLate \(s.maxLateSamples) samples; worst click offset \(worst) samples === END ===")481        #expect(worst <= 2, "deck B clicks are \(worst) samples off the grid")482        #expect(s.lateEvents == 0)483        // First B click: the automation started on the next bar and bar 2 is four beats later.484        // The automation waits for the next bar of the master clock (a multiple of 96 000 samples); bar 2 is 4 beats later.485        let sinceStart = startSample - playStart486        let expected = (sinceStart + 95999) / 96000 * 96000 + 96000 - sinceStart487        #expect(abs(bHits[0] - expected) <= 2, "first click at \(bHits[0]), expected \(expected)")488        #expect(host.activeRuns.isEmpty)489    }490491    @Test func rampsAreSmoothAndReachTheirTargets() {492        let e = makeEngine()493        let host = AutomationHost(engine: e)494        load(e, 0, [Float](repeating: 0.5, count: 48000 * 20), bpm: 120)495        e.set(.mixer("crossfader"), .number(0))496        e.play(deck: 0)497        _ = host.renderOffline(frames: 9600)498        host.start(compile("automation \"Fade\" { over 4beats { deck.A.volume -> -20dB }\n wait 1beat\n deck.A.volume = 0dB }"))499        let out = host.renderOffline(frames: 48000 * 3)[0]500        // DC input: the output is the gain curve itself. Linear in dB: -10 dB at the half-way point (1 s).501        #expect(abs(db(Double(out[48000]) / 0.5) - -10) < 0.25)502        #expect(abs(db(Double(out[96000 + 4800]) / 0.5) - -20) < 0.05)503        #expect(abs(db(Double(out[120_000 + 4800]) / 0.5)) < 0.01)504        var maxStep: Float = 0505        for i in 1 ..< 96000 { maxStep = max(maxStep, abs(out[i] - out[i - 1])) }506        #expect(maxStep < 0.0005, "largest gain step during the ramp \(maxStep)")507    }508509    @Test func failingScriptLeavesAudioRunningAndBypassesItsEffects() {510        let e = makeEngine()511        let host = AutomationHost(engine: e)512        let src = SignalSynth.sine(frequency: 1000, seconds: 10, sampleRate: SR, amplitude: 0.25)513        load(e, 0, src, bpm: 120)514        e.set(.mixer("crossfader"), .number(0))515        e.play(deck: 0)516        host.start(compile("automation \"Bad\" {\n fx.bitcrusher.enable()\n wait 1beat\n deck.C.play()\n}"))517        let out = host.renderOffline(frames: 48000 * 2)[0]518        #expect(host.recentRuns.last.map { if case .failed = $0.state { true } else { false } } == true)519        #expect(host.stats.runtimeErrors == 1)520        #expect(e.rackStatus(nil).first?.enabled == false)521        #expect(e.deckStatus(0).playing)522        // After the bypass the output is the clean sine again.523        var maxError: Float = 0524        for i in 72000 ..< 96000 { maxError = max(maxError, abs(out[i] - src[i])) }525        #expect(maxError < 1e-5)526    }527528    @Test func consoleDrivesTheRealEngine() {529        let e = makeEngine()530        let host = AutomationHost(engine: e)531        host.scriptSource = { $0 == "Fade" ? "automation \"Fade\" { over 4beats { deck.A.volume -> -30dB } }" : nil }532        host.scriptNames = { ["Fade"] }533        load(e, 0, SignalSynth.clickTrack(bpm: 128, seconds: 30, sampleRate: SR), bpm: 128, title: "Click")534        func last(_ line: String) -> String { host.execute(console: line).last?.text ?? "" }535        #expect(last("deck.B.volume = -8dB") == "OK")536        #expect(e.value(of: .deck(1, "volume")) == .gain(-8))537        #expect(last("deck.B.volume") == "-8 dB")538        #expect(last("deck.A.play()") == "OK")539        #expect(e.deckStatus(0).playing)540        _ = host.renderOffline(frames: 48000)541        #expect(last("deck.A.bpm") == "128 BPM" || last("deck.A.bpm") == "128")542        #expect(last("fx.echo.enable()") == "OK")543        #expect(e.rackStatus(nil).first?.kind == .echo)544        #expect(e.rackStatus(nil).first?.enabled == true)545        #expect(last("run \"Fade\"").hasPrefix("Automation scheduled"))546        #expect(host.activeRuns.count == 1)547        #expect(last("deck.Z.play()").contains("E-DECK"))548        #expect(last("deck.C.play()").contains("no track loaded"))549        #expect(last("stop").hasPrefix("Stopped 1"))550        #expect(last("panic").hasPrefix("Emergency stop"))551        #expect(e.rackStatus(nil).first?.enabled == false)552        #expect(host.execute(console: "help").count > 5)553        #expect(last("help deck.A.volume").contains("Default"))554        #expect(last("decks").contains("Deck D: empty"))555    }556557    @Test func eventsReachHandlers() {558        let e = makeEngine()559        let host = AutomationHost(engine: e)560        load(e, 0, SignalSynth.sine(frequency: 500, seconds: 1.0, sampleRate: SR), bpm: 120)561        load(e, 1, SignalSynth.sine(frequency: 800, seconds: 5, sampleRate: SR), bpm: 120)562        host.start(compile("automation \"Chain\" {\n on deck.A.trackEnd once { deck.B.play()\n stop }\n on trigger(3) { deck.A.setCue() }\n}"))563        e.play(deck: 0)564        host.fire(trigger: 3)565        _ = host.renderOffline(frames: 72000)566        #expect(!e.deckStatus(0).playing)567        #expect(e.deckStatus(1).playing)568        #expect(host.activeRuns.isEmpty)569    }570}571572@Suite struct PerformanceTests {573    @Test func renderCostFullLoad() {574        // Four decks with key lock, three effects on each channel and three on the master.575        let e = makeEngine()576        for d in 0 ..< 4 {577            let t = SignalSynth.track(.init(bpm: 120 + Double(d) * 3, seconds: 30, seed: UInt64(d + 1)), sampleRate: 44100)578            load(e, d, t.left, right: t.right, sampleRate: 44100, bpm: 120 + Double(d) * 3)579            e.set(.deck(d, "keylock"), .bool(true)); e.set(.deck(d, "rate"), .number(1.04)); e.set(.deck(d, "eq.low"), .gain(-6)); e.set(.deck(d, "filter"), .number(0.2))580            for k in [EffectKind.echo, .flanger, .compressor] { let s = e.insertEffect(k, rack: d); e.setEffectEnabled(rack: d, slot: s, true) }581            e.play(deck: d)582        }583        for k in [EffectKind.reverb, .delay, .compressor] { let s = e.insertEffect(k, rack: nil); e.setEffectEnabled(rack: nil, slot: s, true) }584        e.set(.mixer("master.limiter"), .bool(true))585        _ = e.renderOffline(frames: 48000)586        e.core.resetCounters()587        _ = e.renderOffline(frames: 48000 * 10)588        let s = e.renderState589        let mean = Double(s.totalRenderNanos) / Double(max(1, s.renderCalls)) / 1000590        let budget = 256 / SR * 1e6591        print("=== ORIX-RENDER-COST (debug build) === blocks \(s.renderCalls) of 256 frames; mean \(mean) µs, max \(Double(s.maxRenderNanos) / 1000) µs, budget \(budget) µs; load \(mean / budget * 100) % === END ===")592        #expect(s.renderCalls > 1000)593    }594}595596@Test func masterClockKeepsRunningWhileTheMasterDeckLoops() throws {597    // A looping master deck used to freeze the clock: the grid-aligned beat fell behind and the increment was dropped.598    var c = EngineConfiguration(); c.sampleRate = 48000; c.bufferFrames = 256599    let engine = DJEngine(configuration: c)600    let host = AutomationHost(engine: engine)601    let seconds = 40.0, bpm = 120.0602    let click = SignalSynth.clickTrack(bpm: bpm, seconds: seconds, sampleRate: 48000)603    let buffer = TrackBuffer(left: click, right: click, sampleRate: 48000)604    let info = LoadedTrack(title: "click", duration: seconds, sampleRate: 48000, grid: BeatGrid(bpm: bpm, firstBeatSeconds: 0))605    _ = engine.load(deck: 0, buffer: buffer, info: info)606    engine.play(deck: 0)607    _ = host.renderOffline(frames: 48000 * 4)608    let before = engine.service().beat609    engine.loop(deck: 0, beats: 1)610    _ = host.renderOffline(frames: 48000 * 4)611    let during = engine.service().beat612    #expect(abs((during - before) - 8) < 0.5)          // 4 s at 120 BPM = 8 beats, while the deck replays one beat613    engine.loopExit(deck: 0)614    _ = host.renderOffline(frames: 48000 * 4)615    let after = engine.service().beat616    #expect(after - during > 3.5 && after - during < 8.5) // never backwards, at least half speed while re-aligning617}618619@Test func aBrakingMasterDeckDoesNotDragTheSyncedDeckDown() throws {620    // The follower used to copy the falling rate of a braking master and keep a wrong tempo afterwards.621    var c = EngineConfiguration(); c.sampleRate = 48000; c.bufferFrames = 256622    let engine = DJEngine(configuration: c)623    let host = AutomationHost(engine: engine)624    for d in 0 ..< 2 {625        let click = SignalSynth.clickTrack(bpm: 120, seconds: 40, sampleRate: 48000)626        let info = LoadedTrack(title: "click \(d)", duration: 40, sampleRate: 48000, grid: BeatGrid(bpm: 120, firstBeatSeconds: 0))627        _ = engine.load(deck: d, buffer: TrackBuffer(left: click, right: click, sampleRate: 48000), info: info)628    }629    engine.play(deck: 0)630    _ = host.renderOffline(frames: 48000 * 2)631    engine.set(.deck(1, "sync"), .bool(true))632    engine.play(deck: 1)633    _ = host.renderOffline(frames: 48000 * 2)634    engine.brake(deck: 0, seconds: 0.5)635    _ = host.renderOffline(frames: 48000 * 3)636    #expect(!engine.deckStatus(0).playing)637    #expect(engine.deckStatus(1).playing)638    #expect(abs(engine.deckStatus(1).bpm - 120) < 0.5)639    #expect(abs(engine.service().bpm - 120) < 0.5)640}641
Files main
Menu

Theme