Class PingPongDelay

A ping-pong delay: the input is summed to mono and the echoes bounce between the left and right channel. The first echo is on the left, the second on the right, and so on.

Extends Effector (through the internal DelayEngine base class).

All four delays (MonoDelay, StereoDelay, PingPongDelay and AdvancedDelay) run the same WebAssembly delay engine in a different mode. Delay time changes glide smoothly over about 50 ms, so changing the time while audio plays gives a short pitch bend instead of a click. The delay keeps processing when its input goes silent, so echoes ring out naturally.

Example

import { PingPongDelay } from "@fluex/fluexgl-dsp";

// A dotted eighth at 120 BPM: 375 ms.
const delay = new PingPongDelay({ delayMs: 375, feedback: 0.5, mix: 0.3 });

channel.addEffect(delay);

---

Constructor

new PingPongDelay(options?: Partial<PingPongDelayOptions>): PingPongDelay;

Arguments

• options?: Partial<PingPongDelayOptions> Every field is optional, falls back to the defaults below, and is clamped to its valid range.

---

Properties

label: string | null

Defaults to "PingPongDelay".

name: string

Defaults to "PingPongDelay".

delayMs: number

Time between two echoes (ms), between 1 and 4000. Defaults to 300.

feedback: number

Amount of each echo that bounces back, between 0 and 0.98. Defaults to 0.5.

mix: number

Dry/wet mix, between 0 and 1. Defaults to 0.35.

strictMode: StrictMode

Defaults to StrictMode.Disabled.

---

Methods

initializeOnAttachment(context: AudioContext): Promise<void>

Creates the PingPongDelayProcessor AudioWorklet node with the current values.

returnOptionsAsObject(): PingPongDelayOptions

Returns a snapshot of the current values.

setDelayMs(delayMs: number): boolean

Sets the time between echoes (ms), clamped between 1 and 4000.

Arguments

• delayMs: number

Returns

• boolean - true when the value was sent to the processor (or applied to the audio node), false when the effect is not attached yet. The value is stored either way and used on attachment.

setFeedback(feedback: number): boolean

Sets the feedback, clamped between 0 and 0.98.

Arguments

• feedback: number

Returns

• boolean - true when the value was sent to the processor (or applied to the audio node), false when the effect is not attached yet. The value is stored either way and used on attachment.

setMix(mix: number): boolean

Sets the dry/wet mix, clamped between 0 and 1.

Arguments

• mix: number

Returns

• boolean - true when the value was sent to the processor (or applied to the audio node), false when the effect is not attached yet. The value is stored either way and used on attachment.

---

Events

Inherited from Effector. The PingPongDelayProcessor processor sends processor-wasm-instantiated when its WebAssembly module is ready, and an incoming-processor-message for every parameter change.

Requirements

Runs on an AudioWorklet backed by WebAssembly. Attach it only after await pipeline.initializeDpsPipeline(), on the AudioDevice returned by resolveDefaultAudioOutputDevice(). Requires a worklet and WASM build from FluexGL-DSP-WebAssembly 0.4.9 or newer, which registers PingPongDelayProcessor.