NFG Games + GameSX

User Tools

Site Tools

Trace:
x68000:mxdrv_mml_mdx_tutorial

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
x68000:mxdrv_mml_mdx_tutorial [2016/01/24 12:46] – exodusmodulesx68000:mxdrv_mml_mdx_tutorial [2019/08/27 20:45] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== MXDRV MML/MDX Tutorial ======+====== x68k Music: MXDRV MML/MDX Tutorial and Documentation ======
 So, you've been enlighted with the knowledge of a little machine called the  So, you've been enlighted with the knowledge of a little machine called the 
 Sharp x68000. Sharp x68000.
Line 29: Line 29:
 LOL LOL
  
-====== x68k Sound Information ======+===== x68k Sound Information =====
 The Sharp x68000 has two chips for audio within the main unit. These two chips are The Sharp x68000 has two chips for audio within the main unit. These two chips are
 the Yamaha YM2151 (a.k.a. OPM), and the OKI MSM6258, which are used for FM Synthesis and  the Yamaha YM2151 (a.k.a. OPM), and the OKI MSM6258, which are used for FM Synthesis and 
Line 36: Line 36:
 The early models of the x68k have 8 channels of FM and 1 channel of ADPCM. The early models of the x68k have 8 channels of FM and 1 channel of ADPCM.
 Later Sharp decided to expand the ADPCM audio, and added 7 extra channels of ADPCM, Later Sharp decided to expand the ADPCM audio, and added 7 extra channels of ADPCM,
-dubbing the new ADPCM system the PCM8 expansion or PCM8. There is also a software called PCM8+dubbing the new ADPCM expansion the Mercury unit. There is also a software called PCM8
 which uses software mixing to add more ADPCM channels, but from what I've tested of it, it's a  which uses software mixing to add more ADPCM channels, but from what I've tested of it, it's a 
 CPU cycle thief. There are other software mixing ADPCM TSR drivers, but I haven't tried them. CPU cycle thief. There are other software mixing ADPCM TSR drivers, but I haven't tried them.
  
-MXDRV allows you to use PCM8 in addition to the normal FM Synthesis and ADPCM.+MXDRV allows you to use PCM8/Mercury expansion in addition to the normal FM Synthesis and ADPCM.
  
 ====== Required/Optional Tools and Information Links ====== ====== Required/Optional Tools and Information Links ======
Line 129: Line 129:
  http://woolyss.com/chipmusic-mml.php  http://woolyss.com/chipmusic-mml.php
  This page has a great deal of MML editors and compilers (though none for the x68k).  This page has a great deal of MML editors and compilers (though none for the x68k).
- It MML bundles for various text editors at the bottom of the page (including  + It has MML syntax highlighters for various text editors at the bottom of the page (including  
- Notepad++), but it was made for PPMCK mml. However, you can still use it.+ Notepad++), but they were made for PPMCK mml. However, you can still use them.
  
 ====== General MML Information ====== ====== General MML Information ======
Line 150: Line 150:
 techniques. techniques.
  
-====== General MML Macros and Syntax ======+===== General MML Macros and Syntax =====
 Get ready, because I'm about to get straight to the point with this one. Get ready, because I'm about to get straight to the point with this one.
 If some of these terms are confusing you, then you might need to learn  If some of these terms are confusing you, then you might need to learn 
Line 338: Line 338:
  Set the coarse volume, where # is a number between 0 and 15  Set the coarse volume, where # is a number between 0 and 15
  
-====== MXDRV MML Macros and Syntax ======+===== MXDRV MML Macros and Syntax =====
 The following macros are MXDRV specific: The following macros are MXDRV specific:
  
Line 419: Line 419:
  0 < # < 255  0 < # < 255
  
-    @v#+ @v#
          
-    Set fine volume (for a single channel) + Set fine volume (for a single channel) 
-    0 < # < 255 + 0 < # < 255 
-    This allows more precise control over the volume. For effects like fade-ins or + This allows more precise control over the volume. For effects like fade-ins or 
-    fade outs, you can use coarse volume instead (unless you find pain pleasurable)+     fade outs, you can use coarse volume instead (unless you find pain pleasurable)
  
-    A-H, P-W+ A-H, P-W
          
-    Set channel + Set channel 
-     This macro must always appear at the very beginning of a line in which  + This macro must always appear at the very beginning of a line in which  
-     you intend to sequence notes and macros. The exceptions are voice definitions,  + you intend to sequence notes and macros. The exceptions are voice definitions,  
-     comments, and metadata definitions.+ comments, and metadata definitions.
  Ex. A   Ex. A 
  sets channel to A (FM channel 1)  sets channel to A (FM channel 1)
Line 561: Line 561:
  
 If you have all the required tools, you will need the following for compilation: If you have all the required tools, you will need the following for compilation:
 +
 1. A Sharp x68000 emulator - run68k is easy as it emulates human68k, although you  1. A Sharp x68000 emulator - run68k is easy as it emulates human68k, although you 
 could use a full Sharp x68k emulator could use a full Sharp x68k emulator
 +
 2. A Sharp x68k MDX compiler - mxc.x from MDX_TOOL is the one I use 2. A Sharp x68k MDX compiler - mxc.x from MDX_TOOL is the one I use
 +
 3. Your MML source code (go figure) as a .mml plain text file 3. Your MML source code (go figure) as a .mml plain text file
  
Line 612: Line 615:
  
 After you finish your PDL file, you'll need to make your PDX. After you finish your PDL file, you'll need to make your PDX.
-Run the following in CMD (or just drag and drop your pdx on mkpdx): +Run the following in CMD (or just drag and drop your pdl on mkpdx): 
-mkpdx \directory\to\mypdl.pdl+<file>mkpdx \directory\to\mypdl.pdl</file>
  
-The mkpdx binary I provided is for Win32, so you don't need to use DOSBox for it.+The mkpdx binary I provided is for Win32, so you don't need to use an x68k emulator or DOSBox for it.
  
 If your PDL file is syntactically correct, then mkpdx will spit out a PDX file in the If your PDL file is syntactically correct, then mkpdx will spit out a PDX file in the
Line 621: Line 624:
  
 Now you can use your PDX in your MML tunes by defining the following at the top: Now you can use your PDX in your MML tunes by defining the following at the top:
-<file>#pcmfile "mypdx.pdx"<file>+<file>#pcmfile "mypdx.pdx"</file>
  
 To use PCM in a MML tune, use channels P-W. It's easier to use the numerical To use PCM in a MML tune, use channels P-W. It's easier to use the numerical
x68000/mxdrv_mml_mdx_tutorial.1453603602.txt.gz · Last modified: 2019/08/27 20:44 (external edit)