Struct web_audio_api::node::DelayNode

pub struct DelayNode { /* private fields */ }

Node that delays the incoming audio signal by a certain amount

The current implementation does not allow for zero delay. The minimum delay is one render quantum (e.g. ~2.9ms at 44.1kHz).

• MDN documentation: https://developer.mozilla.org/en-US/docs/Web/API/DelayNode
• specification: https://webaudio.github.io/web-audio-api/#DelayNode
• see also: BaseAudioContext::create_delay

Usage

use std::fs::File;
use web_audio_api::context::{BaseAudioContext, AudioContext};
use web_audio_api::node::{AudioNode, AudioScheduledSourceNode};

// create an `AudioContext` and load a sound file
let context = AudioContext::new(None);
let file = File::open("samples/sample.wav").unwrap();
let audio_buffer = context.decode_audio_data_sync(file).unwrap();

// create a delay of 0.5s
let delay = context.create_delay(1.);
delay.delay_time().set_value(0.5);
delay.connect(&context.destination());

let src = context.create_buffer_source();
src.set_buffer(audio_buffer);
// connect to both delay and destination
src.connect(&delay);
src.connect(&context.destination());
src.start();

Examples

• cargo run --release --example simple_delay
• cargo run --release --example feedback_delay

Implementations

impl DelayNode

pub fn new<C: BaseAudioContext>(context: &C, options: DelayOptions) -> Self

Create a new DelayNode

Panics

Panics when the max delay value is smaller than zero or langer than three minutes.

pub fn delay_time(&self) -> &AudioParam

A-rate AudioParam representing the amount of delay (in seconds) to apply.

Trait Implementations

impl AudioNode for DelayNode

fn connect_at<'a>(
    &self,
    dest: &'a dyn AudioNode,
    output: u32,
    input: u32
) -> &'a dyn AudioNode

Connect a specific output of this AudioNode to a specific input of another node.

fn disconnect_from<'a>(&self, dest: &'a dyn AudioNode) -> &'a dyn AudioNode

Disconnects all outputs of the AudioNode that go to a specific destination AudioNode.

fn disconnect(&self)

Disconnects all outgoing connections from the AudioNode.

fn registration(&self) -> &AudioContextRegistration

fn channel_config_raw(&self) -> &ChannelConfig

fn number_of_inputs(&self) -> u32

The number of inputs feeding into the AudioNode. For source nodes, this will be 0.

fn number_of_outputs(&self) -> u32

The number of outputs coming out of the AudioNode.

fn id(&self) -> &AudioNodeId

fn channel_config_cloned(&self) -> ChannelConfig

fn context(&self) -> &ConcreteBaseAudioContext

The BaseAudioContext which owns this AudioNode.

fn connect<'a>(&self, dest: &'a dyn AudioNode) -> &'a dyn AudioNode

Connect the output of this AudioNode to the input of another node.

fn channel_count_mode(&self) -> ChannelCountMode

Represents an enumerated value describing the way channels must be matched between the node’s inputs and outputs.

fn set_channel_count_mode(&self, v: ChannelCountMode)

fn channel_interpretation(&self) -> ChannelInterpretation

Represents an enumerated value describing the meaning of the channels. This interpretation will define how audio up-mixing and down-mixing will happen.

fn set_channel_interpretation(&self, v: ChannelInterpretation)

fn channel_count(&self) -> usize

Represents an integer used to determine how many channels are used when up-mixing and down-mixing connections to any inputs to the node.

fn set_channel_count(&self, v: usize)