Struct web_audio_api::node::WaveShaperNode

pub struct WaveShaperNode { /* private fields */ }

WaveShaperNode allows to apply non-linear distortion effect on a audio signal. Arbitrary non-linear shaping curves may be specified.

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

Usage

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

let context = AudioContext::new(None);

let file = File::open("sample.wav").unwrap();
let buffer = context.decode_audio_data(file).unwrap();
let curve = make_distortion_curve(2048);
let drive = 4.;

let post_gain = context.create_gain();
post_gain.connect(&context.destination());
post_gain.gain().set_value(1. / drive);

let shaper = context.create_wave_shaper();
shaper.connect(&post_gain);
shaper.set_curve(curve);

let pre_gain = context.create_gain();
pre_gain.connect(&shaper);
pre_gain.gain().set_value(drive);

let src = context.create_buffer_source();
src.connect(&pre_gain);
src.set_buffer(buffer);

src.start();

Example

• cargo run --release --example waveshaper

Implementations

impl WaveShaperNode

pub fn new<C: AsBaseAudioContext>(
    context: &C,
    options: Option<WaveShaperOptions>
) -> Self

returns a WaveShaperNode instance

Arguments

• context - audio context in which the audio node will live.
• options - waveshaper options

pub fn curve(&self) -> Option<&[f32]>

Returns the distortion curve

pub fn set_curve(&self, curve: Vec<f32>)

Set the distortion curve of this node

Arguments

• curve - the desired distortion curve

Panics

Panics if a curve has already been given to the source (though new or through set_curve)

pub fn oversample(&self) -> OverSampleType

Returns the oversample faactor of this node

pub fn set_oversample(&self, oversample: OverSampleType)

set the oversample factor of this node

Arguments

• oversample - the desired OversampleType variant

Trait Implementations

impl AudioNode for WaveShaperNode

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) -> &BaseAudioContext

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 connect_at<'a>(
    &self,
    dest: &'a dyn AudioNode,
    output: u32,
    input: u32
) -> Result<&'a dyn AudioNode, IndexSizeError>

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

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

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

fn disconnect_all(&self)

Disconnects all outgoing connections from the AudioNode.

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)