Enum Ramp 

pub enum Ramp<T> {
    Fixed(T),
    Sweep {
        from: T,
        to: T,
    },
    Steps {
        first: T,
        rest: Vec<T>,
    },
    Timed {
        ramp: Box<Ramp<T>>,
        span_divisions: f64,
        curve: RampCurve,
    },
}

A value that may travel over the line’s Transform::RampSpan.

Three shapes, because a build is not always a smooth sweep: 4 stays put, 4..16 sweeps continuously, and 2>4>8>16 holds each value in turn. All of them hold their final value once the span has passed — a crescendo arrives and stays until the performer changes it.

Variants

Fixed(T)

A plain value: 4.

Sweep

4..16 — travels continuously from one end to the other.

Fields

from: T

to: T

Steps

2>4>8>16 — each value held for an equal share of the span.

Split into head and tail so the sequence can never be empty.

Fields

first: T

rest: Vec<T>

Timed

r(...) — a travel that carries its own window instead of inheriting the line’s | ramp: a span in time divisions (the signature’s beats) and its own curve. In 4/4, r(300,9000,4) spans one cycle; in 2/4 the same span is two. Written without internal spaces.

Fields

ramp: Box<Ramp<T>>

The travel itself — always Sweep or Steps.

span_divisions: f64

Window length in time divisions. Fractions are legal: 0.5 is half a beat, which with osc is a wobble.

curve: RampCurve

Implementations

impl<T: Copy> Ramp<T>

pub fn fixed(value: T) -> Self

pub fn steps(first: T, rest: Vec<T>) -> Self

Build a stepped ramp, collapsing to a fixed value when nothing follows.

pub fn start(&self) -> T

The value held before the ramp starts moving.

pub fn travels(&self) -> bool

Whether this value travels, and so needs a ramp span.

pub fn values(&self) -> Vec<T>

Every value the ramp passes through, for range checking.

pub fn own_window(&self) -> Option<(f64, RampCurve)>

The window a r(...) value carries, if it has one of its own.

Trait Implementations

impl<T: Clone> Clone for Ramp<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Ramp<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for Ramp<T>

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

Equality operator ==.

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

Inequality operator !=.

impl<T: PartialEq> StructuralPartialEq for Ramp<T>