Enum ChunkResult 

pub enum ChunkResult {
    Filled(usize),
    Starved,
    End,
}

Result returned by the fill callback indicating how the buffer was filled.

This enum allows the callback to communicate three distinct states:

• Successfully filled some number of points
• Temporarily unable to provide data (underrun policy applies)
• Stream should end gracefully

Filled(0) Semantics

• If target_points == 0: Buffer is full, nothing needed. This is fine.
• If target_points > 0: We needed points but got none. Treated as Starved.

Variants

Filled(usize)

Wrote n points to the buffer.

n must be <= buffer.len(). Partial fills (n < min_points) are accepted without padding - useful when content is legitimately ending. Return End on the next call to signal completion.

Starved

No data available right now.

Underrun policy is applied (repeat last chunk or blank). Stream continues; callback will be called again when buffer needs filling.

End

Stream is finished. Shutdown sequence:

1. Stop calling callback
2. Let queued points drain (play out)
3. Blank/park the laser at last position
4. Return from stream() with RunExit::ProducerEnded

Trait Implementations

impl Clone for ChunkResult

fn clone(&self) -> ChunkResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChunkResult

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

Formats the value using the given formatter.

impl PartialEq for ChunkResult

fn eq(&self, other: &ChunkResult) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ChunkResult

impl Eq for ChunkResult

impl StructuralPartialEq for ChunkResult