Features

• A very optimized driver code, in regards to both space and CPU usage.
• Features percussion notes (up to 11), in both the old format (@[email protected]) and a new format where you put the octave as 9 (i.e. o9 c4 c+4 c8c8 c+4).
  You can override the vanilla percussion notes with custom percussion notes via #percussion, which uses a similar format to #instruments. #percussion allows you to set the following data for the percussive note:
  
  • ADSR and GAIN
  • Pitch multiplier (note is o4c)
  • Volume (if 0, it assumes the current channel volume)
  • Panning and surround bits (if $FF, it assumes the current channel panning and surround bits)
  • Echo.
• BRAND NEW COMMANDS.
  Collapsed text: Show/Hide
  • Portamento with customizable speed.
  • Loop break: allows a loop to end at this point during its last repetition.
  • Panbrello: an LFO for panning, think of it like tremolo for panning. Includes delay, speed and optional asynchronization (no resetting when starting a new note).
  • GAIN sequences: build a GAIN sequence that allows you to set a different GAIN value each tick (though you aren't forced to change it every tick; you can make the GAIN values last as long as you want) and apply it to a channel. Loop and release points are included, and a "force GAIN sequence release" command is included too! Think of it as FamiTracker's volume columns.
  • Vibrato toggle: Self-explanatory.
  • Guitar vibrato: makes vibrato only go upwards from the base pitch, like real guitars.
  • Staccato selector: allows you to choose between these options for the silence gap between continuous notes:
    
    • q-based, minimum 2 ticks (normal AMK behavior)
    • q-based, minimum 1 tick (light staccato AMK behavior)
    • no staccato at all (used in Aquarium Park Act 1)
    • always 1 tick (ignores staccato set in q)
    • always 2 ticks (same as before, used in Four Noble Devils 2)
  • Linear volume: makes volume linear instead of cuadratic.
• IMPROVED OLD COMMANDS:
  Collapsed text: Show/Hide
  • 4 loop layers. Go crazy, it supports * and (1) too!
    [ (2)[ [ (1)[ c ]3 ]5 ]37 ]9 (2)8 (1)89 *2
    Note: * calls the most external loop.
  • Decimal panning and tempo values. Panning and tempo can be 16-bit integer&decimal values. You can have more fine panning and tempo precision (i.e. y10.25 t30.6 y10.25,0,1).
  • Input tempo directly as a BPM value by using T instead of t (i.e. T150).
  • Relative pitch bend. If your note value in $DD is $80-$FF, it'll be a direct note. However, what's new in AMFR is that if your value is $00-$7F, it'll take that value to bend to a note relative to the current one, using $40 as the center value (i.e. $41 goes one semitone up, while $3F goes one semitone down).
  • AddMusicM's PWM, with added range parameter where you make the wave go from 50% to the range in 50-0% you define. This can be used to prevent the PWM from "drowning."
  • Like with the new panbrello command, the optional asynchronization setting is also present for tremolo when setting its delay value to $FF.
• Dynamic commands.
  Commands now are treated like samples: with #commands, you may define the hex ID ($D6-$FF), parameter length and file name to include all the commands you may need in your song, potentially excluding the ones you don't use to save ARAM. There are also command groups just like there are sample groups so you don't have to manually include the most commonly used commands!
  
  $D5, $DA, $DB, $DD and $E9 are fixed slots and forbidden to use and change in #commands, as they need to be global. Parameter length may be deprecated in the final release as the .asm files already contain the length in a define.
• Support for decimal/binary values in hex command parameters.
  It is now possible to use non-hex values for hex parameters. For example:
  
  • $E8 $60 100 instead of $E8 $60 $64
  • $EF %01100101 $15 $15 instead of $EF $65 $15 $15
• Custom NSPCs tables.
  At the start of a song, you may put #tables, and start defining your own velocity, staccato, panning and the 2 echo FIR tables for your song.
• NSPC pattern support.
  Divide songs in sections and save some space. You define it as #patterns {00,01,02,01}, where each number is the pattern number for every channel, and each pattern is divided by a /, for example, c / d / c. Individual patterns with repeated data get optimized. If you use / for patterns in the MML, you define the song's loop point with a / inside #patterns (i.e. #patterns {00/01,02,01}).
• Easier legato deactivation.
  Just input $D5 right next to the last note you want legato in; that $D5 will run in the same tick after that note gets triggered and will disable legato! No need to split your note in 2 and inserting a legato off command anymore, which saves space.
• Supports 2 more notes compared to AMK: (o6a+ and o6b).
• Syntax is based off the original AMK syntax, in an attempt to make things retrocompatible with AMK songs, which means that you can do stuff like replacing the third parameter of $DD with a note (or +x or -x for the relative pitch bend feature). There's also new syntax for most hex commands; we'll go in detail about it in the future!
• Are you just too lazy to change notes manually? Then this is your lucky day! - and + are now stackable! c c+ c++ c+++ c++++ e- e-- e---
• Fades now always make sure they end at their desired value. This is more noticeable with quick fades, where AMK would make the end value different than the one defined in the command; AMFR doesn't have this issue.

Future features

• Real-time control features for sound effects:
  
  • Panning control, to create effects such as the SFX coming from different parts of the screen. SFX itself, independent of the control input, can also opt to have a default panning and ignore the control input.
  • Echo. The SFX itself can also ignore the input so it can always force echo on or off.
• Real-time control features for music:
  
  • Fade-out and fade-in, without messing up with global volume unlike AMK, by having a second "secret global volume" and fading that instead.
  • Mute certain channels.
  • Force centered panning for all channels.
  • Force echo on or off for all channels.
• Make GAIN sequences actually multi-purpose: each sequence point, they'll trigger a one-parameter long command defined at the start of the sequence, overriding the parameter with the value at the sequence point, allowing for custom vibratos by using tuning, sample swaps (done in examples by using a custom build that replaces one byte in the GAIN sequence code), etc.
• Multi-samples, by creating a command that reads a multi-sample table and assigns a sample ID based on the current note, and putting it inside a -1 type remote command. This will allow you to automatically change samples depending on the notes for Pianos, Guitars and the like.
• Better Echo Lvl control and automation! No more directly editing the DSP registers.
• SMAS LFSR (wind) effect

Example SPCs (click to play on web player)

• Mother 3 - Showertime Ballad, by Pinci. Panbrello example.
• Romancing SaGa 3 - Four Noble Devils 2, by LMPuny. PWM, custom percussion, decimal panning and staccato selector example.
• Wario Land 4 - Monsoon Jungle, by LMPuny. Panned bongos version.
• Bunny Must Die! - Knightmare Again, by Masterlink. Guitar vibrato, custom percussion and decimal panning example.
• Under Summer Skies, by Pinci. Panbrello, custom percussion and PWM example.
• Sonic Colors - Aquarium Park Act 1, by LMPuny. Done with many of AMFR's own features.
• Etrian Odyssey III - The First Campaign, by Pinci. Sample sequence (modified GAIN sequence), custom percussion and ARAM edit example (to downsample the PWM base sample and change the start point of the muted guitar sample).
• Super Tennis - Circuit, by Pinci. Sample sequence example.
• Golden Sun - Saturos Battle, by Masterlink. PWM, custom percussion, #patterns, staccato table modification, base pitch relative bends, direct BPM tempo, decimal panning and loop breaks example.
• Some sample sequence tests by Pinci.
• A GAIN sequence test by LMPuny.

Credits