Skip to main content

FrameAdapter

Struct FrameAdapter 

Source
pub struct FrameAdapter { /* private fields */ }
Expand description

Converts a point buffer (frame) into a continuous stream.

The adapter cycles through the frame’s points, filling buffers via the fill_chunk() method for use with Stream::run().

§Update semantics

  • update() sets the pending frame (latest-wins if called multiple times)
  • When the current frame ends, any pending frame becomes current immediately (even mid-chunk), ensuring clean frame-to-frame transitions

§Example

use laser_dac::{Frame, FrameAdapter, LaserPoint};

let mut adapter = FrameAdapter::new();
adapter.update(Frame::new(vec![
    LaserPoint::new(0.5, 0.0, 65535, 0, 0, 65535),
]));
let shared = adapter.shared();

stream.run(
    |req, buffer| shared.fill_chunk(req, buffer),
    |err| eprintln!("Error: {}", err),
)?;

Implementations§

Source§

impl FrameAdapter

Source

pub fn new() -> Self

Creates a new adapter with an empty frame.

Call update() to set the initial frame before streaming.

Source

pub fn update(&mut self, frame: Frame)

Sets the pending frame.

The frame becomes current when the current frame ends (all points output). If called multiple times before a swap, only the most recent frame is kept (latest-wins).

Source

pub fn fill_chunk( &mut self, req: &ChunkRequest, buffer: &mut [LaserPoint], ) -> ChunkResult

Fill the provided buffer with points from the current frame.

This is the new zero-allocation API that fills a library-owned buffer instead of allocating a new Vec on each call.

Cycles through the current frame. When the frame ends and a pending frame is available, switches immediately (even mid-chunk).

§Returns
  • ChunkResult::Filled(n) - Wrote n points (always req.target_points)
  • ChunkResult::Starved - Never returned (adapter always has points to output)
  • ChunkResult::End - Never returned (adapter cycles indefinitely)
Source

pub fn shared(self) -> SharedFrameAdapter

Returns a thread-safe handle for updating frames from another thread.

Trait Implementations§

Source§

impl Default for FrameAdapter

Source§

fn default() -> Self

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

Auto Trait Implementations§

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> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<S> FromSample<S> for S

Source§

fn from_sample_(s: S) -> S

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<T, U> ToSample<U> for T
where U: FromSample<T>,

Source§

fn to_sample_(self) -> U

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.
Source§

impl<S, T> Duplex<S> for T
where T: FromSample<S> + ToSample<S>,