Struct PresetFile 

pub struct PresetFile {
    pub version: u32,
    pub instrument: String,
    pub presets: Vec<Preset>,
}

One instrument’s bank of user presets.

Fields

version: u32

instrument: String

Instrument key this file belongs to, matching the .phos spelling.

presets: Vec<Preset>

Implementations

impl PresetFile

pub fn new(instrument: InstrumentType) -> Self

pub fn names(&self) -> Vec<&str>

Preset names in file order — what the browser lists.

pub fn find(&self, name: &str) -> Option<usize>

Index of the preset with this name, if the bank holds one.

Names are compared after trimming, so “ pad“ and “pad “ are the same slot rather than two rows the player cannot tell apart.

pub fn store( &mut self, name: &str, instrument: InstrumentType, params: &[f32], ) -> Result<StoreOutcome, PresetError>

Store params under name.

A name already in the bank rewrites that slot in place rather than adding a second row: the browser lists by name, so two rows called “warm pad” are two rows the player cannot choose between, and d would delete an arbitrary one of them. Callers are expected to confirm before overwriting — find says whether they need to.

pub fn remove(&mut self, index: usize) -> Option<Preset>

Remove the preset at index, returning it.

pub fn params_at( &self, index: usize, instrument: InstrumentType, want_count: usize, ) -> Option<Result<LoadedPreset, PresetError>>

The parameter block at index, if it is safe to load into this instrument’s current panel.

Owned rather than borrowed because the block that comes back is not the block on disk: every selector is repointed at the position the preset named, which for a bank that has changed size is a different fraction from the one that was stored.

Trait Implementations

impl Clone for PresetFile

fn clone(&self) -> PresetFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PresetFile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PresetFile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PresetFile

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

where __S: Serializer,

Serialize this value into the given Serde serializer.