Struct SamplerInstrument 

pub struct SamplerInstrument {
    pub name: String,
    pub origin: String,
    pub description: String,
    pub author: String,
    pub tuning: TuningTable,
    pub zones: Vec<SampleZone>,
    pub zone_groups: Vec<ZoneGroup>,
    pub attack: f32,
    pub decay: f32,
    pub sustain: f32,
    pub release: f32,
    pub max_voices: usize,
}

A complete sampler instrument.

Fields

name: String

Instrument name.

origin: String

Cultural/geographic origin (e.g. “Ethiopian”, “Indian”, “Western”).

description: String

Description.

author: String

Author.

tuning: TuningTable

Tuning system.

zones: Vec<SampleZone>

All sample zones (legacy flat list, kept for backward compatibility).

zone_groups: Vec<ZoneGroup>

Zone groups (new grouped list with round-robin support).

attack: f32

ADSR envelope: attack, decay, sustain, release (seconds/level).

decay: f32

sustain: f32

release: f32

max_voices: usize

Maximum polyphony (simultaneous voices).

Implementations

impl SamplerInstrument

pub fn new(name: &str) -> Self

pub fn normalize(&mut self)

Normalize the instrument after deserialization. If zone_groups is empty, populate it from zones (each zone → ZoneGroup with Sequential mode).

pub fn find_zone(&self, note: u8, velocity: u8) -> Option<&SampleZone>

Find the best matching zone for a note + velocity. If multiple zones match, prefer the one whose root_note is closest.

pub fn find_zone_rr<'a>( &'a self, note: u8, velocity: u8, rr_state: &mut RoundRobinState, ) -> Option<&'a SampleZone>

Find a zone using round-robin selection. Returns the selected zone from the first matching zone group.

pub fn add_zone(&mut self, zone: SampleZone)

Add a zone.

pub fn save(&self, path: &Path) -> Result<()>

Save to JSON file.

pub fn load(path: &Path) -> Result<Self, Box<dyn Error>>

Load from JSON file.

Trait Implementations

impl Clone for SamplerInstrument

fn clone(&self) -> SamplerInstrument

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SamplerInstrument

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SamplerInstrument

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SamplerInstrument

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.