Struct jumpy::prelude::kira::sound::streaming::StreamingSoundData

pub struct StreamingSoundData<Error>
where
    Error: Send + 'static,
{
    pub(crate) decoder: Box<dyn Decoder<Error = Error>>,
    pub settings: StreamingSoundSettings,
    pub slice: Option<(usize, usize)>,
}

A streaming sound that is not playing yet.

Fields

decoder: Box<dyn Decoder<Error = Error>>

settings: StreamingSoundSettings

Settings for the streaming sound.

slice: Option<(usize, usize)>

The portion of the sound this StreamingSoundData represents.

Note that the StreamingSoundData holds the entire piece of audio it was originally given regardless of the value of slice, but StreamingSoundData::num_frames and StreamingSoundData::duration will behave as if this StreamingSoundData only contained the specified portion of audio.

Implementations

impl<Error> StreamingSoundData<Error>

where Error: Send,

pub fn from_decoder( decoder: impl Decoder<Error = Error> + 'static, ) -> StreamingSoundData<Error>

Creates a StreamingSoundData for a Decoder.

pub fn start_time( self, start_time: impl Into<StartTime>, ) -> StreamingSoundData<Error>

Sets when the sound should start playing.

Examples

Configuring a sound to start 4 ticks after a clock’s current time:

use kira::{
	manager::{AudioManager, AudioManagerSettings, backend::DefaultBackend},
	sound::streaming::{StreamingSoundData, StreamingSoundSettings},
	clock::ClockSpeed,
};

let mut manager = AudioManager::<DefaultBackend>::new(AudioManagerSettings::default())?;
let clock_handle = manager.add_clock(ClockSpeed::TicksPerMinute(120.0))?;
let sound = StreamingSoundData::from_file("sound.ogg")?
	.start_time(clock_handle.time() + 4);

pub fn start_position( self, start_position: impl Into<PlaybackPosition>, ) -> StreamingSoundData<Error>

Sets where in the sound playback should start.

pub fn loop_region( self, loop_region: impl IntoOptionalRegion, ) -> StreamingSoundData<Error>

Sets the portion of the sound that should be looped.

Examples

Configure a sound to loop the portion from 3 seconds in to the end:

let sound = StreamingSoundData::from_file("sound.ogg")?.loop_region(3.0..);

Configure a sound to loop the portion from 2 to 4 seconds:

let sound = StreamingSoundData::from_file("sound.ogg")?.loop_region(2.0..4.0);

pub fn volume( self, volume: impl Into<Value<Volume>>, ) -> StreamingSoundData<Error>

Sets the volume of the sound.

Examples

Set the volume as a factor:

let sound = StreamingSoundData::from_file("sound.ogg")?.volume(0.5);

Set the volume as a gain in decibels:

let sound = StreamingSoundData::from_file("sound.ogg")?.volume(kira::Volume::Decibels(-6.0));

Link the volume to a modulator:

use kira::{
	manager::{AudioManager, AudioManagerSettings, backend::DefaultBackend},
	modulator::tweener::TweenerBuilder,
	sound::streaming::StreamingSoundData,
};

let mut manager = AudioManager::<DefaultBackend>::new(AudioManagerSettings::default())?;
let tweener = manager.add_modulator(TweenerBuilder {
	initial_value: 0.5,
})?;
let sound = StreamingSoundData::from_file("sound.ogg")?.volume(&tweener);

pub fn playback_rate( self, playback_rate: impl Into<Value<PlaybackRate>>, ) -> StreamingSoundData<Error>

Sets the playback rate of the sound.

Changing the playback rate will change both the speed and the pitch of the sound.

Examples

Set the playback rate as a factor:

let sound = StreamingSoundData::from_file("sound.ogg")?.playback_rate(0.5);

Set the playback rate as a change in semitones:

use kira::sound::PlaybackRate;
let sound = StreamingSoundData::from_file("sound.ogg")?.playback_rate(PlaybackRate::Semitones(-2.0));

Link the playback rate to a modulator:

use kira::{
	manager::{AudioManager, AudioManagerSettings, backend::DefaultBackend},
	modulator::tweener::TweenerBuilder,
	sound::streaming::StreamingSoundData,
};

let mut manager = AudioManager::<DefaultBackend>::new(AudioManagerSettings::default())?;
let tweener = manager.add_modulator(TweenerBuilder {
	initial_value: 0.5,
})?;
let sound = StreamingSoundData::from_file("sound.ogg")?.playback_rate(&tweener);

pub fn panning( self, panning: impl Into<Value<f64>>, ) -> StreamingSoundData<Error>

Sets the panning of the sound, where 0 is hard left and 1 is hard right.

Examples

Set the panning to a streaming value:

let sound = StreamingSoundData::from_file("sound.ogg")?.panning(0.25);

Link the panning to a modulator:

use kira::{
	manager::{AudioManager, AudioManagerSettings, backend::DefaultBackend},
	modulator::tweener::TweenerBuilder,
	sound::streaming::StreamingSoundData,
};

let mut manager = AudioManager::<DefaultBackend>::new(AudioManagerSettings::default())?;
let tweener = manager.add_modulator(TweenerBuilder {
	initial_value: 0.25,
})?;
let sound = StreamingSoundData::from_file("sound.ogg")?.panning(&tweener);

pub fn output_destination( self, output_destination: impl Into<OutputDestination>, ) -> StreamingSoundData<Error>

Sets the destination that this sound should be routed to.

Examples

Set the output destination of a sound to a mixer track:

use kira::{
	manager::{AudioManager, AudioManagerSettings, backend::DefaultBackend},
	track::TrackBuilder,
	sound::streaming::StreamingSoundData,
};

let mut manager = AudioManager::<DefaultBackend>::new(AudioManagerSettings::default())?;
let sub_track = manager.add_sub_track(TrackBuilder::new())?;
let sound = StreamingSoundData::from_file("sound.ogg")?.output_destination(&sub_track);

Set the output destination of a sound to an emitter in a spatial scene:

use kira::{
	manager::{AudioManager, AudioManagerSettings, backend::DefaultBackend},
	spatial::{scene::SpatialSceneSettings, emitter::EmitterSettings},
	sound::streaming::StreamingSoundData,
};

let mut manager = AudioManager::<DefaultBackend>::new(AudioManagerSettings::default())?;
let mut scene = manager.add_spatial_scene(SpatialSceneSettings::default())?;
let emitter = scene.add_emitter(mint::Vector3 {
	x: 0.0,
	y: 0.0,
	z: 0.0,
}, EmitterSettings::default())?;
let sound = StreamingSoundData::from_file("sound.ogg")?.output_destination(&emitter);

pub fn fade_in_tween( self, fade_in_tween: impl Into<Option<Tween>>, ) -> StreamingSoundData<Error>

Sets the tween used to fade in the instance from silence.

pub fn with_settings( self, settings: StreamingSoundSettings, ) -> StreamingSoundData<Error>

Returns the StreamingSoundData with the specified settings.

pub fn num_frames(&self) -> usize

Returns the number of frames in the StreamingSoundData.

If StreamingSoundData::slice is Some, this will be the number of frames in the slice.

pub fn duration(&self) -> Duration

Returns the duration of the audio.

If StreamingSoundData::slice is Some, this will be the duration of the slice.

pub fn slice(self, region: impl IntoOptionalRegion) -> StreamingSoundData<Error>

Sets the portion of the audio this StreamingSoundData represents.

impl StreamingSoundData<FromFileError>

pub fn from_file( path: impl AsRef<Path>, ) -> Result<StreamingSoundData<FromFileError>, FromFileError>

Creates a StreamingSoundData for an audio file.

pub fn from_cursor<T>( cursor: Cursor<T>, ) -> Result<StreamingSoundData<FromFileError>, FromFileError>

where T: AsRef<[u8]> + Send + Sync + 'static,

Creates a StreamingSoundData for a cursor wrapping audio file data.

pub fn from_media_source( media_source: impl MediaSource + 'static, ) -> Result<StreamingSoundData<FromFileError>, FromFileError>

Creates a StreamingSoundData for a type that implements Symphonia’s MediaSource trait.

Trait Implementations

impl<Error> SoundData for StreamingSoundData<Error>

where Error: Send + 'static,

type Error = Error

Errors that can occur when starting the sound.

type Handle = StreamingSoundHandle<Error>

The type that can be used to control the sound once it has started.

fn into_sound( self, ) -> Result<(Box<dyn Sound>, <StreamingSoundData<Error> as SoundData>::Handle), <StreamingSoundData<Error> as SoundData>::Error>

Converts the loaded sound into a live, playing sound and a handle to control it.