Struct SlotAttributes 

pub struct SlotAttributes {
    pub slot_type: SlotType,
    pub slot_id: u8,
    pub path: Option<PathBuf>,
    pub timestrech_mode: TimeStretchMode,
    pub loop_mode: LoopMode,
    pub trig_quantization_mode: TrigQuantizationMode,
    pub gain: u8,
    pub bpm: u16,
}

A sample slot’s global playback settings – trig quantization, bpm, timestrech mode … anything applied to the sample globally . The Octatrack only stores data when an audio file has been assigned to a sample slot.

Naming

The Octatrack manual specifically refers to

SAVE SAMPLE SETTINGS will save the trim, slice and attribute settings in a separate file and link it to the sample currently being edited. – page 87

So … these are the SLOT ATTRIBUTES which are saved to a SETTINGS FILE.

Non-Copy

This type is non-Copy becaue of the path field (PathBuf).

It is super frustrating in downstream applications, but I can’t really do much about it without

• abandonding the ability to transcode into YAML and JSON
• doing a hefty work-around where we decode into array data for the rust type

That last option is quite a lot of work as it is basically re-implementing OsString using fixed array sizes, then writing abstractions for all path methods that we might want to use on this “path that is really some fixed arrays, but we want everyone to think is a path”.

No-Default trait

It doesn’t make sense to have default field values for slot_type, slot_id or path.

Fields

slot_type: SlotType

Type of sample: STATIC or FLEX

slot_id: u8

String ID Number of the slot the sample is assigned to e.g. 001, 002, 003… Maximum of 128 entries for STATIC sample slots, but can be up to 136 for flex slots as there are 8 recorders + 128 flex slots.

path: Option<PathBuf>

Relative path to the file on the card from the project directory.

Recording buffer flex slots by default have an empty path attribute, which basically means ‘no path’. In idiomatic rust that’s an option.

timestrech_mode: TimeStretchMode

Current TimestrechModes setting for the specific slot. Example: TSMODE=2 See TimeStretchMode.

loop_mode: LoopMode

Current LoopMode setting for the specific slot. See LoopMode.

trig_quantization_mode: TrigQuantizationMode

Current TrigQuantizationModes setting for this specific slot. This is not used for recording buffer ‘flex’ tracks. See TrigQuantizationMode.

gain: u8

Sample gain. 48 is default as per sample attributes file. maximum 96, minimum 0.

bpm: u16

BPM of the sample in this slot. The stored representation is the ‘real’ bpm (float to 2 decimal places) multiplied by 24. Default value is 2880 (120 BPM). Max value is 7200 (300 BPM). Min value is 720 (30 BPM).

Implementations

impl SlotAttributes

pub fn new( slot_type: SlotType, slot_id: u8, path: Option<PathBuf>, timestretch_mode: Option<TimeStretchMode>, loop_mode: Option<LoopMode>, trig_quantization_mode: Option<TrigQuantizationMode>, gain: Option<u8>, bpm: Option<u16>, ) -> Result<Self, OtToolsIoError>

pub fn new_no_opts( slot_type: SlotType, slot_id: u8, path: Option<PathBuf>, ) -> Result<Self, OtToolsIoError>

“I don’t care about optional arguments, just let me create a SlotAttributes”

Trait Implementations

impl AsMut<SlotAttributes> for SlotAttributes

fn as_mut(&mut self) -> &mut SlotAttributes

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<SlotAttributes> for SlotAttributes

fn as_ref(&self) -> &SlotAttributes

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for SlotAttributes

fn clone(&self) -> SlotAttributes

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SlotAttributes

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SlotAttributes

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SlotAttributes

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

Formats the value using the given formatter.

impl Eq for SlotAttributes

impl FromStr for SlotAttributes

type Err = ProjectParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for SlotAttributes

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for SlotAttributes

fn cmp(&self, other: &SlotAttributes) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for SlotAttributes

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for SlotAttributes

fn partial_cmp(&self, other: &SlotAttributes) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for SlotAttributes

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SlotAttributes

impl TryFrom<&HashMap<String, String>> for SlotAttributes

type Error = ProjectParseError

The type returned in the event of a conversion error.

fn try_from(value: &HashMap<String, String>) -> Result<Self, Self::Error>

Performs the conversion.