// =============================================================================
// Extended Documentation - X68000 Music Creation Software
// Authors: Kevin Alexander
// Last updated: 2023-11-16
// =============================================================================

This guide provides information and English translations regarding various
programs involved in the creation of music for the X68000. These are programs
that are simple enough to use as to not require their own documentation file.

This file is an active work in progress. Some programs may be broken out if
deemed necessary. For example, MXC.X may turn into a full-blown MML document at
some point.

Please see my guide "Workspace Setup Guide - X68000 Music Creation" for
information on how to get started with these programs.

// -----------------------------------------------------------------------------
// MXC.X
// -----------------------------------------------------------------------------

Basic usage:
    > run68.exe [option(s)] MXC.X {input}.mml
    
  Translation / Quick Reference of Options
--------------------------------------------------------------------------------
  Option        | Translation                           | Default Value
--------------------------------------------------------------------------------
  -m            | Do not display status message.        | N/A
  -x            | See below.                            | N/A
--------------------------------------------------------------------------------

Not sure what -x is supposed to indicate. The literal translation is: "Make the
top and bottom of the octave the same as X-BASIC." Obviously something to do
with how it functioned in an XBASIC environment. Experimentation/research
needed.

// -----------------------------------------------------------------------------
// mxwav
// -----------------------------------------------------------------------------

Basic usage:
    > mxwav.exe [option(s)] {input}.mdx

  Translation / Quick Reference of Options
--------------------------------------------------------------------------------
  Option        | Translation                           | Default Value
--------------------------------------------------------------------------------
  -L<n>         | Number of loops before fading out.    | 2
  -S<n>         | Set sample rate to 22,050 or 44,100.  | 44100
  -P<n>         | Set PDX buffer size (KB).             | 1024
  -W<n>         | Silence duration after fade out (ms). | 2000
  -U            | Do not use PCM8.                      | N/A
  -B            | Benchmark mode (no WAV output).       | N/A
  -O<filename>  | Specify output filename.              | Input name
--------------------------------------------------------------------------------

Notes and Findings Regarding Each Option:
- -L<n> (Number of loops before fading out)
    - Straightforward.
- -S<n> (Set sample rate to 22,050 or 44,100)
    - Can only be one of those two values.
- -P<n> (Set PDX buffer size (KB))
    - Significance unknown.
- -W<n> (Silence duration after fade out (ms))
    - Add <n> milliseconds of silence after the song completely fades out. This
      gives your track some breathing room in a playlist before the next song
      starts. Common recording technique.
- -U (Do not use PCM8)
    - Significance unknown.
- -B (Benchmark mode (no WAV output))
    - Straightforward.
- -O<filename> (Specify output filename)
    - Must specify extension (.wav) or you'll have to rename the file. There's
      no space after the 'O' (e.g. "-Omyfile.wav").

// =============================================================================

https://www.studioaquacube.com