Struct PianoRoll 

pub struct PianoRoll {
    pub items: Vec<TimedNote>,
    pub lanes: Vec<PianoRollLane>,
    pub time: TimeGrid,
}

A piano roll: a set of timed lanes over a shared timing grid.

Holds the note projection in items alongside the full lanes, all keyed to a single TimeGrid.

Fields

items: Vec<TimedNote>

Note projection across all lanes, in stable order.

lanes: Vec<PianoRollLane>

Lanes making up the roll, sorted by id then kind.

time: TimeGrid

Timing grid shared by every lane.

Implementations

impl PianoRoll

pub fn new(items: Vec<TimedNote>) -> Result<Self, MusicError>

Builds a roll from notes, placing them on a single note lane.

Uses the default TimeGrid; an empty input yields a roll with no lanes.

pub fn from_lanes(lanes: Vec<PianoRollLane>) -> Result<Self, MusicError>

Builds a roll from prepared lanes using the default TimeGrid.

pub fn from_lanes_with_time( lanes: Vec<PianoRollLane>, time: TimeGrid, ) -> Result<Self, MusicError>

Builds a roll from prepared lanes over an explicit timing grid.

Validates time, sorts the lanes, and derives the note projection in stable order.

pub fn from_note_events(events: Vec<NoteEvent>) -> Result<Self, MusicError>

Builds a roll from note events on a single performance note lane.

Converts each event’s tick timing to grid time with normal articulation.

pub fn from_performance_take(take: &PerformanceTake) -> KernelResult<Self>

Builds a roll from a performance take’s extracted note events.

Surfaces extraction or validation failures as a kernel evaluation error.

pub fn cells(&self) -> impl Iterator<Item = &PianoRollCell>

Iterates over every cell across all lanes.

pub fn note_slices(&self) -> Vec<NoteSlice>

Splits the roll at every note onset and release into exact sounding windows.

Silent spans and zero-duration notes do not produce slices. Equal pitches in different cells remain separate SlicedNote entries.

pub fn to_expr(&self) -> Expr

Renders the roll, its grid, and its lanes as an expression.

Trait Implementations

impl Clone for PianoRoll

fn clone(&self) -> PianoRoll

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PianoRoll

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

Formats the value using the given formatter.

impl Eq for PianoRoll

impl MusicObject for PianoRoll

fn kind(&self) -> &'static str

Returns a stable, human-readable tag for this object kind.

fn duration(&self) -> Time

Returns the total duration this object occupies.

fn voices<'a>(&'a self, offset: Time, out: &mut Vec<TimedAtom<'a>>)

Appends the timed atoms produced by this object, shifted by offset.

fn clone_box(&self) -> Box<dyn MusicObject>

Clones this object into a fresh boxed trait object.

fn as_any(&self) -> &dyn Any

Returns this object as a &dyn Any for downcasting.

impl PartialEq for PianoRoll

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PianoRoll