XMrs File format library

A no_std library to edit Sound Tracker data with pleasure.

Because "Representation is the Essence of Programming".

For now MOD Amiga Modules, S3M Scream Tracker III and XM FastTracker II files are supported.

Rob Hubbard C64 SID import is a WIP.

Useful struct parts:

• Module
  • Pattern
    • PatternSlot
  • Instrument
    • InstrDefault for Historical XM Instrument
      • Envelope
      • Vibrato
      • Sample
    • InstrEkn for Euclidian Rythm Instrument
    • InstrMidi for Midi Instrument
    • InstrOpl for Yamaha OPL Instrument
    • InstrSid for MOS6581 SID Instrument
    • InstrRobSid for historical Rob Hubbard Instrument
      • RobEffects

Load MOD file

Use import_mod feature

1. Deserialize AmigaModule struct using AmigaModule::load(&amiga)
2. Convert to struct Module using .to_module()

Load S3M file

Use import_s3m feature

1. Deserialize S3mModule struct using S3mModule::load(&s3m)
2. Convert to struct Module using .to_module()

Load XM file

Use import_xm feature

1. Deserialize XmModule struct using XmModule::load(&XM)
2. Convert to struct Module using .to_module()

Save XM file

1. Convert Module to XmModule: XmModule::from_module(&module)
2. Serialize using XmModule save() fn

Edit data using rustified structs, use Module struct.

Note: You can only save InstrDefault using XM fileformat.

About no_std

micromath is used by default in no_std. If you prefer libm, use cargo build --no-default-features --features=libm --release.

About std

if you want to use std feature use cargo build --no-default-features --features=std --release

About std demo

if you want to test examples use cargo build --no-default-features --features=std,demo --release