Struct SendTrackBuilder

pub struct SendTrackBuilder { /* private fields */ }

Available on crate feature dep_kira only.

Configures a mixer track.

Implementations

impl SendTrackBuilder

pub fn new() -> SendTrackBuilder

Creates a new SendTrackBuilder with the default settings.

pub fn volume(self, volume: impl Into<Value<Decibels>>) -> SendTrackBuilder

Sets the volume of the send track.

Examples

Set the volume to a fixed decibel value:

let builder = SendTrackBuilder::new().volume(-6.0);

Link the volume to a modulator:

use kira::{
	AudioManager, AudioManagerSettings, DefaultBackend,
	modulator::tweener::TweenerBuilder,
	track::SendTrackBuilder,
	Easing, Value, Mapping,
	Decibels,
};

let mut manager = AudioManager::<DefaultBackend>::new(AudioManagerSettings::default())?;
let tweener = manager.add_modulator(TweenerBuilder {
	initial_value: 0.5,
})?;
let builder = SendTrackBuilder::new().volume(Value::FromModulator {
	id: tweener.id(),
	mapping: Mapping {
		input_range: (0.0, 1.0),
		output_range: (Decibels::SILENCE, Decibels::IDENTITY),
		easing: Easing::Linear,
	},
});

pub fn add_effect<B>(&mut self, builder: B) -> <B as EffectBuilder>::Handle

where B: EffectBuilder,

Adds an effect to the send track.

Examples

use kira::{track::SendTrackBuilder, effect::delay::DelayBuilder};

let mut builder = SendTrackBuilder::new();
let delay_handle = builder.add_effect(DelayBuilder::new());

pub fn with_effect<B>(self, builder: B) -> SendTrackBuilder

where B: EffectBuilder,

Adds an effect to the send track and returns the SendTrackBuilder.

If you need to modify the effect later, use add_effect, which returns the effect handle.

Examples

use kira::{
	track::SendTrackBuilder,
	effect::{filter::FilterBuilder, reverb::ReverbBuilder},
};

let mut builder = SendTrackBuilder::new()
	.with_effect(FilterBuilder::new())
	.with_effect(ReverbBuilder::new());

pub fn add_built_effect(&mut self, effect: Box<dyn Effect>)

Adds an already built effect into this track.

Box<dyn Effect> values are created when calling build on an effect builder, which gives you an effect handle, as well as this boxed effect, which is the actual audio effect.

This is a lower-level method than Self::add_effect, and you should probably use it rather than this method, unless you have a reason to.

Examples

use kira::track::SendTrackBuilder;
use kira::effect::{EffectBuilder, delay::DelayBuilder};

let mut builder = SendTrackBuilder::new();
let delay_builder = DelayBuilder::new();
let (effect, delay_handle) = delay_builder.build();
let delay_handle = builder.add_built_effect(effect);

pub fn with_built_effect(self, effect: Box<dyn Effect>) -> SendTrackBuilder

Add an already-built effect and return the SendTrackBuilder.

Box<dyn Effect> values are created when calling build on an effect builder, which gives you an effect handle, as well as this boxed effect, which is the actual audio effect.

This is a lower-level method than Self::with_effect, and you should probably use it rather than this method, unless you have a reason to.

Examples

use kira::{
	track::SendTrackBuilder,
	effect::{filter::FilterBuilder, reverb::ReverbBuilder, EffectBuilder},
};

let (filter_effect, filter_handle) = FilterBuilder::new().build();
let (reverb_effect, reverb_handle) = ReverbBuilder::new().build();
let mut builder = SendTrackBuilder::new()
	.with_built_effect(filter_effect)
	.with_built_effect(reverb_effect);

Trait Implementations

impl Default for SendTrackBuilder

fn default() -> SendTrackBuilder

Returns the “default value” for a type.