Repository Public
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