Trait spectrusty_peripherals::bus::ay::AyAudioBusDevice

pub trait AyAudioBusDevice: BusDevice {
    fn render_ay_audio<L: AmpLevels<B::SampleDelta>, B: Blep>(
        &mut self,
        blep: &mut B,
        end_ts: <Self as BusDevice>::Timestamp,
        frame_tstates: FTs,
        chans: [usize; 3]
    );
}

This trait is being used by AyAudioFrame implementations to render AY-3-8910 audio with bus devices.

Allows for rendering audio frame using AyAudioFrame directly on the ControlUnit without the need to “locate” the Ay3_891xBusDevice in the daisy chain.

This trait is implemented autmatically for all BusDevices which implement PassByAyAudioBusDevice.

Required Methods

fn render_ay_audio<L: AmpLevels<B::SampleDelta>, B: Blep>(
    &mut self,
    blep: &mut B,
    end_ts: <Self as BusDevice>::Timestamp,
    frame_tstates: FTs,
    chans: [usize; 3]
)

Renders square-wave pulses via Blep interface.

Provide AmpLevels that can handle level values from 0 to 15 (4-bits). channels - target Blep audio channels for [A, B, C] AY-3-8910 channels.

Implementations on Foreign Types

impl<D, N> AyAudioBusDevice for Box<OptionalBusDevice<D, N>>where
    OptionalBusDevice<D, N>: AyAudioBusDevice + BusDevice,

fn render_ay_audio<L, B>(
    &mut self,
    blep: &mut B,
    end_ts: <Self as BusDevice>::Timestamp,
    frame_tstates: FTs,
    chans: [usize; 3]
)where
    B: Blep,
    L: AmpLevels<B::SampleDelta>,

impl<D, N> AyAudioBusDevice for OptionalBusDevice<D, N>where
    <D as BusDevice>::Timestamp: Into<FTs> + Copy,
    D: AyAudioBusDevice + BusDevice,
    N: AyAudioBusDevice + BusDevice<Timestamp = D::Timestamp>,

fn render_ay_audio<L, B>(
    &mut self,
    blep: &mut B,
    end_ts: D::Timestamp,
    frame_tstates: FTs,
    chans: [usize; 3]
)where
    B: Blep,
    L: AmpLevels<B::SampleDelta>,

Note

If a device is being attached to an optional device the call will be forwarded to both: an optional device and to the next bus device.

impl<T> AyAudioBusDevice for dyn NamedBusDevice<T>where
    T: Into<FTs> + Copy + Debug + 'static,

fn render_ay_audio<L, B>(
    &mut self,
    blep: &mut B,
    end_ts: T,
    frame_tstates: FTs,
    chans: [usize; 3]
)where
    L: AmpLevels<B::SampleDelta>,
    B: Blep,

Note

Because we need to guess the concrete type of the dynamic BusDevice we can currently handle only the most common cases: Ay3_891xMelodik and Ay3_891xFullerBox. If you use a customized Ay3_891xBusDevice for a dynamic BusDevice you need to render audio directly on the device downcasted to your custom type.

impl<D> AyAudioBusDevice for Box<DynamicBus<D>>where
    DynamicBus<D>: AyAudioBusDevice + BusDevice,
    D: BusDevice,

fn render_ay_audio<L, B>(
    &mut self,
    blep: &mut B,
    end_ts: <Self as BusDevice>::Timestamp,
    frame_tstates: FTs,
    chans: [usize; 3]
)where
    B: Blep,
    L: AmpLevels<B::SampleDelta>,

impl<D> AyAudioBusDevice for DynamicBus<D>where
    <D as BusDevice>::Timestamp: Into<FTs> + Copy + Debug + 'static,
    D: AyAudioBusDevice + BusDevice,

fn render_ay_audio<L, B>(
    &mut self,
    blep: &mut B,
    end_ts: D::Timestamp,
    frame_tstates: FTs,
    chans: [usize; 3]
)where
    B: Blep,
    L: AmpLevels<B::SampleDelta>,

Note

This implementation forwards a call to any recognizable Ay3_891xBusDevice device in a dynamic daisy-chain as well as to an upstream device.

impl<SD, D> AyAudioBusDevice for Box<DynamicSerdeBus<SD, D>>where
    DynamicSerdeBus<SD, D>: AyAudioBusDevice + BusDevice,
    D: BusDevice,

fn render_ay_audio<L, B>(
    &mut self,
    blep: &mut B,
    end_ts: <Self as BusDevice>::Timestamp,
    frame_tstates: FTs,
    chans: [usize; 3]
)where
    B: Blep,
    L: AmpLevels<B::SampleDelta>,

impl<SD, D> AyAudioBusDevice for DynamicSerdeBus<SD, D>where
    <D as BusDevice>::Timestamp: Into<FTs> + Copy + Debug + 'static,
    D: AyAudioBusDevice + BusDevice,

fn render_ay_audio<L, B>(
    &mut self,
    blep: &mut B,
    end_ts: D::Timestamp,
    frame_tstates: FTs,
    chans: [usize; 3]
)where
    B: Blep,
    L: AmpLevels<B::SampleDelta>,

Note

This implementation forwards a call to any recognizable Ay3_891xBusDevice device in a dynamic daisy-chain as well as to an upstream device.

impl<P, PA, PB, D> AyAudioBusDevice for Box<Ay3_891xBusDevice<P, PA, PB, D>>where
    Ay3_891xBusDevice<P, PA, PB, D>: AyAudioBusDevice + BusDevice,
    D: BusDevice,

fn render_ay_audio<L, B>(
    &mut self,
    blep: &mut B,
    end_ts: <Self as BusDevice>::Timestamp,
    frame_tstates: FTs,
    chans: [usize; 3]
)where
    B: Blep,
    L: AmpLevels<B::SampleDelta>,

impl<T> AyAudioBusDevice for Box<NullDevice<T>>where
    NullDevice<T>: AyAudioBusDevice + BusDevice,

fn render_ay_audio<L, B>(
    &mut self,
    blep: &mut B,
    end_ts: <Self as BusDevice>::Timestamp,
    frame_tstates: FTs,
    chans: [usize; 3]
)where
    B: Blep,
    L: AmpLevels<B::SampleDelta>,

impl<T: Into<FTs> + Debug> AyAudioBusDevice for NullDevice<T>

fn render_ay_audio<L, B>(
    &mut self,
    _blep: &mut B,
    _end_ts: T,
    _frame_tstates: FTs,
    _chans: [usize; 3]
)where
    L: AmpLevels<B::SampleDelta>,
    B: Blep,

Implementors

impl<D, N> AyAudioBusDevice for Dwhere
    D::Timestamp: Into<FTs>,
    D: BusDevice<NextDevice = N> + PassByAyAudioBusDevice,
    N: BusDevice<Timestamp = D::Timestamp> + AyAudioBusDevice,

impl<P, PA, PB, D> AyAudioBusDevice for Ay3_891xBusDevice<P, PA, PB, D>where
    Self: BusDevice<Timestamp = D::Timestamp>,
    D: BusDevice,
    D::Timestamp: Into<FTs>,