Struct PatternMutatorConfig 

pub struct PatternMutatorConfig {
    pub operations: Vec<MutationOp>,
    pub amount: u8,
    pub seed: u64,
    pub locks: PatternLockSet,
}

Configuration describing a sequence of pattern mutations and their controls.

Fields

operations: Vec<MutationOp>

Operations applied in order.

amount: u8

Strength of each operation, from 0 to 100.

seed: u64

Seed for the deterministic pseudo-random generator.

locks: PatternLockSet

Source notes held fixed across all operations.

Implementations

impl PatternMutatorConfig

pub fn new(operations: Vec<MutationOp>) -> Self

Builds a config from operations with default amount, seed, and locks.

pub fn with_amount(self, amount: u8) -> Self

Sets the mutation strength, clamped to at most 100.

pub fn with_seed(self, seed: u64) -> Self

Sets the random seed.

pub fn with_locks(self, locks: PatternLockSet) -> Self

Sets the locked note set.

pub fn apply(&self, object: &dyn MusicObject) -> Result<Music, TransformError>

Applies the configured mutations to the input and returns the result.

pub fn to_wire(&self) -> String

Serializes this config to its pattern-mutator|... wire string.

pub fn from_wire(value: &str) -> Result<Self, PatternMutatorError>

Parses a config from its wire string, validating each field.

Examples

use sim_lib_music_transform::{MutationOp, PatternMutatorConfig};

let config = PatternMutatorConfig::new(vec![MutationOp::Reverse]).with_amount(80);
let wire = config.to_wire();
assert_eq!(PatternMutatorConfig::from_wire(&wire), Ok(config));

Trait Implementations

impl Clone for PatternMutatorConfig

fn clone(&self) -> PatternMutatorConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PatternMutatorConfig

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

Formats the value using the given formatter.

impl Eq for PatternMutatorConfig

impl PartialEq for PatternMutatorConfig

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PatternMutatorConfig