Struct CarrierResampler 

pub struct CarrierResampler<C: FfmpegCarrier> { /* private fields */ }

Available on crate feature resample only.

mediadecode::resampler::AudioResampler impl wrapping swresample.

Construction is Self::new, off the trait, taking both specs — see the trait’s own documentation for why the target can never be a constant.

Implementations

impl CarrierResampler<View>

pub fn new( source: ResampleSpec, target: ResampleSpec, limits: FrameLimits, ) -> Result<Self, ResampleError>

Opens a resampler between two explicit specs. See CarrierResampler::new_impl for the full contract.

pub const fn source(&self) -> &ResampleSpec

The spec frames must arrive in.

pub const fn target(&self) -> &ResampleSpec

The spec frames leave in.

pub const fn inner(&self) -> &Context

The wrapped swr context.

pub fn delay(&self) -> i64

Samples still inside the delay line, counted at the output rate.

impl CarrierResampler<Owned>

pub fn new( source: ResampleSpec, target: ResampleSpec, limits: FrameLimits, ) -> Result<Self, ResampleError>

Opens a resampler between two explicit specs. See CarrierResampler::new_impl for the full contract.

pub const fn source(&self) -> &ResampleSpec

The spec frames must arrive in.

pub const fn target(&self) -> &ResampleSpec

The spec frames leave in.

pub const fn inner(&self) -> &Context

The wrapped swr context.

pub fn delay(&self) -> i64

Samples still inside the delay line, counted at the output rate.

Trait Implementations

impl AudioResampler for CarrierResampler<View>

type Adapter = Ffmpeg

Backend vocabulary. The source and target specs are both expressed in it.

type Buffer = <View as FfmpegCarrier>::Buffer

Buffer type held by the frames this resampler accepts and produces.

type Error = ResampleError

Resampler-specific error type — faults only. The rhythm’s own states leave through Sent and Received; what travels here is the mid-stream-change refusal out of send_frame and whatever else genuinely went wrong.

fn send_frame( &mut self, frame: &AudioFrame<SampleFormat, ChannelLayoutDescription, AudioFrameExtra, <View as FfmpegCarrier>::Buffer>, ) -> Result<Sent, ResampleError>

Submits one decoded frame.

fn receive_frame( &mut self, dst: &mut AudioFrame<SampleFormat, ChannelLayoutDescription, AudioFrameExtra, <View as FfmpegCarrier>::Buffer>, ) -> Result<Received, ResampleError>

Drains one converted frame into dst, answering the same Received that AudioStreamDecoder::receive_frame answers.

fn send_eof(&mut self) -> Result<Sent, ResampleError>

Signals end of stream. The conversion tail becomes drainable through receive_frame.

fn flush(&mut self) -> Result<(), ResampleError>

Flushes internal state — buffered input, the undrained tail, and the output timestamp anchor — leaving the resampler ready for a fresh stream on the same two specs.

impl AudioResampler for CarrierResampler<Owned>

type Adapter = Ffmpeg

Backend vocabulary. The source and target specs are both expressed in it.

type Buffer = <Owned as FfmpegCarrier>::Buffer

Buffer type held by the frames this resampler accepts and produces.

type Error = ResampleError

Resampler-specific error type — faults only. The rhythm’s own states leave through Sent and Received; what travels here is the mid-stream-change refusal out of send_frame and whatever else genuinely went wrong.

fn send_frame( &mut self, frame: &AudioFrame<SampleFormat, ChannelLayoutDescription, AudioFrameExtra, <Owned as FfmpegCarrier>::Buffer>, ) -> Result<Sent, ResampleError>

Submits one decoded frame.

fn receive_frame( &mut self, dst: &mut AudioFrame<SampleFormat, ChannelLayoutDescription, AudioFrameExtra, <Owned as FfmpegCarrier>::Buffer>, ) -> Result<Received, ResampleError>

Drains one converted frame into dst, answering the same Received that AudioStreamDecoder::receive_frame answers.

fn send_eof(&mut self) -> Result<Sent, ResampleError>

Signals end of stream. The conversion tail becomes drainable through receive_frame.

fn flush(&mut self) -> Result<(), ResampleError>

Flushes internal state — buffered input, the undrained tail, and the output timestamp anchor — leaving the resampler ready for a fresh stream on the same two specs.

impl<C: FfmpegCarrier> Send for CarrierResampler<C>

Send, and deliberately not Sync.

Safety

The SwrContext behind ctx is owned by this value: it is allocated in [open_context], never shared, never cloned, and dropped with the resampler. Every operation that touches it goes through &mut self — swr_convert_frame, swr_get_delay, swr_init on the rebuild — so no two threads can be inside libswresample for this context at once, which is the whole of what that library requires: it keeps no thread-local or process-global state of its own, and a context is a plain heap allocation whose address is meaningful on any thread.

The other fields are ordinary owned values. The two ffmpeg_next::ChannelLayouts and the two ResampleSpecs wrap an AVChannelLayout, which holds a pointer only for AV_CHANNEL_ORDER_CUSTOM — and [preflight_layout] refuses that order at the one construction choke point, so every layout a live resampler holds is the u.mask arm: a uint64_t, a plain value. The staged layouts come from [initialized_layout], which produces av_channel_layout_default’s mask-only answer. ready holds Frame<C> values, whose carriers are Send by the carrier contract.

Not Sync, and that is not an oversight. &self would let two threads hold the context at once, and nothing in this type serialises that; the &mut receiver is the serialisation. Moving the whole resampler to another thread is sound; sharing it is not offered.