Skip to main content

Lanes

Struct Lanes 

Source
pub struct Lanes<C>(/* private fields */);
Expand description

Multiple lanes with one shared configuration and separate states.

Lanes is the main reason the split-state API exists: immutable configuration is stored once while each lane keeps its own mutable state. Scalar processing is lane-wise over [X; N].

For view processing, pair it with View<_, _, LaneMajor, _> when the natural memory layout is lane-major and the inner stage benefits from long contiguous per-lane slices. Prefer this over repeat() when all lanes should use exactly the same configuration.

§Examples

use dsp_process::{LaneMajor, Offset, Split, View, ViewMut, ViewProcess};

let mut p = Split::stateless(Offset(3)).lanes::<2>();
let x = View::<_, LaneMajor, 2>::from_flat(&[1, 2, 3, 10, 20, 30], 3);
let mut y = [0; 6];
let yv = ViewMut::<_, LaneMajor, 2>::from_flat(&mut y, 3);
ViewProcess::process_view(&mut p, x, yv);
assert_eq!(y, [4, 5, 6, 13, 23, 33]);

Implementations§

Source§

impl<C> Lanes<C>

Source

pub const fn new(inner: C) -> Self

Create a Lanes wrapper around an existing composition.

Source

pub fn into_inner(self) -> C

Consume the wrapper and return the inner composition.

Trait Implementations§

Source§

impl<C: Clone> Clone for Lanes<C>

Source§

fn clone(&self) -> Lanes<C>

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl<C: Copy> Copy for Lanes<C>

Source§

impl<C: Debug> Debug for Lanes<C>

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl<C: Default> Default for Lanes<C>

Source§

fn default() -> Lanes<C>

Returns the “default value” for a type. Read more
Source§

impl<X, C, S> SplitInplace<X, S> for Lanes<C>
where X: Copy, Self: SplitProcess<X, X, S>,

Source§

fn inplace(&self, state: &mut S, xy: &mut [X])

Source§

impl<X: Copy, Y, C, S, const N: usize> SplitProcess<[X; N], [Y; N], [S; N]> for Lanes<C>
where C: SplitProcess<X, Y, S>,

Process data from multiple lanes with a common configuration.

For layout-sensitive view processing use View<_, _, LaneMajor, _>.

Source§

fn process(&self, state: &mut [S; N], x: [X; N]) -> [Y; N]

Process an input into an output Read more
Source§

fn block(&self, state: &mut S, x: &[X], y: &mut [Y])

Process a block of inputs Read more
Source§

impl<'a, X: Copy, C, S, const N: usize> SplitViewInplace<ViewMut<'a, X, LaneMajor, N>, [S; N]> for Lanes<C>
where C: SplitInplace<X, S>,

Source§

fn inplace_view(&self, state: &mut [S; N], xy: ViewMut<'a, X, LaneMajor, N>)

Process one typed view in place.
Source§

impl<'a, 'b, X: Copy, Y, C, S, const N: usize> SplitViewProcess<View<'a, X, LaneMajor, N>, ViewMut<'b, Y, LaneMajor, N>, [S; N]> for Lanes<C>
where C: SplitProcess<X, Y, S>,

Source§

fn process_view( &self, state: &mut [S; N], x: View<'a, X, LaneMajor, N>, y: ViewMut<'b, Y, LaneMajor, N>, )

Process one typed input view into one typed output view.

Auto Trait Implementations§

§

impl<C> Freeze for Lanes<C>
where C: Freeze,

§

impl<C> RefUnwindSafe for Lanes<C>
where C: RefUnwindSafe,

§

impl<C> Send for Lanes<C>
where C: Send,

§

impl<C> Sync for Lanes<C>
where C: Sync,

§

impl<C> Unpin for Lanes<C>
where C: Unpin,

§

impl<C> UnsafeUnpin for Lanes<C>
where C: UnsafeUnpin,

§

impl<C> UnwindSafe for Lanes<C>
where C: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<'a, X, S, T, const L: usize> SplitViewInplace<ViewMut<'a, X, FrameMajor, L>, S> for T
where X: Copy, T: SplitInplace<X, S>, S: ?Sized,

Source§

fn inplace_view(&self, state: &mut S, xy: ViewMut<'a, X, FrameMajor, L>)

Process one typed view in place.
Source§

impl<'a, 'b, X, Y, S, T, const L: usize> SplitViewProcess<View<'a, X, FrameMajor, L>, ViewMut<'b, Y, FrameMajor, L>, S> for T
where X: Copy, T: SplitProcess<X, Y, S>, S: ?Sized,

Source§

fn process_view( &self, state: &mut S, x: View<'a, X, FrameMajor, L>, y: ViewMut<'b, Y, FrameMajor, L>, )

Process one typed input view into one typed output view.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.