Struct PulseSequence 

pub struct PulseSequence { /* private fields */ }

A Lua-friendly melodic sequence with one duration per event.

Implementations

impl PulseSequence

pub fn new() -> Self

Creates an empty sequence using electric_piano.

pub fn with_notes(self, notes: Vec<f32>) -> Self

Replaces the sequence note frequencies.

pub fn with_chords(self, chords: Vec<Vec<f32>>) -> Self

Replaces the sequence with polyphonic note events.

pub fn with_durations(self, durations: Vec<f32>) -> Self

Replaces the sequence durations.

pub fn with_instrument(self, instrument: impl Into<String>) -> Self

Sets the instrument alias for this sequence.

pub fn with_synth(self, synth: PulseSynth) -> Self

Sets an explicit synthesis algorithm for this sequence.

pub fn with_start_at(self, start_at: f32) -> PulseResult<Self>

Sets a sequence start offset relative to the song or phrase placement.

pub fn with_volume(self, volume: f32) -> PulseResult<Self>

Sets track volume for this sequence.

pub fn with_pan(self, pan: f32) -> PulseResult<Self>

Sets stereo pan for this sequence.

pub fn with_velocity(self, velocity: f32) -> PulseResult<Self>

Sets velocity for notes exported from this sequence.

pub fn transposed(&self, semitones: i32) -> Self

Returns a transposed copy without mutating the original sequence.

pub fn with_effect(self, effect: PulseEffect) -> Self

Appends a track-level effect to the sequence.

pub fn validate(&self) -> PulseResult<()>

Validates sequence shape and instrument name.

pub fn events(&self) -> PulseResult<Vec<PulseNoteEvent>>

Returns note/chord events with the current durations applied.

pub fn notes(&self) -> &[f32]

Returns note frequencies.

pub fn chords(&self) -> &[Vec<f32>]

Returns polyphonic event frequencies.

pub fn durations(&self) -> &[f32]

Returns durations in beats.

pub fn instrument(&self) -> &str

Returns the instrument alias.

pub fn synth(&self) -> Option<&PulseSynth>

Returns the explicit synthesis algorithm, if one was selected.

pub fn effects(&self) -> &[PulseEffect]

Returns track-level effects in insertion order.

pub fn start_at(&self) -> f32

Returns the sequence start offset.

pub fn volume(&self) -> f32

Returns sequence track volume.

pub fn pan(&self) -> f32

Returns sequence track pan.

pub fn velocity(&self) -> f32

Returns sequence note velocity.

pub fn duration(&self) -> f32

Returns the sequence duration in the same timeline units used by tunes.

Trait Implementations

impl Clone for PulseSequence

fn clone(&self) -> PulseSequence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PulseSequence

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

Formats the value using the given formatter.

impl Default for PulseSequence

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for PulseSequence

fn eq(&self, other: &PulseSequence) -> 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 StructuralPartialEq for PulseSequence

impl UserData for PulseSequence

fn add_methods<M: UserDataMethods<Self>>(methods: &mut M)

Adds custom methods and operators specific to this userdata.

fn add_fields<F>(fields: &mut F)

where F: UserDataFields<Self>,

Adds custom fields specific to this userdata.

fn register(registry: &mut UserDataRegistry<Self>)

Registers this type for use in Lua.